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

package/dist/gltf/lib/api/convert-gltf-v1-materials.cjs

@@ -0,0 +1,265 @@
+"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/convert-gltf-v1-materials.ts
+var convert_gltf_v1_materials_exports = {};
+__export(convert_gltf_v1_materials_exports, {
+  canPreserveGLTFV1MaterialFallbacks: () => canPreserveGLTFV1MaterialFallbacks,
+  convertGLTFV1Materials: () => convertGLTFV1Materials
+});
+module.exports = __toCommonJS(convert_gltf_v1_materials_exports);
+var COMMON_MATERIAL_EXTENSION = "KHR_materials_common";
+var UNLIT_MATERIAL_EXTENSION = "KHR_materials_unlit";
+function convertGLTFV1Materials(json, reportUnsupported, reportNote) {
+  const fallbackTechniques = /* @__PURE__ */ new Set();
+  const commonRequired = json.extensionsRequired?.includes(COMMON_MATERIAL_EXTENSION) || false;
+  for (const [materialIndex, material] of (json.materials || []).entries()) {
+    const legacyMaterial = material;
+    const common = material.extensions?.[COMMON_MATERIAL_EXTENSION];
+    if (common === void 0) {
+      convertConventionalMaterial(legacyMaterial, json, reportUnsupported, reportNote);
+      continue;
+    }
+    preserveMaterialSource(legacyMaterial, common);
+    const label = `material ${materialIndex}`;
+    if (!isRecord(common) || typeof common.technique !== "string" || !["CONSTANT", "LAMBERT", "PHONG", "BLINN"].includes(common.technique)) {
+      reportUnsupported(`${label} unknown ${COMMON_MATERIAL_EXTENSION} technique`);
+      continue;
+    }
+    if (common.values !== void 0 && !isRecord(common.values)) {
+      reportUnsupported(`${label} common material values must be an object`);
+      continue;
+    }
+    const values = common.values || {};
+    const unknownFields = Object.keys(common).filter(
+      (field) => !["technique", "values", "doubleSided", "transparent", "jointCount"].includes(field)
+    );
+    const unknownValues = Object.keys(values).filter(
+      (field) => ![
+        "ambient",
+        "diffuse",
+        "emission",
+        "specular",
+        "shininess",
+        "transparency",
+        "doubleSided",
+        "transparent"
+      ].includes(field)
+    );
+    if (unknownFields.length || unknownValues.length)
+      reportUnsupported(
+        `${label} unrecognized common material fields ${[...unknownFields, ...unknownValues].join(", ")}`
+      );
+    if (common.jointCount !== void 0 && (!Number.isSafeInteger(common.jointCount) || Number(common.jointCount) < 0))
+      reportUnsupported(`${label} invalid common material jointCount`);
+    const emission = readMaterialValue(
+      values.emission,
+      json,
+      `${label} emission`,
+      reportUnsupported
+    );
+    const constant = common.technique === "CONSTANT";
+    const diffuse = constant ? emission : readMaterialValue(values.diffuse, json, `${label} diffuse`, reportUnsupported);
+    const opacity = values.transparency === void 0 ? 1 : values.transparency;
+    const validOpacity = typeof opacity === "number" && Number.isFinite(opacity) && opacity >= 0 && opacity <= 1;
+    if (!validOpacity) reportUnsupported(`${label} common material transparency must be in [0, 1]`);
+    const transparent = readCommonFlag(common, values, "transparent", label, reportUnsupported);
+    const doubleSided = readCommonFlag(common, values, "doubleSided", label, reportUnsupported);
+    if (values.ambient !== void 0 && !isBlackColor(values.ambient))
+      reportUnsupported(`${label} ambient lighting`);
+    if (["PHONG", "BLINN"].includes(String(common.technique))) {
+      if (values.specular !== void 0 && !isBlackColor(values.specular))
+        reportUnsupported(`${label} specular/shininess lighting`);
+      if (values.shininess !== void 0 && (typeof values.shininess !== "number" || !Number.isFinite(values.shininess) || values.shininess < 0))
+        reportUnsupported(`${label} invalid common material shininess`);
+    }
+    material.pbrMetallicRoughness ||= {};
+    const physicallyBasedMaterial = material.pbrMetallicRoughness;
+    physicallyBasedMaterial.metallicFactor ??= 0;
+    physicallyBasedMaterial.roughnessFactor ??= 1;
+    if (diffuse) {
+      const factor = [...diffuse.factor];
+      factor[3] *= validOpacity ? opacity : 1;
+      physicallyBasedMaterial.baseColorFactor ??= factor;
+      if (diffuse.texture) physicallyBasedMaterial.baseColorTexture ??= diffuse.texture;
+    }
+    material.doubleSided ??= doubleSided;
+    material.alphaMode ??= transparent ? "BLEND" : "OPAQUE";
+    if (constant) {
+      material.extensions[UNLIT_MATERIAL_EXTENSION] ??= {};
+      declareExtension(json, UNLIT_MATERIAL_EXTENSION, commonRequired);
+      reportNote(`Converted ${label} CONSTANT emission to an unlit material.`);
+    } else {
+      if (emission) {
+        material.emissiveFactor ??= emission.factor.slice(0, 3);
+        if (emission.texture) material.emissiveTexture ??= emission.texture;
+      }
+      reportNote(
+        `Approximated ${label} ${String(common.technique)} lighting with rough non-metallic PBR factors.`
+      );
+    }
+    if (typeof legacyMaterial.technique === "string")
+      fallbackTechniques.add(legacyMaterial.technique);
+    else if (legacyMaterial.technique !== void 0)
+      reportUnsupported(`${label} invalid fallback technique ID`);
+    delete legacyMaterial.technique;
+    delete legacyMaterial.values;
+    delete material.extensions[COMMON_MATERIAL_EXTENSION];
+    if (!Object.keys(material.extensions).length) delete material.extensions;
+  }
+  const remaining = collectExtensionNames(json);
+  if (json.extensions?.[COMMON_MATERIAL_EXTENSION] !== void 0 || (json.nodes || []).some((node) => node.extensions?.[COMMON_MATERIAL_EXTENSION] !== void 0))
+    reportUnsupported(`${COMMON_MATERIAL_EXTENSION} lights or scene payloads`);
+  if (!remaining.has(COMMON_MATERIAL_EXTENSION)) {
+    json.extensionsUsed = json.extensionsUsed?.filter(
+      (extension) => extension !== COMMON_MATERIAL_EXTENSION
+    );
+    json.extensionsRequired = json.extensionsRequired?.filter(
+      (extension) => extension !== COMMON_MATERIAL_EXTENSION
+    );
+  }
+  return fallbackTechniques;
+}
+function canPreserveGLTFV1MaterialFallbacks(json, fallbackTechniques) {
+  if (!fallbackTechniques.size || [...collectExtensionNames(json)].some(
+    (extension) => ![COMMON_MATERIAL_EXTENSION, UNLIT_MATERIAL_EXTENSION].includes(extension)
+  ))
+    return false;
+  if ((json.materials || []).some(
+    (material) => material.technique !== void 0 || material.values !== void 0
+  ))
+    return false;
+  const legacyJson = json;
+  if (["techniques", "programs", "shaders"].some(
+    (collection) => legacyJson[collection] !== void 0 && !isRecord(legacyJson[collection])
+  ))
+    return false;
+  const techniques = isRecord(legacyJson.techniques) ? legacyJson.techniques : {};
+  const programs = isRecord(legacyJson.programs) ? legacyJson.programs : {};
+  const shaders = isRecord(legacyJson.shaders) ? legacyJson.shaders : {};
+  const coveredPrograms = /* @__PURE__ */ new Set();
+  const coveredShaders = /* @__PURE__ */ new Set();
+  if (Object.keys(techniques).some((identifier) => !fallbackTechniques.has(identifier))) return false;
+  for (const technique of Object.values(techniques))
+    if (isRecord(technique) && typeof technique.program === "string")
+      coveredPrograms.add(technique.program);
+  if (Object.keys(programs).some((identifier) => !coveredPrograms.has(identifier))) return false;
+  for (const program of Object.values(programs))
+    if (isRecord(program)) {
+      for (const field of ["vertexShader", "fragmentShader"])
+        if (typeof program[field] === "string") coveredShaders.add(program[field]);
+    }
+  return Object.keys(shaders).every((identifier) => coveredShaders.has(identifier));
+}
+function convertConventionalMaterial(material, json, reportUnsupported, reportNote) {
+  preserveMaterialSource(material);
+  const values = isRecord(material.values) ? material.values : {};
+  const textureIdentifier = values.tex || values.texture2d_0 || values.diffuseTex || values.diffuse;
+  const textureIndex = findTextureIndex(json, textureIdentifier);
+  const diffuseColor = isUnitColorFactor(values.diffuse) ? values.diffuse : void 0;
+  if (textureIndex !== -1 || diffuseColor) {
+    const factor = diffuseColor ? [...diffuseColor] : [1, 1, 1, 1];
+    const transparency = values.transparency;
+    if (typeof transparency === "number" && transparency >= 0 && transparency <= 1)
+      factor[3] *= transparency;
+    material.pbrMetallicRoughness ||= {};
+    material.pbrMetallicRoughness.metallicFactor ??= 0;
+    material.pbrMetallicRoughness.roughnessFactor ??= 1;
+    material.pbrMetallicRoughness.baseColorFactor ??= factor;
+    if (textureIndex !== -1)
+      material.pbrMetallicRoughness.baseColorTexture ??= { index: textureIndex };
+    if (material.pbrMetallicRoughness.baseColorFactor[3] < 1) material.alphaMode ||= "BLEND";
+    reportNote("Approximated glTF v1 diffuse material values with PBR material factors.");
+  }
+  if (material.technique || material.values)
+    reportUnsupported(`material technique ${material.technique || "<unnamed>"}`);
+}
+function readMaterialValue(value, json, label, reportUnsupported) {
+  if (value === void 0) return { factor: [0, 0, 0, 1] };
+  if (isUnitColorFactor(value)) return { factor: [...value] };
+  const textureIndex = findTextureIndex(json, value);
+  if (textureIndex !== -1) return { factor: [1, 1, 1, 1], texture: { index: textureIndex } };
+  reportUnsupported(`${label} requires an RGBA factor in [0, 1] or a resolved texture ID`);
+  return null;
+}
+function findTextureIndex(json, value) {
+  if (typeof value !== "string") return -1;
+  return (json.textures || []).findIndex(
+    (texture) => texture.id === value
+  );
+}
+function readCommonFlag(common, values, field, label, reportUnsupported) {
+  if (common[field] !== void 0 && values[field] !== void 0 && common[field] !== values[field])
+    reportUnsupported(`${label} conflicting common material ${field}`);
+  const value = values[field] !== void 0 ? values[field] : common[field] !== void 0 ? common[field] : false;
+  if (typeof value === "boolean") return value;
+  reportUnsupported(`${label} common material ${field} must be boolean`);
+  return false;
+}
+function preserveMaterialSource(material, common) {
+  const extras = isRecord(material.extras) ? material.extras : material.extras === void 0 ? {} : { originalExtras: material.extras };
+  const previous = isRecord(extras.gltf1) ? extras.gltf1 : extras.gltf1 === void 0 ? {} : { originalExtras: extras.gltf1 };
+  const source = {
+    technique: material.technique,
+    values: material.values,
+    ...common === void 0 ? {} : { commonMaterial: common }
+  };
+  const conflicting = Object.keys(source).some((field) => Object.hasOwn(previous, field));
+  material.extras = {
+    ...extras,
+    gltf1: { ...previous, ...source, ...conflicting ? { originalExtras: previous } : {} }
+  };
+}
+function declareExtension(json, extension, required) {
+  json.extensionsUsed = [.../* @__PURE__ */ new Set([...json.extensionsUsed || [], extension])];
+  if (required)
+    json.extensionsRequired = [.../* @__PURE__ */ new Set([...json.extensionsRequired || [], extension])];
+}
+function collectExtensionNames(value) {
+  const names = /* @__PURE__ */ new Set();
+  const pending = [value];
+  const visited = /* @__PURE__ */ new Set();
+  while (pending.length) {
+    const object = pending.pop();
+    if (!object || typeof object !== "object" || visited.has(object)) continue;
+    visited.add(object);
+    if (isRecord(object) && isRecord(object.extensions))
+      for (const name of Object.keys(object.extensions)) names.add(name);
+    for (const [field, child] of Object.entries(object))
+      if (field !== "extras") pending.push(child);
+  }
+  return names;
+}
+function isUnitColorFactor(value) {
+  return Array.isArray(value) && value.length === 4 && value.every(
+    (component) => typeof component === "number" && Number.isFinite(component) && component >= 0 && component <= 1
+  );
+}
+function isBlackColor(value) {
+  return isUnitColorFactor(value) && value.slice(0, 3).every((component) => component === 0);
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  canPreserveGLTFV1MaterialFallbacks,
+  convertGLTFV1Materials
+});
+//# sourceMappingURL=convert-gltf-v1-materials.cjs.map

