@forgeax/engine-pack 0.1.29 → 0.1.31

package/README.md

@@ -278,6 +278,22 @@ vectors, colors, and asset-GUID constraints. The isolated Pack worker passes
 only serializable authoring data to the build and never exposes filesystem or
 runtime state.
 
+Custom build-only content uses `PackCookSource` in the same output map:
+
+```ts
+{ 'volume/main': { kind: 'game-volume', execution: 'cooked', source: { size: values.size } } }
+```
+
+Register the matching `NativeCooker` in the build host. The host supplies the
+derived GUID, source key/path and source data; the cooker returns matching-kind
+metadata, references and artifact bytes. Missing cookers, rewritten GUIDs and
+invalid products fail before publication. Custom sources can coexist with
+ordinary Assets and inherit normal Pack parameters and instance identities.
+They cannot override the closed ordinary Asset kinds. Authoring `readByGuid`
+can explicitly request a `PackCookSource` from the current build generation;
+that is source data, not a decoded runtime asset. Runtime custom kinds still
+need their normal Registry loader/decoder. No cooker enters the player.
+
 `forgeax asset inspect --subject <source.pack.ts> --root <project> --json` executes module initialization, validates the default export, and projects canonical Meta without calling `build`. `@forgeax/engine-pack/source-node` accepts a host executor with `load` and optional `dispose`; `timeoutMs` bounds module initialization and `buildTimeoutMs` bounds one `build(context)` call. A build timeout returns one structured `pack-source-load-failed` Result with `detail.phase: 'build'`, the configured `timeoutMs`, and deterministic cleanup of the isolated worker and compile root.
 
 The default worker executes the complete relative TypeScript module closure on the supported Node floor, including Node 22 hosts that do not load `.ts` files directly. It transpiles that closure into a disposable ESM directory, resolves bare imports through the source project's nearest `node_modules`, and removes the directory when the worker is disposed. Bulk producers use the internal `createScriptablePackModuleExecutorPool()` with two recyclable workers; a pooled lease is released after metadata projection or one build, so a generation never retains one live Worker-backed definition per source.

package/dist/build.mjs

@@ -1,4 +1,4 @@
-import { ok, err, catalogOperationsFor, authoringCapabilityForAssetKind, MATERIAL_TEXTURE_SLOTS, projectCookProductEvidence, projectAssetEvidence, validateSourceOverrideMap, PACK_ERROR_HINTS, catalogEntryDigest, deriveStandardLayerPlan, AssetError, ImportError } from '@forgeax/engine-types';
+import { ok, err, catalogOperationsFor, authoringCapabilityForAssetKind, MATERIAL_TEXTURE_SLOTS, isMaterialProgramAbi, projectCookProductEvidence, projectAssetEvidence, validateSourceOverrideMap, PACK_ERROR_HINTS, catalogEntryDigest, deriveStandardLayerPlan, AssetError, ImportError } from '@forgeax/engine-types';
 import { dirname, resolve, isAbsolute, relative, join, basename, sep, extname } from 'path';
 import { sha1 } from '@noble/hashes/legacy.js';
 import { uuidv7obj } from 'uuidv7';
