@forgeax/engine-assets-runtime 0.1.6 → 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,CAkBtB;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.6",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -26,22 +26,22 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-codec": "0.1.6",
-    "@forgeax/engine-ecs": "0.1.6",
-    "@forgeax/engine-geometry": "0.1.6",
-    "@forgeax/engine-graphics-extras": "0.1.6",
-    "@forgeax/engine-image": "0.1.6",
-    "@forgeax/engine-pack": "0.1.6",
-    "@forgeax/engine-plugin": "0.1.6",
-    "@forgeax/engine-rhi": "0.1.6",
-    "@forgeax/engine-scene": "0.1.6",
-    "@forgeax/engine-shader": "0.1.6",
-    "@forgeax/engine-types": "0.1.6",
-    "@forgeax/engine-ui": "0.1.6",
+    "@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.6",
+    "@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';
@@ -19,7 +20,7 @@ const PRODUCTION_GUID = '019f0000-0000-7000-8000-000000000701';
 function cookedRecord(guid = MATERIAL_GUID): CookedMaterialRecord {
   const artifactDigest = createMaterialArtifactDigest(ARTIFACT_BYTES);
   return {
-    schemaVersion: 'material-cook/2',
+    schemaVersion: 'material-cook/3',
     guid,
     materialGuid: guid,
     publicationGeneration: 7,
@@ -36,15 +37,31 @@ function cookedRecord(guid = MATERIAL_GUID): CookedMaterialRecord {
       bytes: ARTIFACT_BYTES,
     },
     receipt: {
-      schemaVersion: 'material-cook/2',
+      schemaVersion: 'material-cook/3',
       sourceClosure: ['materials/ready.material.json', 'shaders/ready.wgsl'],
       profile: 'webgpu/v1',
       compilerVersion: 'compiler/1',
-      inputDigest: 'input-digest',
-      outputDigest: artifactDigest,
-      layoutIdentity: 'sha256:ready-layout',
+      identity: {
+        materialContractDigest: 'sha256:ready-contract',
+        sourceRevision: 'sha256:ready-source',
+        sourceClosureDigest: 'sha256:ready-closure',
+        layoutIdentity: 'sha256:ready-layout',
+        programIdentity: 'sha256:ready-program',
+        pipelineIdentity: 'sha256:ready-pipeline',
+        materialPublicationIdentity: 'sha256:ready-publication',
+        cookIdentity: 'sha256:ready-cook',
+        compilerFingerprint: 'sha256:ready-compiler',
+        wasm: {
+          sourceContentKey: 'unavailable',
+          artifactSha256: 'unavailable',
+          glueSha256: 'unavailable',
+        },
+        artifactDigest,
+        valueGeneration: 7,
+        dependencyGeneration: 7,
+        cookGeneration: 7,
+      },
       derivedInterface: { layoutIdentity: 'sha256:ready-layout' },
-      publicationGeneration: 7,
     },
   };
 }
@@ -87,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__/material-stale-generation.unit.test.ts

