@forgeax/engine-import 0.1.24 → 0.1.26

package/README.md

@@ -145,7 +145,10 @@ Domain producers return structured `ImportError`; the generic bridge contains no
 
 `createStandardAssetOutputProducerRegistry(sceneComponents)` registers the production
 Material, Mesh, and Scene producers. Material output derives
-parent/texture/sampler refs; Mesh output derives default-material refs and emits
+parent/texture/sampler refs. Material texture references serialize as
+`{ texture: refsIndex, sampler?: refsIndex }`, including GUID string shorthand;
+bare numeric values remain scalars in children without a local parameter schema.
+Mesh output derives default-material refs and emits
 the `mesh-binary/4` body; Scene output uses the definition-bound neutral schema
 through the shared ECS externalization contract. A specialized host may instead
 register only the admitted kinds:

package/dist/build-production.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-production.d.ts","sourceRoot":"","sources":["../src/build-production.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AASvE,OAAO,KAAK,EAKV,cAAc,EACd,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAkB/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,KAAK,CAAC;CAC3D;AA8vBD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B"}
+{"version":3,"file":"build-production.d.ts","sourceRoot":"","sources":["../src/build-production.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AASvE,OAAO,KAAK,EAKV,cAAc,EACd,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAkB/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,KAAK,CAAC;CAC3D;AA+vBD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B"}

package/dist/index.mjs

@@ -785,6 +785,9 @@ function record(value) {
 function isAsset(value) {
   return record(value) && typeof value.kind === "string" && isScriptablePackAssetKind(value.kind);
 }
+function needsMaterialCook(asset) {
+  return asset.kind === "material" && Array.isArray(asset.passes) && !isEngineMaterial(asset);
+}
 function clone(value) {
   return structuredClone(value);
 }
@@ -1009,6 +1012,9 @@ async function buildScriptablePack(options) {
   const imported = [];
   const stagedOutputs = [];
   const localGuids = /* @__PURE__ */ new Set();
+  const materialCookerRegistry = new NativeCookerRegistry();
+  for (const cooker of options.cookers ?? []) materialCookerRegistry.register(cooker);
+  const nativeFingerprints = /* @__PURE__ */ new Map();
   for (const sourceKey of Object.keys(built.value).sort()) {
     if (!isValidPackSourceKey(sourceKey))
       return err(sourceKeyFailure(options.sourcePath, sourceKey));
@@ -1084,12 +1090,40 @@ async function buildScriptablePack(options) {
     const invalidProduct2 = productError(options.sourcePath, sourceKey, producer, produced.value);
     if (invalidProduct2 !== void 0) return err(invalidProduct2);
     const product2 = produced.value;
+    let payload = product2.payload;
+    let artifacts2 = product2.artifacts;
+    if (needsMaterialCook(asset) && materialCookerRegistry.get("material") !== void 0) {
+      const cooked = await materialCookerRegistry.runDraft("material", {
+        guid,
+        source: asset,
+        sourceKey,
+        sourcePath: options.sourcePath,
+        refs: product2.refs.map((reference) => reference.guid)
+      });
+      if (!cooked.ok) return err(cooked.error);
+      if (cooked.value.guid.toLowerCase() !== normalizedGuid) {
+        return err({
+          code: "pack-source-output-invalid",
+          expected: "the authored material cooker to preserve the derived AssetGuid",
+          hint: "repair the native material cooker output GUID and rebuild the Pack",
+          detail: {
+            sourcePath: options.sourcePath,
+            sourceKey,
+            expectedGuid: guid,
+            actualGuid: cooked.value.guid
+          }
+        });
+      }
+      payload = cooked.value.payload;
+      artifacts2 = cooked.value.artifacts;
+      nativeFingerprints.set(sourceKey, cooked.value.inputFingerprint);
+    }
     imported.push({
       guid,
       kind: asset.kind,
-      payload: product2.payload,
+      payload,
       refs: product2.refs,
-      artifacts: product2.artifacts
+      artifacts: artifacts2
     });
     stagedOutputs.push({
       guid: AssetGuid.derive(subjectPackageId, sourceKey),
@@ -1120,7 +1154,7 @@ async function buildScriptablePack(options) {
       digest: read.digest
     })
   );
-  const inputFingerprint = await digest({
+  const authoredInputFingerprint = await digest({
     packageId: PackageId.format(subjectPackageId),
     sourcePath: options.sourcePath,
     sourceClosure: options.sourceClosure ?? [],
@@ -1133,6 +1167,12 @@ async function buildScriptablePack(options) {
     authoringContractVersion: options.authoringContractVersion ?? "scriptable-pack/1",
     producerVersions: options.outputs.versions()
   });
+  const inputFingerprint = nativeFingerprints.size === 0 ? authoredInputFingerprint : await digest({
+    sourceRevision: authoredInputFingerprint,
+    nativeCookers: [...nativeFingerprints.entries()].sort(
+      ([left], [right]) => left.localeCompare(right)
+    )
+  });
   const refs = imported.flatMap((asset) => asset.refs);
   const artifacts = Object.fromEntries(
     imported.flatMap(
@@ -1214,6 +1254,7 @@ async function buildScriptablePackWorklist(options) {
         ...subject.inheritedValues === void 0 ? {} : { inheritedValues: subject.inheritedValues },
         ...subject.sourceClosure === void 0 ? {} : { sourceClosure: subject.sourceClosure },
         outputs: options.outputs,
+        ...options.cookers === void 0 ? {} : { cookers: options.cookers },
         assetSource: stagedSource(staged, options.assetSource),
         availableGuids: /* @__PURE__ */ new Set([...availableGuids, ...staged.keys()]),
         deferReferenceValidation: true
@@ -1572,7 +1613,9 @@ function materialProduct(input) {
   for (const fieldName of Object.keys(material.values ?? {}).sort()) {
     const value = material.values?.[fieldName];
     if (typeof value === "string" && textureFields.has(fieldName)) {
-      values[fieldName] = addMaterialRef(value, { componentName: "<material>", fieldName });
+      values[fieldName] = {
+        texture: addMaterialRef(value, { componentName: "<material>", fieldName })
+      };
     } else if (value !== null && typeof value === "object" && !Array.isArray(value) && "texture" in value) {
       const texture = value;
       values[fieldName] = {
@@ -1905,7 +1948,7 @@ function ordinaryPodProduct(input) {
 }
 var materialAssetOutputProducer = createSafeProducer(
   "material",
-  "material-pack/1",
+  "material-pack/2",
   materialProduct
 );
 var meshAssetOutputProducer = createSafeProducer("mesh", "mesh-binary/4", meshProduct);
@@ -2191,6 +2234,8 @@ async function readCookedAuthoredPack(authoredPack, cookers = [], sourcePath) {
       continue;
     }
     if (isEngineOwnedMaterial(asset)) {
+      hasCookedAsset = true;
+      refsByGuid.set(asset.guid.toLowerCase(), [...asset.refs]);
       assets.push({
         guid: asset.guid,
         kind: asset.kind,
@@ -2679,6 +2724,7 @@ async function produceScriptablePackProducts(options) {
         (source) => projectScriptablePackSceneComponents(source.definition.sceneComponents)
       )
     ),
+    ...options.cookers === void 0 ? {} : { cookers: options.cookers },
     ...assetSource === void 0 ? {} : { assetSource },
     availableGuids,
     ...options.incomingRefs === void 0 ? {} : { incomingRefs: options.incomingRefs },
@@ -2980,6 +3026,7 @@ async function buildPackSources(context) {
   const built = await produceScriptablePackProducts({
     sources: inputs,
     declaredExternalOutputs: externalOutputs,
+    cookers: context.cookers,
     availableGuids
   });
   if (!built.ok) dynamicFailure(context, built.error);