@forgeax/engine-render 0.1.23 → 0.1.24

package/src/assembly/material/assembly.ts

@@ -1,5 +1,9 @@
-import type { CookedMaterialRecord } from '@forgeax/engine-pack/material-cook';
-import type { MaterialValue } from '@forgeax/engine-types';
+import {
+  type CookedMaterialRecord,
+  materialLayerPlanIdentity,
+} from '@forgeax/engine-pack/material-cook';
+import type { MaterialValue, StandardLayerPlan } from '@forgeax/engine-types';
+import { projectStandardLayerPlan } from './standard-layer-projection.js';
 
 export interface MaterialRenderPassProjection {
   readonly name: string;
@@ -18,6 +22,7 @@ export interface MaterialRenderProjection {
   readonly passes: readonly MaterialRenderPassProjection[];
   readonly runtimeValues: Readonly<Record<string, MaterialValue | null>>;
   readonly staticSelection: readonly string[];
+  readonly layerPlan: StandardLayerPlan;
 }
 
 function projectPass(
@@ -37,6 +42,16 @@ function projectPass(
 }
 
 export function assembleMaterialProjection(record: CookedMaterialRecord): MaterialRenderProjection {
+  const layerPlan = projectStandardLayerPlan(record.resolved.parameters, record.resolved.passes);
+  const expectedLayerPlanIdentity = materialLayerPlanIdentity(record);
+  if (
+    expectedLayerPlanIdentity !== undefined &&
+    record.receipt.derivedInterface.layerPlanIdentity !== expectedLayerPlanIdentity
+  ) {
+    throw new Error(
+      `Standard material layer-plan identity mismatch: expected ${expectedLayerPlanIdentity}, got ${record.receipt.derivedInterface.layerPlanIdentity ?? 'missing'}`,
+    );
+  }
   return {
     materialGuid: record.guid,
     specializationKey: record.specializationKey ?? record.receipt.identity.programIdentity,
@@ -44,5 +59,6 @@ export function assembleMaterialProjection(record: CookedMaterialRecord): Materi
     passes: record.resolved.passes.map((pass) => projectPass(record, pass)),
     runtimeValues: record.resolved.values,
     staticSelection: [],
+    layerPlan,
   };
 }

package/src/assembly/material/standard-layer-projection.ts

@@ -0,0 +1,16 @@
+import type { MaterialParameter, MaterialPass, StandardLayerPlan } from '@forgeax/engine-types';
+import { deriveStandardLayerPlan } from '@forgeax/engine-types';
+
+/**
+ * Renderer projection of the compiler-owned Standard layer contract.
+ *
+ * The renderer receives the prepared parameter/pass snapshot and never keeps
+ * a second parameter-name inventory. This function is intentionally pure so
+ * assembly and tests observe the same mode and pass family as cooking.
+ */
+export function projectStandardLayerPlan(
+  parameters: readonly MaterialParameter[],
+  passes: readonly MaterialPass[],
+): StandardLayerPlan {
+  return deriveStandardLayerPlan(parameters, passes);
+}