@forgeax/engine-assets-runtime 0.1.7 → 0.1.20

package/dist/loaders/pack-artifact.d.ts

@@ -1,4 +1,26 @@
-import type { Loader } from '@forgeax/engine-types';
+import type { LoadContext, Loader, TextureAsset } from '@forgeax/engine-types';
+import { AssetError } from '@forgeax/engine-types';
+import { TexturePackVerificationError } from '../errors/asset.js';
+import type { PackLoaderInput } from '../loader-registry';
+export interface TexturePackLoadInput {
+    readonly pack: PackLoaderInput;
+    readonly sourceKey: string;
+    readonly generation: number;
+    readonly expectedDigest: string;
+}
+export type VerifiedTexturePack = {
+    readonly asset: TextureAsset;
+    readonly sourceKey: string;
+    readonly generation: number;
+    readonly digest: string;
+};
+export type VerifiedTexturePackResult = {
+    readonly ok: true;
+    readonly value: VerifiedTexturePack;
+} | {
+    readonly ok: false;
+    readonly error: TexturePackVerificationError | AssetError;
+};
 export type CodecContextFailure = {
     readonly code: 'basis-profile-unsupported';
     readonly detail: {
@@ -11,6 +33,8 @@ export type CodecContextFailure = {
         readonly dfdColorSpace: 'srgb' | 'linear' | 'unknown';
     };
 };
+/** Verify producer facts and then expose one accepted texture projection. */
+export declare function loadVerifiedTexturePack(input: TexturePackLoadInput, ctx: LoadContext): Promise<VerifiedTexturePackResult>;
 export declare const textureLoader: Loader;
 export declare const equirectLoader: Loader;
 export declare const fontLoader: Loader;

package/dist/loaders/pack-artifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-artifact.d.ts","sourceRoot":"","sources":["../../src/loaders/pack-artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAMV,MAAM,EAKP,MAAM,uBAAuB,CAAC;AA+L/B,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;KACvD,CAAC;CACH,CAAC;AAyXN,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAI5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAkBlC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MA0B3B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAMlD,CAAC"}
+{"version":3,"file":"pack-artifact.d.ts","sourceRoot":"","sources":["../../src/loaders/pack-artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAKV,WAAW,EACX,MAAM,EAGN,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAuB,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAEL,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,GAAG,UAAU,CAAA;CAAE,CAAC;AAkPtF,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;KACvD,CAAC;CACH,CAAC;AAkRN,6EAA6E;AAC7E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,yBAAyB,CAAC,CAiHpC;AA8GD,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAI5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAkBlC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MA0B3B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAMlD,CAAC"}

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

@@ -1,6 +1,31 @@
 import type { CookedMaterialRecord } from '@forgeax/engine-pack';
 import { AssetError, type MaterialAsset, type MaterialError } from '@forgeax/engine-types';
 import type { AssetRegistry } from '../asset-registry';
+export interface TexturePublicationStateSnapshot {
+    readonly guid: string;
+    readonly sourceKey: string;
+    readonly acceptedGeneration: number;
+    readonly acceptedDigest: string;
+    readonly candidateGeneration?: number;
+    readonly candidateFailure?: string;
+}
+export interface TexturePublicationState {
+    reject(candidate: {
+        readonly generation: number;
+        readonly reason: string;
+    }): TexturePublicationStateSnapshot;
+    accept(candidate: {
+        readonly generation: number;
+        readonly digest: string;
+    }): TexturePublicationStateSnapshot;
+}
+/** Candidate/accepted state that keeps the last known good publication honest. */
+export declare function createTexturePublicationState(input: {
+    readonly guid: string;
+    readonly sourceKey: string;
+    readonly generation: number;
+    readonly digest: string;
+}): TexturePublicationState;
 /**
  * Validate a MaterialAsset's passes[] against the ShaderRegistry's
  * paramSchema (union semantics: all declared params across all passes
@@ -15,6 +40,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,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,SAAS,EAAE;QAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,+BAA+B,CAAC;IACpC,MAAM,CAAC,SAAS,EAAE;QAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,+BAA+B,CAAC;CACrC;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,uBAAuB,CA0B1B;AAED;;;;;;;;;;;;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.20",
   "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.20",
+    "@forgeax/engine-ecs": "0.1.20",
+    "@forgeax/engine-geometry": "0.1.20",
+    "@forgeax/engine-graphics-extras": "0.1.20",
+    "@forgeax/engine-image": "0.1.20",
+    "@forgeax/engine-pack": "0.1.20",
+    "@forgeax/engine-plugin": "0.1.20",
+    "@forgeax/engine-rhi": "0.1.20",
+    "@forgeax/engine-scene": "0.1.20",
+    "@forgeax/engine-shader": "0.1.20",
+    "@forgeax/engine-types": "0.1.20",
+    "@forgeax/engine-ui": "0.1.20",
     "@webgpu/types": "^0.1.71"
   },
   "devDependencies": {
-    "@forgeax/engine-skinning": "0.1.7",
+    "@forgeax/engine-skinning": "0.1.20",
     "@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__/decode-image-bytes.browser.test.ts

@@ -30,7 +30,6 @@ import { World } from '@forgeax/engine-ecs';
 import type { TextureAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
 import { decodeImageBytes } from '../decode-image-bytes';
-import { numMipLevels } from '../mipmap-generator';
 
 // 1x1 red PNG (RGBA 8-bit). Universally decodable by browser createImageBitmap.
 const PNG_1X1_RED_BASE64 =
@@ -50,14 +49,13 @@ describe('decodeImageBytes browser real-PNG happy path (AC-01)', () => {
     if (!result.ok) return;
     const pod = result.value;
     expect(pod.kind).toBe('texture');
-    expect(pod.width).toBeGreaterThan(0);
-    expect(pod.height).toBeGreaterThan(0);
+    expect(pod.shape.extent.width).toBeGreaterThan(0);
+    expect(pod.shape.extent.height).toBeGreaterThan(0);
     // RGBA8 tight-packed: width * height * 4 bytes.
-    expect(pod.data.length).toBe(pod.width * pod.height * 4);
+    expect(pod.data.length).toBe(pod.shape.extent.width * pod.shape.extent.height * 4);
     expect(pod.format).toBe('rgba8unorm-srgb');
     expect(pod.colorSpace).toBe('srgb');
-    expect(pod.mipmap).toBe(true);
-    expect(pod.mipLevelCount).toBe(numMipLevels({ width: pod.width, height: pod.height }));
+    expect(pod.mips).toEqual({ kind: 'generate' });
   });
 
   it('AC-01: opts.colorSpace="linear" + opts.mipmap=false narrows format + mipLevelCount', async () => {
@@ -70,8 +68,7 @@ describe('decodeImageBytes browser real-PNG happy path (AC-01)', () => {
     const pod = result.value;
     expect(pod.format).toBe('rgba8unorm');
     expect(pod.colorSpace).toBe('linear');
-    expect(pod.mipmap).toBe(false);
-    expect(pod.mipLevelCount).toBe(1);
+    expect(pod.mips).toEqual({ kind: 'none' });
   });
 });
 

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__/pack-basis-load.integration.test.ts

@@ -1,3 +1,4 @@
+import { createHash } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import type { LoadContext, TextureAsset } from '@forgeax/engine-types';
@@ -7,7 +8,11 @@ import type {
   BasisModuleFactory,
 } from '../../../codec/src/wasm/basis-types.js';
 import type { CodecContextFailure } from '../loaders/pack-artifact.js';
-import { PACK_ARTIFACT_LOADERS, textureLoader } from '../loaders/pack-artifact.js';
+import {
+  loadVerifiedTexturePack,
+  PACK_ARTIFACT_LOADERS,
+  textureLoader,
+} from '../loaders/pack-artifact.js';
 
 const TRANSCODER_GLUE = new URL('../../../codec/pkg/basis_transcoder.mjs', import.meta.url);
 const ENCODER_GLUE = new URL('../../../codec/pkg/encode/basis_encoder.mjs', import.meta.url);
@@ -52,6 +57,10 @@ const context: LoadContext = {
   device: undefined,
 };
 
+function digest(bytes: Uint8Array): string {
+  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+}
+
 describe.skipIf(!pkgBuilt)('Pack runtime raw Basis loader', () => {
   it('keeps context failure code and detail correlated as a closed union', () => {
     type ExpectedContextFailure =
@@ -79,7 +88,11 @@ describe.skipIf(!pkgBuilt)('Pack runtime raw Basis loader', () => {
       {
         guid: '019f0000-0000-7000-8000-000000000304',
         kind: 'texture',
-        payload: { width: 4, height: 4, colorSpace: 'linear' },
+        payload: {
+          shape: { viewDimension: '2d', extent: { width: 4, height: 4 } },
+          colorSpace: 'linear',
+          mips: { kind: 'none' },
+        },
         refs: [],
         artifacts: {
           body: {
@@ -101,12 +114,10 @@ describe.skipIf(!pkgBuilt)('Pack runtime raw Basis loader', () => {
     if (!result.ok) return;
     expect(result.value).toMatchObject({
       kind: 'texture',
-      width: 4,
-      height: 4,
+      shape: { viewDimension: '2d', extent: { width: 4, height: 4 } },
       format: 'rgba8unorm',
       colorSpace: 'linear',
-      mipmap: false,
-      mipLevelCount: 1,
+      mips: { kind: 'packed', levelCount: 1 },
     });
     expect(result.value.data.byteLength).toBeGreaterThan(0);
   });
@@ -119,7 +130,11 @@ describe.skipIf(!pkgBuilt)('Pack runtime raw Basis loader', () => {
       {
         guid: '019f0000-0000-7000-8000-000000000305',
         kind: 'texture',
-        payload: { width: 4, height: 4, colorSpace: 'srgb' },
+        payload: {
+          shape: { viewDimension: '2d', extent: { width: 4, height: 4 } },
+          colorSpace: 'srgb',
+          mips: { kind: 'none' },
+        },
         refs: [],
         artifacts: {
           body: {
@@ -165,4 +180,48 @@ describe('Pack artifact loader matrix', () => {
       ['equirect', 'font', 'render-pipeline', 'texture', 'tileset'].sort(),
     );
   });
+
+  it('preserves array shape and generation provenance through verified loading', async () => {
+    const bytes = new Uint8Array(8 * 4 * 3).fill(91);
+    const artifactDigest = digest(bytes);
+    const result = await loadVerifiedTexturePack(
+      {
+        sourceKey: 'array/layers',
+        generation: 4,
+        expectedDigest: artifactDigest,
+        pack: {
+          guid: '019f0000-0000-7000-8000-000000000306',
+          kind: 'texture',
+          payload: {
+            shape: { viewDimension: '2d-array', extent: { width: 8, height: 4, layers: 3 } },
+            format: 'r8unorm',
+            colorSpace: 'linear',
+            mips: { kind: 'none' },
+          },
+          refs: [],
+          artifacts: {
+            body: {
+              bytes,
+              descriptor: {
+                path: 'array.raw',
+                mediaType: 'application/x-forgeax-r8',
+                byteLength: bytes.byteLength,
+                integrity: { algorithm: 'sha256', digest: artifactDigest },
+              },
+            },
+          },
+        },
+      },
+      context,
+    );
+
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    expect(result.value.asset.shape).toEqual({
+      viewDimension: '2d-array',
+      extent: { width: 8, height: 4, layers: 3 },
+    });
+    expect(result.value.generation).toBe(4);
+    expect(result.value.sourceKey).toBe('array/layers');
+  });
 });