@volter/game-editor 0.5.68 → 0.5.69

package/dist-node/create.js

@@ -4,7 +4,7 @@ import { dirname as dirname4, join as join6, resolve as resolve4 } from "node:pa
 import { fileURLToPath } from "node:url";
 
 // node/scaffold/additions.ts
-var SCAFFOLD_ADDITIONS = ["three", "ui", "server", "blender", "studio"];
+var SCAFFOLD_ADDITIONS = ["three", "canvas", "ui", "server", "blender", "studio"];
 var ADDITION_REQUIRES = {
   studio: ["three"]
 };
@@ -174,7 +174,7 @@ const meta = {
   // states below render its presentational body with authored props.
   component: GameUI,
   render: (args) => <ReactGamePage {...args} />,
-  parameters: { vgai: { defaultStory: 'Ready' } },
+  parameters: { volter: { defaultStory: 'Ready' } },
   args: { lastInput: 'Ready', title: 'My Game' },
 } satisfies Meta<typeof ReactGamePage>;
 
@@ -189,15 +189,15 @@ export const LongTitle: Story = {
 `;
 var REACT_ONLY_MAIN_SOURCE = `/**
  * Standalone entry point: this game's own boot, in its own libraries. Every
- * \`dom\` root \`vgai.project.json\` declares renders its entry's default export
+ * \`dom\` root \`volter.project.json\` declares renders its entry's default export
  * with react-dom, in one layer of \`#game-canvas\` per root, stacked by
  * \`zOrder\`. The editor mounts the same entries itself.
  */
 
 import { type ComponentType, createElement } from 'react';
 import { createRoot } from 'react-dom/client';
-import { manifestEntryModules } from 'virtual:vgai-manifest-entries';
-import manifest from '../vgai.project.json';
+import { manifestEntryModules } from 'virtual:volter-manifest-entries';
+import manifest from '../volter.project.json';
 
 interface DeclaredRoot {
   readonly id: string;
@@ -235,7 +235,7 @@ var REACT_ONLY_FILES = {
 };
 function withEditorDeclaration(source, declaration2) {
   if (!source.includes("defineAdapter({"))
-    throw new Error("Starter vgai.adapter.ts must call defineAdapter({ ... }).");
+    throw new Error("Starter volter.adapter.ts must call defineAdapter({ ... }).");
   const look = [
     declaration2.style ? `, style: ${declaration2.style.name}` : "",
     declaration2.keymap ? `, keymap: ${declaration2.keymap.name}` : ""
@@ -253,9 +253,9 @@ function withEditorDeclaration(source, declaration2) {
   return `${imports}${source.replace("defineAdapter({", `defineAdapter({
 ${editor}`)}`;
 }
-var MODELS_AGENTS_CONTRACT = `# AGENTS.md \u2014 VGAI Models Project
+var MODELS_AGENTS_CONTRACT = `# AGENTS.md \u2014 VOLTER Models Project
 
-A standalone modeling project built with VGAI \u2014 Blender itself, compiled to
+A standalone modeling project built with VOLTER \u2014 Blender itself, compiled to
 WebAssembly and running headless in the editor tab's worker, over this
 project's own \`.blend\` files. Work here, not in the engine repo. The editor
 is the authoring and verification surface; nothing here plays.
@@ -266,7 +266,7 @@ is the authoring and verification surface; nothing here plays.
 | --- | --- |
 | Model, revise or add a model | \`src/models/<name>.blend\` \u2014 read \`src/models/cube.py\`'s docstring first |
 | Open the editor, look, or verify | \`.agents/skills/editor/SKILL.md\` |
-| Blender-style modeling craft | \`.agents/skills/vgai-3d-models/SKILL.md\` |
+| Blender-style modeling craft | \`.agents/skills/volter-3d-models/SKILL.md\` |
 
 \`.agents/\` is canonical; \`.claude/skills/\` and \`.github/skills/\` are
 generated projections (never edit); \`CLAUDE.md\` and
@@ -282,7 +282,7 @@ opens. The document does not run the script \u2014 you do, through the session's
 Blender:
 
 \`\`\`bash
-npm run --silent vgai -- blender-mcp    # the MCP transport onto the tab's Blender
+npm run --silent volter -- blender-mcp    # the MCP transport onto the tab's Blender
 \`\`\`
 
 Every call is ordinary bpy against the open document, and the session saves it
@@ -293,33 +293,33 @@ finder lists every \`.blend\` as a document. Coordinates are metres and Z is up
 ## The editor
 
 Workspaces: \`model\`, \`sculpt\`, \`texture\`, \`animate\`, \`design\`, \`look\`
-(\`npm run --silent vgai -- eval 'editor.workspace("sculpt")'\`; a wrong id
+(\`npm run --silent volter -- eval 'editor.workspace("sculpt")'\`; a wrong id
 refuses and names the list). The look and keymap are Blender's
 (\`@volter/editor-blender\` contributes them). There is no Game workspace and
-\`vgai play\` refuses: this project declares no roots.
+\`volter-game-editor play\` refuses: this project declares no roots.
 
 ## Verification contract \u2014 after every change
 
 1. \`npm run typecheck\` \u2014 the gate.
 2. Open the model's document and read the change through a door:
-   \`npm run --silent vgai -- eval 'editor.currentView()'\` names the open
-   document; \`npm run --silent vgai -- screenshot editor\` shows it; and
+   \`npm run --silent volter -- eval 'editor.currentView()'\` names the open
+   document; \`npm run --silent volter -- screenshot editor\` shows it; and
    \`get_scene_info\` over \`blender-mcp\` is what the engine itself says is in
    the file.
-3. \`npm run --silent vgai -- console\` silent \u2014 an unresolved entry is
+3. \`npm run --silent volter -- console\` silent \u2014 an unresolved entry is
    remaining work, never noise.
 
 ## Commands
 
 \\\`\\\`\\\`bash
 npm run dev                            # open/reuse this project's editor
-npm run --silent vgai -- status        # require connected: true
-npm run --silent vgai -- screenshot    # visible evidence
-npm run --silent vgai -- eval '<js>'   # THE door onto the editor
+npm run --silent volter -- status        # require connected: true
+npm run --silent volter -- screenshot    # visible evidence
+npm run --silent volter -- eval '<js>'   # THE door onto the editor
 npm run typecheck                      # THE gate
 \\\`\\\`\\\`
 
-Always \`npm run --silent vgai -- <verb>\`, never a bare \`vgai\` (a global one may
+Always \`npm run --silent volter -- <verb>\`, never a bare \`volter\` (a global one may
 belong to another checkout).
 `;
 function withAgentsContract(source, additions) {
@@ -390,7 +390,7 @@ function assertScaffoldComposition(value, source, product) {
   if (!packages.includes(product))
     fail(
       source,
-      `compose() returned editorPackages ${JSON.stringify(packages)}, which omits ${product}. A scaffolded project declares the product it opens in \u2014 that declaration is how \`vgai edit\` finds the editor to run (ARCHITECTURE-CORE \xA7The target shape, rule 4).`
+      `compose() returned editorPackages ${JSON.stringify(packages)}, which omits ${product}. A scaffolded project declares the product it opens in \u2014 that declaration is how \`volter edit\` finds the editor to run (ARCHITECTURE-CORE \xA7The target shape, rule 4).`
     );
   const editor = composition?.editor;
   if (typeof editor?.inspector !== "string" || editor.inspector.length === 0)
@@ -425,7 +425,7 @@ import {
 } from "node:fs";
 import { basename, dirname as dirname2, join as join4, relative as relative3, resolve as resolve2 } from "node:path";
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/scanner.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/scanner.js
 function createScanner(text, ignoreTrivia = false) {
   const len = text.length;
   let pos = 0, value = "", tokenOffset = 0, token = 16, lineNumber = 0, lineStartOffset = 0, tokenLineStartOffset = 0, prevTokenLineStartOffset = 0, scanError = 0;
@@ -846,7 +846,7 @@ var CharacterCodes;
   CharacterCodes2[CharacterCodes2["tab"] = 9] = "tab";
 })(CharacterCodes || (CharacterCodes = {}));
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/string-intern.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/string-intern.js
 var cachedSpaces = new Array(20).fill(0).map((_, index) => {
   return " ".repeat(index);
 });
@@ -876,7 +876,7 @@ var cachedBreakLinesWithSpaces = {
   }
 };
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/parser.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/parser.js
 var ParseOptions;
 (function(ParseOptions2) {
   ParseOptions2.DEFAULT = {
@@ -1232,7 +1232,7 @@ function visit(text, visitor, options = ParseOptions.DEFAULT) {
   return true;
 }
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/main.js
+// ../../node_modules/jsonc-parser/lib/esm/main.js
 var ScanError;
 (function(ScanError2) {
   ScanError2[ScanError2["None"] = 0] = "None";
@@ -1326,8 +1326,8 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 
 // ../editor-project/src/manifest/filename.ts
-var MANIFEST_FILENAME = "vgai.project.json";
-var REMOVED_MANIFEST_FILENAME = "vgai.game.json";
+var MANIFEST_FILENAME = "volter.project.json";
+var REMOVED_MANIFEST_FILENAME = "volter.game.json";
 function removedManifestFilenameMessage(where) {
   return `${where}: found \`${REMOVED_MANIFEST_FILENAME}\` and no \`${MANIFEST_FILENAME}\`. \`${REMOVED_MANIFEST_FILENAME}\` was REMOVED (the legacy-removal doctrine, docs/ARCHITECTURE-CORE.md \xA7Vocabulary) \u2014 nothing reads it any more, and it is deliberately NOT read as a fallback, because a second accepted name is the defect.
 Fix: rename it \u2014 \`git mv ${REMOVED_MANIFEST_FILENAME} ${MANIFEST_FILENAME}\`. The contents are unchanged; only the filename moved.`;
@@ -1353,7 +1353,7 @@ import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join as join2, relative, sep } from "node:path";
-var SCAFFOLD_BASELINE_RELATIVE_PATH = ".vgai/scaffold-baseline.json";
+var SCAFFOLD_BASELINE_RELATIVE_PATH = ".volter/scaffold-baseline.json";
 function readEngineSourceState(engineDir) {
   try {
     const sha = execFileSync("git", ["-C", engineDir, "rev-parse", "HEAD"], {
@@ -1395,7 +1395,7 @@ function buildScaffoldBaseline(targetDir, engineVersion, engineDir) {
 }
 function writeScaffoldBaseline(targetDir, engineVersion, engineDir) {
   const baseline = buildScaffoldBaseline(targetDir, engineVersion, engineDir);
-  mkdirSync(join2(targetDir, ".vgai"), { recursive: true });
+  mkdirSync(join2(targetDir, ".volter"), { recursive: true });
   writeFileSync(
     join2(targetDir, SCAFFOLD_BASELINE_RELATIVE_PATH),
     `${JSON.stringify(baseline, null, 2)}
@@ -1497,7 +1497,7 @@ ${indent}},`;
 }
 function mergeAdapterRegionIncludes(source, additions) {
   if (additions.length === 0) return { kind: "unchanged" };
-  const parsed = typescript().createSourceFile("vgai.adapter.ts", source, typescript().ScriptTarget.Latest, true);
+  const parsed = typescript().createSourceFile("volter.adapter.ts", source, typescript().ScriptTarget.Latest, true);
   const definition = definitionObject(parsed);
   if ("reason" in definition) return { kind: "unreadable", reason: definition.reason };
   const listed = propertyOf(definition.object, "regions");
@@ -1588,7 +1588,7 @@ function finderText(addition, quote) {
 }
 function mergeAdapterFinders(source, additions) {
   if (additions.length === 0) return { kind: "unchanged" };
-  const parsed = typescript().createSourceFile("vgai.adapter.ts", source, typescript().ScriptTarget.Latest, true);
+  const parsed = typescript().createSourceFile("volter.adapter.ts", source, typescript().ScriptTarget.Latest, true);
   const definition = definitionObject(parsed);
   if ("reason" in definition) return { kind: "unreadable", reason: definition.reason };
   const quote = quoteLike(source, void 0);
@@ -1649,7 +1649,7 @@ ${indentAt(source, array.getStart())}${source.slice(closing)}`;
 }
 
 // node/scaffold/catalog.ts
-var PROJECT_CATALOG_DIR = join3(".vgai", "catalog");
+var PROJECT_CATALOG_DIR = join3(".volter", "catalog");
 var CATALOG_SURFACES = ["three", "canvas", "dom"];
 var CAPABILITY_STAMP_FILENAME = "capability.json";
 function capabilityStampPath(entry) {
@@ -1668,7 +1668,7 @@ function stringArray(value, field, manifestPath) {
 var RENAMED_CAPABILITY_IDS = /* @__PURE__ */ new Map([["mesh", "blender"]]);
 function renamedCapabilityIdMessage(where, oldId, newId) {
   return `${where}: capability id \`${oldId}\` was RENAMED to \`${newId}\` (2026-09-19). Nothing reads \`${oldId}\` any more, and it is deliberately NOT mapped onto \`${newId}\`, because a second accepted name is the defect.
-Fix: in this project, rename the file \u2014 \`git mv .vgai/catalog/${oldId}.json .vgai/catalog/${newId}.json\` \u2014 and change its \`"id"\` to \`"${newId}"\`. If a stamp file names the old id, rename that too (\`src/tools/${oldId}.*\` -> \`src/tools/${newId}.*\`). Then \`vgai outdated\` will report against the current entry. Nothing else about the capability changed.`;
+Fix: in this project, rename the file \u2014 \`git mv .volter/catalog/${oldId}.json .volter/catalog/${newId}.json\` \u2014 and change its \`"id"\` to \`"${newId}"\`. If a stamp file names the old id, rename that too (\`src/tools/${oldId}.*\` -> \`src/tools/${newId}.*\`). Then \`volter-game-editor outdated\` will report against the current entry. Nothing else about the capability changed.`;
 }
 function readCatalogEntry(path) {
   const parsed = JSON.parse(readFileSync2(path, "utf8"));
@@ -1706,15 +1706,15 @@ function readCatalogEntry(path) {
       path
     );
     const scripts = readStringRecord(packageJson["scripts"], "scripts", path);
-    const vgaiTools = packageJson["vgaiTools"];
-    if (vgaiTools !== void 0 && (!Array.isArray(vgaiTools) || vgaiTools.some((entry) => typeof entry !== "string" && !isRecord(entry)))) {
-      throw new Error(`${path}: packageJson.vgaiTools must be an array of module paths`);
+    const volterTools = packageJson["volterTools"];
+    if (volterTools !== void 0 && (!Array.isArray(volterTools) || volterTools.some((entry) => typeof entry !== "string" && !isRecord(entry)))) {
+      throw new Error(`${path}: packageJson.volterTools must be an array of module paths`);
     }
     manifest.packageJson = {
       ...dependencies ? { dependencies } : {},
       ...devDependencies ? { devDependencies } : {},
       ...scripts ? { scripts } : {},
-      ...vgaiTools ? { vgaiTools } : {}
+      ...volterTools ? { volterTools } : {}
     };
   }
   const assetPacks = readAssetPacks(parsed["assetPacks"], path);
@@ -2029,29 +2029,29 @@ function planCapabilityPackageJson(originalBytes, manifests, label = "package.js
       resolveSpec
     );
     mergeStringDependencies(parsed, "scripts", patch.scripts, manifest.id, origins);
-    if (patch.vgaiTools) {
-      const vgai = parsed["vgai"] === void 0 ? {} : parsed["vgai"];
-      if (!isRecord(vgai)) throw new Error(`${label}: vgai must be an object`);
-      const currentTools = vgai["tools"] === void 0 ? [] : vgai["tools"];
+    if (patch.volterTools) {
+      const volter = parsed["volter"] === void 0 ? {} : parsed["volter"];
+      if (!isRecord(volter)) throw new Error(`${label}: volter must be an object`);
+      const currentTools = volter["tools"] === void 0 ? [] : volter["tools"];
       if (!Array.isArray(currentTools) || currentTools.some((tool) => typeof tool !== "string" && !isRecord(tool))) {
-        throw new Error(`${label}: vgai.tools must be an array of strings or objects`);
+        throw new Error(`${label}: volter.tools must be an array of strings or objects`);
       }
       const tools = currentTools.map(
         (tool) => typeof tool === "string" ? tool : { ...tool }
       );
-      for (const tool of patch.vgaiTools) {
+      for (const tool of patch.volterTools) {
         const id = toolIdentity(tool);
         const existing = tools.find((candidate) => toolIdentity(candidate) === id);
         if (existing && JSON.stringify(existing) !== JSON.stringify(tool)) {
           throw new Error(
-            `Capability ${manifest.id} conflicts with existing vgai.tools entry ${id}`
+            `Capability ${manifest.id} conflicts with existing volter.tools entry ${id}`
           );
         }
         if (!existing) tools.push(tool);
       }
       tools.sort((a, b) => toolIdentity(a).localeCompare(toolIdentity(b)));
-      vgai["tools"] = tools;
-      parsed["vgai"] = vgai;
+      volter["tools"] = tools;
+      parsed["volter"] = volter;
     }
   }
   return Buffer.from(`${JSON.stringify(parsed, null, 2)}
@@ -2107,7 +2107,7 @@ function mergedAssetManifest(projectDir, manifests) {
   );
   return { bytes, changed: !original.equals(bytes), declared: merged };
 }
-var ADAPTER_MODULE_FILE = "vgai.adapter.ts";
+var ADAPTER_MODULE_FILE = "volter.adapter.ts";
 function rootSurfaces(projectDir) {
   const surfaces = /* @__PURE__ */ new Map();
   let manifest;
@@ -2647,7 +2647,7 @@ Fix: create the project without --example, which scaffolds from the starter temp
         );
       }
       throw new Error(
-        `Unknown example id "${exampleId}": no vgai.project.json found at ${examplesSrcDir}`
+        `Unknown example id "${exampleId}": no volter.project.json found at ${examplesSrcDir}`
       );
     }
     mkdirSync3(targetDir, { recursive: true });
@@ -2695,7 +2695,7 @@ function assertDevelopmentLog(targetDir) {
   const path = join4(targetDir, PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH);
   if (!existsSync3(path)) {
     throw new Error(
-      `Scaffolded project is missing ${PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH}; restore it from the VGAI starter template`
+      `Scaffolded project is missing ${PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH}; restore it from the VOLTER starter template`
     );
   }
 }
@@ -2720,7 +2720,7 @@ function trackedExampleFiles(exampleDir) {
   });
   if (result.status !== 0 || !result.stdout) return null;
   const paths = result.stdout.toString("utf8").split("\0").filter(Boolean);
-  return paths.includes("vgai.project.json") ? paths : null;
+  return paths.includes("volter.project.json") ? paths : null;
 }
 function copyTrackedExampleFiles(exampleDir, targetDir) {
   const paths = trackedExampleFiles(exampleDir);
@@ -2752,11 +2752,11 @@ function writeExampleReadme(targetDir, projectName, exampleId) {
     path,
     `# ${projectName}
 
-An editable standalone VGAI project scaffolded from the \`${exampleId ?? "example"}\` reference. Its gameplay source and assets were copied unchanged; this folder is now your project.
+An editable standalone VOLTER project scaffolded from the \`${exampleId ?? "example"}\` reference. Its gameplay source and assets were copied unchanged; this folder is now your project.
 
 \`\`\`bash
 npm run dev                 # open/reuse the visual editor
-npm run vgai -- play        # verify Play mode
+npm run volter -- play        # verify Play mode
 npm run typecheck
 npm run validate-manifest
 \`\`\`
@@ -2770,12 +2770,12 @@ function shouldCopyExamplePath(exampleDir, sourcePath) {
   const relativePath = relative3(exampleDir, sourcePath).replaceAll("\\", "/");
   const topLevel = relativePath.split("/")[0] ?? "";
   const segments = relativePath.split("/");
-  return !["node_modules", "dist", "logs", ".vgai", ".git", "package-lock.json"].includes(topLevel) && !segments.some((segment) => segment === ".env" || segment.startsWith(".env."));
+  return !["node_modules", "dist", "logs", ".volter", ".git", "package-lock.json"].includes(topLevel) && !segments.some((segment) => segment === ".env" || segment.startsWith(".env."));
 }
 function shouldCopyStarterPath(templateDir, sourcePath) {
   const relativePath = relative3(templateDir, sourcePath).replaceAll("\\", "/");
   const topLevel = relativePath.split("/")[0] ?? "";
-  return !["node_modules", "dist", "logs", ".vgai"].includes(topLevel);
+  return !["node_modules", "dist", "logs", ".volter"].includes(topLevel);
 }
 function rewritePackageJson(targetDir, slug, engineDir, monoRoot) {
   const pkgPath = join4(targetDir, "package.json");
@@ -2805,8 +2805,8 @@ function rewritePackageJson(targetDir, slug, engineDir, monoRoot) {
   }
   pkg.scripts ??= {};
   for (const [name, script] of Object.entries(pkg.scripts)) {
-    if (name !== "vgai" && script.startsWith("vgai ")) {
-      pkg.scripts[name] = `npm run vgai -- ${script.slice("vgai ".length)}`;
+    if (name !== "volter" && script.startsWith("volter ")) {
+      pkg.scripts[name] = `npm run volter -- ${script.slice("volter ".length)}`;
     }
   }
   pkg.devDependencies = pkg.devDependencies ?? {};
@@ -2842,7 +2842,7 @@ function engineDependencySpec(monoRoot, packageName, checkoutRelPath = "") {
   return `^${version}`;
 }
 function rewriteGameManifest(targetDir, name, slug, additions, monoRoot) {
-  const manifestPath = join4(targetDir, "vgai.project.json");
+  const manifestPath = join4(targetDir, "volter.project.json");
   const engineVersion = readInstalledVersion(monoRoot, "@volter/editor-project");
   let manifest;
   if (existsSync3(manifestPath)) {
@@ -2861,12 +2861,14 @@ function rewriteGameManifest(targetDir, name, slug, additions, monoRoot) {
   }
   manifest["name"] = name;
   manifest["manifestVersion"] = 2;
-  manifest["$schema"] = "./node_modules/@volter/editor-project/schemas/vgai-project.schema.json";
+  manifest["$schema"] = "./node_modules/@volter/editor-project/schemas/volter-project.schema.json";
   manifest["appId"] = `com.example.${slug.replace(/[^a-zA-Z0-9]/g, "")}`;
   if (additions) {
     const roots = [];
     if (additions.has("three"))
       roots.push({ id: "world", adapter: "three", entry: "src/world.tsx" });
+    if (additions.has("canvas"))
+      roots.push({ id: "scene2d", adapter: "canvas", entry: "src/scene2d.tsx" });
     if (additions.has("ui"))
       roots.push({ id: "ui", adapter: "dom", entry: "src/ui/game.tsx", zOrder: 0 });
     manifest["roots"] = roots;
@@ -2905,14 +2907,14 @@ function repinEngineAfterInstall(targetDir) {
   try {
     const baseline = JSON.parse(readFileSync3(baselinePath, "utf-8"));
     baseline.engineVersion = installed;
-    baseline.files["vgai.project.json"] = hashFile(manifestPath);
+    baseline.files["volter.project.json"] = hashFile(manifestPath);
     writeFileSync3(baselinePath, `${JSON.stringify(baseline, null, 2)}
 `, "utf-8");
   } catch {
   }
   return { from, to: installed };
 }
-function checkoutVgaiPackageDirs(monoRoot) {
+function checkoutVolterPackageDirs(monoRoot) {
   const found = /* @__PURE__ */ new Map();
   const packagesDir = join4(monoRoot, "packages");
   let entries;
@@ -2961,7 +2963,7 @@ function pointUnpublishedPackagesAtCheckout(projectDir, monoRoot) {
   return rewritten;
 }
 function checkoutPackageSpec(name, monoRoot) {
-  const dir = checkoutVgaiPackageDirs(monoRoot).get(name);
+  const dir = checkoutVolterPackageDirs(monoRoot).get(name);
   return dir === void 0 ? null : `file:${dir}`;
 }
 function writeEditorPackages(targetDir, wanted) {
@@ -2994,6 +2996,16 @@ function writeNetworkedInput(targetDir) {
   }
   writeFileSync3(inputPath, input, "utf-8");
 }
+function applyCanvasAddition(targetDir, productDir) {
+  const additionDir = join4(productDir, "additions", "canvas");
+  cpSync(join4(additionDir, "src"), join4(targetDir, "src"), { recursive: true });
+  const own = JSON.parse(readFileSync3(join4(additionDir, "package.json"), "utf-8"));
+  const pkgPath = join4(targetDir, "package.json");
+  const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+  pkg.dependencies = { ...pkg.dependencies };
+  for (const [name, spec] of Object.entries(own.dependencies ?? {})) pkg.dependencies[name] ??= spec;
+  writeJson(pkgPath, pkg);
+}
 function rewriteTemplateVariantFiles(targetDir, composition, additions, starterDir) {
   if (!additions.has("three") || !additions.has("studio")) {
     for (const relative4 of STUDIO_OWNED_PATHS) {
@@ -3023,9 +3035,9 @@ function rewriteTemplateVariantFiles(targetDir, composition, additions, starterD
     for (const relative4 of THREE_OWNED_PATHS) {
       rmSync2(join4(targetDir, relative4), { recursive: true, force: true });
     }
-    writeFileSync3(join4(targetDir, "vgai.adapter.ts"), adapterSourceFor(additions), "utf-8");
+    writeFileSync3(join4(targetDir, "volter.adapter.ts"), adapterSourceFor(additions), "utf-8");
   } else {
-    const adapterPath = join4(targetDir, "vgai.adapter.ts");
+    const adapterPath = join4(targetDir, "volter.adapter.ts");
     const source = joinAdditionFinders(readFileSync3(adapterPath, "utf-8"), additions);
     writeFileSync3(adapterPath, source, "utf-8");
   }
@@ -3082,7 +3094,7 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
       ])
     ),
     // `@volter/editor-blender`'s two VALUE exports — the look and the layout a models
-    // project's `vgai.adapter.ts` imports. Spelled entry by entry rather than
+    // project's `volter.adapter.ts` imports. Spelled entry by entry rather than
     // as a wildcard because the package's `exports` names them individually;
     // both entries are inert for a project that never declares the package.
     "@volter/editor-blender/looks": ["node_modules/@volter/editor-blender/src/looks.ts"],
@@ -3180,7 +3192,8 @@ function scaffoldProject(opts) {
       additions,
       resolveScaffoldStarterDir(productDir)
     );
-    const adapterPath = join4(targetDir, "vgai.adapter.ts");
+    if (additions.has("canvas")) applyCanvasAddition(targetDir, productDir);
+    const adapterPath = join4(targetDir, "volter.adapter.ts");
     writeFileSync3(
       adapterPath,
       withEditorDeclaration(readFileSync3(adapterPath, "utf-8"), composition.editor),
@@ -3322,7 +3335,7 @@ function initGitRepo(targetDir, projectName) {
       notice: "Skipped git init \u2014 the project is already inside a git work tree."
     };
   }
-  const authorFallback = hasCommitterIdentity(targetDir) ? [] : ["-c", "user.name=vgai", "-c", "user.email=scaffold@vgai"];
+  const authorFallback = hasCommitterIdentity(targetDir) ? [] : ["-c", "user.name=volter", "-c", "user.email=scaffold@volter"];
   const steps = [
     { label: "git init", args: ["init", "--quiet"] },
     { label: "git add", args: ["add", "-A"] },
@@ -3361,13 +3374,15 @@ var presets = {
     // silent console the agent contract requires; they are an author's TODO
     // from the moment the author ASKS for those panels (`--with studio`, or
     // `--template full`).
-    game: { additions: ["three", "server", "blender"] },
+    // A game's UI is React DOM: its HUD is the `ui` root over the world. A `canvas` (Pixi) root
+    // is 2D game rendering, never the UI layer.
+    game: { additions: ["three", "ui", "server", "blender"] },
     /** A 3D world and its models: the smallest thing that plays. */
     prototype: { additions: ["three", "blender"] },
     // EVERY addition in one project — the composition acceptance made
     // permanent. Check it against `SCAFFOLD_ADDITIONS` (./scaffold/additions.ts)
     // when the scaffolder grows one.
-    full: { additions: ["three", "ui", "server", "blender", "studio"] },
+    full: { additions: ["three", "canvas", "ui", "server", "blender", "studio"] },
     /** The design skew: a React root and no 3D world. */
     website: { additions: ["ui"] },
     /** Nothing but the project — the shape an author adds to. */
@@ -3378,15 +3393,16 @@ var presets = {
   examples: true,
   compose(additions) {
     const three = additions.has("three");
+    const world = three || additions.has("canvas");
     const studio = additions.has("studio");
     const layouts = "@volter/editor-sdk/layouts";
-    const design = additions.has("ui") && !three;
+    const design = additions.has("ui") && !world;
     return {
-      // THE PRODUCT THIS PROJECT OPENS IN, and the 3D lane beside it:
-      // `@volter/editor-game` is the 3D world's lane, and a project with no 3D
-      // root has nothing for Play, the Game workspace or the instruments over
-      // a running game to run.
-      editorPackages: [PRODUCT2, ...three ? ["@volter/editor-game"] : []],
+      // THE PRODUCT THIS PROJECT OPENS IN, and the game lane beside it:
+      // `@volter/editor-game` is the lane of a game world (3D, or a 2D scene), and
+      // a project with no world has nothing for Play, the Game workspace or the
+      // instruments over a running game to run.
+      editorPackages: [PRODUCT2, ...world ? ["@volter/editor-game"] : []],
       editor: {
         layout: { name: design ? "DesignLayout" : studio ? "StudioLayout" : "GameLayout", from: layouts },
         inspector: studio ? "column" : "card"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/game-editor",
   "author": "Volter AI, Inc.",
-  "version": "0.5.68",
+  "version": "0.5.69",
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +28,7 @@
     "workbench",
     "template",
     "template-dotfiles",
+    "additions",
     "catalog",
     "starter",
     "BUNDLED_NOTICES"
@@ -37,34 +38,34 @@
     "build:node": "node scripts/build-node.mjs",
     "typecheck": "tsc -p tsconfig.node.json"
   },
-  "vgai": {
+  "volter": {
     "product": {
       "entry": "./src/index.ts",
       "displayName": "Volter Game Editor",
       "colorTheme": "dark",
       "workbench": {
-        "release": "game-editor-53c70370c14c-d9c0c8f0d344-darwin-arm64",
-        "tarballSha256": "db26cbe669909e5dab61536a01f08d95b7de4b037f6607f40b52bea100194093"
+        "release": "game-editor-f16dc165c0df-7829035e8e51-darwin-arm64",
+        "tarballSha256": "5737029b2bfe64a22466ccf000e80056cf9cebfdc3650022a27fa990e037a421"
       }
     }
   },
   "dependencies": {
-    "@volter/editor-core": "0.5.68",
-    "@volter/editor-game": "0.5.68",
-    "@volter/editor-react": "0.5.68",
-    "@volter/editor-threejs": "0.5.68",
-    "@volter/editor-xstate": "0.5.68",
-    "@volter/editor-blender": "0.1.11",
-    "@volter/dawproject": "0.5.68",
-    "@volter/editor-dawproject": "0.5.68",
-    "@volter/blender-engine": "0.1.9",
-    "@volter/editor-project": "0.5.68",
-    "@volter/editor-sdk": "0.5.68",
-    "@volter/editor-live": "0.5.68",
-    "@volter/game-live": "0.5.68",
+    "@volter/editor-core": "0.5.69",
+    "@volter/editor-game": "0.5.69",
+    "@volter/editor-react": "0.5.69",
+    "@volter/editor-threejs": "0.5.69",
+    "@volter/editor-xstate": "0.5.69",
+    "@volter/editor-blender": "0.1.12",
+    "@volter/dawproject": "0.5.69",
+    "@volter/editor-dawproject": "0.5.69",
+    "@volter/blender-engine": "0.1.10",
+    "@volter/editor-project": "0.5.69",
+    "@volter/editor-sdk": "0.5.69",
+    "@volter/editor-live": "0.5.69",
+    "@volter/game-live": "0.5.69",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/game-runtime": "0.5.68",
-    "@volter/threejs-runtime": "0.5.68",
+    "@volter/game-runtime": "0.5.69",
+    "@volter/threejs-runtime": "0.5.69",
     "undici": "7.29.1",
     "typescript": "5.9.3",
     "@colyseus/schema": "^4.0.14",

package/src/contributions.d.ts

@@ -1,4 +1,4 @@
-declare module 'vgai:contributions/*' {
+declare module 'volter:contributions/*' {
   const contributions: readonly { readonly entryPath: string; readonly load: () => Promise<unknown> }[];
   export default contributions;
 }

package/src/index.ts

@@ -5,31 +5,31 @@
  * building a game needs. Three decisions, each a product's to make and nobody
  * else's:
  *
- *  - WHICH PACKAGES, in mount order. `vgai:contributions/<package>` is that
- *    package's own `package.json#vgai.contributions`, read at build time
+ *  - WHICH PACKAGES, in mount order. `volter:contributions/<package>` is that
+ *    package's own `package.json#volter.contributions`, read at build time
  *    (`@volter/editor-core/build/product-contributions`) — the product names
  *    the package, never its modules, so a package that grows a contribution
  *    grows this product with no edit here.
  *  - THE LOOK. `classic` — the editor's own Graphite, which is the reference
  *    frame every host-default shape was measured against. A DEFAULT:
- *    `~/.vgai/settings.json`, the project's own, and its adapter's declaration
+ *    `~/.volter/settings.json`, the project's own, and its adapter's declaration
  *    each outrank it.
  *  - THE WORKSPACE. `game` — `@volter/editor-game`'s own workspace
  *    contribution, which applies to a project with at least one root that
  *    plays.
  *
- * `mountVgai` is what the workbench contribution reads off this module once
+ * `mountVolter` is what the workbench contribution reads off this module once
  * `/__editor/served-modules` hands it this file's URL.
  */
 
-import blender from 'vgai:contributions/@volter/editor-blender';
-import game from 'vgai:contributions/@volter/editor-game';
-import react from 'vgai:contributions/@volter/editor-react';
-import threejs from 'vgai:contributions/@volter/editor-threejs';
-import xstate from 'vgai:contributions/@volter/editor-xstate';
+import blender from 'volter:contributions/@volter/editor-blender';
+import game from 'volter:contributions/@volter/editor-game';
+import react from 'volter:contributions/@volter/editor-react';
+import threejs from 'volter:contributions/@volter/editor-threejs';
+import xstate from 'volter:contributions/@volter/editor-xstate';
 import { product } from '@volter/editor-core/frame/product';
 
-export const { mountVgai } = product({
+export const { mountVolter } = product({
   id: 'game-editor',
   packages: {
     '@volter/editor-game': game,

package/starter/cube.py

@@ -36,7 +36,7 @@ either way.
 
 Run it through the session's Blender, from this project:
 
-    npm run --silent vgai -- blender-mcp        # the transport an agent drives
+    npm run --silent volter -- blender-mcp        # the transport an agent drives
     # or, in a live editor session:
     # editor.blender('blender-execute', { code: open('src/models/cube.py').read() })