@forgeax/engine-gltf 0.1.20 → 0.1.23

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.20",
+  "version": "0.1.23",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -38,21 +38,21 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.20",
-    "@forgeax/engine-geometry": "0.1.20",
-    "@forgeax/engine-import": "0.1.20",
-    "@forgeax/engine-math": "0.1.20",
-    "@forgeax/engine-pack": "0.1.20",
-    "@forgeax/engine-scene": "0.1.20",
-    "@forgeax/engine-types": "0.1.20",
+    "@forgeax/engine-animation": "0.1.23",
+    "@forgeax/engine-geometry": "0.1.23",
+    "@forgeax/engine-import": "0.1.23",
+    "@forgeax/engine-math": "0.1.23",
+    "@forgeax/engine-pack": "0.1.23",
+    "@forgeax/engine-scene": "0.1.23",
+    "@forgeax/engine-types": "0.1.23",
     "@webgpu/types": "^0.1.71",
     "meshoptimizer": "^0.20.0"
   },
   "devDependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.20",
-    "@forgeax/engine-picking": "0.1.20",
-    "@forgeax/engine-render": "0.1.20",
-    "@forgeax/engine-runtime": "0.1.20",
+    "@forgeax/engine-assets-runtime": "0.1.23",
+    "@forgeax/engine-picking": "0.1.23",
+    "@forgeax/engine-render": "0.1.23",
+    "@forgeax/engine-runtime": "0.1.23",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

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,6 +13,7 @@ import {
   type GltfImageExtractFailedDetail,
   type GltfImageMimeUnsupportedDetail,
   type GltfInstancingCountMismatchDetail,
+  type GltfLodInvalidDetail,
   type GltfMalformedHeaderDetail,
   type GltfMaterialTransmissionInvalidDetail,
   type GltfMeshBridgeInvalidDetail,
@@ -52,6 +53,7 @@ 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;
 };
 
@@ -75,6 +77,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':

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

@@ -309,6 +309,8 @@ 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-accessor-type-mismatch':
@@ -360,6 +362,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',
@@ -456,8 +460,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 24 keys', () => {
+        expect(Object.keys(GLTF_ERROR_HINTS).length).toBe(24);
       });
 
       it.each(ALL_CODES)('hint for %s is a non-empty string', (code) => {
@@ -2020,7 +2024,12 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
       });
 
       it('v1 allowlist contains EXT_mesh_gpu_instancing (literal)', () => {
-        expect(EXTENSION_ALLOWLIST).toEqual(['EXT_mesh_gpu_instancing', 'EXT_meshopt_compression']);
+        expect(EXTENSION_ALLOWLIST).toEqual([
+          'EXT_mesh_gpu_instancing',
+          'EXT_meshopt_compression',
+          'MSFT_lod',
+          'MSFT_screencoverage',
+        ]);
       });
 
       it('(a) rejects unsupported extensionsRequired entries', () => {

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__/parse-gltf.unit.test.ts

@@ -162,6 +162,28 @@ describe('glTF transmission material IR', () => {
   });
 });
 
