@forgeax/engine-assets-runtime 0.1.7 → 0.1.19

package/dist/mipmap-generator.d.ts

@@ -1,4 +1,4 @@
-import { type Result, RhiError } from '@forgeax/engine-rhi';
+import { type Result, RhiError, type RhiRenderPassEncoder } from '@forgeax/engine-rhi';
 /**
  * Subset of `RhiDevice` consumed by the mipmap utility (charter F2: only
  * the methods the algorithm actually invokes; the dawn integration tests
@@ -129,4 +129,6 @@ export declare function blitMipmapsSync(device: MipmapBlitDevice, texture: any,
     readonly height: number;
     readonly levels?: number;
 }): Result<void, RhiError>;
+/** Encode one prewarmed mip level into a caller-owned graph render pass. */
+export declare function encodeMipmapLevel(device: MipmapBlitDevice, pass: RhiRenderPassEncoder, sourceView: unknown, format: GPUTextureFormat): Result<void, RhiError>;
 //# sourceMappingURL=mipmap-generator.d.ts.map

package/dist/mipmap-generator.d.ts.map

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

package/dist/registry/instantiate.d.ts

@@ -12,6 +12,8 @@ import { type ScenePublicationFence, type ScenePublicationFenceError } from './s
 export interface SkinJointResolver {
     resolveSkinAsset(skeletonHandleRaw: number): SkinAsset | undefined;
 }
+/** Derive a publication fence from the registry's unified live projections. */
+export declare function scenePublicationFenceFromRegistry(registry: AssetRegistry, outputGuid: string): Result<ScenePublicationFence, ScenePublicationFenceError>;
 /**
  * Post-spawn hook contract (D-1). A hook runs after instantiate spawns the
  * scene subtree; the shipped implementation is runtime's `postSpawnResolveJoints`

package/dist/registry/instantiate.d.ts.map

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

package/dist/registry/validate-material.d.ts

@@ -15,6 +15,7 @@ import type { AssetRegistry } from '../asset-registry';
  * @returns AssetError on failure, null on success
  */
 export declare function validateMaterialPasses(registry: AssetRegistry, asset: MaterialAsset): AssetError | null;
