@forgeax/engine-import 0.1.20 → 0.1.23

package/dist/scriptable-pack.d.ts

@@ -1,9 +1,8 @@
-import { type ScriptablePackAssetKind } from '@forgeax/engine-pack';
-import { type ScriptablePackDefinition, type ScriptablePackError, type ScriptablePackReadError, type ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
-import type { AnimationGraph, Asset, AssetGuid as AssetGuidType, AssetPublicationEnvelope, FontAsset, MaterialAsset, MeshAsset, Result, TilesetAsset } from '@forgeax/engine-types';
+import type { ScriptablePackAssetKind } from '@forgeax/engine-pack';
+import type { AssetReader, PackAuthoringError, ScriptablePackReadError } from '@forgeax/engine-pack/source';
+import type { AnimationGraph, Asset, AssetGuid as AssetGuidType, AssetPublicationEnvelope, FontAsset, ImportError, ImportedAsset, MaterialAsset, MeshAsset, Result, TilesetAsset } from '@forgeax/engine-types';
+import type { ImportAssetProduct, TerminalImportProduct } from './import-product.js';
 export type { ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
-import { AssetError, ImportError } from '@forgeax/engine-types';
-import { type ImportAssetProduct, type TerminalImportProduct } from './import-product.js';
 export interface ScriptablePackAssetSnapshot {
     readonly asset: Asset;
     readonly generation: number;
@@ -11,8 +10,7 @@ export interface ScriptablePackAssetSnapshot {
 }
 export interface ScriptablePackStagedOutput {
     readonly guid: AssetGuidType;
-    /** Producer-owned stable output identity from the ScriptablePack definition. */
-    readonly sourceKey?: string;
+    readonly sourceKey: string;
     readonly asset: Asset;
     readonly digest?: string;
 }
@@ -48,7 +46,7 @@ type AnimationGraphPackPayload = Omit<AnimationGraph, 'nodes'> & {
         readonly clip: number;
     }))[];
 };
