@vgai/engine 0.5.28 → 0.5.30

package/dist/pixi/ingest.d.ts

@@ -57,5 +57,12 @@ export declare function mountIngestGame2D(pixiNamespace: unknown, game: IngestGa
     captureTimeoutMs?: number;
     onWait?: (wait: VisibleCaptureWindow | null) => void;
     acceptCapture?: (runtime: CapturedRuntime2D) => boolean;
-}): Promise<IngestMount2D>;
+    /**
+     * Called after the entry has run, before spending the Pixi capture budget.
+     * A canvas host with other structural adapters can answer true once one of
+     * those runtimes is ready; `null` then means "dispatch that runtime" rather
+     * than "Pixi failed".
+     */
+    preferStructuralRuntime?: () => boolean | Promise<boolean>;
+}): Promise<IngestMount2D | null>;
 //# sourceMappingURL=ingest.d.ts.map

package/dist/pixi/ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/pixi/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI3C;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;CACpD,GACL,OAAO,CAAC,aAAa,CAAC,CA6BxB"}
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/pixi/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI3C;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACxD;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD,GACL,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiC/B"}

package/dist/pixi/ingest.js

@@ -44,6 +44,10 @@ export async function mountIngestGame2D(pixiNamespace, game, opts = {}) {
     });
     try {
         await game.load();
+        if (await opts.preferStructuralRuntime?.()) {
+            capture.uninstall();
+            return null;
+        }
     }
     catch (err) {
         capture.uninstall();

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/engine",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.28",
+  "version": "0.5.30",
   "description": "Readable TypeScript game engine and universal host for Three.js, PixiJS, and React games.",
   "keywords": [
     "game-engine",

package/src/pixi/ingest.ts

@@ -72,13 +72,24 @@ export async function mountIngestGame2D(
     captureTimeoutMs?: number;
     onWait?: (wait: VisibleCaptureWindow | null) => void;
     acceptCapture?: (runtime: CapturedRuntime2D) => boolean;
+    /**
+     * Called after the entry has run, before spending the Pixi capture budget.
+     * A canvas host with other structural adapters can answer true once one of
+     * those runtimes is ready; `null` then means "dispatch that runtime" rather
+     * than "Pixi failed".
+     */
+    preferStructuralRuntime?: () => boolean | Promise<boolean>;
   } = {},
-): Promise<IngestMount2D> {
+): Promise<IngestMount2D | null> {
   const capture = installSceneCapture2D(pixiNamespace, {
     ...(opts.acceptCapture ? { accept: opts.acceptCapture } : {}),
   });
   try {
     await game.load();
+    if (await opts.preferStructuralRuntime?.()) {
+      capture.uninstall();
+      return null;
+    }
   } catch (err) {
     capture.uninstall();
     throw new IngestGame2DLoadError(game.id, err);