@volter/game-editor 0.5.65

package/LICENSE-MCP

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Siddharth Ahuja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,21 @@
+Copyright 2026 Volter AI, Inc.
+
+The game editor product is AGPL-3.0-only. It mounts the Blender integration,
+which contains Blender-derived icon artwork under GPL-3.0-or-later;
+LICENSE-BLENDER preserves the integration license and attribution. The
+separately installed Blender engine has its own GPL license and
+corresponding-source requirements.
+
+Transferred from the AGPL-3.0-only vgai-engine repository at revision
+09c2749ce:
+  - packages/game-editor (the product entry and its create presets)
+  - packages/create-vgai-project (the project scaffolder, in node/scaffold)
+  - packages/editor/template (template/)
+  - packages/editor/template-dotfiles (template-dotfiles/)
+  - packages/editor/catalog/project-source and catalog/entries (catalog/)
+  - packages/editor/starter (starter/)
+
+Its command line bundles the Blender MCP transport from @volter/editor-blender.
+BlenderMCP tool descriptions and prompt follow ahujasid/blender-mcp,
+copyright (c) 2025 Siddharth Ahuja, MIT. The permission notice is included
+in LICENSE-MCP.

package/catalog/entries/audio.json

@@ -0,0 +1,14 @@
+{
+  "description": "Game-owned Web Audio graph with a lazy AudioAdapter for editor mute, pause and graph inspection. Expose sfxAudioSystem() as systems.audio from the root entry; gameTone() supplies optional synthesized effects. No sound plays until the game asks for it.",
+  "files": [
+    "src/lib/audio/sfx.ts"
+  ],
+  "id": "audio",
+  "packageJson": {
+    "dependencies": {}
+  },
+  "requires": [],
+  "skills": [],
+  "title": "Game audio (Web Audio)",
+  "version": "0.1.1"
+}

package/catalog/entries/bake.json

@@ -0,0 +1,36 @@
+{
+  "description": "Deterministic Object3D baking to GLB, the read-only module look, the seam that turns a model builder into an HMR-correct instance-sharing prefab, the builder document/inspector factories, and the params-schema reader every generator shares.",
+  "files": [
+    "src/lib/bake/asset-seed.ts",
+    "src/lib/bake/bake-schema.ts",
+    "src/lib/bake/clip-layering.ts",
+    "src/lib/bake/gltf-bake.ts",
+    "src/lib/bake/mesh-slice.ts",
+    "src/lib/bake/node-image.ts",
+    "src/lib/bake/object3d-bake.ts",
+    "src/lib/bake/object3d-lifecycle.ts",
+    "src/lib/bake/object3d-source.ts",
+    "src/lib/bake/use-model.ts",
+    "src/lib/bake/params.ts",
+    "src/lib/bake/rest-relative-animation.ts",
+    "src/tools/bake-module.tool.ts",
+    "src/tools/bake-preview.tool.ts",
+    "src/contributions/builder-document.tsx",
+    "src/contributions/builder-state.ts",
+    "src/contributions/builder-ui.tsx",
+    "src/contributions/module-source.ts",
+    "src/contributions/bake.kind.ts"
+  ],
+  "id": "bake",
+  "packageJson": {
+    "dependencies": {
+      "three-bvh-csg": "^0.0.18",
+      "three-mesh-bvh": "^0.9.12"
+    },
+    "vgaiTools": ["./src/tools/bake-module.tool.ts", "./src/tools/bake-preview.tool.ts"]
+  },
+  "requires": [],
+  "skills": [],
+  "title": "Bake",
+  "version": "0.32.0"
+}

package/catalog/entries/blender.json

@@ -0,0 +1,17 @@
+{
+  "description": "Blender-style modeling \u2014 TWO PACKAGES. `@volter/blender-engine` is Blender itself, compiled to WebAssembly and running headless in the editor tab's worker (GPL-3.0-or-later, because Blender is); `@volter/editor-blender` is the editor-side half that drives it: the Model document (a `.blend` the engine opens, edits and saves), the `modelsFromBlendFiles` finder, the display transforms and the Blender look \u2014 style, keymap, palette, icons and the Model/Sculpt/Texture layouts (ARCHITECTURE-CORE \u00a7Blender north star). Adding this capability declares both dependencies and copies in the starter model: `src/models/cube.blend` \u2014 a real Blender document \u2014 and `src/models/cube.py`, the bpy script that authored it, which stays in the project as the asset's source. Select the finder in `vgai.adapter.ts`: `{ finder: 'modelsFromBlendFiles', include: ['src/models/**/*.blend'] }`.",
+  "files": [],
+  "id": "blender",
+  "packageJson": {
+    "dependencies": {
+      "@volter/editor-blender": "0.1.8",
+      "@volter/blender-engine": "0.1.7"
+    }
+  },
+  "requires": [
+    "bake"
+  ],
+  "skills": [],
+  "title": "Blender",
+  "version": "0.136.0"
+}