-/** Serialized Pack projection; durable runtime Assets never carry ref indices. */
+/** Serialized producer payloads; runtime Assets never carry ref indices. */
 export type AssetOutputPayloadByKind = {
     readonly mesh: MeshAsset;
     readonly material: MaterialPackPayload;
@@ -86,6 +84,9 @@ export type AssetOutputPayloadByKind = {
     readonly 'particle-effect': Extract<Asset, {
         readonly kind: 'particle-effect';
     }>;
+    readonly 'ies-profile': Extract<Asset, {
+        readonly kind: 'ies-profile';
+    }>;
 };
 export type AssetOutputPayload = AssetOutputPayloadByKind[ScriptablePackAssetKind];
 export type AssetOutputProduct = ImportAssetProduct<AssetOutputPayload>;
@@ -109,33 +110,19 @@ export interface ScriptablePackExternalEvidence {
 }
 export interface ScriptablePackBuildProduct {
     readonly product: TerminalImportProduct<unknown>;
-    /** Raw private outputs for the current staged build generation, never a runtime publication path. */
     readonly stagedOutputs: readonly ScriptablePackStagedOutput[];
     readonly externalEvidence: readonly ScriptablePackExternalEvidence[];
     readonly inputFingerprint: string;
-    /** Engine publication fields projected after ordinary producers run. */
     readonly publication?: AssetPublicationEnvelope;
 }
-/** Domain-owned structured failure transported without flattening its recovery fields. */
 export interface ScriptablePackDomainError {
     readonly code: string;
     readonly expected: string;
     readonly hint: string;
     readonly detail?: unknown;
 }
-export type ScriptablePackBuildBridgeResult = Result<ScriptablePackBuildProduct, ScriptablePackError | AssetError | ImportError | ScriptablePackDomainError>;
-export interface BuildScriptablePackOptions {
-    readonly definition: ScriptablePackDefinition;
-    readonly sourcePath: string;
-    readonly assetSource?: ScriptablePackAssetSnapshotSource;
-    readonly outputs: AssetOutputProducerRegistry;
-    readonly sourceClosure: readonly ScriptablePackSourceClosureEntry[];
-    readonly authoringContractVersion: string;
-}
-/**
- * Build one external ScriptablePack through the producer-owned Pack bridge.
- * Success preserves payloads, GUID refs, and local artifacts; failure retains
- * `code`, `expected`, `hint`, and `detail` for recovery by the caller.
- */
-export declare function buildScriptablePack(options: BuildScriptablePackOptions): Promise<ScriptablePackBuildBridgeResult>;
+/** The source authoring contract is owned by Pack; this alias keeps reader typing local. */
+export type ScriptablePackAssetReader = AssetReader;
+export type ScriptablePackAuthoringError = PackAuthoringError;
+export type ScriptablePackImportedAsset = ImportedAsset<unknown>;
 //# sourceMappingURL=scriptable-pack.d.ts.map

package/dist/scriptable-pack.d.ts.map

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

package/dist/source-package-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-package-errors.d.ts","sourceRoot":"","sources":["../src/source-package-errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,KAAK,GACL,iBAAiB,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,yBAAyB,CAAC,GACtE,kBAAkB,CAQpB;AAsED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,eAAqB,GAAG,OAAO,CAM7F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAyBpB"}
+{"version":3,"file":"source-package-errors.d.ts","sourceRoot":"","sources":["../src/source-package-errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,KAAK,GACL,iBAAiB,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,yBAAyB,CAAC,GACtE,kBAAkB,CAQpB;AA4ED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,eAAqB,GAAG,OAAO,CAM7F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAyBpB"}

package/dist/source-package-publication.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-import",
-  "version": "0.1.20",
+  "version": "0.1.23",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -27,12 +27,13 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-ddc": "0.1.20",
-    "@forgeax/engine-ecs": "0.1.20",
-    "@forgeax/engine-geometry": "0.1.20",
-    "@forgeax/engine-pack": "0.1.20",
-    "@forgeax/engine-scene": "0.1.20",
-    "@forgeax/engine-types": "0.1.20",
+    "@forgeax/engine-ddc": "0.1.23",
+    "@forgeax/engine-ecs": "0.1.23",
+    "@forgeax/engine-geometry": "0.1.23",
+    "@forgeax/engine-pack": "0.1.23",
+    "@forgeax/engine-scene": "0.1.23",
+    "@forgeax/engine-shader": "0.1.23",
+    "@forgeax/engine-types": "0.1.23",
     "@noble/hashes": "^2.2.0"
   },
   "devDependencies": {

package/src/__tests__/ies-contract.unit.test.ts

@@ -0,0 +1,31 @@
+import type { IesProfileAsset } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { validateIesProfilePayload } from '../ies/ies-importer';
+
+describe('IES asset contract', () => {
+  it('accepts exactly one cooked Type C payload shape', () => {
+    const payload: IesProfileAsset = {
+      kind: 'ies-profile',
+      data: new Uint8Array(256 * 128 * 2),
+    };
+    expect(validateIesProfilePayload(payload)).toEqual({ ok: true, value: payload });
+  });
+
+  it('rejects wrong kind, byte length, and non-finite decoded values', () => {
+    expect(
+      validateIesProfilePayload({ kind: 'texture', data: new Uint8Array(256 * 128 * 2) }),
+    ).toMatchObject({
+      ok: false,
+    });
+    expect(
+      validateIesProfilePayload({ kind: 'ies-profile', data: new Uint8Array(4) }),
+    ).toMatchObject({
+      ok: false,
+    });
+    const nonFinite = new Uint8Array(256 * 128 * 2);
+    nonFinite[1] = 0x7c;
+    expect(validateIesProfilePayload({ kind: 'ies-profile', data: nonFinite })).toMatchObject({
+      ok: false,
+    });
+  });
+});

package/src/__tests__/ies-producer.unit.test.ts

@@ -0,0 +1,104 @@
+import type { ImportContext } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { iesImporter } from '../ies/ies-importer.js';
+import { parseLm63TypeC } from '../ies/parse-lm63.js';
+import { readFloat16LE, resampleTypeC } from '../ies/resample-type-c.js';
+
+const GUID = '019f0000-0000-7000-8000-000000000081';
+const SOURCE = `IESNA:LM-63-2002
+TILT=NONE
+1 1000 1 3 3 1 1 1 1 1 1 1
+0 90 180
+0 90 180
+1 2 3
+4 5 6
+1 2 3
+`;
+
+function context(source: string): ImportContext {
+  return {
+    source: 'fixtures/asymmetric.ies',
+    readSource: async () => ({ ok: true as const, value: new TextEncoder().encode(source) }),
+    readSibling: async () => ({ ok: false as const, error: new Error('not used') as never }),
+    decodeImage: async () => {
+      throw new Error('not used');
+    },
+    subAssets: [{ guid: GUID, sourceIndex: 0, sourceKey: 'ies/main', kind: 'ies-profile' }],
+    importSettings: {},
+  };
+}
+
+function fixture(): string {
+  return `IESNA:LM-63-2002
+[TEST] ForgeaX Type C fixture
+TILT=NONE
+1 1000 1 3 3 1 1 1 1 1 1 1
+0 90 180
+0 90 180
+1 2 3
+4 5 6
+1 2 3
+`;
+}
+
+describe('LM-63 Type C producer primitives', () => {
+  it('parses TILT=NONE and preserves Type C angle tables', () => {
+    const parsed = parseLm63TypeC(fixture());
+    expect(parsed.ok).toBe(true);
+    if (parsed.ok) {
+      expect(parsed.value.horizontalAnglesDeg).toEqual([0, 90, 180]);
+      expect(parsed.value.candela).toHaveLength(9);
+      expect(parsed.value.tilt).toBe('NONE');
+    }
+  });
+
+  it('rejects tilted or non-Type-C sources with source diagnostics', () => {
+    const tilted = parseLm63TypeC(fixture().replace('TILT=NONE', 'TILT=INCLUDE'));
+    const nonTypeC = parseLm63TypeC(fixture().replace('1 1000 1 3 3 1 1', '1 1000 1 3 3 2 1'));
+    expect(tilted.ok).toBe(false);
+    expect(nonTypeC.ok).toBe(false);
+  });
+
+  it('resamples to deterministic finite peak-normalized little-endian f16 bytes', () => {
+    const parsed = parseLm63TypeC(fixture());
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    const first = resampleTypeC(parsed.value);
+    const second = resampleTypeC(parsed.value);
+    expect(first).toEqual(second);
+    expect(first).toHaveLength(256 * 128 * 2);
+    const samples = Array.from({ length: 256 * 128 }, (_, index) =>
+      readFloat16LE(first, index * 2),
+    );
+    expect(samples.every(Number.isFinite)).toBe(true);
+    expect(Math.max(...samples)).toBeCloseTo(1, 6);
+    const lastSample = samples.at(-1) ?? 0;
+    expect(samples[255]).toBeCloseTo(lastSample, 3);
+  });
+});
+
+describe('IES Pack and publication boundary', () => {
+  it('publishes the authored GUID and cooked artifact without source text', async () => {
+    const result = await iesImporter.import(context(SOURCE));
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    expect(result.value.assets).toHaveLength(1);
+    expect(result.value.assets[0]).toMatchObject({ guid: GUID, kind: 'ies-profile' });
+    expect(result.value.assets[0]?.payload).toMatchObject({ kind: 'ies-profile' });
+    expect(result.value.assets[0]?.artifacts.body?.bytes).toHaveLength(256 * 128 * 2);
+  });
+
+  it('is byte deterministic and rejects invalid sources before publication', async () => {
+    const first = await iesImporter.import(context(SOURCE));
+    const second = await iesImporter.import(context(SOURCE));
+    expect(first).toEqual(second);
+
+    const failed = await iesImporter.import(context(SOURCE.replace('TILT=NONE', 'TILT=INCLUDE')));
+    expect(failed.ok).toBe(false);
+    if (!failed.ok) {
+      expect(failed.error).toMatchObject({ code: 'source-validation-failed' });
+      expect(failed.error.expected).toContain('TILT=NONE');
+      expect(failed.error.detail).toMatchObject({ diagnostics: expect.any(Array) });
+    }
+  });
+});

package/src/__tests__/mesh-bin.test.ts

@@ -91,6 +91,75 @@ describe('mesh-bin v4 roundtrip contract', () => {
     );
   });
 
+  it('stores lower-detail mesh refs and screen coverage in v4 metadata', () => {
+    const lodGuid = '019d0000-0000-7000-8000-000000000006';
+    const lod = AssetGuid.parse(lodGuid);
+    if (!lod.ok) throw new Error('fixture guid must parse');
+    const payload = {
+      ...buildPayload(4, 0, false),
+      lods: [{ mesh: lod.value, screenCoverage: 0.5 }],
+      lodHysteresis: 0.08,
+    };
+    const result = packMeshBinV4(payload, 'gltf://lod-root', [lodGuid]);
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    const header = decodeMeshBinHeader(result.value, 'gltf://lod-root');
+    expect(header.ok).toBe(true);
+    if (!header.ok) return;
+    const jsonOffset = 80 + header.value.vertexBytes + header.value.indexBytes;
+    const meta = JSON.parse(
+      new TextDecoder().decode(
+        result.value.subarray(jsonOffset, jsonOffset + header.value.jsonBytes),
+      ),
+    ) as { lods?: unknown; lodHysteresis?: unknown };
+    expect(meta.lods).toEqual([{ meshRef: 0, screenCoverage: 0.5 }]);
+    expect(meta.lodHysteresis).toBe(0.08);
+  });
+
+  it('fails closed when a lower-detail mesh ref is not enclosed by refs', () => {
+    const lod = AssetGuid.parse('019d0000-0000-7000-8000-000000000007');
+    if (!lod.ok) throw new Error('fixture guid must parse');
+    const result = packMeshBinV4(
+      { ...buildPayload(4, 0, false), lods: [{ mesh: lod.value, screenCoverage: 0.5 }] },
+      'gltf://lod-missing-ref',
+    );
+    expect(result.ok).toBe(false);
+    if (result.ok) return;
+    expect(result.error.actual).toContain('absent from refs');
+  });
+
+  it('rejects non-decreasing coverage and invalid hysteresis before cooking', () => {
+    const first = AssetGuid.parse('019d0000-0000-7000-8000-000000000008');
+    const second = AssetGuid.parse('019d0000-0000-7000-8000-000000000009');
+    if (!first.ok || !second.ok) throw new Error('fixture guids must parse');
+    const result = packMeshBinV4(
+      {
+        ...buildPayload(4, 0, false),
+        lods: [
+          { mesh: first.value, screenCoverage: 0.5 },
+          { mesh: second.value, screenCoverage: 0.5 },
+        ],
+      },
+      'gltf://lod-invalid-coverage',
+      [AssetGuid.format(first.value), AssetGuid.format(second.value)],
+    );
+    expect(result.ok).toBe(false);
+    if (result.ok) return;
+    expect(result.error.actual).toContain('strictly decreasing');
+
+    const hysteresis = packMeshBinV4(
+      {
+        ...buildPayload(4, 0, false),
+        lods: [{ mesh: first.value, screenCoverage: 0.5 }],
+        lodHysteresis: 1,
+      },
+      'gltf://lod-invalid-hysteresis',
+      [AssetGuid.format(first.value)],
+    );
+    expect(hysteresis.ok).toBe(false);
+    if (!hysteresis.ok) expect(hysteresis.error.actual).toContain('lodHysteresis');
+  });
+
   it('returns a closed error without bytes for invalid stride cardinality', () => {
     const payload = buildPayload(2, 0, false);
     const result = packMeshBinV4({ ...payload, vertexCount: 3 }, 'gltf://invalid');

package/src/__tests__/mesh-lod-contract.unit.test.ts

@@ -0,0 +1,92 @@
+import { describe, expect, it } from 'vitest';
+import {
+  deriveDefaultLodScreenCoverages,
+  reconcileMeshLodMeta,
+  validateMeshLodContract,
+} from '../mesh-lod.js';
+
+describe('mesh LOD contract', () => {
+  it.each([
+    [1, []],
+    [2, [0.5]],
+    [3, [0.5, 0.2]],
+    [4, [0.5, 0.2, 0.08]],
+    [5, [0.5, 0.2, 0.08, 0.032]],
+    [8, [0.5, 0.2, 0.08, 0.032, 0.0128, 0.00512, 0.002048]],
+  ])('derives stable defaults for %i levels', (levelCount, expected) => {
+    expect(deriveDefaultLodScreenCoverages(levelCount)).toEqual(expected);
+  });
+
+  it('rejects zero, non-finite, and non-decreasing coverage', () => {
+    expect(validateMeshLodContract({ lods: [{ meshGuid: 'a', screenCoverage: 0 }] })).toMatchObject(
+      {
+        ok: false,
+        error: { code: 'mesh-lod-contract-invalid' },
+      },
+    );
+    expect(
+      validateMeshLodContract({
+        lods: [
+          { meshGuid: 'a', screenCoverage: 0.5 },
+          { meshGuid: 'b', screenCoverage: 0.6 },
+        ],
+      }),
+    ).toMatchObject({
+      ok: false,
+      error: { code: 'mesh-lod-contract-invalid' },
+    });
+  });
+
+  it('preserves existing author facts and only appends levels', () => {
+    const previous = [
+      { sourceKey: 'mesh/lod1', meshGuid: 'guid-1', screenCoverage: 0.5 },
+      { sourceKey: 'mesh/lod2', meshGuid: 'guid-2', screenCoverage: 0.2 },
+    ];
+    expect(
+      reconcileMeshLodMeta(previous, [...previous, { sourceKey: 'mesh/lod3', meshGuid: 'guid-3' }]),
+    ).toMatchObject({
+      ok: true,
+      value: {
+        lods: [...previous, { sourceKey: 'mesh/lod3', meshGuid: 'guid-3', screenCoverage: 0.08 }],
+      },
+    });
+    expect(reconcileMeshLodMeta(previous, previous.slice().reverse())).toMatchObject({
+      ok: false,
+      error: { code: 'mesh-lod-topology-change' },
+    });
+  });
+
+  it('rejects incomplete refs, non-enclosing bounds, slot drift, and cycles', () => {
+    const base = {
+      lods: [{ meshGuid: 'lod-1', screenCoverage: 0.5 }],
+      rootMeshGuid: 'root',
+      refs: ['root'],
+      rootBounds: { min: [-1, -1, -1] as const, max: [1, 1, 1] as const },
+      lodBounds: [{ min: [-2, -1, -1] as const, max: [1, 1, 1] as const }],
+      rootMaterialSlots: [{ sourceKey: 'body' }],
+      lodMaterialSlots: [[{ sourceKey: 'body' }]],
+      relations: [{ from: 'root', to: 'lod-1' }],
+    };
+    expect(validateMeshLodContract(base).ok).toBe(false);
+    const cycle = validateMeshLodContract({
+      ...base,
+      refs: ['root', 'lod-1'],
+      lodBounds: [{ min: [-1, -1, -1], max: [1, 1, 1] }],
+      relations: [
+        { from: 'root', to: 'lod-1' },
+        { from: 'lod-1', to: 'root' },
+      ],
+    });
+    expect(cycle.ok).toBe(false);
+    if (!cycle.ok) expect(cycle.error.reason).toContain('acyclic');
+    const slotDrift = validateMeshLodContract({
+      ...base,
+      refs: ['root', 'lod-1'],
+      lodBounds: [{ min: [-1, -1, -1], max: [1, 1, 1] }],
+      relations: [{ from: 'root', to: 'lod-1' }],
+      lodMaterialSlots: [[{ sourceKey: 'head' }]],
+    });
+    expect(slotDrift.ok).toBe(false);
+    if (!slotDrift.ok) expect(slotDrift.error.reason).toContain('material slots');
+  });
+});

package/src/__tests__/mesh-lod-reimport.integration.test.ts

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { reconcileMeshLodMeta } from '../mesh-lod.js';
+
+describe('mesh LOD reimport identity', () => {
+  it('keeps coverage attached to sourceKey instead of array position', () => {
+    const result = reconcileMeshLodMeta(
+      [{ sourceKey: 'root/lod1', meshGuid: 'guid-1', screenCoverage: 0.5 }],
+      [{ sourceKey: 'root/lod1', meshGuid: 'guid-1', screenCoverage: 0.5 }],
+    );
+    expect(result).toMatchObject({
+      ok: true,
+      value: { lods: [{ meshGuid: 'guid-1', screenCoverage: 0.5 }] },
+    });
+  });
+});