+export declare function validateMaterialTransmissionContract(asset: MaterialAsset): MaterialError | null;
 export interface MaterialEffectiveRootIdentity {
     readonly guid: string;
     readonly layoutIdentity: string;

package/dist/registry/validate-material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-material.d.ts","sourceRoot":"","sources":["../../src/registry/validate-material.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,UAAU,EAEV,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,aAAa,GACnB,UAAU,GAAG,IAAI,CAoFnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,6BAA6B,GAClC,aAAa,GAAG,IAAI,CAiBtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,aAAa,GACnB,UAAU,GAAG,IAAI,CA8GnB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAgCT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CA8BhG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,GACf,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAIjC"}
+{"version":3,"file":"validate-material.d.ts","sourceRoot":"","sources":["../../src/registry/validate-material.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,UAAU,EAEV,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,aAAa,GACnB,UAAU,GAAG,IAAI,CAoFnB;AA4CD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CAkD/F;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,6BAA6B,GAClC,aAAa,GAAG,IAAI,CAiBtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,aAAa,GACnB,UAAU,GAAG,IAAI,CA8GnB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAgCT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CA8BhG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,GACf,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAIjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-assets-runtime",
-  "version": "0.1.7",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -26,22 +26,22 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-codec": "0.1.7",
-    "@forgeax/engine-ecs": "0.1.7",
-    "@forgeax/engine-geometry": "0.1.7",
-    "@forgeax/engine-graphics-extras": "0.1.7",
-    "@forgeax/engine-image": "0.1.7",
-    "@forgeax/engine-pack": "0.1.7",
-    "@forgeax/engine-plugin": "0.1.7",
-    "@forgeax/engine-rhi": "0.1.7",
-    "@forgeax/engine-scene": "0.1.7",
-    "@forgeax/engine-shader": "0.1.7",
-    "@forgeax/engine-types": "0.1.7",
-    "@forgeax/engine-ui": "0.1.7",
+    "@forgeax/engine-codec": "0.1.19",
+    "@forgeax/engine-ecs": "0.1.19",
+    "@forgeax/engine-geometry": "0.1.19",
+    "@forgeax/engine-graphics-extras": "0.1.19",
+    "@forgeax/engine-image": "0.1.19",
+    "@forgeax/engine-pack": "0.1.19",
+    "@forgeax/engine-plugin": "0.1.19",
+    "@forgeax/engine-rhi": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-shader": "0.1.19",
+    "@forgeax/engine-types": "0.1.19",
+    "@forgeax/engine-ui": "0.1.19",
     "@webgpu/types": "^0.1.71"
   },
   "devDependencies": {
-    "@forgeax/engine-skinning": "0.1.7",
+    "@forgeax/engine-skinning": "0.1.19",
     "@webgpu/types": "^0.1.71"
   },
   "forgeax": {

package/src/__tests__/catalog-replica.unit.test.ts

@@ -193,4 +193,40 @@ describe('CatalogReplica', () => {
       diagnostics: [{ code: 'catalog-revision-conflict', severity: 'blocking' }],
     });
   });
+
+  it('applies a failed lifecycle projection when the producer advances its observation revision', async () => {
+    const fixture = source();
+    const replica = new CatalogReplica(fixture.source as never);
+    await replica.start();
+
+    fixture.emit({
+      added: [],
+      changed: [
+        {
+          ...base,
+          lifecycle: 'failed',
+          revision: {
+            digest: 'failure:source-package-ddc-failed:sha256:old',
+            observedAt: 2,
+            rootId: base.revision.rootId,
+          },
+          diagnostics: [
+            {
+              code: 'source-package-ddc-failed',
+              severity: 'blocking',
+              hint: 'repair and retry',
+            },
+          ],
+        },
+      ],
+      removed: [],
+    });
+
+    expect(replica.snapshot().entries[0]).toMatchObject({
+      guid: base.guid,
+      lifecycle: 'failed',
+      revision: { observedAt: 2 },
+    });
+    expect(replica.snapshot().stale).toBe(false);
+  });
 });

package/src/__tests__/inline-pack-loaders.unit.test.ts

@@ -279,6 +279,43 @@ describe('materialLoader', () => {
     });
   });
 
