@vgai/cli 0.5.10 → 0.5.11

package/dist/index.js

@@ -39660,6 +39660,9 @@ var init_schema = __esm({
             entryHtml: external_exports.string().optional().describe(
               "Entry HTML path, project-relative. WIRED for opaque-embed (D-W2): the file`s bytes are read verbatim through the project-static route and hosted in a sandboxed iframe (embed-only, no scene introspection), for both canvas and three roots. Legal but NOT wired to a mount for iframe-reachable (a named error at resolve names this \u2014 use `bundleUrl` instead, the wired reachable route)."
             ),
+            contractShim: external_exports.string().optional().describe(
+              'Project-relative path to a HOST-ADDED ES module that declares this game\'s `window.vgaiGame` contract (adapter/ingest/game-contract.ts) WITHOUT editing a vendored byte \u2014 the pristine-copy door. The host injects it as a `<script type="module">` into the assembled iframe document AFTER the game`s own importmap (moving a module load ahead of an import map invalidates the map) and BEFORE the game`s entry module, so deferred module scripts run it first. TIMING CONTRACT, which a shim author must obey: because it runs before the game`s entry, it MUST assign `window.vgaiGame` SYNCHRONOUSLY at top level \u2014 the host waits for that assignment and fails the mount by name if it never arrives. Anything that needs the game`s own modules must be LAZY: a dynamic `import()` INSIDE each verb/provider closure, resolved at call time. Importing a game module eagerly from the shim would evaluate it ahead of the game`s own entry and reorder its module side effects. Read by the vendored/self-hosted three route only (strategy `iframe-reachable` with `entryHtml`); declaring it elsewhere is a schema error rather than a silently dead field.'
+            ),
             assets: external_exports.record(external_exports.string(), external_exports.string()).optional().describe(
               "Path-substring -> served-URL rewrites for this ingested game (IngestGame.assets today)"
             ),
@@ -39694,6 +39697,15 @@ var init_schema = __esm({
           }).describe(
             "Ingest adapter configuration for an unmodified game (a repo-vendored game or your own external folder)"
           ).superRefine((ingest, ctx) => {
+            if (ingest.contractShim === void 0 || ingest.strategy === "iframe-reachable" && ingest.entryHtml !== void 0) {
+              return;
+            }
+            ctx.addIssue({
+              code: external_exports.ZodIssueCode.custom,
+              message: `\`contractShim\` is read ONLY by the self-hosted entry-document route, so it requires strategy 'iframe-reachable' together with \`entryHtml\` (got strategy "${ingest.strategy}"${ingest.entryHtml === void 0 ? " and no `entryHtml`" : ""}) \u2014 the host injects the shim module into the GAME'S OWN entry HTML (ingest-self-hosted-three-adapter.ts), and no other mount has such a document.`,
+              path: ["contractShim"]
+            });
+          }).superRefine((ingest, ctx) => {
             const iframeOnlyFields = [
               ["bundleUrl", ingest.bundleUrl !== void 0],
               ["baseHref", ingest.baseHref !== void 0],
@@ -39935,6 +39947,7 @@ function resolveAdapter(root) {
     surface: adapter.surface,
     strategy: ingest.strategy,
     entryHtml: ingest.entryHtml,
+    contractShim: ingest.contractShim,
     assets: ingest.assets,
     domStubs: ingest.domStubs,
     captureTimeoutMs: ingest.captureTimeoutMs,
@@ -324685,8 +324698,8 @@ function catalogDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.10") {
-    return "0.5.10";
+  if ("0.5.11") {
+    return "0.5.11";
   }
   try {
     const pkg = JSON.parse(readFileSync32(join39(__dirname4, "..", "package.json"), "utf8"));
@@ -324705,7 +324718,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.10","@vgai/editor":"0.5.10","@vgai/p2p-colyseus":"0.5.10","@vgai/live":"0.5.10","@vgai/sdk":"0.5.10","@vgai/editor-sdk":"0.5.10","@vgai/cli":"0.5.10"}');
+    return JSON.parse('{"@vgai/engine":"0.5.11","@vgai/editor":"0.5.11","@vgai/p2p-colyseus":"0.5.11","@vgai/live":"0.5.11","@vgai/sdk":"0.5.11","@vgai/editor-sdk":"0.5.11","@vgai/cli":"0.5.11"}');
   } catch {
     return void 0;
   }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.10",
+  "version": "0.5.11",
   "description": "Create, open, control, validate, and playtest VGAI game projects.",
   "keywords": [
     "game-engine",
@@ -39,12 +39,12 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/editor": "0.5.10",
-    "@vgai/editor-sdk": "0.5.10",
-    "@vgai/engine": "0.5.10",
-    "@vgai/live": "0.5.10",
-    "@vgai/p2p-colyseus": "0.5.10",
-    "@vgai/sdk": "0.5.10",
+    "@vgai/editor": "0.5.11",
+    "@vgai/editor-sdk": "0.5.11",
+    "@vgai/engine": "0.5.11",
+    "@vgai/live": "0.5.11",
+    "@vgai/p2p-colyseus": "0.5.11",
+    "@vgai/sdk": "0.5.11",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",