package/dist/gltf/lib/api/convert-gltf-v1-materials.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/convert-gltf-v1-materials.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {GLTF} from '../types/gltf-types';\nimport type {GLTFMaterial, GLTFTextureInfo} from '../types/gltf-json-schema';\n\nconst COMMON_MATERIAL_EXTENSION = 'KHR_materials_common';\nconst UNLIT_MATERIAL_EXTENSION = 'KHR_materials_unlit';\n\n/** Legacy programmable material properties retained as provenance after conversion. */\ntype LegacyMaterial = GLTFMaterial & {\n  /** Optional fallback technique identifier. */\n  technique?: unknown;\n  /** Fallback shader uniform values. */\n  values?: unknown;\n};\n\n/** A validated legacy color or resolved texture, expressed without changing image bytes. */\ntype MaterialValue = {\n  /** RGBA color, or a white multiplier for texture-only values. */\n  readonly factor: number[];\n  /** Resolved texture using the default coordinate set. */\n  readonly texture?: GLTFTextureInfo;\n};\n\n/** Convert conventional and common materials, returning overridden fallback technique IDs. */\nexport function convertGLTFV1Materials(\n  json: GLTF,\n  reportUnsupported: (feature: string) => void,\n  reportNote: (message: string) => void\n): Set<string> {\n  const fallbackTechniques = new Set<string>();\n  const commonRequired = json.extensionsRequired?.includes(COMMON_MATERIAL_EXTENSION) || false;\n  for (const [materialIndex, material] of (json.materials || []).entries()) {\n    const legacyMaterial = material as LegacyMaterial;\n    const common = material.extensions?.[COMMON_MATERIAL_EXTENSION] as unknown;\n    if (common === undefined) {\n      convertConventionalMaterial(legacyMaterial, json, reportUnsupported, reportNote);\n      continue;\n    }\n    preserveMaterialSource(legacyMaterial, common);\n    const label = `material ${materialIndex}`;\n    if (\n      !isRecord(common) ||\n      typeof common.technique !== 'string' ||\n      !['CONSTANT', 'LAMBERT', 'PHONG', 'BLINN'].includes(common.technique)\n    ) {\n      reportUnsupported(`${label} unknown ${COMMON_MATERIAL_EXTENSION} technique`);\n      continue;\n    }\n    if (common.values !== undefined && !isRecord(common.values)) {\n      reportUnsupported(`${label} common material values must be an object`);\n      continue;\n    }\n    const values = (common.values || {}) as Record<string, unknown>;\n    const unknownFields = Object.keys(common).filter(\n      field => !['technique', 'values', 'doubleSided', 'transparent', 'jointCount'].includes(field)\n    );\n    const unknownValues = Object.keys(values).filter(\n      field =>\n        ![\n          'ambient',\n          'diffuse',\n          'emission',\n          'specular',\n          'shininess',\n          'transparency',\n          'doubleSided',\n          'transparent'\n        ].includes(field)\n    );\n    if (unknownFields.length || unknownValues.length)\n      reportUnsupported(\n        `${label} unrecognized common material fields ${[...unknownFields, ...unknownValues].join(', ')}`\n      );\n    if (\n      common.jointCount !== undefined &&\n      (!Number.isSafeInteger(common.jointCount) || Number(common.jointCount) < 0)\n    )\n      reportUnsupported(`${label} invalid common material jointCount`);\n    const emission = readMaterialValue(\n      values.emission,\n      json,\n      `${label} emission`,\n      reportUnsupported\n    );\n    const constant = common.technique === 'CONSTANT';\n    const diffuse = constant\n      ? emission\n      : readMaterialValue(values.diffuse, json, `${label} diffuse`, reportUnsupported);\n    const opacity = values.transparency === undefined ? 1 : values.transparency;\n    const validOpacity =\n      typeof opacity === 'number' && Number.isFinite(opacity) && opacity >= 0 && opacity <= 1;\n    if (!validOpacity) reportUnsupported(`${label} common material transparency must be in [0, 1]`);\n    const transparent = readCommonFlag(common, values, 'transparent', label, reportUnsupported);\n    const doubleSided = readCommonFlag(common, values, 'doubleSided', label, reportUnsupported);\n    if (values.ambient !== undefined && !isBlackColor(values.ambient))\n      reportUnsupported(`${label} ambient lighting`);\n    if (['PHONG', 'BLINN'].includes(String(common.technique))) {\n      if (values.specular !== undefined && !isBlackColor(values.specular))\n        reportUnsupported(`${label} specular/shininess lighting`);\n      if (\n        values.shininess !== undefined &&\n        (typeof values.shininess !== 'number' ||\n          !Number.isFinite(values.shininess) ||\n          values.shininess < 0)\n      )\n        reportUnsupported(`${label} invalid common material shininess`);\n    }\n    material.pbrMetallicRoughness ||= {};\n    const physicallyBasedMaterial = material.pbrMetallicRoughness;\n    physicallyBasedMaterial.metallicFactor ??= 0;\n    physicallyBasedMaterial.roughnessFactor ??= 1;\n    if (diffuse) {\n      const factor = [...diffuse.factor];\n      factor[3] *= validOpacity ? opacity : 1;\n      physicallyBasedMaterial.baseColorFactor ??= factor;\n      if (diffuse.texture) physicallyBasedMaterial.baseColorTexture ??= diffuse.texture;\n    }\n    material.doubleSided ??= doubleSided;\n    material.alphaMode ??= transparent ? 'BLEND' : 'OPAQUE';\n    if (constant) {\n      material.extensions![UNLIT_MATERIAL_EXTENSION] ??= {};\n      declareExtension(json, UNLIT_MATERIAL_EXTENSION, commonRequired);\n      reportNote(`Converted ${label} CONSTANT emission to an unlit material.`);\n    } else {\n      if (emission) {\n        material.emissiveFactor ??= emission.factor.slice(0, 3);\n        if (emission.texture) material.emissiveTexture ??= emission.texture;\n      }\n      reportNote(\n        `Approximated ${label} ${String(common.technique)} lighting with rough non-metallic PBR factors.`\n      );\n    }\n    if (typeof legacyMaterial.technique === 'string')\n      fallbackTechniques.add(legacyMaterial.technique);\n    else if (legacyMaterial.technique !== undefined)\n      reportUnsupported(`${label} invalid fallback technique ID`);\n    delete legacyMaterial.technique;\n    delete legacyMaterial.values;\n    delete material.extensions![COMMON_MATERIAL_EXTENSION];\n    if (!Object.keys(material.extensions!).length) delete material.extensions;\n  }\n  const remaining = collectExtensionNames(json);\n  if (\n    json.extensions?.[COMMON_MATERIAL_EXTENSION] !== undefined ||\n    (json.nodes || []).some(node => node.extensions?.[COMMON_MATERIAL_EXTENSION] !== undefined)\n  )\n    reportUnsupported(`${COMMON_MATERIAL_EXTENSION} lights or scene payloads`);\n  if (!remaining.has(COMMON_MATERIAL_EXTENSION)) {\n    json.extensionsUsed = json.extensionsUsed?.filter(\n      extension => extension !== COMMON_MATERIAL_EXTENSION\n    );\n    json.extensionsRequired = json.extensionsRequired?.filter(\n      extension => extension !== COMMON_MATERIAL_EXTENSION\n    );\n  }\n  return fallbackTechniques;\n}\n\n/** Recognize resources overridden by converted common materials, without claiming shader translation. */\nexport function canPreserveGLTFV1MaterialFallbacks(\n  json: GLTF,\n  fallbackTechniques: Set<string>\n): boolean {\n  if (\n    !fallbackTechniques.size ||\n    [...collectExtensionNames(json)].some(\n      extension => ![COMMON_MATERIAL_EXTENSION, UNLIT_MATERIAL_EXTENSION].includes(extension)\n    )\n  )\n    return false;\n  if (\n    (json.materials || []).some(\n      material =>\n        (material as LegacyMaterial).technique !== undefined ||\n        (material as LegacyMaterial).values !== undefined\n    )\n  )\n    return false;\n  const legacyJson = json as unknown as Record<string, unknown>;\n  if (\n    ['techniques', 'programs', 'shaders'].some(\n      collection => legacyJson[collection] !== undefined && !isRecord(legacyJson[collection])\n    )\n  )\n    return false;\n  const techniques = isRecord(legacyJson.techniques) ? legacyJson.techniques : {};\n  const programs = isRecord(legacyJson.programs) ? legacyJson.programs : {};\n  const shaders = isRecord(legacyJson.shaders) ? legacyJson.shaders : {};\n  const coveredPrograms = new Set<string>();\n  const coveredShaders = new Set<string>();\n  if (Object.keys(techniques).some(identifier => !fallbackTechniques.has(identifier))) return false;\n  for (const technique of Object.values(techniques))\n    if (isRecord(technique) && typeof technique.program === 'string')\n      coveredPrograms.add(technique.program);\n  if (Object.keys(programs).some(identifier => !coveredPrograms.has(identifier))) return false;\n  for (const program of Object.values(programs))\n    if (isRecord(program))\n      for (const field of ['vertexShader', 'fragmentShader'])\n        if (typeof program[field] === 'string') coveredShaders.add(program[field]);\n  return Object.keys(shaders).every(identifier => coveredShaders.has(identifier));\n}\n\n/** Preserve the existing conventional uniform heuristic for programmable materials. */\nfunction convertConventionalMaterial(\n  material: LegacyMaterial,\n  json: GLTF,\n  reportUnsupported: (feature: string) => void,\n  reportNote: (message: string) => void\n): void {\n  preserveMaterialSource(material);\n  const values = isRecord(material.values) ? material.values : {};\n  const textureIdentifier = values.tex || values.texture2d_0 || values.diffuseTex || values.diffuse;\n  const textureIndex = findTextureIndex(json, textureIdentifier);\n  const diffuseColor = isUnitColorFactor(values.diffuse) ? values.diffuse : undefined;\n  if (textureIndex !== -1 || diffuseColor) {\n    const factor = diffuseColor ? [...diffuseColor] : [1, 1, 1, 1];\n    const transparency = values.transparency;\n    if (typeof transparency === 'number' && transparency >= 0 && transparency <= 1)\n      factor[3] *= transparency;\n    material.pbrMetallicRoughness ||= {};\n    material.pbrMetallicRoughness.metallicFactor ??= 0;\n    material.pbrMetallicRoughness.roughnessFactor ??= 1;\n    material.pbrMetallicRoughness.baseColorFactor ??= factor;\n    if (textureIndex !== -1)\n      material.pbrMetallicRoughness.baseColorTexture ??= {index: textureIndex};\n    if (material.pbrMetallicRoughness.baseColorFactor[3] < 1) material.alphaMode ||= 'BLEND';\n    reportNote('Approximated glTF v1 diffuse material values with PBR material factors.');\n  }\n  if (material.technique || material.values)\n    reportUnsupported(`material technique ${material.technique || '<unnamed>'}`);\n}\n\n/** Resolve a common color/texture, using its specified black default rather than inventing a diffuse value. */\nfunction readMaterialValue(\n  value: unknown,\n  json: GLTF,\n  label: string,\n  reportUnsupported: (feature: string) => void\n): MaterialValue | null {\n  if (value === undefined) return {factor: [0, 0, 0, 1]};\n  if (isUnitColorFactor(value)) return {factor: [...value]};\n  const textureIndex = findTextureIndex(json, value);\n  if (textureIndex !== -1) return {factor: [1, 1, 1, 1], texture: {index: textureIndex}};\n  reportUnsupported(`${label} requires an RGBA factor in [0, 1] or a resolved texture ID`);\n  return null;\n}\n\n/** Resolve string texture IDs retained during dictionary-to-array conversion. */\nfunction findTextureIndex(json: GLTF, value: unknown): number {\n  if (typeof value !== 'string') return -1;\n  return (json.textures || []).findIndex(\n    texture => (texture as unknown as {id?: string}).id === value\n  );\n}\n\n/** Accept common flags in values or the exporter-style extension location, diagnosing conflicts. */\nfunction readCommonFlag(\n  common: Record<string, unknown>,\n  values: Record<string, unknown>,\n  field: string,\n  label: string,\n  reportUnsupported: (feature: string) => void\n): boolean {\n  if (common[field] !== undefined && values[field] !== undefined && common[field] !== values[field])\n    reportUnsupported(`${label} conflicting common material ${field}`);\n  const value =\n    values[field] !== undefined\n      ? values[field]\n      : common[field] !== undefined\n        ? common[field]\n        : false;\n  if (typeof value === 'boolean') return value;\n  reportUnsupported(`${label} common material ${field} must be boolean`);\n  return false;\n}\n\n/** Retain caller extras and previous provenance alongside all source material values. */\nfunction preserveMaterialSource(material: LegacyMaterial, common?: unknown): void {\n  const extras: Record<string, unknown> = isRecord(material.extras)\n    ? material.extras\n    : material.extras === undefined\n      ? {}\n      : {originalExtras: material.extras};\n  const previous = isRecord(extras.gltf1)\n    ? extras.gltf1\n    : extras.gltf1 === undefined\n      ? {}\n      : {originalExtras: extras.gltf1};\n  const source = {\n    technique: material.technique,\n    values: material.values,\n    ...(common === undefined ? {} : {commonMaterial: common})\n  };\n  const conflicting = Object.keys(source).some(field => Object.hasOwn(previous, field));\n  material.extras = {\n    ...extras,\n    gltf1: {...previous, ...source, ...(conflicting ? {originalExtras: previous} : {})}\n  };\n}\n\n/** Add accurate, duplicate-free declarations for generated material extensions. */\nfunction declareExtension(json: GLTF, extension: string, required: boolean): void {\n  json.extensionsUsed = [...new Set([...(json.extensionsUsed || []), extension])];\n  if (required)\n    json.extensionsRequired = [...new Set([...(json.extensionsRequired || []), extension])];\n}\n\n/** Inventory live extension owners, excluding application extras and copied legacy provenance. */\nfunction collectExtensionNames(value: unknown): Set<string> {\n  const names = new Set<string>();\n  const pending = [value];\n  const visited = new Set<object>();\n  while (pending.length) {\n    const object = pending.pop();\n    if (!object || typeof object !== 'object' || visited.has(object)) continue;\n    visited.add(object);\n    if (isRecord(object) && isRecord(object.extensions))\n      for (const name of Object.keys(object.extensions)) names.add(name);\n    for (const [field, child] of Object.entries(object))\n      if (field !== 'extras') pending.push(child);\n  }\n  return names;\n}\n\n/** Check finite RGBA factors accepted by core glTF 2 material properties. */\nfunction isUnitColorFactor(value: unknown): value is number[] {\n  return (\n    Array.isArray(value) &&\n    value.length === 4 &&\n    value.every(\n      component =>\n        typeof component === 'number' &&\n        Number.isFinite(component) &&\n        component >= 0 &&\n        component <= 1\n    )\n  );\n}\n\n/** Recognize a zero RGB lighting term independently of its unused alpha component. */\nfunction isBlackColor(value: unknown): boolean {\n  return isUnitColorFactor(value) && value.slice(0, 3).every(component => component === 0);\n}\n\n/** Distinguish JSON objects from scalar and array extras or malformed extension payloads. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/lib/api/convert-gltf-v1-materials.d.ts

@@ -0,0 +1,6 @@
+import type { GLTF } from "../types/gltf-types.js";
+/** Convert conventional and common materials, returning overridden fallback technique IDs. */
+export declare function convertGLTFV1Materials(json: GLTF, reportUnsupported: (feature: string) => void, reportNote: (message: string) => void): Set<string>;
+/** Recognize resources overridden by converted common materials, without claiming shader translation. */
+export declare function canPreserveGLTFV1MaterialFallbacks(json: GLTF, fallbackTechniques: Set<string>): boolean;
+//# sourceMappingURL=convert-gltf-v1-materials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert-gltf-v1-materials.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/convert-gltf-v1-materials.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,IAAI,EAAC,+BAA4B;AAsB9C,8FAA8F;AAC9F,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC5C,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACpC,GAAG,CAAC,MAAM,CAAC,CAgIb;AAED,yGAAyG;AACzG,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,OAAO,CAsCT"}

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