+  it('resolves transmission and thickness texture refs through authored contract', () => {
+    const out = materialLoader.load(
+      {
+        passes: [{ name: 'Forward', program: { module: 'forgeax::default-standard-pbr' } }],
+        parameters: [
+          { name: 'transmissionTexture', type: 'texture' },
+          { name: 'thicknessTexture', type: 'texture' },
+        ],
+        values: {
+          transmission: 0.8,
+          ior: 1.45,
+          thickness: 0.25,
+          transmissionTexture: { texture: 0, sampler: 1, coordinates: { set: 2 } },
+          thicknessTexture: { texture: 2, sampler: 3, coordinates: { set: 3 } },
+        },
+      },
+      ['texture-transmission', 'sampler-linear', 'texture-thickness', 'sampler-nearest'],
+      emptyCtx,
+    ) as MaterialAsset;
+
+    expect(out.values).toMatchObject({
+      transmission: 0.8,
+      ior: 1.45,
+      thickness: 0.25,
+      transmissionTexture: {
+        texture: 'texture-transmission',
+        sampler: 'sampler-linear',
+        coordinates: { set: 2 },
+      },
+      thicknessTexture: {
+        texture: 'texture-thickness',
+        sampler: 'sampler-nearest',
+        coordinates: { set: 3 },
+      },
+    });
+  });
+
   it('resolves nested texture values when the shader schema is present but empty', () => {
     const out = materialLoader.load(
       {

package/src/__tests__/instantiate-publication-fence.unit.test.ts

@@ -6,7 +6,7 @@ import {
 } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
 import type { AssetRegistry } from '../asset-registry';
-import { resolveMountsRec } from '../registry/instantiate';
+import { resolveMountsRec, scenePublicationFenceFromRegistry } from '../registry/instantiate';
 import { createScenePublicationFence } from '../registry/scene-publication-fence';
 
 const SCENE_GUID = '019ffdb4-1000-7000-8000-000000000008';
@@ -155,4 +155,62 @@ describe('resolveMountsRec publication fence identity', () => {
     );
     expect(result).toMatchObject({ ok: true, value: [{ source: 6 }] });
   });
+
+  it('prefers the complete pack-index tuple during a CatalogReplica handoff', () => {
+    const world = new World();
+    const currentSourcePath = 'assets/current.glb';
+    const currentPublication = {
+      ...publication(),
+      sourcePath: currentSourcePath,
+      receipt: { ...publication().receipt, sourcePath: currentSourcePath },
+    };
+    const fence = createScenePublicationFence(currentPublication);
+    expect(fence.ok).toBe(true);
+    if (!fence.ok) return;
+    const registry = {
+      assetCatalog: new Map(),
+      // The replica may still expose the prior complete tuple while the
+      // latest pack-index has already been hydrated after a source write.
+      catalogSnapshot: () => ({
+        entries: [
+          {
+            guid: SCENE_GUID,
+            kind: 'scene',
+            sourcePath: publication().sourcePath,
+            packageUrl: '/assets/scene.pack.json',
+            publication: publication(),
+          },
+        ],
+      }),
+      packIndexCache: new Map([
+        [
+          SCENE_GUID,
+          {
+            guid: SCENE_GUID,
+            kind: 'scene',
+            sourcePath: currentSourcePath,
+            packageUrl: '/assets/current.pack.json',
+            publication: currentPublication,
+          },
+        ],
+      ]),
+      _guidForAsset: () => undefined,
+    } as unknown as AssetRegistry;
+    const result = resolveMountsRec(
+      registry,
+      [
+        {
+          localId: 0 as never,
+          source: 6,
+          memberFirst: 0 as never,
+          memberCount: 0,
+          publicationFence: fence.value,
+        },
+      ],
+      world,
+      new Set(),
+    );
+    expect(result).toMatchObject({ ok: true, value: [{ source: 6 }] });
+    expect(scenePublicationFenceFromRegistry(registry, SCENE_GUID)).toEqual(fence);
+  });
 });

package/src/__tests__/material-ready.integration.test.ts

@@ -5,6 +5,7 @@ import {
 } from '@forgeax/engine-pack';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
 import { ShaderRegistry } from '@forgeax/engine-shader';
+import type { MaterialParameter } from '@forgeax/engine-types';
 import { describe, expect, it, vi } from 'vitest';
 import { AssetRegistry } from '../asset-registry';
 import { MaterialGenerationCache } from '../material/generation-cache';
@@ -103,6 +104,70 @@ describe('material runtime readiness', () => {
     ]);
   });
 
