@forgeax/engine-gltf 0.1.23 → 0.1.25

package/dist/index.d.ts

@@ -4,10 +4,10 @@ export { COMPONENT_TYPE, decodeAccessor } from './accessor/decode-accessor.js';
 export type { DecodeColorAccessorInput } from './accessor/decode-color.js';
 export { decodeColorAccessor } from './accessor/decode-color.js';
 export type { GltfBridgeContext, MaterialBridgeContext } from './bridge.js';
-export { gltfDocToSceneAsset, meshIrToMeshAsset, toMaterialAsset } from './bridge.js';
+export { gltfDocToSceneAsset, meshIrToMeshAsset, toMaterialAsset, validateMaterialTangentInputs, validateMaterialUvSets, } from './bridge.js';
 export type { ExtensionsCheckResult, GltfExtensionsJson } from './check-extensions.js';
 export { checkExtensions, EXTENSION_ALLOWLIST } from './check-extensions.js';
-export type { GltfAccessorTypeMismatchDetail, GltfAnimationCubicsplineUnsupportedDetail, GltfBufferOutOfBoundsDetail, GltfColorAccessorMalformedDetail, GltfColorAccessorUnsupportedDetail, GltfError, GltfErrorCode, GltfErrorDetail, GltfExtensionUnsupportedDetail, GltfImageExtractFailedDetail, GltfImageMimeUnsupportedDetail, GltfInstancingCountMismatchDetail, GltfMalformedHeaderDetail, GltfMaterialTransmissionInvalidDetail, GltfMetaMissingDetail, GltfMorphInvalidDetail, GltfMorphUnsupportedDetail, GltfSkinAttrAsymmetricDetail, GltfSkinJointCountExceededDetail, GltfSkinJointNameMissingDetail, GltfTextureLoadFailedDetail, GltfVersionUnsupportedDetail, Result, } from './errors.js';
+export type { GltfAccessorTypeMismatchDetail, GltfAnimationCubicsplineUnsupportedDetail, GltfBufferOutOfBoundsDetail, GltfColorAccessorMalformedDetail, GltfColorAccessorUnsupportedDetail, GltfError, GltfErrorCode, GltfErrorDetail, GltfExtensionUnsupportedDetail, GltfImageExtractFailedDetail, GltfImageMimeUnsupportedDetail, GltfInstancingCountMismatchDetail, GltfMalformedHeaderDetail, GltfMaterialPhysicalInvalidDetail, GltfMaterialTransmissionInvalidDetail, GltfMetaMissingDetail, GltfMorphInvalidDetail, GltfMorphUnsupportedDetail, GltfSkinAttrAsymmetricDetail, GltfSkinJointCountExceededDetail, GltfSkinJointNameMissingDetail, GltfTextureLoadFailedDetail, GltfVersionUnsupportedDetail, Result, } from './errors.js';
 export { err, GLTF_ERROR_HINTS, gltfErr, ok } from './errors.js';
 export { gltfImporter } from './gltf-importer.js';
 export { type GltfLodRelation, parseGltfLodExtension } from './lod/parse-lod.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { err, ok, reconcileMeshMaterialSlotTopology, MESH_MATERIAL_SLOT_SOURCE_OVERRIDE_PAYLOAD_SCHEMA, ImportError, IMPORT_ERROR_HINTS, toShared, resolveMeshMaterialSlotDefaultGuid, createMaterialError } from '@forgeax/engine-types';
+import { err, ok, createMaterialError, standardMaterialParameters, reconcileMeshMaterialSlotTopology, MESH_MATERIAL_SLOT_SOURCE_OVERRIDE_PAYLOAD_SCHEMA, STANDARD_MATERIAL_PARAM_SCHEMA, STANDARD_PHYSICAL_PARAMETER_NAMES, STANDARD_TRANSMISSION_PARAMETER_NAMES, ImportError, STANDARD_LAYER_PARAMETER_GROUPS, IMPORT_ERROR_HINTS, toShared, resolveMeshMaterialSlotDefaultGuid } from '@forgeax/engine-types';
 export { err, ok } from '@forgeax/engine-types';
-import { packInterleavedVertexAttributes } from '@forgeax/engine-geometry';
+import { computeTangentVec4, packInterleavedVertexAttributes } from '@forgeax/engine-geometry';
 import { box3, mat4, vec3, quat } from '@forgeax/engine-math';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
 import { deriveDefaultLodScreenCoverages, reconcileMeshLodMeta } from '@forgeax/engine-import';