package/catalog/entries/react-root.json

@@ -0,0 +1,24 @@
+{
+  "description": "Mount this project's `dom` roots with React. A dom root is just an HTMLElement the host hands you; this registers React as what fills it (createRoot + WorldProvider + unmount). Replace it with Vue, Svelte or plain DOM by registering your own factory for 'dom'.",
+  "files": [
+    "src/lib/react-root/index.ts",
+    "src/lib/react-root/react-root-adapter.tsx",
+    "src/contributions/pages.finder.ts"
+  ],
+  "id": "react-root",
+  "packageJson": {
+    "dependencies": {
+      "react": "^19.2.4",
+      "react-dom": "^19.2.4"
+    }
+  },
+  "regions": {
+    "dom": [
+      "src/lib/react-root/**/*.tsx"
+    ]
+  },
+  "requires": [],
+  "skills": [],
+  "title": "React dom-root adapter",
+  "version": "0.2.5"
+}

package/catalog/entries/reflections.json

@@ -0,0 +1,29 @@
+{
+  "description": "Local reflection capture using Three CubeCamera and PMREMGenerator. ReflectionProbe publishes { envMap, envMapIntensity } through its render prop for explicit binding to native materials. Optional createVolumeReflectionMaterial and createVolumeReflectionPhysicalMaterial factories provide volume blending, priority and box-projected parallax across mixed-resolution probes. The editor shows probe volumes, typed settings, capture status and Recapture; authored settings remain in JSX.",
+  "files": [
+    "src/lib/reflections/ReflectionProbe.tsx",
+    "src/lib/reflections/index.ts",
+    "src/lib/reflections/probe-controller.ts",
+    "src/lib/reflections/reflection-probe-registry.ts",
+    "src/lib/reflections/volume-reflection-material.ts"
+  ],
+  "id": "reflections",
+  "packageJson": {
+    "dependencies": {
+      "@react-three/fiber": "^9.6.1",
+      "react": "^19.2.4",
+      "three": "^0.180.0"
+    }
+  },
+  "regions": {
+    "three": [
+      "src/lib/reflections/**/*.tsx"
+    ]
+  },
+  "requires": [],
+  "skills": [
+    "vgai-environment-art"
+  ],
+  "title": "Reflection probes",
+  "version": "0.2.1"
+}

package/catalog/entries/static-batch.json

@@ -0,0 +1,25 @@
+{
+  "description": "Static batching for a three/TSX world, as one wrapper. `<Frozen name=\"Terminal\">…</Frozen>` declares mount-static scenery; on mount it walks that subtree, groups meshes by structural material identity plus shadow flags and layers, turns identical geometries into one `InstancedMesh`, merges the rest, hides the originals, and restores everything exactly on unmount. Multi-material geometry keeps its authored submesh assignment: every validated geometry group becomes a material-specific contribution, including singleton replacements, so hiding the original never drops pixels. Malformed ranges, missing slots, and transparent arrays refuse the whole source loudly before anything is hidden. Structural grouping, never `material.uuid`, collapses inline JSX materials that construct one object per mesh. Instanced, batched, skinned, morph-target and transparent meshes degrade loudly to their original draws; `userData={{ staticBatch: false }}` excludes a subtree silently. In dev, hidden originals are sampled at ~1 Hz for matrix, every material-slot version, and visibility drift. Reactive scenery belongs outside the wrapper. Render vitals report the measured payoff and exact edit when draw calls warrant it.",
+  "files": [
+    "src/lib/static-batch/Frozen.tsx",
+    "src/lib/static-batch/freeze.ts",
+    "src/lib/static-batch/index.ts",
+    "src/lib/static-batch/mutation-watch.ts",
+    "src/lib/static-batch/shadow-cache.ts"
+  ],
+  "id": "static-batch",
+  "packageJson": {
+    "dependencies": {
+      "@react-three/fiber": "^9.6.1",
+      "react": "^19.2.4",
+      "three": "^0.180.0"
+    }
+  },
+  "regions": {
+    "three": ["src/lib/static-batch/**/*.tsx"]
+  },
+  "requires": [],
+  "skills": [],
+  "title": "Static batching (<Frozen> mount-static scenery)",
+  "version": "0.2.3"
+}