+  it('keeps the Standard transmission contract in the published snapshot', async () => {
+    const parameters: readonly MaterialParameter[] = [
+      { name: 'transmission', type: 'f32', default: 0 },
+      { name: 'ior', type: 'f32', default: 1.5 },
+      { name: 'thickness', type: 'f32', default: 0 },
+      { name: 'attenuationColor', type: 'vec3', default: [1, 1, 1] },
+      { name: 'attenuationDistance', type: 'f32' },
+      { name: 'transmissionTexture', type: 'texture' },
+      { name: 'thicknessTexture', type: 'texture' },
+    ];
+    expect(materialParametersToParamSchema(parameters, 'published::standard')).toEqual([
+      { name: 'transmission', type: 'f32', default: 0 },
+      { name: 'ior', type: 'f32', default: 1.5 },
+      { name: 'thickness', type: 'f32', default: 0 },
+      { name: 'attenuationColor', type: 'vec3', default: [1, 1, 1] },
+      { name: 'attenuationDistance', type: 'f32' },
+      { name: 'transmissionTexture', type: 'texture2d' },
+      { name: 'thicknessTexture', type: 'texture2d' },
+    ]);
+    const baseRecord = cookedRecord(PRODUCTION_GUID);
+    const record: CookedMaterialRecord = {
+      ...baseRecord,
+      parameterContract: {
+        parameters,
+        values: {
+          transmission: 0.8,
+          ior: 1.45,
+          thickness: 0.25,
+          attenuationColor: [0.9, 0.95, 1],
+          attenuationDistance: 4,
+          transmissionTexture: { texture: 'texture/transmission' },
+          thicknessTexture: { texture: 'texture/thickness' },
+        },
+      },
+      resolved: {
+        ...baseRecord.resolved,
+        parameters,
+        values: {
+          transmission: 0.8,
+          ior: 1.45,
+          thickness: 0.25,
+          attenuationColor: [0.9, 0.95, 1],
+          attenuationDistance: 4,
+          transmissionTexture: { texture: 'texture/transmission' },
+          thicknessTexture: { texture: 'texture/thickness' },
+        },
+      },
+    };
+    const loader = createMaterialLoader({
+      loadPublication: async () => ({ ...publication(), guid: PRODUCTION_GUID, record }),
+      loadReference: async () => true,
+    });
+
+    const result = await loader.load({
+      guid: PRODUCTION_GUID,
+      specializationKey: 'material-specialization/7/ready',
+    });
+
+    expect(result.status).toBe('Ready');
+    if (result.status !== 'Ready') return;
+    expect(result.parameterContract).toEqual(record.parameterContract);
+    expect(inspectMaterialRuntime(result).parameterContract).toEqual(record.parameterContract);
+  });
+
   it('loads only a cooked record with its artifact and complete references', async () => {
     const loader = createLoader(async () => publication());
 

package/src/__tests__/validate-material.unit.test.ts

@@ -18,6 +18,7 @@ import {
   materialShaderTextureFieldNames,
   validateMaterialCookIdentity,
   validateMaterialPasses,
+  validateMaterialTransmissionContract,
   validateParamType,
   validateSpriteSlices,
 } from '../registry/validate-material';
@@ -180,6 +181,50 @@ describe('validateMaterialPasses', () => {
   });
 });
 