@@ -24,8 +24,8 @@ var gltfErrorPolicy = {
     hint: "rebuild .gltf with valid bufferViews; check accessor index; ensure accessor.byteOffset + EFFECTIVE_STRIDE * (count - 1) + element_size <= bufferView.byteLength"
   },
   "gltf-extension-unsupported": {
-    expected: "extension listed in v1 allowlist (see EXTENSION_ALLOWLIST in @forgeax/engine-gltf)",
-    hint: "see feat-future-gltf-extensions-allowlist; remove this extension or wait for the allowlist to expand"
+    expected: "extension listed in the supported allowlist (see EXTENSION_ALLOWLIST in @forgeax/engine-gltf)",
+    hint: "remove the unsupported required extension or use a supported glTF extension; extensionsUsed-only entries remain diagnostic"
   },
   "gltf-lod-invalid": {
     expected: "MSFT_lod ids to reference unique existing node indices with valid coverage",
@@ -35,6 +35,10 @@ var gltfErrorPolicy = {
     expected: "KHR transmission, IOR, and volume values are finite and within their glTF ranges",
     hint: "repair the named glTF material extension value and re-import the source"
   },
+  "gltf-material-physical-invalid": {
+    expected: "KHR clearcoat, anisotropy, sheen, iridescence, and specular values are finite and within their glTF ranges",
+    hint: "repair the named physical material extension value and re-import the source"
+  },
   "gltf-accessor-type-mismatch": {
     expected: "dense fixed-stride accessor with supported componentType",
     hint: "sparse: see feat-future-gltf-sparse-accessor; morph: see feat-future-gltf-morph; interleaved: see feat-future-gltf-mesh-multi-section"
@@ -491,6 +495,16 @@ function meshIrToMeshAsset(prims, materials = {}) {
     const materialSlot = slotFor(mesh.materialIndex);
     const primVertexCount = mesh.positions.length / 3;
     const primIndexCount = mesh.indices === void 0 ? 0 : mesh.indices.length;
+    let generatedTangents;
+    if (mesh.tangents === void 0 && mesh.normals !== void 0 && mesh.texcoord0 !== void 0) {
+      const generated = computeTangentVec4(
+        mesh.positions,
+        mesh.normals,
+        mesh.texcoord0,
+        mesh.indices
+      );
+      if (generated.ok) generatedTangents = generated.value;
+    }
     if (mesh.colors0 !== void 0 && mesh.colors0.length !== primVertexCount * 4) {
       return err(
         gltfErr("gltf-mesh-bridge-invalid", {
@@ -522,12 +536,13 @@ function meshIrToMeshAsset(prims, materials = {}) {
         uvsCat[(vertexCursor + i) * 2 + 0] = mesh.texcoord0[t + 0];
         uvsCat[(vertexCursor + i) * 2 + 1] = mesh.texcoord0[t + 1];
       }
-      if (mesh.tangents !== void 0) {
+      const sourceTangents = mesh.tangents ?? generatedTangents;
+      if (sourceTangents !== void 0) {
         const g = i * 4;
-        tangentsCat[(vertexCursor + i) * 4 + 0] = mesh.tangents[g + 0];
-        tangentsCat[(vertexCursor + i) * 4 + 1] = mesh.tangents[g + 1];
-        tangentsCat[(vertexCursor + i) * 4 + 2] = mesh.tangents[g + 2];
-        tangentsCat[(vertexCursor + i) * 4 + 3] = mesh.tangents[g + 3];
+        tangentsCat[(vertexCursor + i) * 4 + 0] = sourceTangents[g + 0];
+        tangentsCat[(vertexCursor + i) * 4 + 1] = sourceTangents[g + 1];
+        tangentsCat[(vertexCursor + i) * 4 + 2] = sourceTangents[g + 2];
+        tangentsCat[(vertexCursor + i) * 4 + 3] = sourceTangents[g + 3];
       } else {
         tangentsCat[(vertexCursor + i) * 4 + 0] = 1;
         tangentsCat[(vertexCursor + i) * 4 + 3] = 1;
@@ -862,6 +877,12 @@ function textureValue(info, slot, ctx) {
       return { ...value, normalScale: normal.scale };
     }
   }
+  if (slot === "clearcoatNormalTexture") {
+    const normal = info;
+    if (typeof normal === "object" && normal?.scale !== void 0) {
+      return { ...value, normalScale: normal.scale };
+    }
+  }
   if (slot === "occlusionTexture") {
     const occlusion = info;
     if (typeof occlusion === "object" && occlusion?.strength !== void 0) {
@@ -870,6 +891,47 @@ function textureValue(info, slot, ctx) {
   }
   return value;
 }
+function standardRootParameterNames(mat) {
+  const names = new Set(
+    STANDARD_MATERIAL_PARAM_SCHEMA.filter(
+      (entry) => !STANDARD_PHYSICAL_PARAMETER_NAMES.has(entry.name) && !STANDARD_TRANSMISSION_PARAMETER_NAMES.has(entry.name)
+    ).map((entry) => entry.name)
+  );
+  names.add("ior");
+  const addLayer = (layer) => {
+    for (const name of STANDARD_LAYER_PARAMETER_GROUPS[layer]) names.add(name);
+  };
+  const addTexture = (name, info) => {
+    if (info !== void 0) names.add(name);
+  };
+  const clearcoat = mat.clearcoatFactor !== void 0 || mat.clearcoatRoughnessFactor !== void 0 || mat.clearcoatNormalTexture !== void 0 || mat.clearcoatTexture !== void 0 || mat.clearcoatRoughnessTexture !== void 0;
+  const anisotropy = mat.anisotropyStrength !== void 0 || mat.anisotropyRotation !== void 0 || mat.anisotropyTexture !== void 0;
+  const sheen = mat.sheenColorFactor !== void 0 || mat.sheenRoughnessFactor !== void 0 || mat.sheenColorTexture !== void 0 || mat.sheenRoughnessTexture !== void 0;
+  const iridescence = mat.iridescenceFactor !== void 0 || mat.iridescenceIor !== void 0 || mat.iridescenceThicknessMinimum !== void 0 || mat.iridescenceThicknessMaximum !== void 0 || mat.iridescenceTexture !== void 0 || mat.iridescenceThicknessTexture !== void 0;
+  if (clearcoat) addLayer("clearcoat");
+  if (anisotropy) addLayer("anisotropy");
+  if (sheen) addLayer("sheen");
+  if (iridescence) addLayer("iridescence");
+  if (clearcoat && mat.clearcoatNormalTexture !== void 0) names.add("clearcoatNormalScale");
+  addTexture("clearcoatTexture", mat.clearcoatTexture);
+  addTexture("clearcoatRoughnessTexture", mat.clearcoatRoughnessTexture);
+  addTexture("clearcoatNormalTexture", mat.clearcoatNormalTexture);
+  addTexture("anisotropyTexture", mat.anisotropyTexture);
+  addTexture("sheenColorTexture", mat.sheenColorTexture);
+  addTexture("sheenRoughnessTexture", mat.sheenRoughnessTexture);
+  addTexture("iridescenceTexture", mat.iridescenceTexture);
+  addTexture("iridescenceThicknessTexture", mat.iridescenceThicknessTexture);
+  addTexture("specularTexture", mat.specularTexture);
+  addTexture("specularColorTexture", mat.specularColorTexture);
+  const transmission = mat.transmissionFactor !== void 0 || mat.transmissionTexture !== void 0 || mat.ior !== void 0 || mat.thicknessFactor !== void 0 || mat.thicknessTexture !== void 0 || mat.attenuationColor !== void 0 || mat.attenuationDistance !== void 0;
+  if (transmission) {
+    for (const name of STANDARD_TRANSMISSION_PARAMETER_NAMES) names.add(name);
+  }
+  return {
+    names,
+    extended: clearcoat || anisotropy || sheen || iridescence || transmission || mat.specularTexture !== void 0 || mat.specularColorTexture !== void 0
+  };
+}
 function validateMaterialUvSets(mat, primitive, availableSets) {
   const available = new Set(availableSets);
   const slots = [
@@ -879,7 +941,17 @@ function validateMaterialUvSets(mat, primitive, availableSets) {
     ["occlusionTexture", mat.occlusionTexture],
     ["emissiveTexture", mat.emissiveTexture],
     ["transmissionTexture", mat.transmissionTexture],
-    ["thicknessTexture", mat.thicknessTexture]
+    ["thicknessTexture", mat.thicknessTexture],
+    ["clearcoatTexture", mat.clearcoatTexture],
+    ["clearcoatRoughnessTexture", mat.clearcoatRoughnessTexture],
+    ["clearcoatNormalTexture", mat.clearcoatNormalTexture],
+    ["anisotropyTexture", mat.anisotropyTexture],
+    ["sheenColorTexture", mat.sheenColorTexture],
+    ["sheenRoughnessTexture", mat.sheenRoughnessTexture],
+    ["iridescenceTexture", mat.iridescenceTexture],
+    ["iridescenceThicknessTexture", mat.iridescenceThicknessTexture],
+    ["specularTexture", mat.specularTexture],
+    ["specularColorTexture", mat.specularColorTexture]
   ];
   for (const [slot, rawBinding] of slots) {
     const binding = textureInfo(rawBinding);
@@ -899,7 +971,44 @@ function validateMaterialUvSets(mat, primitive, availableSets) {
   }
   return ok(void 0);
 }
+function validateMaterialTangentInputs(mat, mesh, layer = "clearcoat") {
+  const anisotropyDeclared = mat.anisotropyStrength !== void 0 || mat.anisotropyRotation !== void 0 || mat.anisotropyTexture !== void 0;
+  const tangentSlot = anisotropyDeclared ? { layer: "anisotropy", info: mat.anisotropyTexture } : mat.clearcoatNormalTexture !== void 0 ? { layer: "clearcoat", info: mat.clearcoatNormalTexture } : void 0;
+  if (tangentSlot === void 0) return ok(void 0);
+  const selected = textureInfo(tangentSlot.info);
+  const uvSet = selected?.texCoord ?? 0;
+  const uv = mesh[`texcoord${uvSet === 0 ? "0" : uvSet}`];
+  const attributes = ["NORMAL", `TEXCOORD_${uvSet}`, "TANGENT"];
+  const fail = (reason) => err(
+    createMaterialError("material-tangent-required", {
+      code: "material-tangent-required",
+      material: mat.name ?? "<unnamed>",
+      mesh: mesh.name ?? "<unnamed>",
+      layer: tangentSlot.layer ?? layer,
+      uv: `TEXCOORD_${uvSet}`,
+      attributes,
+      reason
+    })
+  );
+  if (mesh.tangents !== void 0) {
+    if (mesh.tangents.length !== mesh.positions.length / 3 * 4 || mesh.tangents.some((value) => !Number.isFinite(value))) {
+      return fail("imported TANGENT must be finite vec4 per vertex");
+    }
+    return ok(void 0);
+  }
+  if (mesh.normals === void 0) return fail("NORMAL is required to generate tangent");
+  if (!(uv instanceof Float32Array))
+    return fail("the selected UV set is required to generate tangent");
+  const generated = computeTangentVec4(mesh.positions, mesh.normals, uv, mesh.indices);
+  if (!generated.ok) {
+    const detail = generated.error.detail;
+    const reason = detail !== void 0 && "reason" in detail ? String(detail.reason) : "tangent producer rejected topology";
+    return fail(reason);
+  }
+  return ok(void 0);
+}
 function toMaterialAsset(mat, ctx) {
+  const rootContract = standardRootParameterNames(mat);
   const values = {
     baseColor: mat.baseColorFactor,
     metallic: mat.metallicFactor,
@@ -916,7 +1025,17 @@ function toMaterialAsset(mat, ctx) {
     ["occlusionTexture", mat.occlusionTexture],
     ["emissiveTexture", mat.emissiveTexture],
     ["transmissionTexture", mat.transmissionTexture],
-    ["thicknessTexture", mat.thicknessTexture]
+    ["thicknessTexture", mat.thicknessTexture],
+    ["clearcoatTexture", mat.clearcoatTexture],
+    ["clearcoatRoughnessTexture", mat.clearcoatRoughnessTexture],
+    ["clearcoatNormalTexture", mat.clearcoatNormalTexture],
+    ["anisotropyTexture", mat.anisotropyTexture],
+    ["sheenColorTexture", mat.sheenColorTexture],
+    ["sheenRoughnessTexture", mat.sheenRoughnessTexture],
+    ["iridescenceTexture", mat.iridescenceTexture],
+    ["iridescenceThicknessTexture", mat.iridescenceThicknessTexture],
+    ["specularTexture", mat.specularTexture],
+    ["specularColorTexture", mat.specularColorTexture]
   ];
   for (const [slot, info] of textureSlots) {
     const value = textureValue(info, slot, ctx);
@@ -925,11 +1044,35 @@ function toMaterialAsset(mat, ctx) {
   if (mat.occlusionTexture !== void 0 && values.occlusionStrength === void 0) {
     values.occlusionStrength = 1;
   }
-  if (mat.transmissionFactor !== void 0) values.transmission = mat.transmissionFactor;
-  if (mat.ior !== void 0) values.ior = mat.ior;
-  if (mat.thicknessFactor !== void 0) values.thickness = mat.thicknessFactor;
-  if (mat.attenuationColor !== void 0) values.attenuationColor = mat.attenuationColor;
-  if (mat.attenuationDistance !== void 0) values.attenuationDistance = mat.attenuationDistance;
+  if (rootContract.extended && rootContract.names.has("transmission")) {
+    values.transmission = mat.transmissionFactor ?? 0;
+    values.ior = mat.ior ?? 1.5;
+    values.thickness = mat.thicknessFactor ?? 0;
+    values.attenuationColor = mat.attenuationColor ?? [1, 1, 1];
+    if (mat.attenuationDistance !== void 0) values.attenuationDistance = mat.attenuationDistance;
+  }
+  if (rootContract.names.has("clearcoat")) {
+    values.clearcoat = mat.clearcoatFactor ?? 0;
+    values.clearcoatRoughness = mat.clearcoatRoughnessFactor ?? 0;
+  }
+  const clearcoatNormal = textureInfo(mat.clearcoatNormalTexture);
+  if (clearcoatNormal?.scale !== void 0) values.clearcoatNormalScale = clearcoatNormal.scale;
+  if (rootContract.names.has("anisotropyStrength")) {
+    values.anisotropyStrength = mat.anisotropyStrength ?? 0;
+    values.anisotropyRotation = mat.anisotropyRotation ?? 0;
+  }
+  if (rootContract.names.has("sheenColor")) {
+    values.sheenColor = mat.sheenColorFactor ?? [0, 0, 0];
+    values.sheenRoughness = mat.sheenRoughnessFactor ?? 0;
+  }
+  if (rootContract.names.has("iridescence")) {
+    values.iridescence = mat.iridescenceFactor ?? 0;
+    values.iridescenceIor = mat.iridescenceIor ?? 1.3;
+    values.iridescenceThicknessMinimum = mat.iridescenceThicknessMinimum ?? 100;
+    values.iridescenceThicknessMaximum = mat.iridescenceThicknessMaximum ?? 400;
+  }
+  if (mat.specularFactor !== void 0) values.specular = mat.specularFactor;
+  if (mat.specularColorFactor !== void 0) values.specularColor = mat.specularColorFactor;
   const module = ctx?.skinned === true ? "forgeax::pbr-skin" : "forgeax::default-standard-pbr";
   const isMask = mat.alphaMode === "MASK";
   const alphaCutoff = isMask ? mat.alphaCutoff ?? 0.5 : void 0;
@@ -959,11 +1102,14 @@ function toMaterialAsset(mat, ctx) {
       } : {}
     }
   };
+  const child = !rootContract.extended && ctx?.standardRootGuid !== void 0;
   return {
     kind: "material",
-    colorSpace: "linear",
-    ...ctx?.standardRootGuid === void 0 ? {} : { parent: ctx.standardRootGuid },
-    passes: [pass],
+    ...child ? { parent: ctx.standardRootGuid } : {
+      colorSpace: "linear",
+      passes: [pass],
+      parameters: standardMaterialParameters(rootContract.names)
+    },
     values
   };
 }
@@ -972,16 +1118,21 @@ function toMaterialAsset(mat, ctx) {
 var EXTENSION_ALLOWLIST = [
   "EXT_mesh_gpu_instancing",
   "EXT_meshopt_compression",
-  "MSFT_lod",
-  "MSFT_screencoverage"
-];
-var SUPPORTED_EXTENSIONS = [
-  ...EXTENSION_ALLOWLIST,
   "KHR_lights_punctual",
   "KHR_texture_transform",
   "KHR_materials_transmission",
   "KHR_materials_ior",
-  "KHR_materials_volume"
+  "KHR_materials_volume",
+  "KHR_materials_clearcoat",
+  "KHR_materials_anisotropy",
+  "KHR_materials_sheen",
+  "KHR_materials_iridescence",
+  "KHR_materials_specular"
+];
+var SUPPORTED_EXTENSIONS = [
+  ...EXTENSION_ALLOWLIST,
+  "MSFT_lod",
+  "MSFT_screencoverage"
 ];
 function checkExtensions(json) {
   const required = json.extensionsRequired ?? [];
@@ -1419,9 +1570,21 @@ function deriveTextureColorSpace(input) {
   for (const mat of input.materials) {
     record(imageOfTexture(mat.baseColorTexture), "srgb");
     record(imageOfTexture(mat.emissiveTexture), "srgb");
+    record(imageOfTexture(mat.sheenColorTexture), "srgb");
+    record(imageOfTexture(mat.specularColorTexture), "srgb");
     record(imageOfTexture(mat.metallicRoughnessTexture), "linear");
     record(imageOfTexture(mat.normalTexture), "linear");
     record(imageOfTexture(mat.occlusionTexture), "linear");
+    record(imageOfTexture(mat.transmissionTexture), "linear");
+    record(imageOfTexture(mat.thicknessTexture), "linear");
+    record(imageOfTexture(mat.clearcoatTexture), "linear");
+    record(imageOfTexture(mat.clearcoatRoughnessTexture), "linear");
+    record(imageOfTexture(mat.clearcoatNormalTexture), "linear");
+    record(imageOfTexture(mat.anisotropyTexture), "linear");
+    record(imageOfTexture(mat.sheenRoughnessTexture), "linear");
+    record(imageOfTexture(mat.iridescenceTexture), "linear");
+    record(imageOfTexture(mat.iridescenceThicknessTexture), "linear");
+    record(imageOfTexture(mat.specularTexture), "linear");
   }
   for (let i = 0; i < input.imageCount; i++) {
     if (!result.has(i)) {
@@ -1572,6 +1735,11 @@ function parseMaterial(matJson, textures) {
   const transmission = matJson.extensions?.KHR_materials_transmission;
   const ior = matJson.extensions?.KHR_materials_ior;
   const volume = matJson.extensions?.KHR_materials_volume;
+  const clearcoat = matJson.extensions?.KHR_materials_clearcoat;
+  const anisotropy = matJson.extensions?.KHR_materials_anisotropy;
+  const sheen = matJson.extensions?.KHR_materials_sheen;
+  const iridescence = matJson.extensions?.KHR_materials_iridescence;
+  const specular = matJson.extensions?.KHR_materials_specular;
   const attenuationColor = tuple3(volume?.attenuationColor);
   const invalid = (extension, field, reason, actual) => err(
     gltfErr("gltf-material-transmission-invalid", {
@@ -1581,6 +1749,14 @@ function parseMaterial(matJson, textures) {
       ...actual === void 0 ? {} : { actual }
     })
   );
+  const physicalInvalid = (extension, field, reason, actual) => err(
+    gltfErr("gltf-material-physical-invalid", {
+      extension,
+      field,
+      reason,
+      ...actual === void 0 ? {} : { actual }
+    })
+  );
   if (transmission?.transmissionFactor !== void 0 && (typeof transmission.transmissionFactor !== "number" || !Number.isFinite(transmission.transmissionFactor))) {
     return invalid(
       "KHR_materials_transmission",
@@ -1631,6 +1807,98 @@ function parseMaterial(matJson, textures) {
   if (alphaMode === "BLEND" && (transmission?.transmissionFactor ?? 0) > 0) {
     return invalid("KHR_materials_transmission", "alphaMode", "blend", alphaMode);
   }
+  if (clearcoat?.clearcoatFactor !== void 0 && (typeof clearcoat.clearcoatFactor !== "number" || !Number.isFinite(clearcoat.clearcoatFactor))) {
+    return physicalInvalid(
+      "KHR_materials_clearcoat",
+      "clearcoatFactor",
+      "non-finite",
+      clearcoat.clearcoatFactor
+    );
+  }
+  if (clearcoat?.clearcoatFactor !== void 0 && (clearcoat.clearcoatFactor < 0 || clearcoat.clearcoatFactor > 1)) {
+    return physicalInvalid(
+      "KHR_materials_clearcoat",
+      "clearcoatFactor",
+      "range",
+      clearcoat.clearcoatFactor
+    );
+  }
+  if (clearcoat?.clearcoatRoughnessFactor !== void 0 && (typeof clearcoat.clearcoatRoughnessFactor !== "number" || !Number.isFinite(clearcoat.clearcoatRoughnessFactor))) {
+    return physicalInvalid(
+      "KHR_materials_clearcoat",
+      "clearcoatRoughnessFactor",
+      "non-finite",
+      clearcoat.clearcoatRoughnessFactor
+    );
+  }
+  if (clearcoat?.clearcoatRoughnessFactor !== void 0 && (clearcoat.clearcoatRoughnessFactor < 0 || clearcoat.clearcoatRoughnessFactor > 1)) {
+    return physicalInvalid(
+      "KHR_materials_clearcoat",
+      "clearcoatRoughnessFactor",
+      "range",
+      clearcoat.clearcoatRoughnessFactor
+    );
+  }
+  if (clearcoat?.clearcoatNormalTexture?.scale !== void 0 && (typeof clearcoat.clearcoatNormalTexture.scale !== "number" || !Number.isFinite(clearcoat.clearcoatNormalTexture.scale) || clearcoat.clearcoatNormalTexture.scale < 0)) {
+    return physicalInvalid(
+      "KHR_materials_clearcoat",
+      "clearcoatNormalTexture.scale",
+      "range",
+      clearcoat.clearcoatNormalTexture.scale
+    );
+  }
+  const validateUnit = (extension, field, value) => {
+    if (value === void 0) return void 0;
+    if (typeof value !== "number" || !Number.isFinite(value))
+      return physicalInvalid(extension, field, "non-finite", value);
+    if (value < 0 || value > 1) return physicalInvalid(extension, field, "range", value);
+    return void 0;
+  };
+  const validateFinite = (extension, field, value, minimum) => {
+    if (value === void 0) return void 0;
+    if (typeof value !== "number" || !Number.isFinite(value))
+      return physicalInvalid(extension, field, "non-finite", value);
+    if (minimum !== void 0 && value < minimum)
+      return physicalInvalid(extension, field, "range", value);
+    return void 0;
+  };
+  const validateColor = (extension, field, value) => {
+    if (value === void 0) return void 0;
+    if (value.length < 3 || value.slice(0, 3).some((channel) => typeof channel !== "number" || !Number.isFinite(channel))) {
+      return physicalInvalid(extension, field, "type", value);
+    }
+    if (value.slice(0, 3).some((channel) => channel < 0 || channel > 1)) {
+      return physicalInvalid(extension, field, "range", value);
+    }
+    return void 0;
+  };
+  const physicalChecks = [
+    validateUnit("KHR_materials_anisotropy", "anisotropyStrength", anisotropy?.anisotropyStrength),
+    validateFinite(
+      "KHR_materials_anisotropy",
+      "anisotropyRotation",
+      anisotropy?.anisotropyRotation
+    ),
+    validateUnit("KHR_materials_sheen", "sheenRoughnessFactor", sheen?.sheenRoughnessFactor),
+    validateColor("KHR_materials_sheen", "sheenColorFactor", sheen?.sheenColorFactor),
+    validateUnit("KHR_materials_iridescence", "iridescenceFactor", iridescence?.iridescenceFactor),
+    validateFinite("KHR_materials_iridescence", "iridescenceIor", iridescence?.iridescenceIor, 1),
+    validateFinite(
+      "KHR_materials_iridescence",
+      "iridescenceThicknessMinimum",
+      iridescence?.iridescenceThicknessMinimum,
+      0
+    ),
+    validateFinite(
+      "KHR_materials_iridescence",
+      "iridescenceThicknessMaximum",
+      iridescence?.iridescenceThicknessMaximum,
+      0
+    ),
+    validateUnit("KHR_materials_specular", "specularFactor", specular?.specularFactor),
+    validateColor("KHR_materials_specular", "specularColorFactor", specular?.specularColorFactor)
+  ];
+  for (const check of physicalChecks) if (check !== void 0) return check;
   return ok({
     ...matJson.name === void 0 ? {} : { name: matJson.name },
     baseColorFactor: baseColor4,
@@ -1667,6 +1935,65 @@ function parseMaterial(matJson, textures) {
       ...attenuationColor === void 0 ? {} : { attenuationColor },
       ...finiteOrUndefined(volume.attenuationDistance) === void 0 ? {} : { attenuationDistance: volume.attenuationDistance }
     },
+    ...clearcoat === void 0 ? {} : {
+      clearcoatFactor: clearcoat.clearcoatFactor ?? 0,
+      clearcoatChannel: 0,
+      clearcoatRoughnessFactor: clearcoat.clearcoatRoughnessFactor ?? 0,
+      clearcoatRoughnessChannel: 1,
+      clearcoatNormalChannel: [0, 1],
+      ...clearcoat.clearcoatTexture === void 0 ? {} : { clearcoatTexture: parseTextureInfo(clearcoat.clearcoatTexture, textures) },
+      ...clearcoat.clearcoatRoughnessTexture === void 0 ? {} : {
+        clearcoatRoughnessTexture: parseTextureInfo(
+          clearcoat.clearcoatRoughnessTexture,
+          textures
+        )
+      },
+      ...clearcoat.clearcoatNormalTexture === void 0 ? {} : {
+        clearcoatNormalTexture: {
+          ...parseTextureInfo(clearcoat.clearcoatNormalTexture, textures),
+          ...clearcoat.clearcoatNormalTexture.scale === void 0 ? {} : { scale: clearcoat.clearcoatNormalTexture.scale }
+        }
+      }
+    },
+    ...anisotropy === void 0 ? {} : {
+      anisotropyStrength: anisotropy.anisotropyStrength ?? 0,
+      anisotropyRotation: anisotropy.anisotropyRotation ?? 0,
+      anisotropyChannel: [0, 1, 2],
+      ...anisotropy.anisotropyTexture === void 0 ? {} : { anisotropyTexture: parseTextureInfo(anisotropy.anisotropyTexture, textures) }
+    },
+    ...sheen === void 0 ? {} : {
+      sheenColorFactor: tuple3(sheen.sheenColorFactor) ?? [0, 0, 0],
+      sheenColorChannel: [0, 1, 2],
+      sheenRoughnessFactor: sheen.sheenRoughnessFactor ?? 0,
+      sheenRoughnessChannel: 3,
+      ...sheen.sheenColorTexture === void 0 ? {} : { sheenColorTexture: parseTextureInfo(sheen.sheenColorTexture, textures) },
+      ...sheen.sheenRoughnessTexture === void 0 ? {} : { sheenRoughnessTexture: parseTextureInfo(sheen.sheenRoughnessTexture, textures) }
+    },
+    ...iridescence === void 0 ? {} : {
+      iridescenceFactor: iridescence.iridescenceFactor ?? 0,
+      iridescenceIor: iridescence.iridescenceIor ?? 1.3,
+      iridescenceThicknessMinimum: iridescence.iridescenceThicknessMinimum ?? 100,
+      iridescenceThicknessMaximum: iridescence.iridescenceThicknessMaximum ?? 400,
+      iridescenceChannel: 0,
+      iridescenceThicknessChannel: 1,
+      ...iridescence.iridescenceTexture === void 0 ? {} : { iridescenceTexture: parseTextureInfo(iridescence.iridescenceTexture, textures) },
+      ...iridescence.iridescenceThicknessTexture === void 0 ? {} : {
+        iridescenceThicknessTexture: parseTextureInfo(
+          iridescence.iridescenceThicknessTexture,
+          textures
+        )
+      }
+    },
+    ...specular === void 0 ? {} : {
+      specularFactor: specular.specularFactor ?? 1,
+      specularChannel: 3,
+      specularColorFactor: tuple3(specular.specularColorFactor) ?? [1, 1, 1],
+      specularColorChannel: [0, 1, 2],
+      ...specular.specularTexture === void 0 ? {} : { specularTexture: parseTextureInfo(specular.specularTexture, textures) },
+      ...specular.specularColorTexture === void 0 ? {} : {
+        specularColorTexture: parseTextureInfo(specular.specularColorTexture, textures)
+      }
+    },
     ...alphaMode === void 0 ? {} : { alphaMode },
     ...alphaCutoff === void 0 ? {} : { alphaCutoff },
     ...matJson.doubleSided === true ? { doubleSided: true } : {},
@@ -3516,6 +3843,16 @@ function materialRefsForPack(mat, doc, textureGuidByIndex, samplerGuidByIndex =
   pushRefsForSlot(mat.emissiveTexture, "emissiveTexture");
   pushRefsForSlot(mat.transmissionTexture, "transmissionTexture");
   pushRefsForSlot(mat.thicknessTexture, "thicknessTexture");
+  pushRefsForSlot(mat.clearcoatTexture, "clearcoatTexture");
+  pushRefsForSlot(mat.clearcoatRoughnessTexture, "clearcoatRoughnessTexture");
+  pushRefsForSlot(mat.clearcoatNormalTexture, "clearcoatNormalTexture");
+  pushRefsForSlot(mat.anisotropyTexture, "anisotropyTexture");
+  pushRefsForSlot(mat.sheenColorTexture, "sheenColorTexture");
+  pushRefsForSlot(mat.sheenRoughnessTexture, "sheenRoughnessTexture");
+  pushRefsForSlot(mat.iridescenceTexture, "iridescenceTexture");
+  pushRefsForSlot(mat.iridescenceThicknessTexture, "iridescenceThicknessTexture");
+  pushRefsForSlot(mat.specularTexture, "specularTexture");
+  pushRefsForSlot(mat.specularColorTexture, "specularColorTexture");
   return refs;
 }
 function availableUvSets(mesh) {
@@ -3536,7 +3873,17 @@ function rewriteMaterialAssetRefs(matAsset, mat, doc, maps) {
     ["occlusionTexture", mat.occlusionTexture],
     ["emissiveTexture", mat.emissiveTexture],
     ["transmissionTexture", mat.transmissionTexture],
-    ["thicknessTexture", mat.thicknessTexture]
+    ["thicknessTexture", mat.thicknessTexture],
+    ["clearcoatTexture", mat.clearcoatTexture],
+    ["clearcoatRoughnessTexture", mat.clearcoatRoughnessTexture],
+    ["clearcoatNormalTexture", mat.clearcoatNormalTexture],
+    ["anisotropyTexture", mat.anisotropyTexture],
+    ["sheenColorTexture", mat.sheenColorTexture],
+    ["sheenRoughnessTexture", mat.sheenRoughnessTexture],
+    ["iridescenceTexture", mat.iridescenceTexture],
+    ["iridescenceThicknessTexture", mat.iridescenceThicknessTexture],
+    ["specularTexture", mat.specularTexture],
+    ["specularColorTexture", mat.specularColorTexture]
   ];
   let cursor = 0;
   for (const [slot, rawBinding] of slots) {
@@ -3753,6 +4100,10 @@ async function importGltf(ctx, meshopt) {
         if (!uvResult.ok) {
           throw Object.assign(new Error(uvResult.error.message), uvResult.error);
         }
+        const tangentResult = validateMaterialTangentInputs(mat, meshIr);
+        if (!tangentResult.ok) {
+          throw Object.assign(new Error(tangentResult.error.message), tangentResult.error);
+        }
       }
       const matAsset = toMaterialAsset(mat, {
         textureHandles: maps.textureHandles,
@@ -4005,6 +4356,6 @@ function serializeMetaJson(meta) {
 `;
 }
 
-export { COMPONENT_TYPE, EXTENSION_ALLOWLIST, GLTF_ERROR_HINTS, checkExtensions, decodeAccessor, decodeColorAccessor, decomposeNodeTransform, deriveGltfSourceKeys, gltfDocToSceneAsset, gltfErr, gltfImporter, meshIrToMeshAsset, parseGlb, parseGlbChunks, parseGltf, parseGltfHeader, parseGltfLodExtension, projectGltfLodMeta, reimportReuseMeta, serializeMetaJson, sourceKeyForGltfOutput, subAssetKey, toAssetPack, toMaterialAsset };
+export { COMPONENT_TYPE, EXTENSION_ALLOWLIST, GLTF_ERROR_HINTS, checkExtensions, decodeAccessor, decodeColorAccessor, decomposeNodeTransform, deriveGltfSourceKeys, gltfDocToSceneAsset, gltfErr, gltfImporter, meshIrToMeshAsset, parseGlb, parseGlbChunks, parseGltf, parseGltfHeader, parseGltfLodExtension, projectGltfLodMeta, reimportReuseMeta, serializeMetaJson, sourceKeyForGltfOutput, subAssetKey, toAssetPack, toMaterialAsset, validateMaterialTangentInputs, validateMaterialUvSets };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map