@forgeax/engine-pack 0.1.24 → 0.1.26

package/README.md

@@ -426,7 +426,7 @@ When `kind: 'material'`, the `payload` object carries `passes[]` + `values` (fea
 | `values` | `Record<string, unknown>` | Child-owned values, including per-slot texture coordinates. |
 | `parent` | `AssetGuid` | Optional serialized parent edge. |
 
-**Validation** is performed by the material schema and build-time cook. The cook resolves the parent chain, validates values and pass programs, and emits a `material-cook/3` record, artifact, references, and receipt. The receipt keeps material, source, layout, program, pipeline, publication, and cook identities together with compiler/WASM provenance and generation counters. Runtime reports a structured missing-cook error instead of compiling a material; stale generations are recooked by the producer.
+**Validation** is performed by the material schema and build-time cook. The cook resolves the parent chain, validates values and pass programs, and emits a `material-cook/4` record, artifact, references, and receipt. The receipt keeps material, source, layout, program, pipeline, publication, and cook identities together with compiler/WASM provenance and generation counters. Runtime reports a structured missing-cook error instead of compiling a material; stale generations are recooked by the producer.
 
 ## `AssetGuid` API
 

package/dist/build.d.ts

@@ -4,7 +4,7 @@ export { validateArtifactPath } from './artifact-path.js';
 export { buildCatalogProjection, type CatalogAuthority, type CatalogBuildError, type CatalogBuildErrorCode, type CatalogBuildProjectionOptions, type CatalogBuildResult, type CatalogImporterPolicy, type CatalogProducerVisibility, catalogSourcePathFor, metaPathForGuid, } from './catalog-builder.js';
 export { calculateCatalogDelta } from './catalog-delta.js';
 export { type CatalogOutputDeclaration, type CatalogProducerMeta, type CookedPackageProjection, catalogProjectionFor, currentProjectionFor, findReservedAssetKindConflict, type PackageCatalogInput, projectCookedPackageEntry, projectExternalCatalogEntries, projectPackageCatalog, projectRuntimeCatalogRow, type RuntimeCatalogRowInput, } from './catalog-projection.js';
-export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, type MaterialCookArtifact, type MaterialCookIdentityExpectation, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, validateMaterialCookReceipt, } from './evidence/material-cook.js';
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, type MaterialCookArtifact, type MaterialCookIdentityExpectation, type MaterialCookProgram, type MaterialCookProgramContext, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, validateMaterialCookReceipt, } from './evidence/material-cook.js';
 export { buildOfflineAssetEvidence, packageVerification } from './evidence/offline-evidence.js';
 export { AssetGuid, isValidAssetGuidString, isValidPackSourceKey, PACK_SOURCE_KEY_RE, PackageId, } from './guid.js';
 export { projectAssetRefs, projectSceneEntityRefs } from './inventory/binding.js';

package/dist/build.d.ts.map

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

package/dist/build.mjs

