@forgeax/engine-pack 0.1.23 → 0.1.25

package/dist/material-cook.d.ts

@@ -1,2 +1,2 @@
-export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, type MaterialCookArtifact, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, type MaterialCookWasmProvenance, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, } from './evidence/material-cook.js';
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, type MaterialCookArtifact, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, type MaterialCookVariant, type MaterialCookVariantContext, type MaterialCookWasmProvenance, materialLayerPlanIdentity, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, } from './evidence/material-cook.js';
 //# sourceMappingURL=material-cook.d.ts.map

package/dist/material-cook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material-cook.d.ts","sourceRoot":"","sources":["../src/material-cook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"material-cook.d.ts","sourceRoot":"","sources":["../src/material-cook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC"}

package/dist/material-cook.mjs

@@ -1,8 +1,27 @@
-import { MATERIAL_TEXTURE_SLOTS, ok, err } from '@forgeax/engine-types';
+import { deriveStandardLayerPlan, MATERIAL_TEXTURE_SLOTS, ok, err } from '@forgeax/engine-types';
 import { sha256 } from '@noble/hashes/sha2.js';
 import { bytesToHex } from '@noble/hashes/utils.js';
 
 // src/evidence/material-cook.ts
+var STANDARD_ROOT_MODULES = /* @__PURE__ */ new Set([
+  "forgeax::default-standard-pbr",
+  "forgeax::pbr-skin",
+  "forgeax_material::standard",
+  "forgeax_material::pbr-skin",
+  "forgeax::default-shadow-caster"
+]);
+function isStandardRootModule(module) {
+  return STANDARD_ROOT_MODULES.has(module);
+}
+function isStandardMaterialRecord(record) {
+  return record.resolved.passes.some((pass) => isStandardRootModule(pass.program.module));
+}
+function materialLayerPlanIdentity(record) {
+  if (!isStandardMaterialRecord(record)) {
+    return void 0;
+  }
+  return deriveStandardLayerPlan(record.resolved.parameters, record.resolved.passes).identity;
+}
 function unique(values) {
   return [...new Set(values)].sort();
 }
@@ -97,6 +116,14 @@ function invalid(field, actual) {
     }
   });
 }
+function normalizeArtifactBytes(value) {
+  if (Array.isArray(value)) {
+    return value.every((byte) => Number.isInteger(byte) && byte >= 0 && byte <= 255) ? Uint8Array.from(value) : void 0;
+  }
+  if (!ArrayBuffer.isView(value)) return void 0;
+  const view = value;
+  return new Uint8Array(view.buffer, view.byteOffset, view.byteLength).slice();
+}
 var IDENTITY_FIELDS = [
   "materialContractDigest",
   "sourceRevision",
@@ -153,6 +180,12 @@ function validateMaterialCookReceipt(value, expected = {}) {
   if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {
     return invalid("receipt.derivedInterface.layoutIdentity", derivedInterface.layoutIdentity);
   }
+  if (derivedInterface.layerPlanIdentity !== void 0 && (typeof derivedInterface.layerPlanIdentity !== "string" || derivedInterface.layerPlanIdentity.length === 0)) {
+    return invalid(
+      "receipt.derivedInterface.layerPlanIdentity",
+      derivedInterface.layerPlanIdentity
+    );
+  }
   for (const field of ["sourceClosure", "profile", "compilerVersion"]) {
     const fieldValue = candidate[field];
     if (field === "sourceClosure" && !Array.isArray(fieldValue) || field !== "sourceClosure" && typeof fieldValue !== "string") {
@@ -178,7 +211,10 @@ function validateMaterialCookReceipt(value, expected = {}) {
     profile: candidate.profile,
     compilerVersion: candidate.compilerVersion,
     identity,
-    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity }
+    derivedInterface: {
+      layoutIdentity: derivedInterface.layoutIdentity,
+      ...derivedInterface.layerPlanIdentity === void 0 ? {} : { layerPlanIdentity: derivedInterface.layerPlanIdentity }
+    }
   });
 }
 function validateCookedMaterialRecord(value) {
@@ -193,6 +229,33 @@ function validateCookedMaterialRecord(value) {
     return invalid("publicationGeneration", candidate.publicationGeneration);
   if (candidate.specializationKey !== void 0 && typeof candidate.specializationKey !== "string")
     return invalid("specializationKey");
+  if (candidate.variantContext !== void 0) {
+    if (candidate.variantContext === null || typeof candidate.variantContext !== "object")
+      return invalid("variantContext");
+    const context = candidate.variantContext;
+    if (context.backend !== "webgpu" && context.backend !== "webgl2" && context.backend !== "wgpu-native" || context.capability !== "storage-buffer" && context.capability !== "uniform-fallback")
+      return invalid("variantContext", candidate.variantContext);
+  }
+  if (candidate.variants !== void 0) {
+    if (!Array.isArray(candidate.variants)) return invalid("variants");
+    for (const [index, value2] of candidate.variants.entries()) {
+      if (value2 === null || typeof value2 !== "object") return invalid(`variants[${index}]`);
+      const variant = value2;
+      const context = variant.context;
+      if (context === null || typeof context !== "object")
+        return invalid(`variants[${index}].context`);
+      const contextRecord = context;
+      if (contextRecord.backend !== "webgpu" && contextRecord.backend !== "webgl2" && contextRecord.backend !== "wgpu-native" || contextRecord.capability !== "storage-buffer" && contextRecord.capability !== "uniform-fallback")
+        return invalid(`variants[${index}].context`, context);
+      if (typeof variant.specializationKey !== "string" || variant.specializationKey.length === 0)
+        return invalid(`variants[${index}].specializationKey`);
+      if (variant.artifact === null || typeof variant.artifact !== "object")
+        return invalid(`variants[${index}].artifact`);
+      const variantArtifact = variant.artifact;
+      if (typeof variantArtifact.mediaType !== "string" || typeof variantArtifact.path !== "string" || typeof variantArtifact.digest !== "string" || normalizeArtifactBytes(variantArtifact.bytes) === void 0)
+        return invalid(`variants[${index}].artifact`);
+    }
+  }
   if (candidate.artifactDigest !== void 0 && typeof candidate.artifactDigest !== "string")
     return invalid("artifactDigest");
   if (candidate.sourceClosure !== void 0 && (!Array.isArray(candidate.sourceClosure) || candidate.sourceClosure.some((path) => typeof path !== "string")))
@@ -221,6 +284,26 @@ function validateCookedMaterialRecord(value) {
     artifactDigest: artifact.digest
   });
   if (!receiptResult.ok) return receiptResult;
+  const resolved = candidate.resolved;
+  if (!Array.isArray(resolved.passes)) return invalid("resolved.passes", resolved.passes);
+  if (!Array.isArray(resolved.parameters))
+    return invalid("resolved.parameters", resolved.parameters);
+  if (resolved.values === null || typeof resolved.values !== "object" || Array.isArray(resolved.values))
+    return invalid("resolved.values", resolved.values);
+  let expectedLayerPlanIdentity;
+  try {
+    expectedLayerPlanIdentity = materialLayerPlanIdentity({
+      resolved
+    });
+  } catch (error) {
+    return invalid("resolved.layerPlanIdentity", error instanceof Error ? error.message : error);
+  }
+  if (expectedLayerPlanIdentity !== void 0 && receiptResult.value.derivedInterface.layerPlanIdentity !== expectedLayerPlanIdentity) {
+    return invalid(
+      "receipt.derivedInterface.layerPlanIdentity",
+      receiptResult.value.derivedInterface.layerPlanIdentity
+    );
+  }
   if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== artifact.digest)
     return invalid("artifactDigest", candidate.artifactDigest);
   if (candidate.publicationGeneration !== void 0 && receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration)
@@ -229,8 +312,21 @@ function validateCookedMaterialRecord(value) {
     ...candidate,
     artifact: {
       ...artifact,
-      bytes: ArrayBuffer.isView(artifact.bytes) ? Uint8Array.from(artifact.bytes) : Uint8Array.from(artifact.bytes)
+      bytes: normalizeArtifactBytes(artifact.bytes)
     },
+    ...Array.isArray(candidate.variants) ? {
+      variants: candidate.variants.map((value2) => {
+        const variant = value2;
+        const variantArtifact = variant.artifact;
+        return {
+          ...variant,
+          artifact: {
+            ...variantArtifact,
+            bytes: normalizeArtifactBytes(variantArtifact.bytes)
+          }
+        };
+      })
+    } : {},
     receipt: receiptResult.value
   };
   return ok(normalized);
@@ -240,11 +336,13 @@ function projectCookedMaterialRecord(record) {
     resolved: record.resolved,
     refs: record.refs,
     artifact: record.artifact,
+    ...record.variantContext === void 0 ? {} : { variantContext: record.variantContext },
+    ...record.variants === void 0 ? {} : { variants: record.variants },
     receipt: record.receipt,
     schemaVersion: record.schemaVersion
   };
 }
 