@@ -0,0 +1,266 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const COMMON_MATERIAL_EXTENSION = 'KHR_materials_common';
+const UNLIT_MATERIAL_EXTENSION = 'KHR_materials_unlit';
+/** Convert conventional and common materials, returning overridden fallback technique IDs. */
+export function convertGLTFV1Materials(json, reportUnsupported, reportNote) {
+    const fallbackTechniques = new Set();
+    const commonRequired = json.extensionsRequired?.includes(COMMON_MATERIAL_EXTENSION) || false;
+    for (const [materialIndex, material] of (json.materials || []).entries()) {
+        const legacyMaterial = material;
+        const common = material.extensions?.[COMMON_MATERIAL_EXTENSION];
+        if (common === undefined) {
+            convertConventionalMaterial(legacyMaterial, json, reportUnsupported, reportNote);
+            continue;
+        }
+        preserveMaterialSource(legacyMaterial, common);
+        const label = `material ${materialIndex}`;
+        if (!isRecord(common) ||
+            typeof common.technique !== 'string' ||
+            !['CONSTANT', 'LAMBERT', 'PHONG', 'BLINN'].includes(common.technique)) {
+            reportUnsupported(`${label} unknown ${COMMON_MATERIAL_EXTENSION} technique`);
+            continue;
+        }
+        if (common.values !== undefined && !isRecord(common.values)) {
+            reportUnsupported(`${label} common material values must be an object`);
+            continue;
+        }
+        const values = (common.values || {});
+        const unknownFields = Object.keys(common).filter(field => !['technique', 'values', 'doubleSided', 'transparent', 'jointCount'].includes(field));
+        const unknownValues = Object.keys(values).filter(field => ![
+            'ambient',
+            'diffuse',
+            'emission',
+            'specular',
+            'shininess',
+            'transparency',
+            'doubleSided',
+            'transparent'
+        ].includes(field));
+        if (unknownFields.length || unknownValues.length)
+            reportUnsupported(`${label} unrecognized common material fields ${[...unknownFields, ...unknownValues].join(', ')}`);
+        if (common.jointCount !== undefined &&
+            (!Number.isSafeInteger(common.jointCount) || Number(common.jointCount) < 0))
+            reportUnsupported(`${label} invalid common material jointCount`);
+        const emission = readMaterialValue(values.emission, json, `${label} emission`, reportUnsupported);
+        const constant = common.technique === 'CONSTANT';
+        const diffuse = constant
+            ? emission
+            : readMaterialValue(values.diffuse, json, `${label} diffuse`, reportUnsupported);
+        const opacity = values.transparency === undefined ? 1 : values.transparency;
+        const validOpacity = typeof opacity === 'number' && Number.isFinite(opacity) && opacity >= 0 && opacity <= 1;
+        if (!validOpacity)
+            reportUnsupported(`${label} common material transparency must be in [0, 1]`);
+        const transparent = readCommonFlag(common, values, 'transparent', label, reportUnsupported);
+        const doubleSided = readCommonFlag(common, values, 'doubleSided', label, reportUnsupported);
+        if (values.ambient !== undefined && !isBlackColor(values.ambient))
+            reportUnsupported(`${label} ambient lighting`);
+        if (['PHONG', 'BLINN'].includes(String(common.technique))) {
+            if (values.specular !== undefined && !isBlackColor(values.specular))
+                reportUnsupported(`${label} specular/shininess lighting`);
+            if (values.shininess !== undefined &&
+                (typeof values.shininess !== 'number' ||
+                    !Number.isFinite(values.shininess) ||
+                    values.shininess < 0))
+                reportUnsupported(`${label} invalid common material shininess`);
+        }
+        material.pbrMetallicRoughness ||= {};
+        const physicallyBasedMaterial = material.pbrMetallicRoughness;
+        physicallyBasedMaterial.metallicFactor ??= 0;
+        physicallyBasedMaterial.roughnessFactor ??= 1;
+        if (diffuse) {
+            const factor = [...diffuse.factor];
+            factor[3] *= validOpacity ? opacity : 1;
+            physicallyBasedMaterial.baseColorFactor ??= factor;
+            if (diffuse.texture)
+                physicallyBasedMaterial.baseColorTexture ??= diffuse.texture;
+        }
+        material.doubleSided ??= doubleSided;
+        material.alphaMode ??= transparent ? 'BLEND' : 'OPAQUE';
+        if (constant) {
+            material.extensions[UNLIT_MATERIAL_EXTENSION] ??= {};
+            declareExtension(json, UNLIT_MATERIAL_EXTENSION, commonRequired);
+            reportNote(`Converted ${label} CONSTANT emission to an unlit material.`);
+        }
+        else {
+            if (emission) {
+                material.emissiveFactor ??= emission.factor.slice(0, 3);
+                if (emission.texture)
+                    material.emissiveTexture ??= emission.texture;
+            }
+            reportNote(`Approximated ${label} ${String(common.technique)} lighting with rough non-metallic PBR factors.`);
+        }
+        if (typeof legacyMaterial.technique === 'string')
+            fallbackTechniques.add(legacyMaterial.technique);
+        else if (legacyMaterial.technique !== undefined)
+            reportUnsupported(`${label} invalid fallback technique ID`);
+        delete legacyMaterial.technique;
+        delete legacyMaterial.values;
+        delete material.extensions[COMMON_MATERIAL_EXTENSION];
+        if (!Object.keys(material.extensions).length)
+            delete material.extensions;
+    }
+    const remaining = collectExtensionNames(json);
+    if (json.extensions?.[COMMON_MATERIAL_EXTENSION] !== undefined ||
+        (json.nodes || []).some(node => node.extensions?.[COMMON_MATERIAL_EXTENSION] !== undefined))
+        reportUnsupported(`${COMMON_MATERIAL_EXTENSION} lights or scene payloads`);
+    if (!remaining.has(COMMON_MATERIAL_EXTENSION)) {
+        json.extensionsUsed = json.extensionsUsed?.filter(extension => extension !== COMMON_MATERIAL_EXTENSION);
+        json.extensionsRequired = json.extensionsRequired?.filter(extension => extension !== COMMON_MATERIAL_EXTENSION);
+    }
+    return fallbackTechniques;
+}
+/** Recognize resources overridden by converted common materials, without claiming shader translation. */
+export function canPreserveGLTFV1MaterialFallbacks(json, fallbackTechniques) {
+    if (!fallbackTechniques.size ||
+        [...collectExtensionNames(json)].some(extension => ![COMMON_MATERIAL_EXTENSION, UNLIT_MATERIAL_EXTENSION].includes(extension)))
+        return false;
+    if ((json.materials || []).some(material => material.technique !== undefined ||
+        material.values !== undefined))
+        return false;
+    const legacyJson = json;
+    if (['techniques', 'programs', 'shaders'].some(collection => legacyJson[collection] !== undefined && !isRecord(legacyJson[collection])))
+        return false;
+    const techniques = isRecord(legacyJson.techniques) ? legacyJson.techniques : {};
+    const programs = isRecord(legacyJson.programs) ? legacyJson.programs : {};
+    const shaders = isRecord(legacyJson.shaders) ? legacyJson.shaders : {};
+    const coveredPrograms = new Set();
+    const coveredShaders = new Set();
+    if (Object.keys(techniques).some(identifier => !fallbackTechniques.has(identifier)))
+        return false;
+    for (const technique of Object.values(techniques))
+        if (isRecord(technique) && typeof technique.program === 'string')
+            coveredPrograms.add(technique.program);
+    if (Object.keys(programs).some(identifier => !coveredPrograms.has(identifier)))
+        return false;
+    for (const program of Object.values(programs))
+        if (isRecord(program))
+            for (const field of ['vertexShader', 'fragmentShader'])
+                if (typeof program[field] === 'string')
+                    coveredShaders.add(program[field]);
+    return Object.keys(shaders).every(identifier => coveredShaders.has(identifier));
+}
+/** Preserve the existing conventional uniform heuristic for programmable materials. */
+function convertConventionalMaterial(material, json, reportUnsupported, reportNote) {
+    preserveMaterialSource(material);
+    const values = isRecord(material.values) ? material.values : {};
+    const textureIdentifier = values.tex || values.texture2d_0 || values.diffuseTex || values.diffuse;
+    const textureIndex = findTextureIndex(json, textureIdentifier);
+    const diffuseColor = isUnitColorFactor(values.diffuse) ? values.diffuse : undefined;
+    if (textureIndex !== -1 || diffuseColor) {
+        const factor = diffuseColor ? [...diffuseColor] : [1, 1, 1, 1];
+        const transparency = values.transparency;
+        if (typeof transparency === 'number' && transparency >= 0 && transparency <= 1)
+            factor[3] *= transparency;
+        material.pbrMetallicRoughness ||= {};
+        material.pbrMetallicRoughness.metallicFactor ??= 0;
+        material.pbrMetallicRoughness.roughnessFactor ??= 1;
+        material.pbrMetallicRoughness.baseColorFactor ??= factor;
+        if (textureIndex !== -1)
+            material.pbrMetallicRoughness.baseColorTexture ??= { index: textureIndex };
+        if (material.pbrMetallicRoughness.baseColorFactor[3] < 1)
+            material.alphaMode ||= 'BLEND';
+        reportNote('Approximated glTF v1 diffuse material values with PBR material factors.');
+    }
+    if (material.technique || material.values)
+        reportUnsupported(`material technique ${material.technique || '<unnamed>'}`);
+}
+/** Resolve a common color/texture, using its specified black default rather than inventing a diffuse value. */
+function readMaterialValue(value, json, label, reportUnsupported) {
+    if (value === undefined)
+        return { factor: [0, 0, 0, 1] };
+    if (isUnitColorFactor(value))
+        return { factor: [...value] };
+    const textureIndex = findTextureIndex(json, value);
+    if (textureIndex !== -1)
+        return { factor: [1, 1, 1, 1], texture: { index: textureIndex } };
+    reportUnsupported(`${label} requires an RGBA factor in [0, 1] or a resolved texture ID`);
+    return null;
+}
+/** Resolve string texture IDs retained during dictionary-to-array conversion. */
+function findTextureIndex(json, value) {
+    if (typeof value !== 'string')
+        return -1;
+    return (json.textures || []).findIndex(texture => texture.id === value);
+}
+/** Accept common flags in values or the exporter-style extension location, diagnosing conflicts. */
+function readCommonFlag(common, values, field, label, reportUnsupported) {
+    if (common[field] !== undefined && values[field] !== undefined && common[field] !== values[field])
+        reportUnsupported(`${label} conflicting common material ${field}`);
+    const value = values[field] !== undefined
+        ? values[field]
+        : common[field] !== undefined
+            ? common[field]
+            : false;
+    if (typeof value === 'boolean')
+        return value;
+    reportUnsupported(`${label} common material ${field} must be boolean`);
+    return false;
+}
+/** Retain caller extras and previous provenance alongside all source material values. */
+function preserveMaterialSource(material, common) {
+    const extras = isRecord(material.extras)
+        ? material.extras
+        : material.extras === undefined
+            ? {}
+            : { originalExtras: material.extras };
+    const previous = isRecord(extras.gltf1)
+        ? extras.gltf1
+        : extras.gltf1 === undefined
+            ? {}
+            : { originalExtras: extras.gltf1 };
+    const source = {
+        technique: material.technique,
+        values: material.values,
+        ...(common === undefined ? {} : { commonMaterial: common })
+    };
+    const conflicting = Object.keys(source).some(field => Object.hasOwn(previous, field));
+    material.extras = {
+        ...extras,
+        gltf1: { ...previous, ...source, ...(conflicting ? { originalExtras: previous } : {}) }
+    };
+}
+/** Add accurate, duplicate-free declarations for generated material extensions. */
+function declareExtension(json, extension, required) {
+    json.extensionsUsed = [...new Set([...(json.extensionsUsed || []), extension])];
+    if (required)
+        json.extensionsRequired = [...new Set([...(json.extensionsRequired || []), extension])];
+}
+/** Inventory live extension owners, excluding application extras and copied legacy provenance. */
+function collectExtensionNames(value) {
+    const names = new Set();
+    const pending = [value];
+    const visited = new Set();
+    while (pending.length) {
+        const object = pending.pop();
+        if (!object || typeof object !== 'object' || visited.has(object))
+            continue;
+        visited.add(object);
+        if (isRecord(object) && isRecord(object.extensions))
+            for (const name of Object.keys(object.extensions))
+                names.add(name);
+        for (const [field, child] of Object.entries(object))
+            if (field !== 'extras')
+                pending.push(child);
+    }
+    return names;
+}
+/** Check finite RGBA factors accepted by core glTF 2 material properties. */
+function isUnitColorFactor(value) {
+    return (Array.isArray(value) &&
+        value.length === 4 &&
+        value.every(component => typeof component === 'number' &&
+            Number.isFinite(component) &&
+            component >= 0 &&
+            component <= 1));
+}
+/** Recognize a zero RGB lighting term independently of its unused alpha component. */
+function isBlackColor(value) {
+    return isUnitColorFactor(value) && value.slice(0, 3).every(component => component === 0);
+}
+/** Distinguish JSON objects from scalar and array extras or malformed extension payloads. */
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=convert-gltf-v1-materials.js.map

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

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