@forgeax/engine-gltf 0.1.21 → 0.1.24

package/dist/parse-gltf.d.ts

@@ -1,6 +1,7 @@
 import { ImportError } from '@forgeax/engine-types';
 import { COMPONENT_TYPE } from './accessor/decode-accessor.js';
 import { type GltfError, type Result } from './errors.js';
+import { type GltfLodRelation } from './lod/parse-lod.js';
 import { type GltfImageIr, type GltfMaterialIr, type GltfSamplerIr, type GltfTextureIr } from './material/parse-material.js';
 import { type GltfBufferViewDecodeCapability } from './meshopt-decode.js';
 import { type GltfAnimationClipRecord } from './parse-animation.js';
@@ -129,6 +130,7 @@ export interface GltfDoc {
      * fixtures; producers from parseGltf / parseGlb always populate it.
      */
     readonly meshPrimitiveCount?: ReadonlyMap<number, number>;
+    readonly lod?: GltfLodRelation;
 }
 export type ExternalLoader = (uri: string) => Promise<ArrayBuffer>;
 type GltfParseError = GltfError | ImportError;
@@ -156,7 +158,7 @@ export interface GltfAssetPack {
     readonly meta: GltfMetaJson;
     readonly subAssets: readonly GltfSubAssetEntry[];
 }
