@forgeax/engine-gltf 0.1.23 → 0.1.25

package/README.md

@@ -21,6 +21,36 @@ the render phase. The carrier validates the source, Pack, GUID load, and rendere
 
 If a source requests a UV set that the primitive does not provide, handle `gltf-material-uv-set-missing` using its material, primitive, slot, requested set, and available sets. Add the source UV set and re-import; do not substitute a custom mesh or discard the slot transform.
 
+### KHR physical material extensions
+
+The importer accepts the five second-stage material extensions below in both
+`extensionsUsed` and `extensionsRequired`. A required extension outside the
+supported set fails closed with `gltf-extension-unsupported`; a supported
+extension is projected into the same Standard `MaterialAsset` root rather than
+an extension-specific runtime type.
+
+| Extension | Standard values / slots | Channel and color-space rule | Admission / recovery |
+|:--|:--|:--|:--|
+| `KHR_materials_clearcoat` | `clearcoat`, `clearcoatRoughness`, `clearcoatTexture`, `clearcoatRoughnessTexture`, `clearcoatNormalTexture`, `clearcoatNormalScale` | weight R, roughness G, coat normal RG; data textures are linear | coat normal uses the mesh tangent producer |
+| `KHR_materials_anisotropy` | `anisotropyStrength`, `anisotropyRotation`, `anisotropyTexture` | direction RG, strength B; linear data | scalar and mapped forms both require a tangent frame |
+| `KHR_materials_sheen` | `sheenColor`, `sheenRoughness`, `sheenColorTexture`, `sheenRoughnessTexture` | color RGB is sRGB; roughness A is linear | preserve each slot's UV transform; repair `gltf-material-uv-set-missing` on conflict |
+| `KHR_materials_iridescence` | `iridescence`, `iridescenceIor`, `iridescenceThicknessMinimum/Maximum`, `iridescenceTexture`, `iridescenceThicknessTexture` | strength R and thickness G; both maps are linear | minimum greater than maximum is accepted per glTF semantics |
+| `KHR_materials_specular` | `specular`, `specularTexture`, `specularColor`, `specularColorTexture` | weight A is linear; color RGB is sRGB | texture declarations select the physical Forward contract |
+
+All five paths preserve `textureInfo.texCoord` and
+`KHR_texture_transform` into `MaterialTextureValue.coordinates`. A material
+with any of these declarations owns an extended Standard root, so its scalar
+defaults and only its authored physical texture bindings participate in cook,
+reflection, Pack refs, Catalog/load, and runtime sampling.
+
+> [!IMPORTANT]
+> `KHR_materials_anisotropy` always needs a finite tangent frame, even when
+> only `anisotropyStrength` or `anisotropyRotation` is authored. If `TANGENT`
+> is absent, the producer may generate it from `NORMAL + TEXCOORD_n + triangle
+> topology`; if those inputs are missing or degenerate, import returns the
+> structured `material-tangent-required` error. The importer persists generated
+> tangents in `MeshAsset.attributes.tangent` and never writes an identity guess.
+
 > Runtime glTF 2.0 importer (Tier-C subset). Pure-function pipeline `parseGlb` / `parseGltf` / `toAssetPack` consumed by build-time CLI plugin bin `forgeax-engine-remote-gltf` (resolved via PATH-prefix scan for `forgeax-engine-remote-`) writing `<source>.meta.json` (external-asset-package; dispatch on top-level `importer: 'gltf'`); runtime spawn happens via the existing `loadByGuid<SceneAsset>` plus `world.instantiateScene` 4-step recipe (no `loadGltf(url)` parallel API).
 
 > [!IMPORTANT]
@@ -39,7 +69,7 @@ This package consumes:
 - `scenes` + `nodes` (TRS or matrix decomposed via `mat4.decompose` wrapper)
 - `meshes` with **multiple primitives** -- each primitive produces an independent `MeshIr` with UUIDv7 GUID; `SceneAsset` nodes reference individual primitive-level mesh sub-assets
 - Vertex attributes: `POSITION` (VEC3, mandatory), `NORMAL` (VEC3), `TEXCOORD_0` (VEC2), `TANGENT` (VEC4, optional), and `COLOR_0` (see the support matrix below) -- decoded via the accessor SoA path; `INDICES` (U8/U16/U32 scalar — U8 widens to U16; U32 preserved, narrowed to U16 by bridge when maxIndex < 65536)
-- `materials` with metallic-roughness PBR mapping to pass-based `MaterialAsset` (see MaterialIr table below)
+- `materials` with metallic-roughness and five KHR physical extensions mapped to pass-based `MaterialAsset` (see MaterialIr table below)
 - `textures` / `images` / `samplers` top-level arrays parsed into `GltfDoc` IR; texture index -> image index -> URI two-hop resolution via `externalLoader`
 - `cameras` of `type: 'perspective'`
 