package/catalog/project-source/LICENSE

@@ -0,0 +1,37 @@
+MIT License
+
+Copyright (c) 2026 Volter AI, Inc.
+
+THIS SUBTREE IS NOT AGPL. It sits inside `packages/editor`, which is
+AGPL-3.0-only, and it is deliberately excluded from that grant and licensed MIT
+instead — because every file here is COPIED, byte for byte, into projects that
+are not ours. `vgai add <id>` copies a capability's declared files into a user's
+game; `npm run capabilities:sync` copies the same bytes into the MIT starter
+template (`packages/editor/template/`). The copy becomes the project's, editing
+it is the entire point (the shadcn model), and the person who edits it must be
+able to relicense their game under any terms they choose. Source that lands in
+someone's game under the editor's copyleft would be a trap, so it is MIT at the
+source: the licence of the file does not change on the way in.
+
+The AGPL continues to govern the rest of `packages/editor` — the editor
+application that does the copying. See LICENSE.md at the repository root for
+the per-package map, and `packages/editor/template/LICENSE` for the template's
+own copy of this grant.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/catalog/project-source/src/contributions/bake.kind.ts

@@ -0,0 +1,40 @@
+/**
+ * The `bake` CONFIGURATION KIND (ARCHITECTURE-CORE §The project model): a
+ * build-role configuration that bakes one project-authored Object3D module
+ * into a GLB — the bake capability's own `project.bake.module` tool, run by
+ * the host as a build. Declare one in `vgai.project.json`:
+ *
+ *   { "id": "cube-glb", "kind": "bake", "modulePath": "src/models/cube.ts", "name": "cube" }
+ *
+ * and `vgai build cage-glb` (or Export) bakes it. This module is a plain
+ * object the HOST registers; it mounts no UI.
+ */
+
+import { z } from 'zod';
+
+export const kind = {
+  kind: 'bake',
+  role: 'build',
+  describe: 'Bake an Object3D module into a GLB (the bake capability\'s project.bake.module tool)',
+  schema: z
+    .object({
+      id: z.string().min(1),
+      kind: z.literal('bake'),
+      modulePath: z.string().min(1).describe('Project-relative module exporting the builder'),
+      exportName: z.string().min(1).optional().describe("The export to call (default: the module's default)"),
+      name: z
+        .string()
+        .regex(/^[a-z0-9][a-z0-9-_]{0,63}$/)
+        .describe('Stable lowercase asset name for the GLB'),
+    })
+    .strict(),
+  build: {
+    tool: 'project.bake.module',
+    input: (configuration: { modulePath: string; exportName?: string; name: string }) => ({
+      modulePath: configuration.modulePath,
+      exportName: configuration.exportName ?? 'default',
+      name: configuration.name,
+      dryRun: false,
+    }),
+  },
+} as const;

package/catalog/project-source/src/contributions/builder-document.tsx