-export type GltfAssetPackResult = Result<GltfAssetPack, GltfSourceKeyError>;
+export type GltfAssetPackResult = Result<GltfAssetPack, GltfSourceKeyError | GltfError>;
 /**
  * Project a parsed `GltfDoc` into the disk-shape `<source>.meta.json` plus
  * the freshly minted `subAssets[]` list (UUIDv7 + reimport-reuse-meta

package/dist/parse-gltf.d.ts.map

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

package/dist/reimport-reuse-meta.d.ts

@@ -19,7 +19,7 @@ export interface GltfMetaJson {
     readonly importer: 'gltf';
     readonly source: string;
     readonly subAssets: readonly GltfSubAssetEntry[];
-    readonly sourceOverrides?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    readonly sourceOverrides?: Readonly<Record<string, Readonly<Record<string, unknown>>>> | undefined;
     readonly sourceOverrideDescriptors?: readonly import('@forgeax/engine-types').SourceOverrideDescriptor[];
     readonly importSettings: {
         readonly defaultSceneIndex: number;

package/dist/reimport-reuse-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reimport-reuse-meta.d.ts","sourceRoot":"","sources":["../src/reimport-reuse-meta.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,OAAO,uBAAuB,EAAE,wBAAwB,EAAE,CAAC;IACzG,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,WAAW,EAAE;YACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;YACtC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;YAClD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;SACnD,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,mBAAmB,CAmDrB"}
+{"version":3,"file":"reimport-reuse-meta.d.ts","sourceRoot":"","sources":["../src/reimport-reuse-meta.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EACrB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAC3D,SAAS,CAAC;IACd,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,OAAO,uBAAuB,EAAE,wBAAwB,EAAE,CAAC;IACzG,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,WAAW,EAAE;YACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;YACtC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;YAClD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;SACnD,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,mBAAmB,CAmDrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-gltf",
-  "version": "0.1.21",
+  "version": "0.1.24",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -38,21 +38,21 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.21",
-    "@forgeax/engine-geometry": "0.1.21",
-    "@forgeax/engine-import": "0.1.21",
-    "@forgeax/engine-math": "0.1.21",
-    "@forgeax/engine-pack": "0.1.21",
-    "@forgeax/engine-scene": "0.1.21",
-    "@forgeax/engine-types": "0.1.21",
+    "@forgeax/engine-animation": "0.1.24",
+    "@forgeax/engine-geometry": "0.1.24",
+    "@forgeax/engine-import": "0.1.24",
+    "@forgeax/engine-math": "0.1.24",
+    "@forgeax/engine-pack": "0.1.24",
+    "@forgeax/engine-scene": "0.1.24",
+    "@forgeax/engine-types": "0.1.24",
     "@webgpu/types": "^0.1.71",
     "meshoptimizer": "^0.20.0"
   },
   "devDependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.21",
-    "@forgeax/engine-picking": "0.1.21",
-    "@forgeax/engine-render": "0.1.21",
-    "@forgeax/engine-runtime": "0.1.21",
+    "@forgeax/engine-assets-runtime": "0.1.24",
+    "@forgeax/engine-picking": "0.1.24",
+    "@forgeax/engine-render": "0.1.24",
+    "@forgeax/engine-runtime": "0.1.24",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

package/src/__tests__/bridge-material-values.unit.test.ts

@@ -1,4 +1,4 @@
-import type { Handle } from '@forgeax/engine-types';
+import type { AssetGuid, Handle } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
 import { toMaterialAsset } from '../bridge.js';
 import type { GltfMaterialIr } from '../parse-gltf.js';
@@ -149,4 +149,87 @@ describe('glTF material bridge values', () => {
       },
     });
   });
+
+  it('owns a complete five-extension Standard root and admits only authored physical textures', () => {
+    const material = toMaterialAsset(
+      {
+        name: 'physical-root',
+        baseColorFactor: [0.8, 0.7, 0.6, 1],
+        metallicFactor: 0.1,
+        roughnessFactor: 0.35,
+        clearcoatFactor: 0.75,
+        clearcoatRoughnessFactor: 0.2,
+        clearcoatNormalTexture: { texture: 0 },
+        anisotropyStrength: 0.5,
+        anisotropyRotation: 0.25,
+        anisotropyTexture: { texture: 1 },
+        sheenColorFactor: [0.2, 0.1, 0.05],
+        sheenRoughnessFactor: 0.3,
+        sheenColorTexture: { texture: 2 },
+        iridescenceFactor: 0.6,
+        iridescenceIor: 1.4,
+        iridescenceThicknessMinimum: 120,
+        iridescenceThicknessMaximum: 380,
+        iridescenceTexture: { texture: 3 },
+        specularFactor: 0.8,
+        specularColorFactor: [0.9, 0.85, 0.75],
+        specularColorTexture: { texture: 4 },
+      } as unknown as GltfMaterialIr,
+      {
+        standardRootGuid: 'standard-root' as unknown as AssetGuid,
+        textureHandles: new Map([
+          [0, 100],
+          [1, 101],
+          [2, 102],
+          [3, 103],
+          [4, 104],
+        ]) as unknown as ReadonlyMap<number, Handle<'TextureAsset', 'shared'>>,
+      },
+    );
+
+    expect(material.parent).toBeUndefined();
+    const names = new Set((material.parameters ?? []).map((parameter) => parameter.name));
+    for (const name of [
+      'clearcoat',
+      'clearcoatRoughness',
+      'clearcoatNormalTexture',
+      'anisotropyStrength',
+      'anisotropyRotation',
+      'anisotropyTexture',
+      'sheenColor',
+      'sheenRoughness',
+      'sheenColorTexture',
+      'iridescence',
+      'iridescenceIor',
+      'iridescenceThicknessMinimum',
+      'iridescenceThicknessMaximum',
+      'iridescenceTexture',
+      'specular',
+      'specularColor',
+      'specularColorTexture',
+    ]) {
+      expect(names.has(name)).toBe(true);
+    }
+    for (const name of [
+      'clearcoatTexture',
+      'clearcoatRoughnessTexture',
+      'sheenRoughnessTexture',
+      'iridescenceThicknessTexture',
+      'specularTexture',
+    ]) {
+      expect(names.has(name)).toBe(false);
+    }
+    expect(material.values).toMatchObject({
+      clearcoat: 0.75,
+      anisotropyStrength: 0.5,
+      sheenColor: [0.2, 0.1, 0.05],
+      iridescenceIor: 1.4,
+      specularColor: [0.9, 0.85, 0.75],
+      clearcoatNormalTexture: { texture: 100 },
+      anisotropyTexture: { texture: 101 },
+      sheenColorTexture: { texture: 102 },
+      iridescenceTexture: { texture: 103 },
+      specularColorTexture: { texture: 104 },
+    });
+  });
 });

package/src/__tests__/bridge-skin-stride.unit.test.ts

@@ -102,6 +102,28 @@ describe('meshIrToMeshAsset pure-unskinned path (AC-04 / AC-08 / OOS-9)', () =>
 });
 
 describe('glTF bridge uses geometry-owned packing', () => {
+  it('persists a generated tangent frame when source TANGENT is absent', () => {
+    const asset = meshIrToMeshAsset([
+      {
+        meshIndex: 0,
+        materialIndex: null,
+        positions: new Float32Array([0, 0, 0, 1, 0, 0, 0, 1, 0]),
+        normals: new Float32Array([0, 0, 1, 0, 0, 1, 0, 0, 1]),
+        texcoord0: new Float32Array([0, 0, 1, 0, 0, 1]),
+        indices: new Uint16Array([0, 1, 2]),
+      },
+    ]);
+
+    const tangent = asset.attributes.tangent;
+    expect(tangent).toBeInstanceOf(Float32Array);
+    if (!(tangent instanceof Float32Array)) throw new Error('generated tangent stream missing');
+    expect(tangent?.length).toBe(12);
+    expect(tangent?.[0]).toBeCloseTo(1, 5);
+    expect(tangent?.[1]).toBeCloseTo(0, 5);
+    expect(tangent?.[2]).toBeCloseTo(0, 5);
+    expect(Math.abs(tangent?.[3] ?? 0)).toBeCloseTo(1, 5);
+  });
+
   it('does not own a parallel 12F/18F stride or uv count calculation', () => {
     const asset = meshIrToMeshAsset([makeUnskinnedPrim(0, 4)]);
     expect(asset.vertices.length / 12).toBe(4);

package/src/__tests__/fixtures/lod/core-only.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0"},"nodes":[{"mesh":0}],"meshes":[{"primitives":[]}],"scenes":[{"nodes":[0]}]}

package/src/__tests__/fixtures/lod/msft-lod-malformed.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0"},"extensionsRequired":["MSFT_lod"],"extensionsUsed":["MSFT_lod"],"nodes":[{"mesh":0,"extensions":{"MSFT_lod":{"ids":[99]}}}],"scenes":[{"nodes":[0]}]}

package/src/__tests__/fixtures/lod/msft-lod-multi-root.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0"},"extensionsUsed":["MSFT_lod"],"meshes":[{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]}],"nodes":[{"mesh":0,"extensions":{"MSFT_lod":{"ids":[1,2]}}},{"mesh":1},{"mesh":2},{"mesh":3,"extensions":{"MSFT_lod":{"ids":[4,5]}}},{"mesh":4},{"mesh":5}],"extensions":{"MSFT_screencoverage":{"scales":[0.5,0.2]}},"scenes":[{"nodes":[0,3]}]}

package/src/__tests__/fixtures/lod/msft-lod-node-extras.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0"},"extensionsUsed":["MSFT_lod"],"meshes":[{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]}],"nodes":[{"mesh":0,"extensions":{"MSFT_lod":{"ids":[1,2]}},"extras":{"MSFT_screencoverage":[0.5,0.2,0.01]}},{"mesh":1},{"mesh":2}],"scenes":[{"nodes":[0]}]}

package/src/__tests__/fixtures/lod/msft-lod.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0"},"extensionsUsed":["MSFT_lod"],"meshes":[{"primitives":[{}]},{"primitives":[{}]},{"primitives":[{}]}],"nodes":[{"mesh":0,"extensions":{"MSFT_lod":{"ids":[1,2]}}},{"mesh":1},{"mesh":2}],"extensions":{"MSFT_screencoverage":{"scales":[0.5,0.2]}},"scenes":[{"nodes":[0]}]}

package/src/__tests__/gltf-error-derived-views.test-d.ts

@@ -13,7 +13,9 @@ import {
   type GltfImageExtractFailedDetail,
   type GltfImageMimeUnsupportedDetail,
   type GltfInstancingCountMismatchDetail,
+  type GltfLodInvalidDetail,
   type GltfMalformedHeaderDetail,
+  type GltfMaterialPhysicalInvalidDetail,
   type GltfMaterialTransmissionInvalidDetail,
   type GltfMeshBridgeInvalidDetail,
   type GltfMeshoptDecodeFailedDetail,
@@ -52,7 +54,9 @@ type ExpectedDetails = {
   readonly 'gltf-color-accessor-unsupported': GltfColorAccessorUnsupportedDetail;
   readonly 'gltf-color-accessor-malformed': GltfColorAccessorMalformedDetail;
   readonly 'gltf-mesh-bridge-invalid': GltfMeshBridgeInvalidDetail;
+  readonly 'gltf-lod-invalid': GltfLodInvalidDetail;
   readonly 'gltf-material-transmission-invalid': GltfMaterialTransmissionInvalidDetail;
+  readonly 'gltf-material-physical-invalid': GltfMaterialPhysicalInvalidDetail;
 };
 
 type ExpectedCodes = keyof ExpectedDetails;
@@ -75,6 +79,8 @@ function exhaustive(error: GltfError): string {
       return `${error.detail.accessor}:${error.detail.bufferIndex}`;
     case 'gltf-extension-unsupported':
       return error.detail.extension;
+    case 'gltf-lod-invalid':
+      return String(error.detail.rootNode);
     case 'gltf-accessor-type-mismatch':
       return error.detail.reason;
     case 'gltf-texture-load-failed':
@@ -113,6 +119,8 @@ function exhaustive(error: GltfError): string {
       return error.detail.reason;
     case 'gltf-material-transmission-invalid':
       return `${error.detail.extension}:${error.detail.field}:${error.detail.reason}`;
+    case 'gltf-material-physical-invalid':
+      return `${error.detail.extension}:${error.detail.field}:${error.detail.reason}`;
   }
   return error;
 }

package/src/__tests__/gltf-error-migration.test.ts

@@ -17,7 +17,7 @@ import { resolve } from 'node:path';
 import { describe, expect, it } from 'vitest';
 
 const REPO_ROOT = resolve(import.meta.dirname ?? '.', '..', '..', '..', '..');
-const TYPES_INDEX = resolve(REPO_ROOT, 'packages', 'types', 'src', 'index.ts');
+const TYPES_INDEX = resolve(REPO_ROOT, 'packages', 'types', 'src', 'core-contracts.ts');
 const GLTF_ERRORS = resolve(REPO_ROOT, 'packages', 'gltf', 'src', 'errors.ts');
 
 function grepCount(pattern: string, file: string): number {
@@ -125,12 +125,12 @@ function grepCountImportGltfErrorFromTypes(): number {
 }
 
 describe('M1 GltfErrorCode migration grep gate (AC-28)', () => {
-  it("(a) types/src/index.ts contains zero 'gltf-' string literals", () => {
+  it("(a) types/src/core-contracts.ts contains zero 'gltf-' string literals", () => {
     const count = grepCount("'gltf-", TYPES_INDEX);
     expect(count).toBe(0);
   });
 
-  it('(b) types/src/index.ts contains zero export type GltfError* exports', () => {
+  it('(b) types/src/core-contracts.ts contains zero export type GltfError* exports', () => {
     const count = grepCount('export type GltfError', TYPES_INDEX);
     expect(count).toBe(0);
   });

package/src/__tests__/gltf.unit.test.ts

@@ -278,7 +278,9 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
     'gltf-version-unsupported',
     'gltf-buffer-out-of-bounds',
     'gltf-extension-unsupported',
+    'gltf-lod-invalid',
     'gltf-material-transmission-invalid',
+    'gltf-material-physical-invalid',
     'gltf-accessor-type-mismatch',
     'gltf-texture-load-failed',
     'gltf-meta-missing',
@@ -300,7 +302,8 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
   ];
 
   function classifyByExhaustiveSwitch(err: GltfError): string {
-    switch (err.code) {
+    const code = err.code;
+    switch (code) {
       case 'gltf-malformed-header':
         return 'malformed';
       case 'gltf-version-unsupported':
@@ -309,8 +312,12 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         return 'oob';
       case 'gltf-extension-unsupported':
         return 'ext';
+      case 'gltf-lod-invalid':
+        return 'lod';
       case 'gltf-material-transmission-invalid':
         return 'material-transmission-invalid';
+      case 'gltf-material-physical-invalid':
+        return 'material-physical-invalid';
       case 'gltf-accessor-type-mismatch':
         return 'accessor';
       case 'gltf-texture-load-failed':
@@ -348,6 +355,7 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
       case 'gltf-mesh-bridge-invalid':
         return 'mesh-bridge-invalid';
     }
+    throw new Error(`unhandled glTF error code: ${code}`);
   }
 
   function buildErrSample(code: GltfErrorCode): GltfError {
@@ -360,6 +368,8 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         return gltfErr(code, { accessor: 0, byteOffset: 0, byteLength: 0, bufferIndex: 0 });
       case 'gltf-extension-unsupported':
         return gltfErr(code, { extension: 'KHR_x', source: 'extensionsRequired' });
+      case 'gltf-lod-invalid':
+        return gltfErr(code, { rootNode: 0, ids: [1], reason: 'missing-node' });
       case 'gltf-material-transmission-invalid':
         return gltfErr(code, {
           extension: 'KHR_materials_transmission',
@@ -367,6 +377,13 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
           reason: 'range',
           actual: 2,
         });
+      case 'gltf-material-physical-invalid':
+        return gltfErr(code, {
+          extension: 'KHR_materials_clearcoat',
+          field: 'clearcoatFactor',
+          reason: 'range',
+          actual: 2,
+        });
       case 'gltf-accessor-type-mismatch':
         return gltfErr(code, { accessorIndex: 0, reason: 'sparse' });
       case 'gltf-texture-load-failed':
@@ -448,6 +465,7 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
       case 'gltf-mesh-bridge-invalid':
         return gltfErr(code, { reason: 'empty-input', primitiveCount: 0 });
     }
+    throw new Error(`unhandled glTF error code: ${code}`);
   }
 
   describe('errors.test.ts', () => {
@@ -456,8 +474,8 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
     });
 
     describe('GltfErrorCode roster', () => {
-      it('GLTF_ERROR_HINTS exposes exactly 23 keys', () => {
-        expect(Object.keys(GLTF_ERROR_HINTS).length).toBe(23);
+      it('GLTF_ERROR_HINTS exposes exactly 25 keys', () => {
+        expect(Object.keys(GLTF_ERROR_HINTS).length).toBe(25);
       });
 
       it.each(ALL_CODES)('hint for %s is a non-empty string', (code) => {
@@ -1930,6 +1948,25 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         expect(map.get(0)).toBe('srgb');
       });
 
+      it('physical extension texture slots keep their glTF color domains', () => {
+        const map = deriveTextureColorSpace({
+          imageCount: 4,
+          textures: [{ source: 0 }, { source: 1 }, { source: 2 }, { source: 3 }],
+          materials: [
+            {
+              sheenColorTexture: 0,
+              specularColorTexture: 1,
+              anisotropyTexture: 2,
+              thicknessTexture: 3,
+            },
+          ],
+        });
+        expect(map.get(0)).toBe('srgb');
+        expect(map.get(1)).toBe('srgb');
+        expect(map.get(2)).toBe('linear');
+        expect(map.get(3)).toBe('linear');
+      });
+
       it('occlusionTexture image classifies as linear', () => {
         const map = deriveTextureColorSpace({
           imageCount: 1,
@@ -2019,8 +2056,21 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         stderrSpy.mockRestore();
       });
 
-      it('v1 allowlist contains EXT_mesh_gpu_instancing (literal)', () => {
-        expect(EXTENSION_ALLOWLIST).toEqual(['EXT_mesh_gpu_instancing', 'EXT_meshopt_compression']);
+      it('public allowlist contains every currently supported extension (literal)', () => {
+        expect(EXTENSION_ALLOWLIST).toEqual([
+          'EXT_mesh_gpu_instancing',
+          'EXT_meshopt_compression',
+          'KHR_lights_punctual',
+          'KHR_texture_transform',
+          'KHR_materials_transmission',
+          'KHR_materials_ior',
+          'KHR_materials_volume',
+          'KHR_materials_clearcoat',
+          'KHR_materials_anisotropy',
+          'KHR_materials_sheen',
+          'KHR_materials_iridescence',
+          'KHR_materials_specular',
+        ]);
       });
 
       it('(a) rejects unsupported extensionsRequired entries', () => {
@@ -2086,6 +2136,11 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         'KHR_materials_transmission',
         'KHR_materials_ior',
         'KHR_materials_volume',
+        'KHR_materials_clearcoat',
+        'KHR_materials_anisotropy',
+        'KHR_materials_sheen',
+        'KHR_materials_iridescence',
+        'KHR_materials_specular',
       ])('%s in extensionsRequired routes ok (supported)', (extension) => {
         const result = checkExtensions({ extensionsRequired: [extension] });
         expect(result.ok).toBe(true);

package/src/__tests__/lod-import.integration.test.ts

@@ -0,0 +1,106 @@
+import { readFile } from 'node:fs/promises';
+import { describe, expect, it } from 'vitest';
+import { parseGltfLodExtension } from '../lod/parse-lod.js';
+
+async function fixture(name: string): Promise<Record<string, unknown>> {
+  return JSON.parse(
+    await readFile(new URL(`./fixtures/lod/${name}`, import.meta.url), 'utf8'),
+  ) as Record<string, unknown>;
+}
+
+describe('glTF MSFT_lod producer contract', () => {
+  it('adopts node-level ids in author order and suppresses lower nodes', async () => {
+    const json = await fixture('msft-lod.gltf');
+    const result = parseGltfLodExtension(json);
+    expect(result).toMatchObject({
+      ok: true,
+      value: { rootNode: 0, lodNodeIds: [1, 2], screenCoverages: [0.5, 0.2] },
+    });
+  });
+
+  it('adopts the official node extras coverage array and drops its terminal discard hint', async () => {
+    const json = await fixture('msft-lod-node-extras.gltf');
+    const result = parseGltfLodExtension(json);
+    expect(result).toMatchObject({
+      ok: true,
+      value: {
+        rootNode: 0,
+        lodNodeIds: [1, 2],
+        screenCoverages: [0.5, 0.2],
+        groups: [{ rootNode: 0, lodNodeIds: [1, 2], screenCoverages: [0.5, 0.2] }],
+      },
+    });
+  });
+
+  it('rejects an official node extras array whose root/level count is incomplete', () => {
+    expect(
+      parseGltfLodExtension({
+        meshes: [{ primitives: [{}] }, { primitives: [{}] }, { primitives: [{}] }],
+        nodes: [
+          {
+            extensions: { MSFT_lod: { ids: [1, 2] } },
+            extras: { MSFT_screencoverage: [0.5, 0.2] },
+          },
+          {},
+          {},
+        ],
+      }),
+    ).toMatchObject({ ok: false, error: { code: 'gltf-lod-invalid' } });
+  });
+
+  it('fails closed when a required MSFT_lod extension has no normalizable group', () => {
+    expect(
+      parseGltfLodExtension({ extensionsRequired: ['MSFT_lod'], nodes: [{ mesh: 0 }] }),
+    ).toMatchObject({ ok: false, error: { code: 'gltf-lod-invalid' } });
+  });
+
+  it('requires every referenced node to resolve a mesh sub-asset', () => {
+    expect(
+      parseGltfLodExtension({
+        nodes: [{ mesh: 0, extensions: { MSFT_lod: { ids: [1] } } }, {}],
+      }),
+    ).toMatchObject({ ok: false, error: { code: 'gltf-lod-invalid' } });
+  });
+
+  it('rejects a referenced mesh index outside the source mesh table', () => {
+    expect(
+      parseGltfLodExtension({
+        meshes: [{}],
+        nodes: [{ mesh: 0, extensions: { MSFT_lod: { ids: [1] } } }, { mesh: 2 }],
+      }),
+    ).toMatchObject({ ok: false, error: { code: 'gltf-lod-invalid' } });
+  });
+
+  it('rejects a referenced mesh with no primitives before publication', () => {
+    expect(
+      parseGltfLodExtension({
+        meshes: [{ primitives: [] }, { primitives: [{}] }],
+        nodes: [{ mesh: 0, extensions: { MSFT_lod: { ids: [1] } } }, { mesh: 1 }],
+      }),
+    ).toMatchObject({ ok: false, error: { code: 'gltf-lod-invalid' } });
+  });
+
+  it('rejects malformed required extension instead of loading only LOD0', async () => {
+    const json = await fixture('msft-lod-malformed.gltf');
+    expect(parseGltfLodExtension(json)).toMatchObject({
+      ok: false,
+      error: { code: 'gltf-lod-invalid' },
+    });
+  });
+
+  it('retains every node-level relation for multi-root scenes', async () => {
+    const json = await fixture('msft-lod-multi-root.gltf');
+    const result = parseGltfLodExtension(json);
+    expect(result).toMatchObject({
+      ok: true,
+      value: {
+        rootNode: 0,
+        lodNodeIds: [1, 2],
+        groups: [
+          { rootNode: 0, lodNodeIds: [1, 2] },
+          { rootNode: 3, lodNodeIds: [4, 5] },
+        ],
+      },
+    });
+  });
+});

package/src/__tests__/lod-meta-publication.integration.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { projectGltfLodMeta } from '../lod/project-meta.js';
+
+describe('glTF LOD Meta publication candidate', () => {
+  it('uses declared GUIDs and leaves publication to the shared host', () => {
+    const result = projectGltfLodMeta({
+      rootSourceKey: 'mesh/root',
+      levels: [
+        { sourceKey: 'mesh/lod1', guid: 'guid-1' },
+        { sourceKey: 'mesh/lod2', guid: 'guid-2' },
+      ],
+      previous: undefined,
+    });
+    expect(result).toMatchObject({
+      ok: true,
+      value: {
+        lods: [
+          { meshGuid: 'guid-1', screenCoverage: 0.5 },
+          { meshGuid: 'guid-2', screenCoverage: 0.2 },
+        ],
+      },
+    });
+  });
+});

package/src/__tests__/material-pack-refs.integration.test.ts

@@ -67,4 +67,57 @@ describe('glTF material Pack refs', () => {
       'sampler-6',
     ]);
   });
+
+  it('keeps the five physical extension texture edges in producer slot order', () => {
+    const material = {
+      name: 'PhysicalPackMaterial',
+      baseColorFactor: [1, 1, 1, 1],
+      metallicFactor: 0,
+      roughnessFactor: 0.5,
+      clearcoatNormalTexture: { texture: 0, sampler: 0 },
+      anisotropyTexture: { texture: 1, sampler: 1 },
+      sheenColorTexture: { texture: 2, sampler: 2 },
+      iridescenceTexture: { texture: 3, sampler: 3 },
+      specularColorTexture: { texture: 4, sampler: 4 },
+    } as unknown as GltfMaterialIr;
+    const doc = {
+      textures: [
+        { source: 0, sampler: 0 },
+        { source: 1, sampler: 1 },
+        { source: 2, sampler: 2 },
+        { source: 3, sampler: 3 },
+        { source: 4, sampler: 4 },
+      ],
+    } as unknown as GltfDoc;
+    const refs = materialRefsForPack(
+      material,
+      doc,
+      new Map([
+        [0, 'clearcoat-normal-texture'],
+        [1, 'anisotropy-texture'],
+        [2, 'sheen-color-texture'],
+        [3, 'iridescence-texture'],
+        [4, 'specular-color-texture'],
+      ]),
+      new Map([
+        [0, 'clearcoat-normal-sampler'],
+        [1, 'anisotropy-sampler'],
+        [2, 'sheen-color-sampler'],
+        [3, 'iridescence-sampler'],
+        [4, 'specular-color-sampler'],
+      ]),
+    );
+    expect(refs.map((ref) => ref.guid)).toEqual([
+      'clearcoat-normal-texture',
+      'clearcoat-normal-sampler',
+      'anisotropy-texture',
+      'anisotropy-sampler',
+      'sheen-color-texture',
+      'sheen-color-sampler',
+      'iridescence-texture',
+      'iridescence-sampler',
+      'specular-color-texture',
+      'specular-color-sampler',
+    ]);
+  });
 });