@@ -102,6 +132,21 @@ The complete closed error/detail union remains owned by
 | `metallicRoughnessTexture` | `number` (texture index) | no | Same two-hop resolution |
 | `normalTexture` | `number` (texture index) | no | Same two-hop resolution; TANGENT optional decode |
 
+The physical extension fields are projected into the same IR object:
+
+| Extension | Scalar fields | Texture fields |
+|:--|:--|:--|
+| `KHR_materials_clearcoat` | `clearcoatFactor`, `clearcoatRoughnessFactor` | `clearcoatTexture`, `clearcoatRoughnessTexture`, `clearcoatNormalTexture` |
+| `KHR_materials_anisotropy` | `anisotropyStrength`, `anisotropyRotation` | `anisotropyTexture` |
+| `KHR_materials_sheen` | `sheenColorFactor`, `sheenRoughnessFactor` | `sheenColorTexture`, `sheenRoughnessTexture` |
+| `KHR_materials_iridescence` | `iridescenceFactor`, `iridescenceIor`, `iridescenceThicknessMinimum/Maximum` | `iridescenceTexture`, `iridescenceThicknessTexture` |
+| `KHR_materials_specular` | `specularFactor`, `specularColorFactor` | `specularTexture`, `specularColorTexture` |
+
+Each texture field is a `GltfTextureInfoIr | number` with an explicit texture
+index and optional UV/transform facts. The bridge creates a complete extended
+root for the declarations it sees; base-only materials may still inherit the
+configured `standardMaterialGuid`.
+
 ### GltfDoc IR (textures / images / samplers)
 
 | Array | Element | Notes |
@@ -119,7 +164,7 @@ only its slot index. Canonical `SceneAsset` nodes carry `MeshFilter` plus an
 empty `MeshRenderer.materials` override vector, so imported defaults remain
 mesh-owned and reimport-safe.
 
-Out of scope (each routed to its own `feat-future-*` anchor in `requirements.md` OOS-1 .. OOS-15): KHR extensions other than the supported `EXT_mesh_gpu_instancing` and `KHR_texture_transform` paths / morph targets other than the explicit `COLOR_0` deferred signal / orthographic camera / sparse accessors / inspector future fields / pixel-parity vs three.js. Dense interleaved `COLOR_0` is supported; other interleaved accessor consumers retain their existing scope. v1.1 OOS additions (locked by feat-20260518-gltf-instancing-and-name-component): multi-primitive instancing / mesh-level + material-level + scene-level Name (only node.name lands as ECS `Name`) / instancing hard cap / SoA TRS direct-to-GPU pipe / IR-to-GPU direct path / ROTATION BYTE/SHORT normalized encoding / Babylon thin-instances style SoA channel / Bevy multi-tier Name propagation.
+Out of scope (each routed to its own `feat-future-*` anchor in `requirements.md` OOS-1 .. OOS-15): KHR material extensions other than the supported transmission/IOR/volume, clearcoat, anisotropy, sheen, iridescence, and specular paths / morph targets other than the explicit `COLOR_0` deferred signal / orthographic camera / sparse accessors / inspector future fields / pixel-parity vs three.js. Dense interleaved `COLOR_0` is supported; other interleaved accessor consumers retain their existing scope. v1.1 OOS additions (locked by feat-20260518-gltf-instancing-and-name-component): multi-primitive instancing / mesh-level + material-level + scene-level Name (only node.name lands as ECS `Name`) / instancing hard cap / SoA TRS direct-to-GPU pipe / IR-to-GPU direct path / ROTATION BYTE/SHORT normalized encoding / Babylon thin-instances style SoA channel / Bevy multi-tier Name propagation.
 
 ## Importer sub-asset PODs (7 kinds)
 
@@ -150,7 +195,7 @@ Sample reference: `apps/hello/skin` -- 3 Khronos Fox foxes side-by-side, each ru
 | `gltf-malformed-header` | GLB magic / version / length header rejection or missing JSON chunk |
 | `gltf-version-unsupported` | `asset.version` is not `'2.0'` |
 | `gltf-buffer-out-of-bounds` | accessor reads past `bufferView.byteLength` |
-| `gltf-extension-unsupported` | `extensionsRequired[]` lists an extension outside the supported allowlist (`EXT_mesh_gpu_instancing`, `KHR_texture_transform`) |
+| `gltf-extension-unsupported` | `extensionsRequired[]` lists an extension outside the supported allowlist exported as `EXTENSION_ALLOWLIST` (`EXT_mesh_gpu_instancing`, `EXT_meshopt_compression`, `KHR_lights_punctual`, `KHR_texture_transform`, transmission/IOR/volume, clearcoat, anisotropy, sheen, iridescence, specular) |
 | `gltf-accessor-type-mismatch` | sparse / morph / interleaved / unknown componentType accessor (4 reasons) |
 | `gltf-texture-load-failed` | `externalLoader` rejected for a texture `uri`; `detail.uri` carries the failing URI; hint: `'check sidecar meta.json + textures/ directory + vite-plugin-pack /__pack/lookup'` |
 | `gltf-meta-missing` | sidecar `<source>.meta.json` is absent next to the `.gltf` / `.glb` source file |