-export { collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord };
+export { collectMaterialCookRefs, createMaterialArtifactDigest, createMaterialCookIdentity, materialLayerPlanIdentity, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord };
 //# sourceMappingURL=material-cook.mjs.map
 //# sourceMappingURL=material-cook.mjs.map

package/dist/material-cook.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/evidence/material-cook.ts"],"names":[],"mappings":"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","file":"material-cook.mjs","sourcesContent":["import type {\n  MaterialAsset,\n  MaterialParameter,\n  MaterialPass,\n  MaterialTextureReference,\n  MaterialTextureValue,\n  MaterialValue,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, MATERIAL_TEXTURE_SLOTS, ok } from '@forgeax/engine-types';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex } from '@noble/hashes/utils.js';\n\nexport interface MaterialCookRefs {\n  readonly parent: readonly string[];\n  readonly textures: readonly string[];\n  readonly samplers: readonly string[];\n  readonly modules: readonly string[];\n}\n\nexport interface MaterialCookArtifact {\n  readonly mediaType: string;\n  readonly path: string;\n  readonly digest: string;\n  readonly bytes: Uint8Array;\n}\n\nexport interface MaterialCookWasmProvenance {\n  readonly sourceContentKey: string;\n  readonly artifactSha256: string;\n  readonly glueSha256: string;\n}\n\nexport interface MaterialCookIdentity {\n  readonly materialContractDigest: string;\n  readonly sourceRevision: string;\n  readonly sourceClosureDigest: string;\n  readonly layoutIdentity: string;\n  readonly programIdentity: string;\n  readonly pipelineIdentity: string;\n  readonly materialPublicationIdentity: string;\n  readonly cookIdentity: string;\n  readonly compilerFingerprint: string;\n  readonly wasm: MaterialCookWasmProvenance;\n  readonly artifactDigest: string;\n  readonly valueGeneration: number;\n  readonly dependencyGeneration: number;\n  readonly cookGeneration: number;\n}\n\nexport type MaterialCookIdentityInput = Omit<MaterialCookIdentity, 'cookIdentity'>;\n\nexport interface MaterialCookReceipt {\n  readonly schemaVersion: 'material-cook/3';\n  readonly sourceClosure: readonly string[];\n  readonly profile: string;\n  readonly compilerVersion: string;\n  readonly identity: MaterialCookIdentity;\n  readonly derivedInterface: { readonly layoutIdentity: string };\n}\n\nexport interface MaterialParameterContract {\n  readonly parameters: readonly MaterialParameter[];\n  readonly values: Readonly<Record<string, MaterialValue | null>>;\n}\n\nexport interface CookedMaterialRecord {\n  readonly schemaVersion: 'material-cook/3';\n  readonly guid: string;\n  readonly authored?: MaterialAsset;\n  readonly materialGuid?: string;\n  readonly publicationGeneration?: number;\n  readonly specializationKey?: string;\n  readonly artifactDigest?: string;\n  readonly sourceClosure?: readonly string[];\n  readonly parameterContract?: MaterialParameterContract;\n  readonly resolved: {\n    readonly passes: readonly MaterialPass[];\n    readonly parameters: readonly MaterialParameter[];\n    readonly values: Readonly<Record<string, MaterialValue | null>>;\n  };\n  readonly refs: MaterialCookRefs;\n  readonly artifact: MaterialCookArtifact;\n  readonly receipt: MaterialCookReceipt;\n}\n\nexport interface MaterialCookRecordError {\n  readonly code: 'material-cook-record-invalid';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: {\n    readonly field: string;\n    readonly actual?: unknown;\n    readonly action: string;\n  };\n}\n\nexport interface MaterialCookIdentityExpectation {\n  readonly layoutIdentity?: string;\n  readonly artifactDigest?: string;\n  readonly inputDigest?: string;\n}\n\nfunction unique(values: readonly string[]): readonly string[] {\n  return [...new Set(values)].sort();\n}\n\nfunction guidText(value: string | Uint8Array): string {\n  return typeof value === 'string'\n    ? value\n    : Array.from(value, (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\nfunction cookGuidText(value: MaterialTextureReference): string | undefined {\n  return typeof value === 'number' ? undefined : guidText(value);\n}\n\nfunction textureValues(\n  values: Readonly<Record<string, MaterialValue | null>> | undefined,\n  textureFields: ReadonlySet<string>,\n): readonly MaterialTextureValue[] {\n  return Object.entries(values ?? {}).flatMap(([name, value]) => {\n    if (value === null) return [];\n    if (typeof value === 'string') {\n      return textureFields.has(name) ? [{ texture: value }] : [];\n    }\n    return value !== null &&\n      typeof value === 'object' &&\n      !Array.isArray(value) &&\n      'texture' in value\n      ? [value as MaterialTextureValue]\n      : [];\n  });\n}\n\nexport function collectMaterialCookRefs(material: Partial<MaterialAsset>): MaterialCookRefs {\n  const textureFields =\n    material.parameters === undefined\n      ? new Set<string>(MATERIAL_TEXTURE_SLOTS)\n      : new Set(\n          material.parameters\n            .filter(\n              (parameter) => parameter.type === 'texture' || parameter.type === 'texture_cube',\n            )\n            .map((parameter) => parameter.name),\n        );\n  const textures = textureValues(material.values, textureFields);\n  return {\n    parent: material.parent ? [guidText(material.parent)] : [],\n    textures: unique(\n      textures.flatMap((value) => {\n        const guid = cookGuidText(value.texture);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    samplers: unique(\n      textures.flatMap((value) => {\n        if (value.sampler === undefined) return [];\n        const guid = cookGuidText(value.sampler);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    modules: unique((material.passes ?? []).map((pass) => pass.program.module)),\n  };\n}\n\nexport function createMaterialArtifactDigest(bytes: Uint8Array): string {\n  return `sha256:${bytesToHex(sha256(bytes))}`;\n}\n\nfunction jsonValue(value: unknown): unknown {\n  if (value instanceof Uint8Array) return [...value];\n  if (Array.isArray(value)) return value.map(jsonValue);\n  if (value !== null && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([key, entry]) => [key, jsonValue(entry)]),\n    );\n  }\n  return value;\n}\n\nexport function createMaterialCookIdentity(input: MaterialCookIdentityInput): MaterialCookIdentity {\n  const cookIdentity = createMaterialArtifactDigest(\n    new TextEncoder().encode(\n      JSON.stringify(\n        jsonValue({\n          materialContractDigest: input.materialContractDigest,\n          sourceRevision: input.sourceRevision,\n          sourceClosureDigest: input.sourceClosureDigest,\n          layoutIdentity: input.layoutIdentity,\n          programIdentity: input.programIdentity,\n          pipelineIdentity: input.pipelineIdentity,\n          compilerFingerprint: input.compilerFingerprint,\n          wasm: input.wasm,\n          artifactDigest: input.artifactDigest,\n        }),\n      ),\n    ),\n  );\n  return { ...input, cookIdentity };\n}\n\nexport function serializeCookedMaterialRecord(record: CookedMaterialRecord): string {\n  return JSON.stringify(jsonValue(record));\n}\n\nexport function serializeMaterialCookReceipt(receipt: MaterialCookReceipt): string {\n  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));\n}\n\nfunction invalid(field: string, actual?: unknown): Result<never, MaterialCookRecordError> {\n  return err({\n    code: 'material-cook-record-invalid',\n    expected: 'a complete material-cook/3 record with layered identity and provenance',\n    hint: 're-cook the material and publish its record, artifact, references, and receipt together',\n    detail: {\n      field,\n      ...(actual === undefined ? {} : { actual }),\n      action: 'inspect the named field and recook the material generation',\n    },\n  });\n}\n\nconst IDENTITY_FIELDS = [\n  'materialContractDigest',\n  'sourceRevision',\n  'sourceClosureDigest',\n  'layoutIdentity',\n  'programIdentity',\n  'pipelineIdentity',\n  'materialPublicationIdentity',\n  'cookIdentity',\n  'compilerFingerprint',\n  'artifactDigest',\n] as const;\n\nfunction isGeneration(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 1;\n}\n\nfunction validateIdentity(value: unknown): Result<MaterialCookIdentity, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt.identity', value);\n  const candidate = value as Record<string, unknown>;\n  for (const field of IDENTITY_FIELDS) {\n    if (typeof candidate[field] !== 'string' || candidate[field].length === 0) {\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n    }\n  }\n  if (candidate.wasm === null || typeof candidate.wasm !== 'object') {\n    return invalid('receipt.identity.wasm', candidate.wasm);\n  }\n  const wasm = candidate.wasm as Record<string, unknown>;\n  for (const field of ['sourceContentKey', 'artifactSha256', 'glueSha256']) {\n    if (typeof wasm[field] !== 'string' || wasm[field].length === 0) {\n      return invalid(`receipt.identity.wasm.${field}`, wasm[field]);\n    }\n  }\n  for (const field of ['valueGeneration', 'dependencyGeneration', 'cookGeneration']) {\n    if (!isGeneration(candidate[field]))\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n  }\n  return ok({\n    ...candidate,\n    wasm: wasm as unknown as MaterialCookWasmProvenance,\n  } as MaterialCookIdentity);\n}\n\nexport function validateMaterialCookReceipt(\n  value: unknown,\n  expected: MaterialCookIdentityExpectation = {},\n): Result<MaterialCookReceipt, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('receipt.schemaVersion', candidate.schemaVersion);\n  const identityResult = validateIdentity(candidate.identity);\n  if (!identityResult.ok) return identityResult;\n  const identity = identityResult.value;\n  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== 'object') {\n    return invalid('receipt.derivedInterface', candidate.derivedInterface);\n  }\n  const derivedInterface = candidate.derivedInterface as Record<string, unknown>;\n  if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {\n    return invalid('receipt.derivedInterface.layoutIdentity', derivedInterface.layoutIdentity);\n  }\n  for (const field of ['sourceClosure', 'profile', 'compilerVersion']) {\n    const fieldValue = candidate[field];\n    if (\n      (field === 'sourceClosure' && !Array.isArray(fieldValue)) ||\n      (field !== 'sourceClosure' && typeof fieldValue !== 'string')\n    ) {\n      return invalid(`receipt.${field}`, fieldValue);\n    }\n  }\n  const sourceClosure = candidate.sourceClosure;\n  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== 'string')) {\n    return invalid('receipt.sourceClosure', sourceClosure);\n  }\n  if (\n    expected.layoutIdentity !== undefined &&\n    identity.layoutIdentity !== expected.layoutIdentity\n  ) {\n    return invalid('receipt.identity.layoutIdentity', identity.layoutIdentity);\n  }\n  if (\n    expected.artifactDigest !== undefined &&\n    identity.artifactDigest !== expected.artifactDigest\n  ) {\n    return invalid('receipt.identity.artifactDigest', identity.artifactDigest);\n  }\n  if (expected.inputDigest !== undefined && identity.cookIdentity !== expected.inputDigest) {\n    return invalid('receipt.identity.cookIdentity', identity.cookIdentity);\n  }\n  return ok({\n    schemaVersion: 'material-cook/3',\n    sourceClosure: candidate.sourceClosure as string[],\n    profile: candidate.profile as string,\n    compilerVersion: candidate.compilerVersion as string,\n    identity,\n    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity as string },\n  });\n}\n\nexport function validateCookedMaterialRecord(\n  value: unknown,\n): Result<CookedMaterialRecord, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('record');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('schemaVersion', candidate.schemaVersion);\n  if (typeof candidate.guid !== 'string' || !candidate.guid) return invalid('guid');\n  if (candidate.materialGuid !== undefined && typeof candidate.materialGuid !== 'string')\n    return invalid('materialGuid');\n  if (\n    candidate.publicationGeneration !== undefined &&\n    !isGeneration(candidate.publicationGeneration)\n  )\n    return invalid('publicationGeneration', candidate.publicationGeneration);\n  if (candidate.specializationKey !== undefined && typeof candidate.specializationKey !== 'string')\n    return invalid('specializationKey');\n  if (candidate.artifactDigest !== undefined && typeof candidate.artifactDigest !== 'string')\n    return invalid('artifactDigest');\n  if (\n    candidate.sourceClosure !== undefined &&\n    (!Array.isArray(candidate.sourceClosure) ||\n      candidate.sourceClosure.some((path) => typeof path !== 'string'))\n  )\n    return invalid('sourceClosure');\n  if (candidate.parameterContract !== undefined) {\n    if (candidate.parameterContract === null || typeof candidate.parameterContract !== 'object')\n      return invalid('parameterContract');\n    const parameterContract = candidate.parameterContract as Record<string, unknown>;\n    if (!Array.isArray(parameterContract.parameters))\n      return invalid('parameterContract.parameters');\n    if (\n      parameterContract.values === null ||\n      typeof parameterContract.values !== 'object' ||\n      Array.isArray(parameterContract.values)\n    )\n      return invalid('parameterContract.values');\n  }\n  if (candidate.resolved === null || typeof candidate.resolved !== 'object')\n    return invalid('resolved');\n  if (candidate.refs === null || typeof candidate.refs !== 'object') return invalid('refs');\n  if (candidate.artifact === null || typeof candidate.artifact !== 'object')\n    return invalid('artifact');\n  if (candidate.receipt === null || typeof candidate.receipt !== 'object')\n    return invalid('receipt');\n  const artifact = candidate.artifact as Record<string, unknown>;\n  if (\n    typeof artifact.digest !== 'string' ||\n    (!Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes))\n  ) {\n    return invalid('artifact');\n  }\n  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {\n    artifactDigest: artifact.digest as string,\n  });\n  if (!receiptResult.ok) return receiptResult;\n  if (candidate.artifactDigest !== undefined && candidate.artifactDigest !== artifact.digest)\n    return invalid('artifactDigest', candidate.artifactDigest);\n  if (\n    candidate.publicationGeneration !== undefined &&\n    receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration\n  )\n    return invalid('receipt.identity.cookGeneration', receiptResult.value.identity.cookGeneration);\n  const normalized = {\n    ...candidate,\n    artifact: {\n      ...artifact,\n      bytes: ArrayBuffer.isView(artifact.bytes)\n        ? Uint8Array.from(artifact.bytes as Uint8Array)\n        : Uint8Array.from(artifact.bytes as number[]),\n    },\n    receipt: receiptResult.value,\n  } as CookedMaterialRecord;\n  return ok(normalized);\n}\n\nexport function projectCookedMaterialRecord(\n  record: CookedMaterialRecord,\n): Omit<CookedMaterialRecord, 'guid' | 'authored'> {\n  return {\n    resolved: record.resolved,\n    refs: record.refs,\n    artifact: record.artifact,\n    receipt: record.receipt,\n    schemaVersion: record.schemaVersion,\n  };\n}\n"]}
+{"version":3,"sources":["../src/evidence/material-cook.ts"],"names":["value"],"mappings":"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","file":"material-cook.mjs","sourcesContent":["import type {\n  MaterialAsset,\n  MaterialParameter,\n  MaterialPass,\n  MaterialTextureReference,\n  MaterialTextureValue,\n  MaterialValue,\n  Result,\n} from '@forgeax/engine-types';\nimport { deriveStandardLayerPlan, err, MATERIAL_TEXTURE_SLOTS, ok } from '@forgeax/engine-types';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex } from '@noble/hashes/utils.js';\n\nexport interface MaterialCookRefs {\n  readonly parent: readonly string[];\n  readonly textures: readonly string[];\n  readonly samplers: readonly string[];\n  readonly modules: readonly string[];\n}\n\nexport interface MaterialCookArtifact {\n  readonly mediaType: string;\n  readonly path: string;\n  readonly digest: string;\n  readonly bytes: Uint8Array;\n}\n\n/** Backend capability projection for one immutable cooked material artifact. */\nexport interface MaterialCookVariantContext {\n  readonly backend: 'webgpu' | 'webgl2' | 'wgpu-native';\n  readonly capability: 'storage-buffer' | 'uniform-fallback';\n}\n\n/** Additional backend artifact published with one material generation. */\nexport interface MaterialCookVariant {\n  readonly context: MaterialCookVariantContext;\n  readonly specializationKey: string;\n  readonly artifact: MaterialCookArtifact;\n}\n\nexport interface MaterialCookWasmProvenance {\n  readonly sourceContentKey: string;\n  readonly artifactSha256: string;\n  readonly glueSha256: string;\n}\n\nexport interface MaterialCookIdentity {\n  readonly materialContractDigest: string;\n  readonly sourceRevision: string;\n  readonly sourceClosureDigest: string;\n  readonly layoutIdentity: string;\n  readonly programIdentity: string;\n  readonly pipelineIdentity: string;\n  readonly materialPublicationIdentity: string;\n  readonly cookIdentity: string;\n  readonly compilerFingerprint: string;\n  readonly wasm: MaterialCookWasmProvenance;\n  readonly artifactDigest: string;\n  readonly valueGeneration: number;\n  readonly dependencyGeneration: number;\n  readonly cookGeneration: number;\n}\n\nexport type MaterialCookIdentityInput = Omit<MaterialCookIdentity, 'cookIdentity'>;\n\nexport interface MaterialCookReceipt {\n  readonly schemaVersion: 'material-cook/3';\n  readonly sourceClosure: readonly string[];\n  readonly profile: string;\n  readonly compilerVersion: string;\n  readonly identity: MaterialCookIdentity;\n  readonly derivedInterface: {\n    readonly layoutIdentity: string;\n    /** Build-time Standard physical lowering identity, when the root is Standard. */\n    readonly layerPlanIdentity?: string;\n  };\n}\n\nexport interface MaterialParameterContract {\n  readonly parameters: readonly MaterialParameter[];\n  readonly values: Readonly<Record<string, MaterialValue | null>>;\n}\n\nexport interface CookedMaterialRecord {\n  readonly schemaVersion: 'material-cook/3';\n  readonly guid: string;\n  readonly authored?: MaterialAsset;\n  readonly materialGuid?: string;\n  readonly publicationGeneration?: number;\n  readonly specializationKey?: string;\n  /** Compiler context used by the primary `artifact` entry. */\n  readonly variantContext?: MaterialCookVariantContext;\n  /** Additional immutable artifacts for other backend capability lanes. */\n  readonly variants?: readonly MaterialCookVariant[];\n  readonly artifactDigest?: string;\n  readonly sourceClosure?: readonly string[];\n  readonly parameterContract?: MaterialParameterContract;\n  readonly resolved: {\n    readonly passes: readonly MaterialPass[];\n    readonly parameters: readonly MaterialParameter[];\n    readonly values: Readonly<Record<string, MaterialValue | null>>;\n  };\n  readonly refs: MaterialCookRefs;\n  readonly artifact: MaterialCookArtifact;\n  readonly receipt: MaterialCookReceipt;\n}\n\nexport interface MaterialCookRecordError {\n  readonly code: 'material-cook-record-invalid';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: {\n    readonly field: string;\n    readonly actual?: unknown;\n    readonly action: string;\n  };\n}\n\nexport interface MaterialCookIdentityExpectation {\n  readonly layoutIdentity?: string;\n  readonly artifactDigest?: string;\n  readonly inputDigest?: string;\n}\n\nconst STANDARD_ROOT_MODULES = new Set([\n  'forgeax::default-standard-pbr',\n  'forgeax::pbr-skin',\n  'forgeax_material::standard',\n  'forgeax_material::pbr-skin',\n  'forgeax::default-shadow-caster',\n]);\n\n/** Shared ownership predicate for the built-in Standard material root. */\nexport function isStandardRootModule(module: string): boolean {\n  return STANDARD_ROOT_MODULES.has(module);\n}\n\nexport function isStandardMaterialRecord(record: Pick<CookedMaterialRecord, 'resolved'>): boolean {\n  return record.resolved.passes.some((pass) => isStandardRootModule(pass.program.module));\n}\n\n/**\n * Recompute the Standard layer identity from the admitted resolved root.\n * Material admission and runtime loading share this owner so a stale receipt\n * cannot select a different physical layer plan after cooking.\n */\nexport function materialLayerPlanIdentity(\n  record: Pick<CookedMaterialRecord, 'resolved'>,\n): string | undefined {\n  if (!isStandardMaterialRecord(record)) {\n    return undefined;\n  }\n  return deriveStandardLayerPlan(record.resolved.parameters, record.resolved.passes).identity;\n}\n\nfunction unique(values: readonly string[]): readonly string[] {\n  return [...new Set(values)].sort();\n}\n\nfunction guidText(value: string | Uint8Array): string {\n  return typeof value === 'string'\n    ? value\n    : Array.from(value, (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\nfunction cookGuidText(value: MaterialTextureReference): string | undefined {\n  return typeof value === 'number' ? undefined : guidText(value);\n}\n\nfunction textureValues(\n  values: Readonly<Record<string, MaterialValue | null>> | undefined,\n  textureFields: ReadonlySet<string>,\n): readonly MaterialTextureValue[] {\n  return Object.entries(values ?? {}).flatMap(([name, value]) => {\n    if (value === null) return [];\n    if (typeof value === 'string') {\n      return textureFields.has(name) ? [{ texture: value }] : [];\n    }\n    return value !== null &&\n      typeof value === 'object' &&\n      !Array.isArray(value) &&\n      'texture' in value\n      ? [value as MaterialTextureValue]\n      : [];\n  });\n}\n\nexport function collectMaterialCookRefs(material: Partial<MaterialAsset>): MaterialCookRefs {\n  const textureFields =\n    material.parameters === undefined\n      ? new Set<string>(MATERIAL_TEXTURE_SLOTS)\n      : new Set(\n          material.parameters\n            .filter(\n              (parameter) => parameter.type === 'texture' || parameter.type === 'texture_cube',\n            )\n            .map((parameter) => parameter.name),\n        );\n  const textures = textureValues(material.values, textureFields);\n  return {\n    parent: material.parent ? [guidText(material.parent)] : [],\n    textures: unique(\n      textures.flatMap((value) => {\n        const guid = cookGuidText(value.texture);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    samplers: unique(\n      textures.flatMap((value) => {\n        if (value.sampler === undefined) return [];\n        const guid = cookGuidText(value.sampler);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    modules: unique((material.passes ?? []).map((pass) => pass.program.module)),\n  };\n}\n\nexport function createMaterialArtifactDigest(bytes: Uint8Array): string {\n  return `sha256:${bytesToHex(sha256(bytes))}`;\n}\n\nfunction jsonValue(value: unknown): unknown {\n  if (value instanceof Uint8Array) return [...value];\n  if (Array.isArray(value)) return value.map(jsonValue);\n  if (value !== null && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([key, entry]) => [key, jsonValue(entry)]),\n    );\n  }\n  return value;\n}\n\nexport function createMaterialCookIdentity(input: MaterialCookIdentityInput): MaterialCookIdentity {\n  const cookIdentity = createMaterialArtifactDigest(\n    new TextEncoder().encode(\n      JSON.stringify(\n        jsonValue({\n          materialContractDigest: input.materialContractDigest,\n          sourceRevision: input.sourceRevision,\n          sourceClosureDigest: input.sourceClosureDigest,\n          layoutIdentity: input.layoutIdentity,\n          programIdentity: input.programIdentity,\n          pipelineIdentity: input.pipelineIdentity,\n          compilerFingerprint: input.compilerFingerprint,\n          wasm: input.wasm,\n          artifactDigest: input.artifactDigest,\n        }),\n      ),\n    ),\n  );\n  return { ...input, cookIdentity };\n}\n\nexport function serializeCookedMaterialRecord(record: CookedMaterialRecord): string {\n  return JSON.stringify(jsonValue(record));\n}\n\nexport function serializeMaterialCookReceipt(receipt: MaterialCookReceipt): string {\n  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));\n}\n\nfunction invalid(field: string, actual?: unknown): Result<never, MaterialCookRecordError> {\n  return err({\n    code: 'material-cook-record-invalid',\n    expected: 'a complete material-cook/3 record with layered identity and provenance',\n    hint: 're-cook the material and publish its record, artifact, references, and receipt together',\n    detail: {\n      field,\n      ...(actual === undefined ? {} : { actual }),\n      action: 'inspect the named field and recook the material generation',\n    },\n  });\n}\n\nfunction normalizeArtifactBytes(value: unknown): Uint8Array | undefined {\n  if (Array.isArray(value)) {\n    return value.every((byte) => Number.isInteger(byte) && byte >= 0 && byte <= 255)\n      ? Uint8Array.from(value)\n      : undefined;\n  }\n  if (!ArrayBuffer.isView(value)) return undefined;\n  const view = value as ArrayBufferView;\n  return new Uint8Array(view.buffer, view.byteOffset, view.byteLength).slice();\n}\n\nconst IDENTITY_FIELDS = [\n  'materialContractDigest',\n  'sourceRevision',\n  'sourceClosureDigest',\n  'layoutIdentity',\n  'programIdentity',\n  'pipelineIdentity',\n  'materialPublicationIdentity',\n  'cookIdentity',\n  'compilerFingerprint',\n  'artifactDigest',\n] as const;\n\nfunction isGeneration(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 1;\n}\n\nfunction validateIdentity(value: unknown): Result<MaterialCookIdentity, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt.identity', value);\n  const candidate = value as Record<string, unknown>;\n  for (const field of IDENTITY_FIELDS) {\n    if (typeof candidate[field] !== 'string' || candidate[field].length === 0) {\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n    }\n  }\n  if (candidate.wasm === null || typeof candidate.wasm !== 'object') {\n    return invalid('receipt.identity.wasm', candidate.wasm);\n  }\n  const wasm = candidate.wasm as Record<string, unknown>;\n  for (const field of ['sourceContentKey', 'artifactSha256', 'glueSha256']) {\n    if (typeof wasm[field] !== 'string' || wasm[field].length === 0) {\n      return invalid(`receipt.identity.wasm.${field}`, wasm[field]);\n    }\n  }\n  for (const field of ['valueGeneration', 'dependencyGeneration', 'cookGeneration']) {\n    if (!isGeneration(candidate[field]))\n      return invalid(`receipt.identity.${field}`, candidate[field]);\n  }\n  return ok({\n    ...candidate,\n    wasm: wasm as unknown as MaterialCookWasmProvenance,\n  } as MaterialCookIdentity);\n}\n\nexport function validateMaterialCookReceipt(\n  value: unknown,\n  expected: MaterialCookIdentityExpectation = {},\n): Result<MaterialCookReceipt, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('receipt.schemaVersion', candidate.schemaVersion);\n  const identityResult = validateIdentity(candidate.identity);\n  if (!identityResult.ok) return identityResult;\n  const identity = identityResult.value;\n  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== 'object') {\n    return invalid('receipt.derivedInterface', candidate.derivedInterface);\n  }\n  const derivedInterface = candidate.derivedInterface as Record<string, unknown>;\n  if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {\n    return invalid('receipt.derivedInterface.layoutIdentity', derivedInterface.layoutIdentity);\n  }\n  if (\n    derivedInterface.layerPlanIdentity !== undefined &&\n    (typeof derivedInterface.layerPlanIdentity !== 'string' ||\n      derivedInterface.layerPlanIdentity.length === 0)\n  ) {\n    return invalid(\n      'receipt.derivedInterface.layerPlanIdentity',\n      derivedInterface.layerPlanIdentity,\n    );\n  }\n  for (const field of ['sourceClosure', 'profile', 'compilerVersion']) {\n    const fieldValue = candidate[field];\n    if (\n      (field === 'sourceClosure' && !Array.isArray(fieldValue)) ||\n      (field !== 'sourceClosure' && typeof fieldValue !== 'string')\n    ) {\n      return invalid(`receipt.${field}`, fieldValue);\n    }\n  }\n  const sourceClosure = candidate.sourceClosure;\n  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== 'string')) {\n    return invalid('receipt.sourceClosure', sourceClosure);\n  }\n  if (\n    expected.layoutIdentity !== undefined &&\n    identity.layoutIdentity !== expected.layoutIdentity\n  ) {\n    return invalid('receipt.identity.layoutIdentity', identity.layoutIdentity);\n  }\n  if (\n    expected.artifactDigest !== undefined &&\n    identity.artifactDigest !== expected.artifactDigest\n  ) {\n    return invalid('receipt.identity.artifactDigest', identity.artifactDigest);\n  }\n  if (expected.inputDigest !== undefined && identity.cookIdentity !== expected.inputDigest) {\n    return invalid('receipt.identity.cookIdentity', identity.cookIdentity);\n  }\n  return ok({\n    schemaVersion: 'material-cook/3',\n    sourceClosure: candidate.sourceClosure as string[],\n    profile: candidate.profile as string,\n    compilerVersion: candidate.compilerVersion as string,\n    identity,\n    derivedInterface: {\n      layoutIdentity: derivedInterface.layoutIdentity as string,\n      ...(derivedInterface.layerPlanIdentity === undefined\n        ? {}\n        : { layerPlanIdentity: derivedInterface.layerPlanIdentity as string }),\n    },\n  });\n}\n\nexport function validateCookedMaterialRecord(\n  value: unknown,\n): Result<CookedMaterialRecord, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('record');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/3')\n    return invalid('schemaVersion', candidate.schemaVersion);\n  if (typeof candidate.guid !== 'string' || !candidate.guid) return invalid('guid');\n  if (candidate.materialGuid !== undefined && typeof candidate.materialGuid !== 'string')\n    return invalid('materialGuid');\n  if (\n    candidate.publicationGeneration !== undefined &&\n    !isGeneration(candidate.publicationGeneration)\n  )\n    return invalid('publicationGeneration', candidate.publicationGeneration);\n  if (candidate.specializationKey !== undefined && typeof candidate.specializationKey !== 'string')\n    return invalid('specializationKey');\n  if (candidate.variantContext !== undefined) {\n    if (candidate.variantContext === null || typeof candidate.variantContext !== 'object')\n      return invalid('variantContext');\n    const context = candidate.variantContext as Record<string, unknown>;\n    if (\n      (context.backend !== 'webgpu' &&\n        context.backend !== 'webgl2' &&\n        context.backend !== 'wgpu-native') ||\n      (context.capability !== 'storage-buffer' && context.capability !== 'uniform-fallback')\n    )\n      return invalid('variantContext', candidate.variantContext);\n  }\n  if (candidate.variants !== undefined) {\n    if (!Array.isArray(candidate.variants)) return invalid('variants');\n    for (const [index, value] of candidate.variants.entries()) {\n      if (value === null || typeof value !== 'object') return invalid(`variants[${index}]`);\n      const variant = value as Record<string, unknown>;\n      const context = variant.context;\n      if (context === null || typeof context !== 'object')\n        return invalid(`variants[${index}].context`);\n      const contextRecord = context as Record<string, unknown>;\n      if (\n        (contextRecord.backend !== 'webgpu' &&\n          contextRecord.backend !== 'webgl2' &&\n          contextRecord.backend !== 'wgpu-native') ||\n        (contextRecord.capability !== 'storage-buffer' &&\n          contextRecord.capability !== 'uniform-fallback')\n      )\n        return invalid(`variants[${index}].context`, context);\n      if (typeof variant.specializationKey !== 'string' || variant.specializationKey.length === 0)\n        return invalid(`variants[${index}].specializationKey`);\n      if (variant.artifact === null || typeof variant.artifact !== 'object')\n        return invalid(`variants[${index}].artifact`);\n      const variantArtifact = variant.artifact as Record<string, unknown>;\n      if (\n        typeof variantArtifact.mediaType !== 'string' ||\n        typeof variantArtifact.path !== 'string' ||\n        typeof variantArtifact.digest !== 'string' ||\n        normalizeArtifactBytes(variantArtifact.bytes) === undefined\n      )\n        return invalid(`variants[${index}].artifact`);\n    }\n  }\n  if (candidate.artifactDigest !== undefined && typeof candidate.artifactDigest !== 'string')\n    return invalid('artifactDigest');\n  if (\n    candidate.sourceClosure !== undefined &&\n    (!Array.isArray(candidate.sourceClosure) ||\n      candidate.sourceClosure.some((path) => typeof path !== 'string'))\n  )\n    return invalid('sourceClosure');\n  if (candidate.parameterContract !== undefined) {\n    if (candidate.parameterContract === null || typeof candidate.parameterContract !== 'object')\n      return invalid('parameterContract');\n    const parameterContract = candidate.parameterContract as Record<string, unknown>;\n    if (!Array.isArray(parameterContract.parameters))\n      return invalid('parameterContract.parameters');\n    if (\n      parameterContract.values === null ||\n      typeof parameterContract.values !== 'object' ||\n      Array.isArray(parameterContract.values)\n    )\n      return invalid('parameterContract.values');\n  }\n  if (candidate.resolved === null || typeof candidate.resolved !== 'object')\n    return invalid('resolved');\n  if (candidate.refs === null || typeof candidate.refs !== 'object') return invalid('refs');\n  if (candidate.artifact === null || typeof candidate.artifact !== 'object')\n    return invalid('artifact');\n  if (candidate.receipt === null || typeof candidate.receipt !== 'object')\n    return invalid('receipt');\n  const artifact = candidate.artifact as Record<string, unknown>;\n  if (\n    typeof artifact.digest !== 'string' ||\n    (!Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes))\n  ) {\n    return invalid('artifact');\n  }\n  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {\n    artifactDigest: artifact.digest as string,\n  });\n  if (!receiptResult.ok) return receiptResult;\n  const resolved = candidate.resolved as Record<string, unknown>;\n  if (!Array.isArray(resolved.passes)) return invalid('resolved.passes', resolved.passes);\n  if (!Array.isArray(resolved.parameters))\n    return invalid('resolved.parameters', resolved.parameters);\n  if (\n    resolved.values === null ||\n    typeof resolved.values !== 'object' ||\n    Array.isArray(resolved.values)\n  )\n    return invalid('resolved.values', resolved.values);\n  let expectedLayerPlanIdentity: string | undefined;\n  try {\n    expectedLayerPlanIdentity = materialLayerPlanIdentity({\n      resolved: resolved as unknown as CookedMaterialRecord['resolved'],\n    });\n  } catch (error) {\n    return invalid('resolved.layerPlanIdentity', error instanceof Error ? error.message : error);\n  }\n  if (\n    expectedLayerPlanIdentity !== undefined &&\n    receiptResult.value.derivedInterface.layerPlanIdentity !== expectedLayerPlanIdentity\n  ) {\n    return invalid(\n      'receipt.derivedInterface.layerPlanIdentity',\n      receiptResult.value.derivedInterface.layerPlanIdentity,\n    );\n  }\n  if (candidate.artifactDigest !== undefined && candidate.artifactDigest !== artifact.digest)\n    return invalid('artifactDigest', candidate.artifactDigest);\n  if (\n    candidate.publicationGeneration !== undefined &&\n    receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration\n  )\n    return invalid('receipt.identity.cookGeneration', receiptResult.value.identity.cookGeneration);\n  const normalized = {\n    ...candidate,\n    artifact: {\n      ...artifact,\n      bytes: normalizeArtifactBytes(artifact.bytes) as Uint8Array,\n    },\n    ...(Array.isArray(candidate.variants)\n      ? {\n          variants: candidate.variants.map((value) => {\n            const variant = value as Record<string, unknown>;\n            const variantArtifact = variant.artifact as Record<string, unknown>;\n            return {\n              ...variant,\n              artifact: {\n                ...variantArtifact,\n                bytes: normalizeArtifactBytes(variantArtifact.bytes) as Uint8Array,\n              },\n            };\n          }),\n        }\n      : {}),\n    receipt: receiptResult.value,\n  } as unknown as CookedMaterialRecord;\n  return ok(normalized);\n}\n\nexport function projectCookedMaterialRecord(\n  record: CookedMaterialRecord,\n): Omit<CookedMaterialRecord, 'guid' | 'authored'> {\n  return {\n    resolved: record.resolved,\n    refs: record.refs,\n    artifact: record.artifact,\n    ...(record.variantContext === undefined ? {} : { variantContext: record.variantContext }),\n    ...(record.variants === undefined ? {} : { variants: record.variants }),\n    receipt: record.receipt,\n    schemaVersion: record.schemaVersion,\n  };\n}\n"]}

package/dist/{parameterized-pack-node.d.ts → pack-authoring-node.d.ts}

@@ -1,7 +1,7 @@
 import type { Result } from '@forgeax/engine-types';
-import { type PackAuthoringError, type ParameterizedPackGatewayPort, type ParameterizedPackOperationResult } from './parameterized-pack.js';
+import { type PackAuthoringError, type PackAuthoringGatewayPort, type PackAuthoringOperationResult } from './pack-authoring.js';
 import { type ScanInventory } from './scanner.js';
-export interface ParameterizedPackMaterializedAsset {
+export interface PackAuthoringMaterializedAsset {
     readonly packageId: string;
     readonly sourceKey: string;
     readonly guid: string;
@@ -11,16 +11,16 @@ export interface ParameterizedPackMaterializedAsset {
     readonly ready?: boolean;
     readonly artifactsReady?: boolean;
 }
-export interface FileSystemParameterizedPackAuthoringOptions {
+export interface FileSystemPackAuthoringOptions {
     readonly gameRoot: string;
     readonly scanRoots?: readonly string[];
     /** Current-generation rows only; this callback is never called by mutations. */
-    readonly materialized?: () => readonly ParameterizedPackMaterializedAsset[] | Promise<readonly ParameterizedPackMaterializedAsset[]>;
+    readonly materialized?: () => readonly PackAuthoringMaterializedAsset[] | Promise<readonly PackAuthoringMaterializedAsset[]>;
     /** Build owner callback; the gateway itself does not own DDC or Catalog state. */
     readonly rebuild?: (sourcePath: string, mode: 'rebuild' | 'cold-cook') => Promise<Result<unknown, PackAuthoringError>>;
     /** Injection point for hosts that already own a validated Source Index. */
     readonly inventory?: () => Promise<Result<ScanInventory, unknown>>;
 }
-export declare function createFileSystemParameterizedPackAuthoringPort(options: FileSystemParameterizedPackAuthoringOptions): ParameterizedPackGatewayPort<ParameterizedPackOperationResult>;
-export declare function createFileSystemParameterizedPackAuthoringGateway(options: FileSystemParameterizedPackAuthoringOptions): ParameterizedPackGatewayPort<ParameterizedPackOperationResult>;
-//# sourceMappingURL=parameterized-pack-node.d.ts.map
+export declare function createFileSystemPackAuthoringPort(options: FileSystemPackAuthoringOptions): PackAuthoringGatewayPort<PackAuthoringOperationResult>;
+export declare function createFileSystemPackAuthoringGateway(options: FileSystemPackAuthoringOptions): PackAuthoringGatewayPort<PackAuthoringOperationResult>;
+//# sourceMappingURL=pack-authoring-node.d.ts.map

package/dist/pack-authoring-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-authoring-node.d.ts","sourceRoot":"","sources":["../src/pack-authoring-node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgC,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGlF,OAAO,EAIL,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAE7B,KAAK,4BAA4B,EASlC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MACpB,SAAS,8BAA8B,EAAE,GACzC,OAAO,CAAC,SAAS,8BAA8B,EAAE,CAAC,CAAC;IACvD,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,GAAG,WAAW,KAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;CACpE;AAg3DD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CAAC,4BAA4B,CAAC,CAExD;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CAAC,4BAA4B,CAAC,CAExD"}