@volter/game-editor 0.5.65 → 0.5.66

package/dist-node/create.js

@@ -43,14 +43,8 @@ var STUDIO_OWNED_PATHS = [
   "src/contributions/analytics.analytics.tsx"
 ];
 var REACT_ONLY_REMOVED_PATHS = [
-  "src/runtime",
-  "src/scripts",
   "src/prefabs",
-  "src/stage",
   "src/world.tsx",
-  "src/lib/humanoid",
-  "src/lib/mesh",
-  "src/lib/native-three",
   "src/components",
   "public"
 ];
@@ -88,6 +82,43 @@ export function ReactGamePage({ lastInput, title = 'My Game' }: ReactGamePagePro
   );
 }
 `;
+var REACT_HUD_PAGE_SOURCE = `export interface ReactGamePageProps {
+  readonly lastInput: string;
+  readonly title?: string;
+}
+
+/** The game's HUD over its 3D world. Runtime input ownership stays in game.tsx. */
+export function ReactGamePage({ lastInput, title = 'My Game' }: ReactGamePageProps) {
+  return (
+    <main
+      data-testid="game-ui-root"
+      style={{
+        position: 'absolute',
+        inset: 0,
+        padding: 16,
+        pointerEvents: 'none',
+        fontFamily: 'system-ui, sans-serif',
+      }}
+    >
+      <section
+        style={{
+          display: 'inline-block',
+          padding: '10px 14px',
+          borderRadius: 8,
+          pointerEvents: 'auto',
+          color: '#f7f4ea',
+          background: 'rgba(17, 24, 39, 0.72)',
+        }}
+      >
+        <h1 style={{ margin: 0, fontSize: 18 }}>{title}</h1>
+        <p aria-live="polite" style={{ margin: '4px 0 0', color: '#cbd5e1', fontSize: 13 }}>
+          Last input: {lastInput}
+        </p>
+      </section>
+    </main>
+  );
+}
+`;
 var REACT_ONLY_GAME_SOURCE = `import { useEffect, useState } from 'react';
 import { useDebugProvider } from '@volter/game-runtime/react/world-state';
 import { ReactGamePage } from './game-page';
@@ -1355,34 +1386,36 @@ import {
 import { dirname, isAbsolute, join as join3, relative as relative2, resolve, sep as sep2 } from "node:path";
 
 // node/scaffold/adapter-region-merge.ts
-import ts from "typescript";
+import { createRequire } from "node:module";
+var loaded;
+var typescript = () => loaded ??= createRequire(import.meta.url)("typescript");
 function quoteLike(source, sample) {
   const double = sample !== void 0 && source[sample.getStart()] === '"';
   return (value) => double || value.includes("'") ? JSON.stringify(value) : `'${value}'`;
 }
 function stringLiteralOf(node) {
-  return node && ts.isStringLiteralLike(node) ? node.text : void 0;
+  return node && typescript().isStringLiteralLike(node) ? node.text : void 0;
 }
 function propertyOf(object, name) {
   for (const member of object.properties) {
-    if (!ts.isPropertyAssignment(member)) continue;
-    const key = ts.isIdentifier(member.name) ? member.name.text : stringLiteralOf(member.name);
+    if (!typescript().isPropertyAssignment(member)) continue;
+    const key = typescript().isIdentifier(member.name) ? member.name.text : stringLiteralOf(member.name);
     if (key === name) return member;
   }
   return void 0;
 }
 function definitionObject(source) {
   for (const statement of source.statements) {
-    if (!ts.isExportAssignment(statement) || statement.isExportEquals) continue;
+    if (!typescript().isExportAssignment(statement) || statement.isExportEquals) continue;
     const call = statement.expression;
-    if (!ts.isCallExpression(call)) {
+    if (!typescript().isCallExpression(call)) {
       return { reason: "its default export is not a direct `defineAdapter({\u2026})` call" };
     }
     const arg = call.arguments[0];
     if (arg === void 0) {
       return { reason: "its default export takes no argument object to declare into" };
     }
-    if (!ts.isObjectLiteralExpression(arg)) {
+    if (!typescript().isObjectLiteralExpression(arg)) {
       return { reason: "its default export is not called with an object literal" };
     }
     return { object: arg };
@@ -1432,11 +1465,11 @@ ${indent}},`;
 }
 function mergeAdapterRegionIncludes(source, additions) {
   if (additions.length === 0) return { kind: "unchanged" };
-  const parsed = ts.createSourceFile("vgai.adapter.ts", source, ts.ScriptTarget.Latest, true);
+  const parsed = typescript().createSourceFile("vgai.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");
-  if (listed && !ts.isStringLiteralLike(listed.initializer)) {
+  if (listed && !typescript().isStringLiteralLike(listed.initializer)) {
     return {
       kind: "unreadable",
       reason: "it states an explicit `regions` list, whose entries carry their own `include`"
@@ -1457,7 +1490,7 @@ ${indent}},`;
       })
     );
   } else {
-    if (!ts.isObjectLiteralExpression(overlay.initializer)) {
+    if (!typescript().isObjectLiteralExpression(overlay.initializer)) {
       return { kind: "unreadable", reason: "`regionIncludes` is not an object literal" };
     }
     const table = overlay.initializer;
@@ -1470,7 +1503,7 @@ ${indent}},`;
         );
         continue;
       }
-      if (!ts.isObjectLiteralExpression(entry.initializer)) {
+      if (!typescript().isObjectLiteralExpression(entry.initializer)) {
         return {
           kind: "unreadable",
           reason: `\`regionIncludes.${addition.rootId}\` is not an object literal`
@@ -1489,7 +1522,7 @@ ${indent}],`;
         );
         continue;
       }
-      if (!ts.isArrayLiteralExpression(include.initializer)) {
+      if (!typescript().isArrayLiteralExpression(include.initializer)) {
         return {
           kind: "unreadable",
           reason: `\`regionIncludes.${addition.rootId}.include\` is not an array literal`
