@vgai/engine 0.5.20 → 0.5.21

package/dist/pixi/ingest.d.ts

@@ -10,6 +10,29 @@ export interface IngestGame2D {
     /** How long to wait for the game's first captured frame before failing. */
     captureTimeoutMs?: number;
 }
+/**
+ * The game's own modules failed to load or run — a DIFFERENT defect from
+ * "loaded, but the host's pixi never saw a frame", and named so a caller can
+ * tell them apart.
+ *
+ * Both used to arrive as a bare `Error`, so `mount-canvas-ingest-root.ts`'s
+ * one catch reported a module that 404'd, threw, or failed to transform in
+ * the capture trap's words — "the host's pixi captured no frame ... or it
+ * bundles its own (un-shared) copy of pixi.js". That sentence sends the
+ * reader to the wrong file: it describes a module-identity problem, and the
+ * measured cause was a JSX-bearing `.js` module the packaged host had no
+ * transform for.
+ *
+ * Classified by `name` ({@link INGEST_GAME_2D_LOAD_ERROR_NAME}) rather than
+ * `instanceof` — under the packaged runtime the editor shell and the project
+ * graph can hold different instances of a module, and this whole lane exists
+ * because of that; a discriminator that silently flips when the class object
+ * differs is the wrong tool for saying which failure happened.
+ */
+export declare const INGEST_GAME_2D_LOAD_ERROR_NAME = "IngestGame2DLoadError";
+export declare class IngestGame2DLoadError extends Error {
+    constructor(gameId: string, cause: unknown);
+}
 export interface IngestMount2D {
     /** The captured live stage Container. */
     stage: unknown;

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,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;CACpD,GACL,OAAO,CAAC,aAAa,CAAC,CA6BxB"}

package/dist/pixi/ingest.js

@@ -1,4 +1,30 @@
 import { installSceneCapture2D, } from './scene-capture';
+/**
+ * The game's own modules failed to load or run — a DIFFERENT defect from
+ * "loaded, but the host's pixi never saw a frame", and named so a caller can
+ * tell them apart.
+ *
+ * Both used to arrive as a bare `Error`, so `mount-canvas-ingest-root.ts`'s
+ * one catch reported a module that 404'd, threw, or failed to transform in
+ * the capture trap's words — "the host's pixi captured no frame ... or it
+ * bundles its own (un-shared) copy of pixi.js". That sentence sends the
+ * reader to the wrong file: it describes a module-identity problem, and the
+ * measured cause was a JSX-bearing `.js` module the packaged host had no
+ * transform for.
+ *
+ * Classified by `name` ({@link INGEST_GAME_2D_LOAD_ERROR_NAME}) rather than
+ * `instanceof` — under the packaged runtime the editor shell and the project
+ * graph can hold different instances of a module, and this whole lane exists
+ * because of that; a discriminator that silently flips when the class object
+ * differs is the wrong tool for saying which failure happened.
+ */
+export const INGEST_GAME_2D_LOAD_ERROR_NAME = 'IngestGame2DLoadError';
+export class IngestGame2DLoadError extends Error {
+    constructor(gameId, cause) {
+        super(`pixi ingest: game "${gameId}" failed to load: ${cause}`, { cause });
+        this.name = INGEST_GAME_2D_LOAD_ERROR_NAME;
+    }
+}
 /**
  * Mount an UNMODIFIED PixiJS game via the shared-instance capture path — the 2D
  * analog of `mountIngestGame`. Installs the render trap on the host's pixi
@@ -21,7 +47,7 @@ export async function mountIngestGame2D(pixiNamespace, game, opts = {}) {
     }
     catch (err) {
         capture.uninstall();
-        throw new Error(`pixi ingest: game "${game.id}" failed to load: ${err}`);
+        throw new IngestGame2DLoadError(game.id, err);
     }
     const timeout = opts.captureTimeoutMs ?? game.captureTimeoutMs ?? 8000;
     try {

package/package.json

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

package/src/pixi/ingest.ts

@@ -16,6 +16,34 @@ export interface IngestGame2D {
   captureTimeoutMs?: number;
 }
 
+/**
+ * The game's own modules failed to load or run — a DIFFERENT defect from
+ * "loaded, but the host's pixi never saw a frame", and named so a caller can
+ * tell them apart.
+ *
+ * Both used to arrive as a bare `Error`, so `mount-canvas-ingest-root.ts`'s
+ * one catch reported a module that 404'd, threw, or failed to transform in
+ * the capture trap's words — "the host's pixi captured no frame ... or it
+ * bundles its own (un-shared) copy of pixi.js". That sentence sends the
+ * reader to the wrong file: it describes a module-identity problem, and the
+ * measured cause was a JSX-bearing `.js` module the packaged host had no
+ * transform for.
+ *
+ * Classified by `name` ({@link INGEST_GAME_2D_LOAD_ERROR_NAME}) rather than
+ * `instanceof` — under the packaged runtime the editor shell and the project
+ * graph can hold different instances of a module, and this whole lane exists
+ * because of that; a discriminator that silently flips when the class object
+ * differs is the wrong tool for saying which failure happened.
+ */
+export const INGEST_GAME_2D_LOAD_ERROR_NAME = 'IngestGame2DLoadError';
+
+export class IngestGame2DLoadError extends Error {
+  constructor(gameId: string, cause: unknown) {
+    super(`pixi ingest: game "${gameId}" failed to load: ${cause}`, { cause });
+    this.name = INGEST_GAME_2D_LOAD_ERROR_NAME;
+  }
+}
+
 export interface IngestMount2D {
   /** The captured live stage Container. */
   stage: unknown;
@@ -53,7 +81,7 @@ export async function mountIngestGame2D(
     await game.load();
   } catch (err) {
     capture.uninstall();
-    throw new Error(`pixi ingest: game "${game.id}" failed to load: ${err}`);
+    throw new IngestGame2DLoadError(game.id, err);
   }
 
   const timeout = opts.captureTimeoutMs ?? game.captureTimeoutMs ?? 8000;