@forgeax/engine-pack 0.1.28 → 0.1.29

package/README.md

@@ -37,11 +37,22 @@ export default definePack({
   build: ({ packageId: subjectId }) =>
     ok({
       'mesh/main': { kind: 'mesh', materialSlots: [] },
+      'scene/hero': {
+        kind: 'scene',
+        entities: { body: { components: {} } },
+      },
       'scene/main': {
         kind: 'scene',
-        entities: [],
-        mounts: [],
-        mesh: AssetGuid.format(AssetGuid.derive(subjectId, 'mesh/main')),
+        entities: {
+          root: { components: {} },
+          hero: {
+            components: {},
+            instance: {
+              source: AssetGuid.format(AssetGuid.derive(subjectId, 'scene/hero')),
+              overrides: [{ target: ['body'], components: {} }],
+            },
+          },
+        },
       },
     }),
 });
@@ -201,9 +212,10 @@ Pack owns the offline half of the GUID evidence chain: `source inventory -> cata
 
 The catalog is a locator, not proof. `lookup/verify --guid --project --catalog --json` joins the source meta or authored pack, the catalog row, the receipt, and the package descriptors. Both commands emit one JSON record on stdout or one structured `{code, expected, hint, detail}` record on stderr; there is no runtime or WebSocket dependency.
 
-## VFX Pack v2 migration
+## VFX Program v3 in Pack v2
 
-VFX source v2 is cooked in one atomic producer step. The executable contract is
+VFX source v3 is cooked in one atomic producer step and stored in the ordinary
+Pack v2 envelope. The executable contract is
 `scripts/asset-cook-contract.mjs`; a package-local scripts path is not valid.
 The cook publishes the Pack payload and
 `particle-effect/program.json` with the same source fingerprint. Runtime loads

package/dist/build.mjs

@@ -9061,9 +9061,17 @@ var WorkerScriptablePackExecutor = class {
         }
       };
       worker.on("message", onMessage);
-      worker.once("error", rejectLoad);
+      const fail = (error) => {
+        rejectLoad(error);
+        const active = this.build;
+        this.build = void 0;
+        active?.reject(error);
+        void this.dispose("failure");
+      };
+      worker.once("error", fail);
       worker.once("exit", (code) => {
-        if (code !== 0) rejectLoad(new Error(`ScriptablePack worker exited with code ${code}`));
+        if (this.disposal !== void 0) return;
+        fail(new Error(`ScriptablePack worker exited with code ${code}`));
       });
     });
   }
@@ -9298,16 +9306,17 @@ function makePackError(code, detail) {
     detail
   });
 }
-function* extractMountSourceGuids(asset) {
+function* extractInstanceSourceGuids(asset) {
   if (asset.kind !== "scene") return;
   const payload = asset.payload;
-  if (!payload || !Array.isArray(payload.mounts)) return;
-  for (const rawMount of payload.mounts) {
-    const mount = rawMount;
-    const idx = mount.source;
-    if (typeof idx !== "number" || !Number.isInteger(idx)) continue;
-    if (idx < 0 || idx >= asset.refs.length) continue;
-    const resolved = asset.refs[idx];
+  if (!payload || payload.entities === null || typeof payload.entities !== "object" || Array.isArray(payload.entities))
+    return;
+  for (const rawEntity of Object.values(payload.entities)) {
+    if (rawEntity === null || typeof rawEntity !== "object" || Array.isArray(rawEntity)) continue;
+    const instance = rawEntity.instance;
+    if (instance === null || typeof instance !== "object" || Array.isArray(instance)) continue;
+    const source = instance.source;
+    const resolved = typeof source === "number" && Number.isInteger(source) ? asset.refs[source] : typeof source === "string" ? source : void 0;
     if (typeof resolved !== "string") continue;
     yield resolved.toLowerCase();
   }
@@ -9425,7 +9434,7 @@ async function scanValidated(roots, opts = {}, capture) {
           guidToPath.set(normalizedGuid, packPath);
           packRefs.set(normalizedGuid, [
             ...asset.refs.map((ref) => ref.toLowerCase()),
-            ...extractMountSourceGuids(asset)
+            ...extractInstanceSourceGuids(asset)
           ]);
         }
       }
@@ -9529,7 +9538,7 @@ async function scanValidated(roots, opts = {}, capture) {
       guidToPath.set(normalizedGuid, packPath);
       packRefs.set(normalizedGuid, [
         ...asset.refs.map((ref) => ref.toLowerCase()),
-        ...extractMountSourceGuids(asset)
+        ...extractInstanceSourceGuids(asset)
       ]);
     }
     capture?.declarations.set(packPath, {
@@ -10714,9 +10723,9 @@ function projectAssetRefs(inventory) {
 }
 function projectSceneEntityRefs(inventory) {
   return inventory.declarations.flatMap(
-    (row) => row.sceneBindings === void 0 ? [] : row.sceneBindings.map((bindingKey) => ({
+    (row) => row.sceneEntityKeys === void 0 ? [] : row.sceneEntityKeys.map((address) => ({
       sceneSourceKey: row.sourceKey,
-      bindingKey
+      address
     }))
   );
 }
@@ -10776,49 +10785,23 @@ function validateAuthorInventory(value) {
         { guid, sourceKey: sourceKey2 }
       );
     }
-    if (row.kind === "scene") {
-      const payload = row.payload;
-      const payloadRecord = typeof payload === "object" && payload !== null ? payload : void 0;
-      const entities = payloadRecord !== void 0 && Array.isArray(payloadRecord.entities) ? payloadRecord.entities : [];
-      const bindings = /* @__PURE__ */ new Set();
-      for (const entity of entities) {
-        const bindingKey = typeof entity === "object" && entity !== null && typeof entity.bindingKey === "string" ? entity.bindingKey : void 0;
-        if (bindingKey !== void 0 && bindingKey.length === 0) {
-          return failure2(
-            "inventory-scene-binding-missing",
-            "each declared scene bindingKey is non-empty",
-            "remove the empty bindingKey or declare a stable key in the scene producer",
-            { sourceKey: sourceKey2 }
-          );
-        }
-        if (bindingKey === void 0) continue;
-        if (bindings.has(bindingKey)) {
-          return failure2(
-            "inventory-scene-binding-duplicate",
-            "bindingKey values are unique within one scene",
-            "rename the duplicate bindingKey in the scene producer",
-            { sourceKey: sourceKey2 }
-          );
-        }
-        bindings.add(bindingKey);
-      }
-    }
     guids.add(normalizedGuid);
     sourceKeys.add(sourceKey2);
-    const sceneBindings = row.kind === "scene" && typeof row.payload === "object" && row.payload !== null ? row.payload.entities?.flatMap(
-      (entity) => {
-        if (typeof entity !== "object" || entity === null) return [];
-        const key = entity.bindingKey;
-        return typeof key === "string" && key.length > 0 ? [key] : [];
-      }
-    ) : void 0;
+    const sceneEntityKeys = (() => {
+      if (row.kind !== "scene" || typeof row.payload !== "object" || row.payload === null)
+        return void 0;
+      const entities = row.payload.entities;
+      if (entities === null || typeof entities !== "object" || Array.isArray(entities))
+        return void 0;
+      return Object.keys(entities);
+    })();
     declarations.push({
       guid,
       sourceKey: sourceKey2,
       kind: typeof row.kind === "string" ? row.kind : "unknown",
       payload: typeof row.payload === "object" && row.payload !== null ? row.payload : {},
       refs: Array.isArray(row.refs) ? row.refs.filter((ref) => typeof ref === "string") : [],
-      ...sceneBindings === void 0 ? {} : { sceneBindings }
+      ...sceneEntityKeys === void 0 ? {} : { sceneEntityKeys }
     });
   }
   return ok({ declarations });
@@ -10827,7 +10810,7 @@ function validateAuthorInventory(value) {
 // src/inventory/sync.ts
 function inventoryDigest(inventory) {
   return inventory.declarations.map(
-    (row) => `${row.guid}\0${row.sourceKey}\0${row.kind}\0${row.sceneBindings?.join("\0") ?? ""}`
+    (row) => `${row.guid}\0${row.sourceKey}\0${row.kind}\0${row.sceneEntityKeys?.join("\0") ?? ""}`
   ).sort().join("\n");
 }
 function syncAuthorInventory(inventory) {
@@ -10835,7 +10818,7 @@ function syncAuthorInventory(inventory) {
     declarations: inventory.declarations.map((row) => ({
       ...row,
       refs: [...row.refs],
-      ...row.sceneBindings === void 0 ? {} : { sceneBindings: [...row.sceneBindings] }
+      ...row.sceneEntityKeys === void 0 ? {} : { sceneEntityKeys: [...row.sceneEntityKeys] }
     }))
   };
 }