@@ -2848,7 +2881,11 @@ function rewriteTemplateVariantFiles(targetDir, composition, additions, starterD
     for (const [relative4, source] of Object.entries(REACT_ONLY_FILES)) {
       if (relative4 === "src/main.ts") continue;
       mkdirSync3(dirname2(join4(targetDir, relative4)), { recursive: true });
-      writeFileSync3(join4(targetDir, relative4), source, "utf-8");
+      writeFileSync3(
+        join4(targetDir, relative4),
+        relative4 === "src/ui/game-page.tsx" ? REACT_HUD_PAGE_SOURCE : source,
+        "utf-8"
+      );
     }
     return;
   }
@@ -2890,6 +2927,9 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
   if (editorRelPath) {
     tsconfig.compilerOptions.paths["@editor/*"] = [`${editorRelPath}/src/*`];
   }
+  tsconfig.compilerOptions.paths["@editor/game-module-access"] = [
+    "node_modules/@volter/editor-game/src/host/game-module-access.ts"
+  ];
   if (Array.isArray(tsconfig.files)) {
     tsconfig.files = tsconfig.files.map((f) => rewriteEngineRelativeFilePath(f, engineRelPath));
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/game-editor",
   "author": "Volter AI, Inc.",
-  "version": "0.5.65",
+  "version": "0.5.66",
   "publishConfig": {
     "access": "public"
   },
@@ -43,23 +43,26 @@
       "displayName": "Volter Game Editor",
       "colorTheme": "dark",
       "workbench": {
-        "release": "game-editor-f8664703ab59-595ba7af8402-darwin-arm64",
-        "tarballSha256": "fac04a80a9745b6af25c232308faab1691ef2ecc40883cc8c9b89b42f12f8ccd"
+        "release": "game-editor-9ef15b1f345b-e22708e88dca-darwin-arm64",
+        "tarballSha256": "ffa4556a84b2744c966d3461d022ccf27c5123bcb48025628f3a0129779e9b17"
       }
     }
   },
   "dependencies": {
-    "@volter/editor-core": "0.5.65",
-    "@volter/editor-game": "0.5.65",
-    "@volter/editor-blender": "0.1.8",
-    "@volter/blender-engine": "0.1.7",
-    "@volter/editor-project": "0.5.65",
-    "@volter/editor-sdk": "0.5.65",
-    "@volter/editor-live": "0.5.65",
-    "@volter/game-live": "0.5.65",
+    "@volter/editor-core": "0.5.66",
+    "@volter/editor-game": "0.5.66",
+    "@volter/editor-react": "0.5.66",
+    "@volter/editor-threejs": "0.5.66",
+    "@volter/editor-xstate": "0.5.66",
+    "@volter/editor-blender": "0.1.9",
+    "@volter/blender-engine": "0.1.8",
+    "@volter/editor-project": "0.5.66",
+    "@volter/editor-sdk": "0.5.66",
+    "@volter/editor-live": "0.5.66",
+    "@volter/game-live": "0.5.66",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/game-runtime": "0.5.65",
-    "@volter/threejs-runtime": "0.5.65",
+    "@volter/game-runtime": "0.5.66",
+    "@volter/threejs-runtime": "0.5.66",
     "undici": "7.29.1",
     "typescript": "5.9.3",
     "@colyseus/schema": "^4.0.14",

package/src/index.ts

@@ -24,12 +24,18 @@
 
 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 { product } from '@volter/editor-core/frame/product';
 
 export const { mountVgai } = product({
   id: 'game-editor',
   packages: {
     '@volter/editor-game': game,
+    '@volter/editor-react': react,
+    '@volter/editor-threejs': threejs,
+    '@volter/editor-xstate': xstate,
     '@volter/editor-blender': blender,
   },
   look: 'classic',

package/template/.agents/skills/vgai-3d-models/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-3d-models
-description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay use vgai-3d-assets; for procedural geometry generated during gameplay use ordinary Three.js.
+description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay follow .agents/references/project-manual.md; for procedural geometry generated during gameplay use ordinary Three.js.
 ---
 
 # Model a game asset
@@ -45,8 +45,8 @@ verification requirements. Before handoff, run the game's build and inspect the
 exported game. Keep input assets and runtime exports in version control;
 keep scratch files in `.vgai/tmp/`.
 
-For animation and skinning, also read `vgai-animation-assets`; a static mesh
-export is not proof that an animated character is game-ready.
+For animation and skinning, a static mesh export is not proof that an animated
+character is game-ready.
 
 ## Where the model lives
 

package/template/.agents/skills/vgai-threejs-authoring/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-threejs-authoring
-description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-assets alongside this skill when the result should become a source document and a baked GLB. Do not use for Blender bpy work or imported skeletal retargeting.
+description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-models when the result should be a Blender source document with an exported GLB. Do not use for Blender bpy work or imported skeletal retargeting.
 ---
 
 # VGAI Three.js Authoring
@@ -23,9 +23,8 @@ Never introduce a parallel entity tree, semantic operation log, generated
 scene JSON, or wrapper around ordinary Three.js access for agent control. Give
 important objects stable `Object3D.name` values or project metadata.
 
-Also use `vgai-3d-assets` for reusable source-backed assets,
-`vgai-animation-assets` for imported skeletons or clips, and
-`vgai-environment-art` for whole-scene art direction.
+Use `vgai-3d-models` for Blender-sourced assets; prefab placement, stories and the
+naming floor are in `.agents/references/project-manual.md`.
 
 ## Choose the lowest sufficient layer
 
@@ -44,11 +43,7 @@ Keep alternate library representations temporary. Return a normal
 `BufferGeometry`, `Mesh`, `Group`, or other native `Object3D`.
 
 Read [references/helper-catalog.md](references/helper-catalog.md) before adding
-modeling capabilities or dependencies. That catalog answers *which op* — for
-*which surfacing mode* (palette, shader look, tiling projection, card, decal,
-provider retexture, procedural mask) and whether the asset needs UVs at all,
-walk the eight modes cheapest-first in the `vgai-3d-assets` skill's
-`references/surfacing.md`.
+modeling capabilities or dependencies; it answers *which op*.
 
 ## Author raw code
 

package/template/.claude/skills/vgai-3d-models/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-3d-models
-description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay use vgai-3d-assets; for procedural geometry generated during gameplay use ordinary Three.js.
+description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay follow .agents/references/project-manual.md; for procedural geometry generated during gameplay use ordinary Three.js.
 ---
 
 # Model a game asset
@@ -45,8 +45,8 @@ verification requirements. Before handoff, run the game's build and inspect the
 exported game. Keep input assets and runtime exports in version control;
 keep scratch files in `.vgai/tmp/`.
 
-For animation and skinning, also read `vgai-animation-assets`; a static mesh
-export is not proof that an animated character is game-ready.
+For animation and skinning, a static mesh export is not proof that an animated
+character is game-ready.
 
 ## Where the model lives
 

package/template/.claude/skills/vgai-threejs-authoring/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-threejs-authoring
-description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-assets alongside this skill when the result should become a source document and a baked GLB. Do not use for Blender bpy work or imported skeletal retargeting.
+description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-models when the result should be a Blender source document with an exported GLB. Do not use for Blender bpy work or imported skeletal retargeting.
 ---
 
 # VGAI Three.js Authoring
@@ -23,9 +23,8 @@ Never introduce a parallel entity tree, semantic operation log, generated
 scene JSON, or wrapper around ordinary Three.js access for agent control. Give
 important objects stable `Object3D.name` values or project metadata.
 
-Also use `vgai-3d-assets` for reusable source-backed assets,
-`vgai-animation-assets` for imported skeletons or clips, and
-`vgai-environment-art` for whole-scene art direction.
+Use `vgai-3d-models` for Blender-sourced assets; prefab placement, stories and the
+naming floor are in `.agents/references/project-manual.md`.
 
 ## Choose the lowest sufficient layer
 
@@ -44,11 +43,7 @@ Keep alternate library representations temporary. Return a normal
 `BufferGeometry`, `Mesh`, `Group`, or other native `Object3D`.
 
 Read [references/helper-catalog.md](references/helper-catalog.md) before adding
-modeling capabilities or dependencies. That catalog answers *which op* — for
-*which surfacing mode* (palette, shader look, tiling projection, card, decal,
-provider retexture, procedural mask) and whether the asset needs UVs at all,
-walk the eight modes cheapest-first in the `vgai-3d-assets` skill's
-`references/surfacing.md`.
+modeling capabilities or dependencies; it answers *which op*.
 
 ## Author raw code
 

package/template/.github/skills/vgai-3d-models/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-3d-models
-description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay use vgai-3d-assets; for procedural geometry generated during gameplay use ordinary Three.js.
+description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay follow .agents/references/project-manual.md; for procedural geometry generated during gameplay use ordinary Three.js.
 ---
 
 # Model a game asset
@@ -45,8 +45,8 @@ verification requirements. Before handoff, run the game's build and inspect the
 exported game. Keep input assets and runtime exports in version control;
 keep scratch files in `.vgai/tmp/`.
 
-For animation and skinning, also read `vgai-animation-assets`; a static mesh
-export is not proof that an animated character is game-ready.
+For animation and skinning, a static mesh export is not proof that an animated
+character is game-ready.
 
 ## Where the model lives
 

package/template/.github/skills/vgai-threejs-authoring/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vgai-threejs-authoring
-description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-assets alongside this skill when the result should become a source document and a baked GLB. Do not use for Blender bpy work or imported skeletal retargeting.
+description: Build, rig, animate, diagnose, and visually refine polished native Three.js scenes and procedural assets with direct Object3D code, reusable construction helpers, geometry libraries, and an inspect-render-critique loop. Use for procedural models, rigid mechanical armatures, environments, static props, stylized materials, lighting, cameras, scene composition, or an agent-focused Blender-like workflow. Use vgai-3d-models when the result should be a Blender source document with an exported GLB. Do not use for Blender bpy work or imported skeletal retargeting.
 ---
 
 # VGAI Three.js Authoring
@@ -23,9 +23,8 @@ Never introduce a parallel entity tree, semantic operation log, generated
 scene JSON, or wrapper around ordinary Three.js access for agent control. Give
 important objects stable `Object3D.name` values or project metadata.
 
-Also use `vgai-3d-assets` for reusable source-backed assets,
-`vgai-animation-assets` for imported skeletons or clips, and
-`vgai-environment-art` for whole-scene art direction.
+Use `vgai-3d-models` for Blender-sourced assets; prefab placement, stories and the
+naming floor are in `.agents/references/project-manual.md`.
 
 ## Choose the lowest sufficient layer
 
@@ -44,11 +43,7 @@ Keep alternate library representations temporary. Return a normal
 `BufferGeometry`, `Mesh`, `Group`, or other native `Object3D`.
 
 Read [references/helper-catalog.md](references/helper-catalog.md) before adding
-modeling capabilities or dependencies. That catalog answers *which op* — for
-*which surfacing mode* (palette, shader look, tiling projection, card, decal,
-provider retexture, procedural mask) and whether the asset needs UVs at all,
-walk the eight modes cheapest-first in the `vgai-3d-assets` skill's
-`references/surfacing.md`.
+modeling capabilities or dependencies; it answers *which op*.
 
 ## Author raw code
 

package/template/AGENTS.md

@@ -10,7 +10,7 @@ The editor is the authoring and verification surface.
 | Build or change this game | This file + the relevant `.agents/references/project-manual.md` section |
 | Open, play, or verify it | `.agents/skills/editor/SKILL.md` |
 | Model or revise a game prop with Blender | `.agents/skills/vgai-3d-models/SKILL.md` |
-| The game needs a 3D asset placed, rigged, or baked | `.agents/skills/vgai-3d-assets/SKILL.md` |
+| The game needs a 3D asset placed, rigged, or baked | `.agents/skills/vgai-3d-models/SKILL.md` (model and export); placement, stories and baking in `.agents/references/project-manual.md` |
 | Other craft (2D/3D art, animation, humanoids, generated assets) | The matching `.agents/skills/vgai-*/SKILL.md` |
 | Import an existing web game | Read-only compatibility report; never rewrite its source |
 | Browse or modify an example | Read-only, or scaffold a copy; user games never go in `examples/` |

package/template/check-idioms.ts

@@ -63,8 +63,7 @@ import { fileURLToPath } from 'node:url';
 //         logs read on an interval, redirected live until satisfied — and
 //         the play log (`logs/play-*.jsonl`) is the playtest's receipt.
 //   SHIP-TIER (E9) — the required naming floor for shipped 3D source (owner
-//   decision 2026-08-10; `.agents/skills/vgai-3d-assets/SKILL.md`, "The
-//   REQUIRED floor"). E9 reports as a WARNING with a standing count the
+//   decision 2026-08-10; `.agents/references/project-manual.md`). E9 reports as a WARNING with a standing count the
 //   operator reads. An unnamed primitive is normal mid-build;
 //   declaring a prefab folder entry without its registration is not.
 //   WARN (exit 0 unless --strict) — heuristics, more prone to false
@@ -1201,7 +1200,7 @@ function checkAuthoringWarnings(): void {
   if (found.length === 0) return;
 
   const fix =
-    'Fix each one at its callsite — the R3F00x codes are the named-nodes half of the required floor: a named prefab with a story (.agents/skills/vgai-3d-assets/SKILL.md). R3F004 wants an ordinary `name` prop, R3F002 wants the ThreeElements transform props forwarded to the one native root, R3F003 wants a single wrapping group, R3F005 wants runtime motion on an inner child. `idioms-ignore E9 <reason>` is the escape when a code is genuinely wrong about your source.';
+    'Fix each one at its callsite — the R3F00x codes are the named-nodes half of the required floor: a named prefab with a story (.agents/references/project-manual.md). R3F004 wants an ordinary `name` prop, R3F002 wants the ThreeElements transform props forwarded to the one native root, R3F003 wants a single wrapping group, R3F005 wants runtime motion on an inner child. `idioms-ignore E9 <reason>` is the escape when a code is genuinely wrong about your source.';
 
   if (floorSeverity() === 'warn') {
     const codes = [...new Set(found.map((f) => f.diagnostic.code))].sort();
@@ -1229,7 +1228,7 @@ function checkAuthoringWarnings(): void {
       'E9',
       'error',
       'authoring-warnings-zero',
-      `${diagnostic.code}: ${diagnostic.message} Authoring warnings are ZERO at handoff — the required floor: a named prefab with a story (.agents/skills/vgai-3d-assets).`,
+      `${diagnostic.code}: ${diagnostic.message} Authoring warnings are ZERO at handoff — the required floor: a named prefab with a story (.agents/references/project-manual.md).`,
       fix,
     );
   }
@@ -1322,7 +1321,7 @@ function checkPrefabStories(): void {
         'E10',
         'error',
         'prefab-ships-a-story',
-        `${name} is a shipped prefab with no colocated story — the required floor: a named prefab with a story (.agents/skills/vgai-3d-assets). Without one it is invisible to the editor's Content tab, which is where a designer finds, previews and places it.`,
+        `${name} is a shipped prefab with no colocated story — the required floor: a named prefab with a story (.agents/references/project-manual.md). Without one it is invisible to the editor's Content tab, which is where a designer finds, previews and places it.`,
         `Add ${relPath(file).replace(/\.[jt]sx$/, '.stories.tsx')} with \`component: ${name}\` in its \`meta\` — copy src/prefabs/HeroBox.stories.tsx and rename. If this module is not a shipped prefab, it does not belong in ${PREFAB_DIR}.`,
       );
       continue;

package/template/package.json

@@ -25,9 +25,9 @@
     "@colyseus/sdk": "^0.17.34",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.1",
-    "@volter/editor-project": "^0.5.65",
-    "@volter/game-runtime": "^0.5.65",
-    "@volter/threejs-runtime": "^0.5.65",
+    "@volter/editor-project": "^0.5.66",
+    "@volter/game-runtime": "^0.5.66",
+    "@volter/threejs-runtime": "^0.5.66",
     "react": "~19.2.4",
     "react-dom": "~19.2.4",
     "three": "^0.180.0",
@@ -41,12 +41,12 @@
     "@types/react-dom": "^19.2.3",
     "@types/three": "^0.180.0",
     "@vitejs/plugin-react": "^5.1.4",
-    "@volter/editor-core": "^0.5.65",
-    "@volter/editor-game": "^0.5.65",
-    "@volter/editor-live": "^0.5.65",
-    "@volter/editor-sdk": "^0.5.65",
-    "@volter/game-editor": "^0.5.65",
-    "@volter/game-live": "^0.5.65",
+    "@volter/editor-core": "^0.5.66",
+    "@volter/editor-game": "^0.5.66",
+    "@volter/editor-live": "^0.5.66",
+    "@volter/editor-sdk": "^0.5.66",
+    "@volter/game-editor": "^0.5.66",
+    "@volter/game-live": "^0.5.66",
     "colyseus": "^0.17.8",
     "storybook": "10.6.0",
     "tsx": "^4.23.0",

package/template/tsconfig.json

@@ -27,6 +27,7 @@
       "@volter/editor-project/*": ["node_modules/@volter/editor-project/src/*"],
       "@volter/threejs-runtime/*": ["node_modules/@volter/threejs-runtime/src/*"],
       "@volter/game-runtime/*": ["node_modules/@volter/game-runtime/src/*"],
+      "@editor/game-module-access": ["node_modules/@volter/editor-game/src/host/game-module-access.ts"],
       "@editor/*": ["node_modules/@volter/editor-core/src/*"]
     }
   },

package/template/vgai.adapter.ts

@@ -70,6 +70,7 @@ export default defineAdapter({
     find: [
       { finder: 'scenesFromEntrypointSelection', regions: ['world'], selection: 'scenes' },
       { finder: 'prefabsFromStories' },
+      { finder: 'machinesFromModules', include: ['src/**/*.ts', 'src/**/*.tsx'] },
     ],
     default: 'main',
   },

package/template-dotfiles/gitignore

@@ -15,6 +15,8 @@ dist-server/
 .vgai/session.json
 .vgai/collaboration.json
 .vgai/workbench.json
+.vgai/chat-selection.json
+.vgai/chat-sessions.json
 .vgai/captures/
 .vgai/tmp/
 .vgai/last-run/

package/workbench/src/media/game-cover.css

@@ -1,5 +1,5 @@
 /* THE GAME EDITOR'S OWN SPLASH — what this product draws into the kit's opening cover
-   (`VgaiProduct.cover`, `packages/editor/workbench/src/vgaiCover.ts`).
+   (`VgaiProduct.cover`, `packages/editor-core/workbench/src/vgaiCover.ts`).
 
    IT SPELLS CLASSIC'S PALETTE, for the same reason the model editor's spells Blender's: the
    cover paints BEFORE any theme extension is registered — the web workbench's first frame is