@@ -9245,9 +9245,13 @@ function packErr(error) {
 function record(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-var STANDARD_SCRIPTABLE_PACK_SCAN_OPTIONS = Object.freeze(
-  {}
-);
+var STANDARD_SCRIPTABLE_PACK_SCAN_OPTIONS = Object.freeze({
+  // Scriptable Packs execute in an isolated worker.  A cold worker must
+  // compile the authored source closure before it can return metadata;
+  // heavy procedural packs otherwise make the shared catalog fall back to
+  // an empty degraded projection at the old 15-second budget.
+  timeoutMs: 6e4
+});
 var BLACKLIST = /* @__PURE__ */ new Set([
   "node_modules",
   "__tests__",
@@ -10374,7 +10378,7 @@ function serializeMaterialCookReceipt(receipt) {
 function invalid(field, actual) {
   return err({
     code: "material-cook-record-invalid",
-    expected: "a complete material-cook/3 record with layered identity and provenance",
+    expected: "a complete material-cook/4 record with layered identity and provenance",
     hint: "re-cook the material and publish its record, artifact, references, and receipt together",
     detail: {
       field,
@@ -10383,6 +10387,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",
@@ -10427,7 +10439,7 @@ function validateIdentity(value) {
 function validateMaterialCookReceipt(value, expected = {}) {
   if (value === null || typeof value !== "object") return invalid("receipt");
   const candidate = value;
-  if (candidate.schemaVersion !== "material-cook/3")
+  if (candidate.schemaVersion !== "material-cook/4")
     return invalid("receipt.schemaVersion", candidate.schemaVersion);
   const identityResult = validateIdentity(candidate.identity);
   if (!identityResult.ok) return identityResult;
@@ -10465,7 +10477,7 @@ function validateMaterialCookReceipt(value, expected = {}) {
     return invalid("receipt.identity.cookIdentity", identity.cookIdentity);
   }
   return ok({
-    schemaVersion: "material-cook/3",
+    schemaVersion: "material-cook/4",
     sourceClosure: candidate.sourceClosure,
     profile: candidate.profile,
     compilerVersion: candidate.compilerVersion,
@@ -10479,7 +10491,7 @@ function validateMaterialCookReceipt(value, expected = {}) {
 function validateCookedMaterialRecord(value) {
   if (value === null || typeof value !== "object") return invalid("record");
   const candidate = value;
-  if (candidate.schemaVersion !== "material-cook/3")
+  if (candidate.schemaVersion !== "material-cook/4")
     return invalid("schemaVersion", candidate.schemaVersion);
   if (typeof candidate.guid !== "string" || !candidate.guid) return invalid("guid");
   if (candidate.materialGuid !== void 0 && typeof candidate.materialGuid !== "string")
@@ -10488,6 +10500,8 @@ function validateCookedMaterialRecord(value) {
     return invalid("publicationGeneration", candidate.publicationGeneration);
   if (candidate.specializationKey !== void 0 && typeof candidate.specializationKey !== "string")
     return invalid("specializationKey");
+  if ("artifact" in candidate || "variants" in candidate || "variantContext" in candidate)
+    return invalid("programs", "legacy single-artifact publication");
   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")))
@@ -10504,24 +10518,72 @@ function validateCookedMaterialRecord(value) {
   if (candidate.resolved === null || typeof candidate.resolved !== "object")
     return invalid("resolved");
   if (candidate.refs === null || typeof candidate.refs !== "object") return invalid("refs");
-  if (candidate.artifact === null || typeof candidate.artifact !== "object")
-    return invalid("artifact");
   if (candidate.receipt === null || typeof candidate.receipt !== "object")
     return invalid("receipt");
-  const artifact = candidate.artifact;
-  if (typeof artifact.digest !== "string" || !Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes)) {
-    return invalid("artifact");
-  }
-  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {
-    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);
+  const passes = resolved.passes;
+  const passNames = /* @__PURE__ */ new Set();
+  for (const [index, pass] of passes.entries()) {
+    if (pass === null || typeof pass !== "object" || typeof pass.name !== "string" || !pass.name || passNames.has(pass.name) || pass.program === null || typeof pass.program !== "object" || typeof pass.program.module !== "string")
+      return invalid(`resolved.passes[${index}]`);
+    passNames.add(pass.name);
+  }
+  if (!Array.isArray(candidate.programs) || candidate.programs.length === 0)
+    return invalid("programs");
+  const programs = [];
+  const programKeys = /* @__PURE__ */ new Set();
+  const selections = /* @__PURE__ */ new Set();
+  const selectedPasses = /* @__PURE__ */ new Set();
+  for (const [index, entry] of candidate.programs.entries()) {
+    const field = `programs[${index}]`;
+    if (entry === null || typeof entry !== "object") return invalid(field);
+    const program = entry;
+    if (typeof program.specializationKey !== "string" || !program.specializationKey || programKeys.has(program.specializationKey))
+      return invalid(`${field}.specializationKey`);
+    programKeys.add(program.specializationKey);
+    if (program.artifact === null || typeof program.artifact !== "object")
+      return invalid(`${field}.artifact`);
+    const artifact = program.artifact;
+    const bytes = normalizeArtifactBytes(artifact.bytes);
+    if (artifact.mediaType !== "text/wgsl" || typeof artifact.path !== "string" || !artifact.path || typeof artifact.digest !== "string" || !artifact.digest || bytes === void 0)
+      return invalid(`${field}.artifact`);
+    if (!Array.isArray(program.selections) || program.selections.length === 0)
+      return invalid(`${field}.selections`);
+    const programSelections = [];
+    for (const [selectionIndex, selection] of program.selections.entries()) {
+      const selectionField = `${field}.selections[${selectionIndex}]`;
+      if (selection === null || typeof selection !== "object" || !passNames.has(selection.pass))
+        return invalid(selectionField);
+      const context = validateMaterialCookProgramContext(selection.context);
+      if (!context.ok)
+        return invalid(
+          `${selectionField}.${context.error.detail.field}`,
+          context.error.detail.actual
+        );
+      const key = JSON.stringify([selection.pass, materialProgramContextKey(context.value)]);
+      if (selections.has(key)) return invalid(selectionField, "ambiguous Pass/context selection");
+      selections.add(key);
+      selectedPasses.add(selection.pass);
+      programSelections.push({ pass: selection.pass, context: context.value });
+    }
+    programs.push({
+      specializationKey: program.specializationKey,
+      artifact: { mediaType: "text/wgsl", path: artifact.path, digest: artifact.digest, bytes },
+      selections: programSelections
+    });
+  }
+  if ([...passNames].some((pass) => !selectedPasses.has(pass)))
+    return invalid("programs.selections", "unpublished Pass");
+  const manifestDigest = createMaterialProgramSetDigest(programs, passes);
+  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {
+    artifactDigest: manifestDigest
+  });
+  if (!receiptResult.ok) return receiptResult;
   let expectedLayerPlanIdentity;
   try {
     expectedLayerPlanIdentity = materialLayerPlanIdentity({
@@ -10536,29 +10598,70 @@ function validateCookedMaterialRecord(value) {
       receiptResult.value.derivedInterface.layerPlanIdentity
     );
   }
-  if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== artifact.digest)
+  if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== manifestDigest)
     return invalid("artifactDigest", candidate.artifactDigest);
   if (candidate.publicationGeneration !== void 0 && receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration)
     return invalid("receipt.identity.cookGeneration", receiptResult.value.identity.cookGeneration);
-  const normalized = {
+  return ok({
     ...candidate,
-    artifact: {
-      ...artifact,
-      bytes: ArrayBuffer.isView(artifact.bytes) ? Uint8Array.from(artifact.bytes) : Uint8Array.from(artifact.bytes)
-    },
+    programs,
     receipt: receiptResult.value
-  };
-  return ok(normalized);
+  });
 }
 function projectCookedMaterialRecord(record2) {
   return {
     resolved: record2.resolved,
     refs: record2.refs,
-    artifact: record2.artifact,
+    programs: record2.programs,
     receipt: record2.receipt,
     schemaVersion: record2.schemaVersion
   };
 }
+function materialProgramContextKey(context) {
+  return JSON.stringify(jsonValue(context));
+}
+function validateMaterialCookProgramContext(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value))
+    return invalid("context", value);
+  const context = value;
+  const fields = {
+    backend: ["webgpu", "webgl2", "wgpu-native"],
+    capability: ["storage-buffer", "uniform-fallback"],
+    pipeline: ["forward", "deferred"],
+    geometry: ["mesh", "skinned", "sprite"],
+    pass: ["forward", "shadow", "depth"],
+    profile: ["forgeax-material-wgsl-v1"],
+    toolchain: ["naga-oil"],
+    instrumentation: ["none", "validation"]
+  };
+  for (const field of Object.keys(context)) {
+    if (!(field in fields)) return invalid(`context.${field}`, context[field]);
+  }
+  for (const [field, allowed] of Object.entries(fields)) {
+    if (!allowed.includes(context[field]))
+      return invalid(`context.${field}`, context[field]);
+  }
+  return ok({ ...context });
+}
+function createMaterialProgramSetDigest(programs, passes) {
+  const manifest = {
+    passes,
+    programs: programs.map((program) => ({
+      specializationKey: program.specializationKey,
+      artifact: {
+        path: program.artifact.path,
+        mediaType: program.artifact.mediaType,
+        digest: program.artifact.digest
+      },
+      selections: [...program.selections].sort(
+        (a, b) => JSON.stringify(jsonValue(a)).localeCompare(JSON.stringify(jsonValue(b)))
+      )
+    })).sort((a, b) => a.specializationKey.localeCompare(b.specializationKey))
+  };
+  return createMaterialArtifactDigest(
+    new TextEncoder().encode(JSON.stringify(jsonValue(manifest)))
+  );
+}
 function packageEvidence(input) {
   return {
     guid: input.guid,