@@ -9149,7 +9149,7 @@ function scriptablePackLoadFailure(sourcePath, reason, phase, diagnostic, timeou
 }
 async function loadScriptablePack(sourcePath, options = {}) {
   const timeoutMs = options.timeoutMs ?? 15e3;
-  const buildTimeoutMs = options.buildTimeoutMs ?? 5e3;
+  const buildTimeoutMs = options.buildTimeoutMs ?? 15e3;
   const executor = options.executor ?? new WorkerScriptablePackExecutor();
   let disposeReason;
   let timeout;
@@ -10547,6 +10547,9 @@ function validateCookedMaterialRecord(value) {
   const programs = [];
   const programKeys = /* @__PURE__ */ new Set();
   const selections = /* @__PURE__ */ new Set();
+  const submissionSelections = /* @__PURE__ */ new Map();
+  let modernPublication = false;
+  let legacySelectionField;
   const selectedPasses = /* @__PURE__ */ new Set();
   for (const [index, entry] of candidate.programs.entries()) {
     const field = `programs[${index}]`;
@@ -10564,9 +10567,11 @@ function validateCookedMaterialRecord(value) {
     if (!Array.isArray(program.selections) || program.selections.length === 0)
       return invalid(`${field}.selections`);
     const programSelections = [];
-    for (const [selectionIndex, selection] of program.selections.entries()) {
+    for (const [selectionIndex, rawSelection] of program.selections.entries()) {
       const selectionField = `${field}.selections[${selectionIndex}]`;
-      if (selection === null || typeof selection !== "object" || !passNames.has(selection.pass))
+      if (rawSelection === null || typeof rawSelection !== "object") return invalid(selectionField);
+      const selection = rawSelection;
+      if (typeof selection.pass !== "string" || !passNames.has(selection.pass))
         return invalid(selectionField);
       const context = validateMaterialCookProgramContext(selection.context);
       if (!context.ok)
@@ -10574,11 +10579,51 @@ function validateCookedMaterialRecord(value) {
           `${selectionField}.${context.error.detail.field}`,
           context.error.detail.actual
         );
-      const key = JSON.stringify([selection.pass, materialProgramContextKey(context.value)]);
+      const address = selection.address === void 0 ? "direct" : selection.address;
+      if (address !== "direct" && address !== "scene-index")
+        return invalid(`${selectionField}.address`, selection.address);
+      const hasAddressFacts = selection.address !== void 0 || selection.entry !== void 0 || selection.abi !== void 0;
+      modernPublication ||= hasAddressFacts;
+      if (!hasAddressFacts) legacySelectionField ??= selectionField;
+      const rawEntry = selection.entry;
+      const entry2 = typeof rawEntry === "string" ? rawEntry : void 0;
+      if (hasAddressFacts && selection.address === void 0)
+        return invalid(
+          `${selectionField}.address`,
+          "modern ABI selections require an explicit address"
+        );
+      if (hasAddressFacts && (entry2 === void 0 || entry2.length === 0))
+        return invalid(`${selectionField}.entry`, rawEntry);
+      if (hasAddressFacts && !isMaterialProgramAbi(selection.abi))
+        return invalid(`${selectionField}.abi`, selection.abi);
+      if (hasAddressFacts) {
+        const abi = selection.abi;
+        const expectedEntry = address === "direct" ? abi.directEntry : abi.sceneIndexEntry;
+        if (entry2 !== expectedEntry)
+          return invalid(`${selectionField}.entry`, "entry does not match published ABI");
+        const submissionKey = JSON.stringify([
+          selection.pass,
+          materialProgramContextKey(context.value)
+        ]);
+        const addresses = submissionSelections.get(submissionKey) ?? /* @__PURE__ */ new Set();
+        addresses.add(address);
+        submissionSelections.set(submissionKey, addresses);
+      }
+      const key = JSON.stringify([
+        selection.pass,
+        materialProgramContextKey(context.value),
+        address
+      ]);
       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 });
+      programSelections.push({
+        pass: selection.pass,
+        context: context.value,
+        ...selection.address === void 0 ? {} : { address },
+        ...entry2 === void 0 ? {} : { entry: entry2 },
+        ...selection.abi === void 0 ? {} : { abi: selection.abi }
+      });
     }
     programs.push({
       specializationKey: program.specializationKey,
@@ -10586,6 +10631,17 @@ function validateCookedMaterialRecord(value) {
       selections: programSelections
     });
   }
+  if (modernPublication && legacySelectionField !== void 0) {
+    return invalid(
+      legacySelectionField,
+      "modern material publications require address, entry, and ABI facts on every selection"
+    );
+  }
+  for (const [selectionKey, addresses] of submissionSelections) {
+    if (addresses.size !== 2) {
+      return invalid("programs.selections", `incomplete submission address pair: ${selectionKey}`);
+    }
+  }
   if ([...passNames].some((pass) => !selectedPasses.has(pass)))
     return invalid("programs.selections", "unpublished Pass");
   const manifestDigest = createMaterialProgramSetDigest(programs, passes);
@@ -12767,10 +12823,10 @@ function normalizedAssets(pack) {
     };
   });
 }
-function outputFor(asset) {
+function outputFor(asset, sourceKey2) {
   return {
     guid: asset.guid.toLowerCase(),
-    sourceKey: asset.guid.toLowerCase(),
+    sourceKey: sourceKey2 ?? asset.guid.toLowerCase(),
     kind: asset.kind,
     digest: digest2({
       guid: asset.guid.toLowerCase(),
@@ -12809,7 +12865,7 @@ function createRuntimePackPublication(input) {
     )
   };
   const valueDigest = input.digest ?? digest2(semantic);
-  const outputs = input.outputs ?? assets.map(outputFor);
+  const outputs = input.outputs ?? assets.map((asset) => outputFor(asset, input.sourceKeys?.get(asset.guid.toLowerCase())));
   const outputDigest = outputSetDigest(outputs);
   const generation = input.generation ?? publicationGeneration(input.sourceRevision, valueDigest, outputDigest);
   const externalEvidence = input.externalEvidence ?? [];