+describe('glTF required extension admission', () => {
+  it.each([
+    'KHR_materials_transmission',
+    'KHR_materials_ior',
+    'KHR_materials_volume',
+  ])('accepts %s through the parse path', async (extension) => {
+    const result = await parseGltf(
+      {
+        asset: { version: '2.0' },
+        extensionsUsed: [extension],
+        extensionsRequired: [extension],
+      },
+      noopLoader,
+      `/required-${extension}.gltf`,
+    );
+
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    expect(result.value.diagnostics.unsupportedExtensions).toEqual([]);
+  });
+});
+
 describe('glTF COLOR_0 importer carrier', () => {
   it('publishes normalized VEC3 FLOAT colors as importer-owned RGBA', async () => {
     const fixture = JSON.parse(

package/src/__tests__/source-key-producer.integration.test.ts

@@ -86,7 +86,9 @@ describe('glTF producer source-key boundary', () => {
     expect(result.ok).toBe(false);
     if (result.ok) return;
     expect(result.error.code).toBe('duplicate-source-key');
-    expect(result.error.detail.sourceIndices).toEqual([0, 1]);
+    expect((result.error.detail as { sourceIndices: readonly number[] }).sourceIndices).toEqual([
+      0, 1,
+    ]);
   });
 
   it('applies the same preflight to duplicate material names', () => {
@@ -95,7 +97,9 @@ describe('glTF producer source-key boundary', () => {
     expect(result.ok).toBe(false);
     if (result.ok) return;
     expect(result.error.code).toBe('duplicate-source-key');
-    expect(result.error.detail.sourceIndices).toEqual([0, 1]);
+    expect((result.error.detail as { sourceIndices: readonly number[] }).sourceIndices).toEqual([
+      0, 1,
+    ]);
   });
 
   it('publishes producer-valid output when semantic identity is unique', () => {

package/src/bridge.ts

@@ -541,7 +541,7 @@ export function gltfDocToSceneAsset(doc: GltfDoc, ctx: GltfBridgeContext): Scene
 
   // bug-20260613: SceneAsset entities also emit ChildOf when a glTF node has a
   // parent (line 547 below). Runtime propagateTransforms then derives
-  // Transform.world via `parent.world * compose(child.local TRS)`. If we
+  // GlobalTransform.world via `parent.world * compose(child.local TRS)`. If we
   // wrote the *world* TRS into Transform here, every child node would get
   // baked twice -- once at importer time and again at propagate time --
   // collapsing the skin so vertices fly to (parent.world)^2 space and the

package/src/check-extensions.ts

@@ -27,6 +27,8 @@ import { err, type GltfError, gltfErr, ok, type Result } from './errors.js';
 export const EXTENSION_ALLOWLIST: readonly string[] = [
   'EXT_mesh_gpu_instancing',
   'EXT_meshopt_compression',
+  'MSFT_lod',
+  'MSFT_screencoverage',
 ];
 const SUPPORTED_EXTENSIONS: readonly string[] = [
   ...EXTENSION_ALLOWLIST,

package/src/errors.ts

@@ -60,6 +60,12 @@ export interface GltfExtensionUnsupportedDetail {
   readonly source: 'extensionsRequired' | 'extensionsUsed';
 }
 
+export interface GltfLodInvalidDetail {
+  readonly rootNode: number;
+  readonly ids: readonly number[];
+  readonly reason: 'missing-node' | 'duplicate-node' | 'not-integer' | 'coverage';
+}
+
 export interface GltfMaterialTransmissionInvalidDetail {
   readonly extension: 'KHR_materials_transmission' | 'KHR_materials_ior' | 'KHR_materials_volume';
   readonly field: string;
@@ -263,6 +269,10 @@ const gltfErrorPolicy = {
     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',
   },
+  'gltf-lod-invalid': {
+    expected: 'MSFT_lod ids to reference unique existing node indices with valid coverage',
+    hint: 'repair the MSFT_lod node relation or remove it from extensionsRequired before re-importing',
+  },
   'gltf-material-transmission-invalid': {
     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',
@@ -357,6 +367,7 @@ interface DetailFor {
   readonly 'gltf-version-unsupported': GltfVersionUnsupportedDetail;
   readonly 'gltf-buffer-out-of-bounds': GltfBufferOutOfBoundsDetail;
   readonly 'gltf-extension-unsupported': GltfExtensionUnsupportedDetail;
+  readonly 'gltf-lod-invalid': GltfLodInvalidDetail;
   readonly 'gltf-accessor-type-mismatch': GltfAccessorTypeMismatchDetail;
   readonly 'gltf-texture-load-failed': GltfTextureLoadFailedDetail;
   readonly 'gltf-meta-missing': GltfMetaMissingDetail;

package/src/gltf-importer.ts

@@ -32,6 +32,7 @@
 // gap as `import-produced-no-assets`. A texture sub-asset that fails byte
 // extraction surfaces as `gltf-image-extract-failed` (D-6).
 
+import { deriveDefaultLodScreenCoverages } from '@forgeax/engine-import';
 import { packMeshBinV4 } from '@forgeax/engine-import/mesh-bin';
 import { AssetGuid as AssetGuidCodec } from '@forgeax/engine-pack/guid';
 import type {
@@ -591,7 +592,83 @@ async function importGltf(
           }),
         };
       }
-      const meshPayload = stabilizeMeshMaterialSlots(bridged.value, ctx, sub.guid, sub.sourceKey);
+      const stabilizedMesh = stabilizeMeshMaterialSlots(
+        bridged.value,
+        ctx,
+        sub.guid,
+        sub.sourceKey,
+      );
+      const lodGroup =
+        doc.lod?.groups?.find(
+          (group) => doc.nodes[group.rootNode]?.meshIndex === sub.sourceIndex,
+        ) ??
+        (doc.lod?.rootNode !== undefined &&
+        doc.nodes[doc.lod.rootNode]?.meshIndex === sub.sourceIndex
+          ? doc.lod
+          : undefined);
+      const rootMeshIndex = lodGroup === undefined ? undefined : sub.sourceIndex;
+      if (lodGroup !== undefined) {
+        const referencedMeshIndices = [
+          sub.sourceIndex,
+          ...lodGroup.lodNodeIds.map((nodeIndex) => doc.nodes[nodeIndex]?.meshIndex),
+        ];
+        const missingMeshIndex = referencedMeshIndices.find(
+          (meshIndex) =>
+            !Number.isInteger(meshIndex) ||
+            meshIndex === null ||
+            meshIndex === undefined ||
+            maps.meshGuidByIndex.get(meshIndex as number) === undefined,
+        );
+        if (missingMeshIndex !== undefined) {
+          return {
+            ok: false,
+            error: new ImportError({
+              code: 'import-internal-error',
+              expected: 'every MSFT_lod node to resolve a cooked mesh sub-asset',
+              actual: String(missingMeshIndex),
+              hint: 'repair the referenced glTF mesh primitives and re-run the importer',
+              detail: {
+                reason: `MSFT_lod group for mesh ${sub.sourceIndex} references an unprojected mesh`,
+              },
+            }),
+          };
+        }
+      }
+      const authoredLods =
+        sub.sourceKey === undefined ? undefined : ctx.sourceOverrides?.[sub.sourceKey]?.lods;
+      const lodEntries = Array.isArray(authoredLods) ? authoredLods : [];
+      const lodLevels =
+        rootMeshIndex === sub.sourceIndex && lodGroup !== undefined
+          ? lodGroup.lodNodeIds.flatMap((nodeIndex, index) => {
+              const meshIndex = doc.nodes[nodeIndex]?.meshIndex;
+              const guid =
+                meshIndex === undefined || meshIndex === null
+                  ? undefined
+                  : maps.meshGuidByIndex.get(meshIndex);
+              if (guid === undefined) return [];
+              const authored = lodEntries[index];
+              const authoredCoverage =
+                authored !== null && typeof authored === 'object'
+                  ? (authored as { readonly screenCoverage?: unknown }).screenCoverage
+                  : undefined;
+              const coverage =
+                typeof authoredCoverage === 'number'
+                  ? authoredCoverage
+                  : (lodGroup.screenCoverages[index] ??
+                    deriveDefaultLodScreenCoverages(lodGroup.lodNodeIds.length + 1)[index]);
+              const parsed = AssetGuidCodec.parse(guid);
+              return parsed.ok && coverage !== undefined
+                ? [{ mesh: parsed.value, screenCoverage: coverage, guid }]
+                : [];
+            })
+          : [];
+      const meshPayload: MeshAsset =
+        lodLevels.length === 0
+          ? stabilizedMesh
+          : {
+              ...stabilizedMesh,
+              lods: lodLevels.map(({ mesh, screenCoverage }) => ({ mesh, screenCoverage })),
+            };
       const materialRefs: AssetRef[] = [];
       const seenMaterialGuids = new Set<string>();
       for (let slotIndex = 0; slotIndex < meshPayload.materialSlots.length; slotIndex++) {
@@ -606,6 +683,15 @@ async function importGltf(
           });
         }
       }
+      for (const [lodIndex, level] of lodLevels.entries()) {
+        if (!seenMaterialGuids.has(level.guid.toLowerCase())) {
+          seenMaterialGuids.add(level.guid.toLowerCase());
+          materialRefs.push({
+            guid: level.guid,
+            sourceField: { fieldName: 'lods', arrayIndex: lodIndex },
+          });
+        }
+      }
       out.push({
         guid: sub.guid,
         kind: 'mesh',

package/src/index.ts

@@ -81,6 +81,8 @@ export { err, GLTF_ERROR_HINTS, gltfErr, ok } from './errors.js';
 // gltfImporter: the build-time `{ key: 'gltf', import }` Importer
 // (feat-20260603-asset-import-loader-injection M2 / w19).
 export { gltfImporter } from './gltf-importer.js';
+export { type GltfLodRelation, parseGltfLodExtension } from './lod/parse-lod.js';
+export { projectGltfLodMeta } from './lod/project-meta.js';
 export type { GlbChunks } from './parse-glb-chunks.js';
 // Header / chunk parsers (w8).
 export { parseGlbChunks, parseGltfHeader } from './parse-glb-chunks.js';