@@ -30,7 +30,6 @@ function createCookedMaterialLoader() {
         guid,
         record: {
           ...raw,
-          schemaVersion: 'material-cook/2',
           materialGuid: raw.guid,
           publicationGeneration: 1,
           specializationKey: SPECIALIZATION_KEY,
@@ -40,11 +39,7 @@ function createCookedMaterialLoader() {
           artifact: { ...raw.artifact, digest, bytes },
           receipt: {
             ...raw.receipt,
-            schemaVersion: 'material-cook/2',
-            layoutIdentity: 'sha256:pulse-layout',
-            derivedInterface: { layoutIdentity: 'sha256:pulse-layout' },
-            publicationGeneration: 1,
-            outputDigest: digest,
+            identity: { ...raw.receipt.identity, artifactDigest: digest, cookGeneration: 1 },
           },
         },
         artifact: { bytes },

package/src/__tests__/resolve-asset-handle.unit.test.ts

@@ -167,7 +167,7 @@ describe('walkMaterialPassesOverSharedRefs', () => {
     const child = mat({
       parent: 'p-guid' as never,
       parameters: [
-        { name: 'roughness', type: 'f32', static: true },
+        { name: 'roughness', type: 'f32' },
         { name: 'normalTexture', type: 'texture' },
       ],
     });

package/src/__tests__/scriptable-pack-public-surface.test-d.ts

@@ -1,8 +1,10 @@
 import type {
   AnimationGraph,
   AssetRegistry,
+  AssetRegistryResolver,
   AudioClipAsset,
   ParticleEffectAsset,
+  RuntimeAssetRegistry,
   TilesetAsset,
 } from '@forgeax/engine-assets-runtime';
 import { expectTypeOf, it } from 'vitest';
@@ -14,3 +16,12 @@ it('exports concrete loadByGuid payload types from the runtime entry point', ()
   expectTypeOf<AudioClipAsset['mediaType']>().toMatchTypeOf<`audio/${string}`>();
   expectTypeOf<ParticleEffectAsset['program']>().toMatchTypeOf<ParticleEffectAsset['program']>();
 });
+
+it('exports the five-action runtime registry and its resolver from the root entry point', () => {
+  expectTypeOf<RuntimeAssetRegistry>().toHaveProperty('installDecoder');
+  expectTypeOf<RuntimeAssetRegistry>().toHaveProperty('load');
+  expectTypeOf<RuntimeAssetRegistry>().toHaveProperty('snapshot');
+  expectTypeOf<RuntimeAssetRegistry>().toHaveProperty('subscribe');
+  expectTypeOf<AssetRegistryResolver>().toHaveProperty('lookup');
+  expectTypeOf<AssetRegistryResolver>().toHaveProperty('guidOf');
+});

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

@@ -18,6 +18,7 @@ import {
   materialShaderTextureFieldNames,
   validateMaterialCookIdentity,
   validateMaterialPasses,
+  validateMaterialTransmissionContract,
   validateParamType,
   validateSpriteSlices,
 } from '../registry/validate-material';
@@ -64,7 +65,7 @@ describe('validateMaterialCookIdentity', () => {
   const record = {
     guid: 'mat-child',
     receipt: {
-      layoutIdentity: 'sha256:root-layout',
+      identity: { layoutIdentity: 'sha256:root-layout' },
       derivedInterface: { layoutIdentity: 'sha256:root-layout' },
     },
   } as never;
@@ -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/asset-registry.ts

@@ -611,6 +611,11 @@ export class AssetRegistry {
     return this._originIndex.get(asset as object);
   }
 
+  /** Public identity projection consumed by scene collection boundaries. */
+  guidOf(asset: Asset): string | undefined {
+    return this._guidForAsset(asset);
+  }
+
   /** Return the production MaterialReady/Error result for one material GUID. */
   getMaterialReadiness(guid: string): MaterialReady | MaterialLoadError | undefined {
     return this.materialReadiness.get(guid.toLowerCase());

package/src/handles.ts

@@ -3,7 +3,7 @@
 // straight-cut). Pure move from asset-registry.ts; zero identifier changes.
 
 import type { Handle } from '@forgeax/engine-types';
-import { toShared } from '@forgeax/engine-types';
+import { handleSlot, toShared } from '@forgeax/engine-types';
 
 // ─── Builtin handles (D-S9 / backward compat with hello-triangle + hello-cube) ─
 
@@ -146,6 +146,12 @@ export const BUILTIN_MESH_GUIDS: ReadonlyArray<readonly [Handle<'MeshAsset', 'sh
   [HANDLE_CYLINDER, 'ab20af21-0764-55be-a7f2-b80ab3d46a0a'],
 ];
 
+/** Resolve the stable producer GUID for one process-static builtin mesh handle. */
+export function builtinMeshGuid(handle: Handle<string, 'shared'>): string | undefined {
+  const slot = handleSlot(handle);
+  return BUILTIN_MESH_GUIDS.find(([candidate]) => handleSlot(candidate) === slot)?.[1];
+}
+
 /**
  * Field names known to carry handle<> schema-vocab references (plan-strategy
  * D-4).  parseScenePayload uses this allowlist to replace integer values

package/src/index.ts

@@ -76,6 +76,7 @@ export {
 } from './errors/asset';
 // ─── Builtin mesh handles (re-exported by asset-registry from ./handles) ─────
 export {
+  builtinMeshGuid,
   HANDLE_CUBE,
   HANDLE_CYLINDER,
   HANDLE_NINESLICE_QUAD,
@@ -83,7 +84,15 @@ export {
   HANDLE_SPHERE,
   HANDLE_TRIANGLE,
 } from './handles';
-export { createAssetRegistry } from './internal/load-asset.js';
+// The five-action runtime registry is distinct from the legacy authoring
+// AssetRegistry class above. Keep its resolver on the public package boundary
+// so render/VFX hosts never reach through `/internal` to inspect loaded assets.
+export {
+  type AssetRegistry as RuntimeAssetRegistry,
+  type AssetRegistryResolver,
+  createAssetRegistry,
+  getAssetRegistryResolver,
+} from './internal/load-asset.js';
 // ─── Loader-injection surface ───────────────────────────────────────────────
 export { LoaderRegistry } from './loader-registry';
 // ─── Default loader tables + individual loaders (pre-w14 consumer face) ──────
@@ -134,6 +143,7 @@ export {
 // ─── Mipmap generation helpers ──────────────────────────────────────────────
 export {
   blitMipmapsSync,
+  encodeMipmapLevel,
   getOrCreateMipmapPipeline,
   type MipmapBlitDevice,
   type MipmapShaderModuleFactory,
@@ -148,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/material/inspection.ts

@@ -29,7 +29,7 @@ export function inspectMaterialRuntime(ready: MaterialReady): MaterialRuntimeInf
     publicationGeneration: ready.publicationGeneration,
     specializationKey: ready.specializationKey,
     artifactDigest: ready.artifactDigest,
-    layoutIdentity: ready.record.receipt.layoutIdentity,
+    layoutIdentity: ready.record.receipt.identity.layoutIdentity,
     dependencies: [
       ...ready.record.refs.parent,
       ...ready.record.refs.textures,

package/src/material/loader.ts

@@ -108,7 +108,7 @@ function missingCook(request: MaterialLoadRequest): MaterialLoadError {
 function recordError(
   request: MaterialLoadRequest,
   field: string,
-  expected = 'a complete material-cook/2 publication record',
+  expected = 'a complete material-cook/3 publication record',
 ): MaterialLoadError {
   return materialError(
     request,
@@ -174,18 +174,18 @@ function completeTupleField(record: CookedMaterialRecord): string | undefined {
     receipt.profile.length === 0 ||
     typeof receipt.compilerVersion !== 'string' ||
     receipt.compilerVersion.length === 0 ||
-    typeof receipt.inputDigest !== 'string' ||
-    receipt.inputDigest.length === 0 ||
-    receipt.outputDigest !== record.artifactDigest ||
-    receipt.publicationGeneration !== record.publicationGeneration
+    typeof receipt.identity.cookIdentity !== 'string' ||
+    receipt.identity.cookIdentity.length === 0 ||
+    receipt.identity.artifactDigest !== record.artifactDigest ||
+    receipt.identity.cookGeneration !== record.publicationGeneration
   )
     return 'receipt';
   if (
-    typeof receipt.layoutIdentity !== 'string' ||
-    receipt.layoutIdentity.length === 0 ||
-    receipt.derivedInterface?.layoutIdentity !== receipt.layoutIdentity
+    typeof receipt.identity.layoutIdentity !== 'string' ||
+    receipt.identity.layoutIdentity.length === 0 ||
+    receipt.derivedInterface?.layoutIdentity !== receipt.identity.layoutIdentity
   )
-    return 'receipt.layoutIdentity';
+    return 'receipt.identity.layoutIdentity';
   if (
     typeof record.artifact.mediaType !== 'string' ||
     record.artifact.mediaType.length === 0 ||