@@ -0,0 +1,65 @@
+import type {
+  ToolContributionProps,
+  ToolObject3DPreviewSource,
+} from '@volter/editor-sdk/contributions';
+import { type ComponentType, useCallback, useSyncExternalStore } from 'react';
+import type { BuilderState } from './builder-state';
+
+/**
+ * The wiring every parametric-asset Builder document repeats: subscribe to the
+ * lib's builder state, rebuild on the params that actually affect the mesh, and
+ * hand the raw native graph to the editor-owned `Object3DAuthoring` surface.
+ *
+ * This is a plain helper with explicit inputs and outputs — NOT a registry, base
+ * class, or generator kind. Each lib still owns its own contribution file and
+ * its own `vgaiTools` entry; the file just shrinks to the handful of facts that
+ * are genuinely its own (what to build, what it is called, and where its
+ * source lives).
+ */
+export interface BuilderDocumentConfig<T extends object> {
+  /** The shared store this document and its Generator inspector both read. */
+  state: BuilderState<T>;
+  /** Build the native graph for a state snapshot. */
+  build: (state: T) => ToolObject3DPreviewSource;
+  /** Title shown on the workspace document. */
+  displayName: string;
+  /** Project-relative path of the build source, for the document's source link. */
+  sourcePath: string;
+  cameraDirection: readonly [number, number, number];
+  /**
+   * Which state fields rebuild the preview. Defaults to the whole snapshot.
+   * Libs whose state also carries fields the BUILD ignores (bake-only inputs,
+   * for instance) narrow it here so typing in those fields is not a rebuild.
+   * The returned array's length must be stable across renders.
+   */
+  rebuildOn?: (state: T) => readonly unknown[];
+}
+
+/** Build the default-export component for a Builder workspace document. */
+export function createBuilderDocument<T extends object>(
+  config: BuilderDocumentConfig<T>,
+): ComponentType<ToolContributionProps> {
+  return function BuilderDocument({ active, documentId, surfaces }: ToolContributionProps) {
+    const state = useSyncExternalStore(
+      config.state.subscribe,
+      config.state.getSnapshot,
+      config.state.getSnapshot,
+    );
+    const build = useCallback(
+      () => config.build(state),
+      config.rebuildOn ? [...config.rebuildOn(state)] : [state],
+    );
+    if (!documentId) return <div>This contribution must be opened as a workspace document.</div>;
+    const Object3DAuthoring = surfaces.Object3DAuthoring;
+    return (
+      <Object3DAuthoring
+        active={active ?? true}
+        build={build}
+        cameraDirection={config.cameraDirection}
+        displayName={config.displayName}
+        documentId={documentId}
+        sourcePath={config.sourcePath}
+      />
+    );
+  };
+}

package/catalog/project-source/src/contributions/builder-state.ts

@@ -0,0 +1,27 @@
+export interface BuilderState<T extends object> {
+  getSnapshot(): T;
+  subscribe(listener: () => void): () => void;
+  update(patch: Partial<T> | ((current: T) => T)): void;
+  reset(): void;
+}
+
+/** Tiny project-owned state shared by one document contribution and its Inspector contribution. */
+export function createBuilderState<T extends object>(initial: T): BuilderState<T> {
+  let value = initial;
+  const listeners = new Set<() => void>();
+  return {
+    getSnapshot: () => value,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    update(patch) {
+      value = typeof patch === 'function' ? patch(value) : { ...value, ...patch };
+      for (const listener of listeners) listener();
+    },
+    reset() {
+      value = initial;
+      for (const listener of listeners) listener();
+    },
+  };
+}

package/catalog/project-source/src/contributions/builder-ui.tsx

@@ -0,0 +1,61 @@
+import type { CSSProperties } from 'react';
+
+export const hintStyle: CSSProperties = { color: 'var(--vgai-content-muted)', fontSize: 11 };
+export const fieldLabelStyle: CSSProperties = { fontSize: 12, fontWeight: 600 };
+export const inputStyle: CSSProperties = { width: '100%', minWidth: 0, boxSizing: 'border-box' };
+
+export function BuilderSliderRow({
+  label,
+  hint,
+  min,
+  max,
+  step = 0.01,
+  value,
+  onChange,
+}: {
+  label: string;
+  hint: string;
+  min: number;
+  max: number;
+  /** Slider/spinner increment (default 0.01 — the proportion-param grain;
+   *  metre-scale offsets pass 0.001). */
+  step?: number;
+  value: number;
+  onChange(value: number): void;
+}) {
+  return (
+    <label style={sliderRowStyle}>
+      <span style={{ minWidth: 0 }}>
+        <strong style={{ display: 'block', fontSize: 12 }}>{label}</strong>
+        <span style={hintStyle}>{hint}</span>
+      </span>
+      <input
+        type="range"
+        min={min}
+        max={max}
+        step={step}
+        value={value}
+        onChange={(event) => onChange(Number(event.target.value))}
+        style={{ width: '100%', minWidth: 0, accentColor: 'var(--vgai-accent)' }}
+      />
+      <input
+        className="vgai-input"
+        type="number"
+        min={min}
+        max={max}
+        step={step}
+        value={value}
+        onChange={(event) => onChange(Number(event.target.value))}
+        style={{ width: 64, boxSizing: 'border-box' }}
+      />
+    </label>
+  );
+}
+
+const sliderRowStyle: CSSProperties = {
+  display: 'grid',
+  gridTemplateColumns: 'minmax(90px, 0.85fr) minmax(70px, 1.15fr) 64px',
+  alignItems: 'center',
+  gap: 10,
+  minWidth: 0,
+};