+describe('validateMaterialTransmissionContract', () => {
+  it.each([
+    ['transmission range', { transmission: 1.1 }],
+    ['ior range', { ior: 0 }],
+    ['thickness range', { thickness: -0.1 }],
+    ['attenuation distance', { attenuationDistance: Number.POSITIVE_INFINITY }],
+  ])('returns a structured error for %s', (_name, value) => {
+    const error = validateMaterialTransmissionContract(mat({ values: value }));
+    expect(error?.code).toBe('material-transmission-contract-invalid');
+    expect(error?.detail).toMatchObject({ reason: expect.any(String) });
+  });
+
+  it('rejects BLEND and depth writes when transmission is active', () => {
+    expect(
+      validateMaterialTransmissionContract(
+        mat({
+          values: { transmission: 0.5 },
+          passes: [
+            {
+              name: 'forward',
+              program: { module: 'forgeax_material::standard' },
+              renderState: { blend: {} },
+            },
+          ],
+        }),
+      )?.detail,
+    ).toMatchObject({ reason: 'blend' });
+    expect(
+      validateMaterialTransmissionContract(
+        mat({
+          values: { transmission: 0.5 },
+          passes: [
+            {
+              name: 'forward',
+              program: { module: 'forgeax_material::standard' },
+              renderState: { depthWriteEnabled: true },
+            },
+          ],
+        }),
+      )?.detail,
+    ).toMatchObject({ reason: 'depth-write' });
+  });
+});
+
 describe('validateParamType', () => {
   const reg = makeRegistry({});
   it('numeric scalars', () => {

package/src/index.ts

@@ -143,6 +143,7 @@ export {
 // ─── Mipmap generation helpers ──────────────────────────────────────────────
 export {
   blitMipmapsSync,
+  encodeMipmapLevel,
   getOrCreateMipmapPipeline,
   type MipmapBlitDevice,
   type MipmapShaderModuleFactory,
@@ -157,9 +158,13 @@ export {
   type RuntimeEvidenceSource,
 } from './registry/asset-evidence';
 export { CatalogReplica, type CatalogReplicaSnapshot } from './registry/catalog-state';
-export type { PostSpawnHook, SkinJointResolver } from './registry/instantiate';
 // ─── Scene instantiate collaboration contract types (D-1 injected hook) ─────
-export { buildSceneChildContext } from './registry/instantiate';
+export {
+  buildSceneChildContext,
+  type PostSpawnHook,
+  type SkinJointResolver,
+  scenePublicationFenceFromRegistry,
+} from './registry/instantiate';
 export { loadMaterialReadyByGuid } from './registry/load-by-guid';
 export {
   compareScenePublicationFences,

package/src/mipmap-generator.ts

@@ -45,7 +45,7 @@
 //   - `numMipLevels` is pure (no device argument); the WeakMap lookup only
 //     happens at pipeline-create time.
 
-import { err, ok, type Result, RhiError } from '@forgeax/engine-rhi';
+import { err, ok, type Result, RhiError, type RhiRenderPassEncoder } from '@forgeax/engine-rhi';
 
 /**
  * Subset of `RhiDevice` consumed by the mipmap utility (charter F2: only
@@ -448,3 +448,45 @@ export function blitMipmapsSync(
 
   return recordMipmapBlit<RhiError>(device, texture, levels, pipeline, cache);
 }
+
+/** Encode one prewarmed mip level into a caller-owned graph render pass. */
+export function encodeMipmapLevel(
+  device: MipmapBlitDevice,
+  pass: RhiRenderPassEncoder,
+  sourceView: unknown,
+  format: GPUTextureFormat,
+): Result<void, RhiError> {
+  const cache = deviceCache.get(device);
+  if (cache === undefined) {
+    return err(
+      new RhiError({
+        code: 'rhi-not-available',
+        expected: 'mipmap pipeline cache prewarmed for the graph device before encoding',
+        hint: 'call prewarmMipmapPipeline(device, formats) at renderer.ready',
+      }),
+    );
+  }
+  const pipeline = cache.pipelines.get(format);
+  if (pipeline === undefined) {
+    return err(
+      new RhiError({
+        code: 'rhi-not-available',
+        expected: `mipmap pipeline for format ${format} prewarmed`,
+        hint: `format ${format} was not prewarmed; add it to the renderer prewarm list`,
+      }),
+    );
+  }
+  const bindGroup = device.createBindGroup({
+    label: 'mipmap-graph-bind-group',
+    layout: cache.layout,
+    entries: [
+      { binding: 0, resource: { kind: 'sampler', value: cache.sampler } },
+      { binding: 1, resource: { kind: 'textureView', value: sourceView } },
+    ],
+  });
+  if (!bindGroup.ok) return bindGroup;
+  pass.setPipeline(pipeline);
+  pass.setBindGroup(0, bindGroup.value);
+  pass.draw(3, 1, 0, 0);
+  return ok(undefined);
+}

package/src/registry/instantiate.ts

@@ -78,16 +78,26 @@ function catalogEntriesForFence(registry: AssetRegistry): readonly CatalogEntry[
     if (record.sourcePath === undefined) continue;
     const candidate = { ...record, guid, sourcePath: record.sourcePath } as CatalogEntry;
     const current = byGuid.get(guid.toLowerCase());
-    if (
-      current === undefined ||
-      (current.publication === undefined && candidate.publication !== undefined)
-    ) {
+    if (current === undefined || candidate.publication !== undefined) {
+      // A persisted Scene fence is captured from the complete pack-index
+      // publication at save time. If the CatalogReplica is still carrying its
+      // previous tuple during the watcher handoff, keep the same pack-index
+      // authority here or the freshly reopened scene will reject its own
+      // mount with asset-generation-fence-mismatch.
       byGuid.set(guid.toLowerCase(), candidate);
     }
   }
   return [...byGuid.values()];
 }
 
+/** Derive a publication fence from the registry's unified live projections. */
+export function scenePublicationFenceFromRegistry(
+  registry: AssetRegistry,
+  outputGuid: string,
+): Result<ScenePublicationFence, ScenePublicationFenceError> {
+  return scenePublicationFenceFromCatalog(catalogEntriesForFence(registry), outputGuid);
+}
+
 /**
  * Post-spawn hook contract (D-1). A hook runs after instantiate spawns the
  * scene subtree; the shipped implementation is runtime's `postSpawnResolveJoints`

package/src/registry/validate-material.ts

@@ -112,6 +112,100 @@ export function validateMaterialPasses(
   return null;
 }
 
+type TransmissionParameter =
+  | 'transmission'
+  | 'ior'
+  | 'thickness'
+  | 'attenuationColor'
+  | 'attenuationDistance'
+  | 'transmissionTexture'
+  | 'thicknessTexture';
+
+function transmissionError(
+  material: string,
+  parameter: TransmissionParameter,
+  reason: 'non-finite' | 'range' | 'shape' | 'blend' | 'depth-write',
+  actual?: unknown,
+): MaterialError {
+  return createMaterialError('material-transmission-contract-invalid', {
+    code: 'material-transmission-contract-invalid',
+    material,
+    parameter,
+    reason,
+    ...(actual === undefined ? {} : { actual }),
+  });
+}
+
+function validateTransmissionNumber(
+  material: string,
+  values: Record<string, unknown>,
+  parameter: 'transmission' | 'ior' | 'thickness' | 'attenuationDistance',
+  minimum: number,
+  maximum?: number,
+): MaterialError | null {
+  const value = values[parameter];
+  if (value === undefined) return null;
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return transmissionError(material, parameter, 'non-finite', value);
+  }
+  if (value < minimum || (maximum !== undefined && value > maximum)) {
+    return transmissionError(material, parameter, 'range', value);
+  }
+  return null;
+}
+
+export function validateMaterialTransmissionContract(asset: MaterialAsset): MaterialError | null {
+  const material = (asset.values?.materialName as string | undefined) ?? '<unnamed>';
+  const values = (asset.values ?? {}) as Record<string, unknown>;
+  const numericChecks: ReadonlyArray<
+    ['transmission' | 'ior' | 'thickness' | 'attenuationDistance', number, number | undefined]
+  > = [
+    ['transmission', 0, 1],
+    ['ior', 1, undefined],
+    ['thickness', 0, undefined],
+    ['attenuationDistance', Number.MIN_VALUE, undefined],
+  ];
+  for (const [parameter, minimum, maximum] of numericChecks) {
+    const error = validateTransmissionNumber(material, values, parameter, minimum, maximum);
+    if (error !== null) return error;
+  }
+  const attenuationColor = values.attenuationColor;
+  if (attenuationColor !== undefined) {
+    if (
+      !Array.isArray(attenuationColor) ||
+      attenuationColor.length !== 3 ||
+      attenuationColor.some(
+        (value) => typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 1,
+      )
+    ) {
+      return transmissionError(material, 'attenuationColor', 'shape', attenuationColor);
+    }
+  }
+  for (const parameter of ['transmissionTexture', 'thicknessTexture'] as const) {
+    const value = values[parameter];
+    if (
+      value !== undefined &&
+      typeof value !== 'string' &&
+      !(typeof value === 'number' && Number.isInteger(value) && value >= 0) &&
+      (typeof value !== 'object' || value === null || Array.isArray(value))
+    ) {
+      return transmissionError(material, parameter, 'shape', value);
+    }
+  }
+  const transmission = values.transmission;
+  if (typeof transmission === 'number' && transmission > 0) {
+    for (const pass of asset.passes ?? []) {
+      if (pass.renderState?.blend !== undefined) {
+        return transmissionError(material, 'transmission', 'blend');
+      }
+      if (pass.renderState?.depthWriteEnabled === true) {
+        return transmissionError(material, 'transmission', 'depth-write');
+      }
+    }
+  }
+  return null;
+}
+
 export interface MaterialEffectiveRootIdentity {
   readonly guid: string;
   readonly layoutIdentity: string;