@@ -162,6 +207,14 @@ Sample reference: `apps/hello/skin` -- 3 Khronos Fox foxes side-by-side, each ru
 | `gltf-morph-unsupported` | animation channel targets morph weights (`path==='weights'`, OOS-skin-morph-anim) |
 | `gltf-color-accessor-unsupported` | `COLOR_0` type/component/normalized combination, sparse input, or morph-target input is deferred |
 | `gltf-color-accessor-malformed` | `COLOR_0` count, finite/range, buffer bounds, or reference validation failed |
+| `gltf-material-physical-invalid` | a clearcoat/anisotropy/sheen/iridescence/specular scalar or color violates its finite glTF range |
+
+Mesh tangent admission is a material error because the geometry producer owns
+the repairable frame. Branch on `material-tangent-required` and read its
+`detail.material`, `detail.mesh`, `detail.layer`, `detail.uv`,
+`detail.attributes`, and `detail.reason`; fix the source attributes and rerun
+the same importer. Do not parse the human-facing message or silently continue
+with an identity tangent.
 
 Source-key conflicts are producer failures, not automatic renames. A
 `duplicate-source-key` or `ambiguous-source-key` detail includes the semantic

package/dist/__tests__/physical-clearcoat.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=physical-clearcoat.unit.test.d.ts.map

package/dist/__tests__/physical-clearcoat.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical-clearcoat.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/physical-clearcoat.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/physical-material-import.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=physical-material-import.integration.test.d.ts.map

package/dist/__tests__/physical-material-import.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical-material-import.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/physical-material-import.integration.test.ts"],"names":[],"mappings":""}

package/dist/bridge.d.ts

@@ -98,6 +98,7 @@ export interface MaterialBridgeContext {
     readonly skinned?: boolean;
 }
 export declare function validateMaterialUvSets(mat: GltfMaterialIr, primitive: string, availableSets: readonly number[]): Result<void, MaterialError>;
+export declare function validateMaterialTangentInputs(mat: GltfMaterialIr, mesh: GltfMeshIr, layer?: string): Result<void, MaterialError>;
 /** Convert a parsed GltfMaterialIr into a standard-root derived MaterialAsset. */
 export declare function toMaterialAsset(mat: GltfMaterialIr, ctx?: MaterialBridgeContext): MaterialAsset;
 //# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EAEN,aAAa,EACb,aAAa,EAEb,SAAS,EAIT,MAAM,EACN,UAAU,EAIX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA4B,KAAK,SAAS,EAAe,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,GAAE;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,GACL,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CA0U9B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChE;AA+DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA8NpF;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAuDD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CA4B7B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAiF/F"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EAEN,aAAa,EACb,aAAa,EAEb,SAAS,EAIT,MAAM,EACN,UAAU,EAIX,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAA4B,KAAK,SAAS,EAAe,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,GAAE;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,GACL,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CA0V9B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChE;AA+DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA8NpF;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAuKD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAsC7B;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,UAAU,EAChB,KAAK,SAAc,GAClB,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAoD7B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,aAAa,CA2H/F"}

package/dist/check-extensions.d.ts

@@ -1,5 +1,5 @@
 import { type GltfError, type Result } from './errors.js';
-/** Legacy v1 mesh-only list kept for callers that display that surface. */
+/** Public supported extension list used by the required/used declaration gate. */
 export declare const EXTENSION_ALLOWLIST: readonly string[];
 export interface ExtensionsCheckResult {
     /** Names listed in extensionsUsed but not in the supported extension set. */

package/dist/check-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-extensions.d.ts","sourceRoot":"","sources":["../src/check-extensions.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5E,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAKhD,CAAC;AAUF,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAsB1C"}
+{"version":3,"file":"check-extensions.d.ts","sourceRoot":"","sources":["../src/check-extensions.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5E,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAahD,CAAC;AAOF,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAsB1C"}

package/dist/cli-gltf.mjs

@@ -25,8 +25,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",
@@ -36,6 +36,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"
@@ -400,16 +404,21 @@ function decodeColorAccessor(input, flags = {}) {
 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 ?? [];
@@ -602,6 +611,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", {
@@ -611,6 +625,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",
@@ -661,6 +683,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,
@@ -697,6 +811,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 } : {},