@vgai/cli 0.5.52 → 0.5.53

package/dist/index.js

@@ -25947,6 +25947,15 @@ var init_client = __esm({
         return data.entries;
       }
       // --- State ---
+      /**
+       * The document table the host resolved — every scene, prefab, page, model,
+       * shot, take … the project's finders produced (`getState().adapter.scenes`
+       * is the same projection). A command, so it answers on the browser tier
+       * too, where there is no `/__editor/state` route.
+       */
+      async documentTable() {
+        return this.command({ type: "document-table" });
+      }
       async getState() {
         const res = await this.httpFetch(`${this.baseUrl}/__editor/state`);
         const state = await this.readJson(res);
@@ -334365,7 +334374,28 @@ function printParseErrorCode(code) {
 init_locate();
 
 // ../create-vgai-project/src/additions.ts
-var SCAFFOLD_ADDITIONS = ["three", "ui", "server", "mesh", "studio"];
+var SCAFFOLD_ADDITIONS = [
+  "three",
+  "ui",
+  "server",
+  "mesh",
+  "studio",
+  "production"
+];
+var ADDITION_REQUIRES = {
+  studio: ["three"],
+  production: ["three"]
+};
+function closeAdditions(additions) {
+  const wanted = /* @__PURE__ */ new Set();
+  const visit2 = (addition) => {
+    if (wanted.has(addition)) return;
+    wanted.add(addition);
+    for (const required2 of ADDITION_REQUIRES[addition] ?? []) visit2(required2);
+  };
+  for (const addition of additions) visit2(addition);
+  return SCAFFOLD_ADDITIONS.filter((addition) => wanted.has(addition));
+}
 function isScaffoldAddition(value) {
   return typeof value === "string" && SCAFFOLD_ADDITIONS.includes(value);
 }
@@ -334374,7 +334404,14 @@ var TEMPLATE_ADDITIONS = {
   prototype: ["three"],
   game: ["three", "server", "studio"],
   website: ["ui"],
-  models: ["mesh"]
+  models: ["mesh"],
+  // The four skews (ARCHITECTURE-CORE §Apps are addition presets, "The four
+  // skews"): `models` is the Blender, `website` the design tool, `production`
+  // the virtual production system, and `full` is every addition in one
+  // project — the composition acceptance made permanent, so an addition that
+  // special-cases the presence of another shows here first.
+  production: ["three", "production"],
+  full: [...SCAFFOLD_ADDITIONS]
 };
 var THREE_OWNED_PATHS = [
   "src/world.tsx",
@@ -334523,7 +334560,7 @@ var STARTER_MODEL_SOURCE = `import * as THREE from 'three';
  * three.js. Edit it in the editor (Edit Mesh appends each gesture as one
  * line below, before the whole-mesh tail), edit it by hand, or delete the
  * file once your own model exists. Blender's topology operators live in
- * '../lib/mesh/geometry' as functions over BufferGeometry \u2014 bevel, inset,
+ * '@vgai/mesh/geometry' as functions over BufferGeometry \u2014 bevel, inset,
  * loopCut, extrudeRegion, subdivisionSurface\u2026 \u2014 with selectors in three.js
  * coordinates (Y up) and radians:
  *
@@ -334535,12 +334572,129 @@ export function build(): THREE.BufferGeometry {
   return new THREE.BoxGeometry(1, 1, 1);
 }
 `;
+var STARTER_SHOT_PATH = "src/shots/010-establishing/010-establishing.shot.ts";
+var STARTER_TAKE_PATH = "src/shots/010-establishing/takes/camera-a.theatre-project.json";
+var STARTER_SHOT_SOURCE = `import { defineShot } from '../../lib/production/shot';
+
+/**
+ * Shot 010 \u2014 the establishing shot over the starter set. A shot names the SET
+ * (a key of src/world.tsx's \`scenes\` table), its range and rate, the takes
+ * recorded for it, and which take each object plays (\`select\`). Edit it by
+ * hand; the Shots bin and the shot document read this file.
+ */
+export const shot = defineShot({
+  id: '010',
+  title: 'Establishing',
+  scene: 'main',
+  fps: 30,
+  range: { in: 0, out: 4 },
+  camera: 'Camera',
+  takes: [
+    {
+      id: 'camera-a',
+      sheet: '${STARTER_TAKE_PATH}',
+      recorded: '2026-09-15',
+      by: 'starter',
+      kept: true,
+      notes: 'A slow push-in while the hero box turns to camera.',
+    },
+  ],
+  select: {
+    Camera: { take: 'camera-a' },
+    'Hero Box': { take: 'camera-a' },
+  },
+});
+`;
+function starterTrack(id, keys) {
+  const keyframes = keys.map(
+    ([position, value], index) => `{ "id": "${id}-k${index}", "value": ${value}, "position": ${position}, "handles": [0.5, 1, 0.5, 0], "connectedRight": true, "type": "bezier" }`
+  );
+  return `"${id}": { "type": "BasicKeyframedTrack", "keyframes": [ ${keyframes.join(", ")} ] }`;
+}
+var STARTER_TAKE_SOURCE = `{
+  "sheetsById": {
+    "Main": {
+      "staticOverrides": { "byObject": {} },
+      "sequence": {
+        "type": "PositionalSequence",
+        "length": 4,
+        "subUnitsPerUnit": 30,
+        "tracksByObject": {
+          "Camera": {
+            "trackIdByPropPath": {
+              "[\\"position\\",\\"x\\"]": "camera_position_x",
+              "[\\"position\\",\\"y\\"]": "camera_position_y",
+              "[\\"position\\",\\"z\\"]": "camera_position_z"
+            },
+            "trackData": {
+              ${starterTrack("camera_position_x", [
+  [0, 7.35],
+  [4, 5.4]
+])},
+              ${starterTrack("camera_position_y", [
+  [0, 3.9],
+  [4, 3.1]
+])},
+              ${starterTrack("camera_position_z", [
+  [0, 8.15],
+  [4, 6]
+])}
+            }
+          },
+          "Hero Box": {
+            "trackIdByPropPath": {
+              "[\\"position\\",\\"y\\"]": "hero_position_y",
+              "[\\"rotation\\",\\"y\\"]": "hero_rotation_y"
+            },
+            "trackData": {
+              ${starterTrack("hero_position_y", [
+  [0, 1.3],
+  [2, 1.9],
+  [4, 1.3]
+])},
+              ${starterTrack("hero_rotation_y", [
+  [0, -0.28],
+  [4, 2.86]
+])}
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitionVersion": "0.4.0",
+  "revisionHistory": []
+}
+`;
+var PRODUCTION_FILES = {
+  [STARTER_SHOT_PATH]: STARTER_SHOT_SOURCE,
+  [STARTER_TAKE_PATH]: STARTER_TAKE_SOURCE
+};
+function withTemplateEditorConfiguration(source, template, additions = new Set(TEMPLATE_ADDITIONS[template])) {
+  const workspace = template === "production" ? "stage" : template === "models" ? "model" : template === "website" ? "design" : "game";
+  const studio = additions.has("studio");
+  const editor2 = `  editor: {
+    workspace: '${workspace}',
+    inspector: '${studio ? "column" : "card"}',
+    playUtilities: [${studio ? "'tool:analytics.analytics'" : ""}],
+  },`;
+  if (!source.includes("defineAdapter({"))
+    throw new Error("Starter vgai.adapter.ts must call defineAdapter({ ... }).");
+  return source.replace(
+    "defineAdapter({",
+    `defineAdapter({
+${editor2}`
+  );
+}
 var PAGES_FINDER_SELECTION = "{ finder: 'pagesFromUiModules', include: ['src/ui/**/*page.tsx'] }";
 var MODELS_FINDER_SELECTION = "{ finder: 'modelsFromMeshModules', include: ['src/models/**/*.ts'] }";
+var SHOTS_FINDER_SELECTION = "{ finder: 'shotsFromShotModules', include: ['src/shots/**/*.shot.ts'] }";
+var TAKES_FINDER_SELECTION = "{ finder: 'takesFromTheatreFiles', include: ['src/shots/**/*.theatre-project.json'] }";
 function joinAdditionFinders(adapterSource, additions) {
   const joined = [];
   if (additions.has("ui")) joined.push(PAGES_FINDER_SELECTION);
   if (additions.has("mesh")) joined.push(MODELS_FINDER_SELECTION);
+  if (additions.has("production")) joined.push(SHOTS_FINDER_SELECTION, TAKES_FINDER_SELECTION);
   if (joined.length === 0) return adapterSource;
   return adapterSource.replace(
     "{ finder: 'prefabsFromStories' },",
@@ -335108,7 +335262,8 @@ function mergeStringDependencies(target, field, incoming, owner, origins) {
     const existing = merged[name];
     const key = `${field}.${name}`;
     if (existing !== void 0) {
-      const winner = typeof existing !== "string" ? null : field === "scripts" ? existing === spec ? existing : null : widerSpec(existing, spec);
+      const projectOwned = !origins.has(key);
+      const winner = typeof existing !== "string" ? null : field === "scripts" ? existing === spec ? existing : null : projectOwned ? widerSpec(existing, spec) === null ? null : existing : widerSpec(existing, spec);
       if (winner === null) {
         const from = origins.get(key) ?? "the project package.json";
         throw new Error(
@@ -335696,6 +335851,33 @@ var templates_default = {
         "Opens in the Model workspace"
       ]
     },
+    {
+      id: "production",
+      title: "Virtual production",
+      description: "A set to dress, shots to frame and takes to play \u2014 authored, never played. The 3D world plus the virtual-production capability.",
+      source: "template:production",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "Three.js world root as the set",
+        "src/shots/ with a starter shot and take",
+        "The Shots bin and the shot document",
+        "Opens in the Stage workspace; the Unreal keymap is one View \u25B8 Keymap choice"
+      ]
+    },
+    {
+      id: "full",
+      title: "Everything",
+      description: "Every addition in one project \u2014 a 3D world, a UI root, a multiplayer server, development panels, models and virtual production. The composition acceptance: nothing here special-cases the presence of anything else.",
+      source: "template:full",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "Three.js world + React DOM root",
+        "server + multiplayer configurations",
+        "Data, Game Inspector and Analytics stubs",
+        "mesh + virtual-production capabilities",
+        "Game, Model, Stage and every other workspace"
+      ]
+    },
     {
       id: "first-person",
       title: "First Person",
@@ -335721,7 +335903,15 @@ var templates_default = {
 };
 
 // ../create-vgai-project/src/templates.ts
-var TEMPLATE_COMPOSITION_IDS = ["empty", "prototype", "game", "website", "models"];
+var TEMPLATE_COMPOSITION_IDS = [
+  "empty",
+  "prototype",
+  "game",
+  "website",
+  "models",
+  "production",
+  "full"
+];
 var SCAFFOLD_PRESENTATIONS = ["blank"];
 function parseTemplateSource(source) {
   const exampleId = source.startsWith("example:") ? source.slice("example:".length) : void 0;
@@ -335802,7 +335992,16 @@ function loadTemplateRegistry() {
 }
 
 // ../create-vgai-project/src/scaffold.ts
-var SCAFFOLD_TEMPLATES = ["empty", "prototype", "game", "website", "models", "example"];
+var SCAFFOLD_TEMPLATES = [
+  "empty",
+  "prototype",
+  "game",
+  "website",
+  "models",
+  "production",
+  "full",
+  "example"
+];
 function resolveScaffoldPackageDir(monoRoot, checkoutRelativePath, packageName) {
   const checkoutDir = join15(monoRoot, checkoutRelativePath);
   if (existsSync10(checkoutDir)) return checkoutDir;
@@ -336303,7 +336502,21 @@ function rewriteTemplateVariantFiles(targetDir, additions) {
     writeFileSync4(join15(targetDir, "src", "models", "cube.ts"), STARTER_MODEL_SOURCE, "utf-8");
     relaxIndexAccessForModels(targetDir);
   }
+  if (additions.has("production")) {
+    for (const [relative13, source] of Object.entries(PRODUCTION_FILES)) {
+      mkdirSync5(dirname9(join15(targetDir, relative13)), { recursive: true });
+      writeFileSync4(join15(targetDir, relative13), source, "utf-8");
+    }
+  }
   if (!additions.has("ui")) return;
+  if (additions.has("three")) {
+    for (const [relative13, source] of Object.entries(REACT_ONLY_FILES)) {
+      if (relative13 === "src/main.ts") continue;
+      mkdirSync5(dirname9(join15(targetDir, relative13)), { recursive: true });
+      writeFileSync4(join15(targetDir, relative13), source, "utf-8");
+    }
+    return;
+  }
   for (const relative13 of REACT_ONLY_REMOVED_PATHS) {
     rmSync2(join15(targetDir, relative13), { recursive: true, force: true });
   }
@@ -336337,7 +336550,11 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
   }
   tsconfig.compilerOptions = tsconfig.compilerOptions ?? {};
   tsconfig.compilerOptions.paths = {
-    "@vgai/engine/*": [`${engineRelPath}/src/*`]
+    "@vgai/engine/*": [`${engineRelPath}/src/*`],
+    // `@vgai/mesh` exports extensionless `./src/*` the same way, so a model
+    // module's `@vgai/mesh/geometry` needs the same alias to typecheck; the
+    // entry is inert for a project that never declares the package.
+    "@vgai/mesh/*": ["node_modules/@vgai/mesh/src/*"]
   };
   if (editorRelPath) {
     tsconfig.compilerOptions.paths["@editor/*"] = [`${editorRelPath}/src/*`];
@@ -336385,7 +336602,9 @@ function rewriteIndexHtml(targetDir, name) {
 function scaffoldProject(opts) {
   const { name, targetDir, monoRoot } = opts;
   const template = opts.template ?? "empty";
-  const additions = template === "example" ? null : /* @__PURE__ */ new Set([...TEMPLATE_ADDITIONS[template], ...opts.additions ?? []]);
+  const additions = template === "example" ? null : new Set(
+    closeAdditions([...TEMPLATE_ADDITIONS[template], ...opts.additions ?? []])
+  );
   if (template === "example" && !opts.exampleId) {
     throw new Error('exampleId is required when template is "example"');
   }
@@ -336415,6 +336634,18 @@ function scaffoldProject(opts) {
   rewritePackageJson(targetDir, slug, engineDir, monoRoot);
   const manifest = rewriteGameManifest(targetDir, name, slug, additions, monoRoot);
   if (additions) rewriteTemplateVariantFiles(targetDir, additions);
+  if (template !== "example") {
+    const adapterPath = join15(targetDir, "vgai.adapter.ts");
+    writeFileSync4(
+      adapterPath,
+      withTemplateEditorConfiguration(
+        readFileSync11(adapterPath, "utf-8"),
+        template,
+        additions ?? void 0
+      ),
+      "utf-8"
+    );
+  }
   rewriteTsconfig(targetDir, engineRelPath, editorRelPath);
   rewriteViteConfig(targetDir);
   rewriteIndexHtml(targetDir, name);
@@ -336423,7 +336654,8 @@ function scaffoldProject(opts) {
   if (hasCapabilityDistribution && additions) {
     const ids = [
       ...additions.has("ui") ? DEFAULT_REACT_CAPABILITIES : [],
-      ...additions.has("mesh") ? ["mesh"] : []
+      ...additions.has("mesh") ? ["mesh"] : [],
+      ...additions.has("production") ? ["virtual-production"] : []
     ];
     if (ids.length > 0) addCapabilities({ catalogDir, ids: [...ids], projectDir: targetDir });
   }
@@ -338679,6 +338911,8 @@ var RELAY_COMMANDS = {
   "show-build": alwaysRefresh(),
   "present-view": alwaysRefresh(3e4),
   "current-view": refreshIfContentChanged(),
+  // A read of the resolved document table; changes nothing.
+  "document-table": noDerivedRefresh(),
   // ---- Inspection and authoring ------------------------------------------
   // The inspection writes go through the project mutation path, which touches
   // the filesystem and may wait on a collaboration revision.
@@ -354402,8 +354636,8 @@ function catalogDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.52") {
-    return "0.5.52";
+  if ("0.5.53") {
+    return "0.5.53";
   }
   try {
     const pkg = JSON.parse(readFileSync32(join39(__dirname4, "..", "package.json"), "utf8"));
@@ -354422,7 +354656,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.52","@vgai/editor":"0.5.52","@vgai/p2p-colyseus":"0.5.52","@vgai/live":"0.5.52","@vgai/sdk":"0.5.52","@vgai/editor-sdk":"0.5.52","@vgai/cli":"0.5.52"}');
+    return JSON.parse('{"@vgai/engine":"0.5.53","@vgai/editor":"0.5.53","@vgai/p2p-colyseus":"0.5.53","@vgai/live":"0.5.53","@vgai/sdk":"0.5.53","@vgai/editor-sdk":"0.5.53","@vgai/cli":"0.5.53"}');
   } catch {
     return void 0;
   }
@@ -354625,7 +354859,7 @@ Project:
                               below: reuses/starts a session, opens the browser, prints the URL
                               as the LAST line of output). Suppressed when CI is set or --no-edit
                               is passed \u2014 run \`vgai edit\` yourself then.
-    --template empty|prototype|game|website|models
+    --template empty|prototype|game|website|models|production|full
                               Project composition (default: empty)
     --example <id>            Scaffold from examples/<id>/ instead (implies --template example)
     --no-edit                 Don't auto-launch the editor after scaffolding
@@ -355770,6 +356004,24 @@ function createProject(name, location2, template, exampleId, additions = []) {
     ...exampleId !== void 0 ? { exampleId } : {}
   });
 }
+function installCheckoutPackagesFromCheckout(projectDir, monoRoot) {
+  const plan = planCheckoutLink(projectDir, monoRoot);
+  if (plan.packages.length === 0) return () => void 0;
+  const pkgPath = join39(projectDir, "package.json");
+  const original = readFileSync32(pkgPath, "utf8");
+  const pkg = JSON.parse(original);
+  plan.packages.forEach((name, index) => {
+    const dir = plan.directories[index];
+    if (!dir) return;
+    for (const section of ["dependencies", "devDependencies"]) {
+      const deps = pkg[section];
+      if (deps?.[name] !== void 0) deps[name] = `file:${dir}`;
+    }
+  });
+  writeFileSync15(pkgPath, `${JSON.stringify(pkg, null, 2)}
+`);
+  return () => writeFileSync15(pkgPath, original);
+}
 function listAvailableExamples(monoRoot = ENGINE_ROOT) {
   const examplesDir = resolveScaffoldExamplesDir(monoRoot);
   if (!existsSync27(examplesDir)) return [];
@@ -358391,17 +358643,26 @@ Unrecognized option or invalid project name: ${name}`);
         if (tryCloneDependencies(targetDir)) {
           console.log("Dependencies cloned from the local store.");
         } else {
-          const install = spawn4("npm", ["install", "--no-audit", "--no-fund", "--loglevel=error"], {
-            cwd: targetDir,
-            stdio: "inherit",
-            shell: true
-          });
-          const exitCode = await new Promise((resolve22, reject) => {
-            install.on("error", reject);
-            install.on("close", resolve22);
-          });
-          if (exitCode !== 0)
-            throw new Error(`npm install exited with code ${exitCode ?? "unknown"}`);
+          const restoreSpecs = installCheckoutPackagesFromCheckout(targetDir, ENGINE_ROOT);
+          try {
+            const install = spawn4(
+              "npm",
+              ["install", "--prefer-offline", "--no-audit", "--no-fund", "--loglevel=error"],
+              {
+                cwd: targetDir,
+                stdio: "inherit",
+                shell: true
+              }
+            );
+            const exitCode = await new Promise((resolve22, reject) => {
+              install.on("error", reject);
+              install.on("close", resolve22);
+            });
+            if (exitCode !== 0)
+              throw new Error(`npm install exited with code ${exitCode ?? "unknown"}`);
+          } finally {
+            restoreSpecs();
+          }
           cacheDependencies(targetDir);
         }
         try {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.52",
+  "version": "0.5.53",
   "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.52",
-    "@vgai/editor-sdk": "0.5.52",
-    "@vgai/engine": "0.5.52",
-    "@vgai/live": "0.5.52",
-    "@vgai/p2p-colyseus": "0.5.52",
-    "@vgai/sdk": "0.5.52",
+    "@vgai/editor": "0.5.53",
+    "@vgai/editor-sdk": "0.5.53",
+    "@vgai/engine": "0.5.53",
+    "@vgai/live": "0.5.53",
+    "@vgai/p2p-colyseus": "0.5.53",
+    "@vgai/sdk": "0.5.53",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",