@volter/editor-game 0.5.68 → 0.5.69

package/src/host/authoring/pixi-authoring-adapter.ts

@@ -247,7 +247,7 @@ export interface PixiAuthoringOptions {
    * `pickable` at all — a stage with no mapped surface cannot answer where a
    * client point landed, and guessing one would fabricate a hit.
    *
-   * When the element carries `data-vgai-stage-width`/`-height`, those are the
+   * When the element carries `data-volter-stage-width`/`-height`, those are the
    * stage's LOGICAL size and the mapping divides the measured rect by them —
    * which is what lets a design surface presented through the shared pan/zoom
    * camera (a CSS scale) pick correctly. Without them the mapping is 1:1,
@@ -413,6 +413,11 @@ function defaultLabelFor(kind: string): string {
  *  `pixi` is THIS SURFACE's namespace ({@link PixiAuthoringOptions.pixi}): a
  *  node built from another graph's classes is a foreign object in the world's
  *  own display list, and the world's renderer is the one that has to draw it. */
+/** A ParticleContainer, from whichever copy of Pixi made it: it adds particles, never children. */
+function isParticleContainer(object: Container | null | undefined): boolean {
+  return !!object && typeof (object as { addParticle?: unknown }).addParticle === 'function';
+}
+
 function createDisplayObject(pixi: CanvasPixiNamespace, kind: string): Container | null {
   switch (kind) {
     case 'container':
@@ -439,6 +444,18 @@ function createDisplayObject(pixi: CanvasPixiNamespace, kind: string): Container
       return new pixi.BitmapText({ text: 'BitmapText', style: { fill: 0xffffff, fontSize: 24 } });
     case 'htmlText':
       return new pixi.HTMLText({ text: 'HTMLText', style: { fill: 0xffffff, fontSize: 24 } });
+    case 'meshPlane': {
+      const plane = new pixi.MeshPlane({ texture: pixi.Texture.WHITE });
+      plane.setSize(100, 100);
+      return plane;
+    }
+    case 'perspectiveMesh': {
+      const mesh = new pixi.PerspectiveMesh({ texture: pixi.Texture.WHITE });
+      mesh.setSize(100, 100);
+      return mesh;
+    }
+    case 'particleContainer':
+      return new pixi.ParticleContainer();
     default:
       return null;
   }
@@ -589,7 +606,18 @@ function transformForBoxPatch(
     scale: [...session.transform.scale],
   };
   const rotate = patch['rotate'];
-  if (rotate !== undefined) next.rotation = rotateTransformZ(session.transform, localTurn(session, rotate));
+  if (rotate !== undefined) {
+    let turn = localTurn(session, rotate);
+    const step = patch['rotationStep'];
+    if (step !== undefined && step > 0) {
+      // Configure Snap's absolute step lands the node's own rotation on the step from the offset.
+      const [, , z, w] = session.transform.rotation;
+      const start = (2 * Math.atan2(z, w) * 180) / Math.PI;
+      const offset = patch['rotationOffset'] ?? 0;
+      turn = Math.round((start + turn - offset) / step) * step + offset - start;
+    }
+    next.rotation = rotateTransformZ(session.transform, turn);
+  }
   const width = patch['width'];
   if (width !== undefined && session.rect.width > 0) {
     next.scale[0] = session.transform.scale[0] * Math.max(0.0001, width / session.rect.width);
@@ -817,10 +845,38 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     const structure = this.target.structure ?? this.liveStructure;
     // A placed creation reaches the structure in the new node's PARENT's own space: the target
     // writes `x`/`y` as authored, and only this adapter knows the frame `rects` answer in.
+    // A ParticleContainer holds particles its code adds, never display objects: Pixi's `addChild`
+    // on one throws, so nothing is created or moved into it.
+    const holdsNoChildren = (parentId: string | null | undefined): boolean =>
+      !!parentId && isParticleContainer(this.projector.object(parentId));
+    const noChildren = 'a ParticleContainer holds particles added with addParticle, not display objects.';
     this.structure = {
       ...structure,
       create: (kind, parentId, at) =>
-        structure.create(kind, parentId, at ? this.pointInParent(parentId ?? null, at) : undefined),
+        holdsNoChildren(parentId)
+          ? { id: '', ack: this.refuseStructure(noChildren) }
+          : structure.create(kind, parentId, at ? this.pointInParent(parentId ?? null, at) : undefined),
+      ...(structure.reparent
+        ? {
+            reparent: (id: string, newParentId: string | null) =>
+              holdsNoChildren(newParentId) ? this.refuseStructure(noChildren) : structure.reparent!(id, newParentId),
+          }
+        : {}),
+      ...(structure.paste
+        ? {
+            paste: (parentId: string | null) =>
+              holdsNoChildren(parentId) ? this.refuseStructure(noChildren) : structure.paste!(parentId),
+          }
+        : {}),
+      ...(structure.canPaste
+        ? { canPaste: (parentId: string | null) => !holdsNoChildren(parentId) && structure.canPaste!(parentId) }
+        : {}),
+      ...(structure.creatableKinds
+        ? {
+            creatableKinds: (parentId: string | null) =>
+              holdsNoChildren(parentId) ? [] : structure.creatableKinds!(parentId),
+          }
+        : {}),
     };
     this.assetDrop =
       this.target.assetDrop ??
@@ -1039,7 +1095,7 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
   private containerFor(parentId: string | null): Container | null {
     if (!parentId) return this.root;
     const object = this.projector.object(parentId);
-    if (!object || typeof object.addChild !== 'function') return null;
+    if (!object || typeof object.addChild !== 'function' || isParticleContainer(object)) return null;
     return object;
   }
 

package/src/host/authoring/pixi-creatable-kinds.ts

@@ -59,4 +59,22 @@ export const PIXI_CREATABLE_KINDS: readonly CreatableKind[] = [
     extends: 'container',
     description: 'Draws vector shapes (rectangles, circles, paths) from its draw callback.',
   },
+  {
+    kind: 'meshPlane',
+    label: 'MeshPlane',
+    extends: 'container',
+    description: 'A textured grid of vertices that can be bent and deformed.',
+  },
+  {
+    kind: 'perspectiveMesh',
+    label: 'PerspectiveMesh',
+    extends: 'meshPlane',
+    description: 'A texture drawn in perspective between four corner points.',
+  },
+  {
+    kind: 'particleContainer',
+    label: 'ParticleContainer',
+    extends: 'container',
+    description: 'Draws many lightweight particles in one batch, added from code with addParticle.',
+  },
 ];

package/src/host/authoring/pixi-live-write-target.ts

@@ -30,6 +30,7 @@
  * moved, and the persistence parameter is what this unit added.
  */
 
+import { physicsOwnerOf } from '@volter/editor-project/adapter';
 import type {
   AuthoringAdapter2D,
   Overlay2D,
@@ -554,7 +555,7 @@ export function createLiveCanvasWriteTarget(
    * `literalsFor` is what a rendering one needs. A revert or an apply is a
    * deliberate act with somewhere to await, so it must not silently do nothing
    * merely because nothing happened to have described this node first (an agent
-   * driving the provider through `vgai eval` never does).
+   * driving the provider through `volter-game-editor eval` never does).
    */
   const literalsNow = async (
     id: string,
@@ -807,7 +808,7 @@ export function createLiveCanvasWriteTarget(
     beginTransformEdit(id: string): void {
       historyResource?.assertCanMutate();
       const display = a2d.displayObject(id);
-      if (display && physics.ownerOf(display) === 'physics') physics.freeze(display);
+      if (display && physicsOwnerOf(physics, display) === 'physics') physics.freeze(display);
       editStartState = captureHistoryState();
       editBaseline = persist ? (a2d.getTransform(id) ?? undefined) : undefined;
       editMovedOrigin = false;
@@ -816,7 +817,7 @@ export function createLiveCanvasWriteTarget(
     writeTransform(id: string, next: Transform2DValue): void {
       historyResource?.assertCanMutate();
       const display = a2d.displayObject(id);
-      if (display && physics.ownerOf(display) === 'physics') {
+      if (display && physicsOwnerOf(physics, display) === 'physics') {
         physics.commit(display, next.position, next.rotation);
       }
       a2d.setTransform(id, next);
@@ -829,7 +830,7 @@ export function createLiveCanvasWriteTarget(
     // source write is attempted.
     endTransformEdit(id: string): void | Promise<WriteAck> {
       const display = a2d.displayObject(id);
-      if (display && physics.ownerOf(display) === 'physics') physics.unfreeze(display);
+      if (display && physicsOwnerOf(physics, display) === 'physics') physics.unfreeze(display);
       const label = `Transform ${labelOf(id)}`;
       const before = editStartState;
       const baseline = editBaseline;
@@ -907,7 +908,7 @@ export function createLiveCanvasWriteTarget(
      * channel a refused transform does: they asked for source writes, so each
      * one that did not land matters individually. Unarmed, the first structural
      * edit of the session raises the warning that reaches the product's own
-     * doors (`vgai status`, the session journal, one ack to clear) — a whole
+     * doors (`volter-game-editor status`, the session journal, one ack to clear) — a whole
      * class of this author's edits will not be saved, which is exactly what an
      * unresolved warning is for — and every later op logs, because repeating an
      * ack-requiring entry per created node would flood the set with the lane

package/src/host/authoring/pixi-source-write-target.ts

@@ -119,12 +119,15 @@ const CREATE_SNIPPETS: Readonly<Record<string, string>> = {
   nineSliceSprite: '<pixiNineSliceSprite label="NineSliceSprite" texture={Texture.WHITE} width={100} height={100} />',
   bitmapText: '<pixiBitmapText label="BitmapText" text="BitmapText" />',
   htmlText: '<pixiHTMLText label="HTMLText" text="HTMLText" />',
+  meshPlane: '<pixiMeshPlane label="MeshPlane" texture={Texture.WHITE} width={100} height={100} />',
+  perspectiveMesh: '<pixiPerspectiveMesh label="PerspectiveMesh" texture={Texture.WHITE} width={100} height={100} />',
+  particleContainer: '<pixiParticleContainer label="ParticleContainer" />',
 };
 /** A kind whose snippet names Pixi's `Texture`, which the file must then import. */
-const TEXTURE_SNIPPET_KINDS = new Set(['animatedSprite', 'tilingSprite', 'nineSliceSprite']);
+const TEXTURE_SNIPPET_KINDS = new Set(['animatedSprite', 'tilingSprite', 'nineSliceSprite', 'meshPlane', 'perspectiveMesh']);
 
 function isHiddenProp(name: string): boolean {
-  return HIDDEN_PROPS.has(name) || /^on[A-Z]/.test(name) || name.startsWith('__vgai');
+  return HIDDEN_PROPS.has(name) || /^on[A-Z]/.test(name) || name.startsWith('__volter');
 }
 
 /** Present a source identifier the way native engine inspectors present

package/src/host/authoring/pixi-structure-history.ts

@@ -42,7 +42,7 @@ const ROOT_UID = '#root';
  *  `AuthoringAdapter2D` uses for `__authId`, for the same reason (there is no
  *  side table that survives the object outliving one walk). */
 interface StructureStamped {
-  __vgaiStructUid?: string;
+  __volterStructUid?: string;
 }
 
 /** A node's own local pose, as plain numbers. Recorded because `reparent`
@@ -185,10 +185,10 @@ export class CanvasStructureHistory {
   private uidOf(object: Container): string {
     if (object === this.root) return ROOT_UID;
     const stamped = object as Container & StructureStamped;
-    const existing = stamped.__vgaiStructUid;
+    const existing = stamped.__volterStructUid;
     if (existing && this.byUid.get(existing) === object) return existing;
     const uid = existing ?? `s${crypto.randomUUID()}`;
-    stamped.__vgaiStructUid = uid;
+    stamped.__volterStructUid = uid;
     this.byUid.set(uid, object);
     return uid;
   }

package/src/host/binding-resolver.ts

@@ -4,7 +4,7 @@
  *
  * A game is a native program plus a declaration of itself; the editor is a
  * universal client of that declaration. This module is where the declaration
- * is READ: the manifest root, the project's parsed `vgai.adapter.ts`, and the
+ * is READ: the manifest root, the project's parsed `volter.adapter.ts`, and the
  * entry module's own static surface, resolved against ONE realm
  * (`realm-services.ts` — dev or packaged).
  *
@@ -85,7 +85,7 @@ export interface ResolveRootBindingOptions {
  * Resolve one manifest root against one realm.
  *
  * `adapterDef` is an INPUT, never something this function goes and fetches:
- * `vgai.adapter.ts` loading stays in `project-adapter.ts`, and the binding is
+ * `volter.adapter.ts` loading stays in `project-adapter.ts`, and the binding is
  * the hand-off's shape rather than a second loader.
  */
 export async function resolveRootBinding(
@@ -252,7 +252,7 @@ function rejectCapturedIngestAsRootAdapter(root: ResolvedAdapterRoot): never {
 export interface ResolveAllRootEntriesOptions {
   /**
    * Remount the named region's entrypoint at this swap-slot key. Only that
-   * world's entry URL carries the override; siblings share `?vgai-mount=`
+   * world's entry URL carries the override; siblings share `?volter-mount=`
    * alone so the module graph stays one instance.
    */
   readonly selectionOverride?:
@@ -276,7 +276,7 @@ interface ResolvedComposition {
  * resolvers would give each root its own generation, which is the defect.
  *
  * The COMPOSITION level is likewise where the project's two ambient inputs are
- * fetched — the realm's services and the parsed `vgai.adapter.ts` — because
+ * fetched — the realm's services and the parsed `volter.adapter.ts` — because
  * both are properties of the open project rather than of any one root, and
  * asking once per composition is what keeps every root of a game bound to the
  * same declaration. `resolveRootBinding` itself still fetches neither: it is
@@ -302,7 +302,7 @@ async function resolveComposition(
     out.push({ world, resolved });
   }
   // Stringified because that is the form the id travels in everywhere else:
-  // the entry url's `?vgai-mount=` value, and therefore the key
+  // the entry url's `?volter-mount=` value, and therefore the key
   // `gated-globals.ts` reads back off a module url.
   return { roots: out, mountId: String(epoch) };
 }
@@ -351,7 +351,7 @@ export async function resolveAllRoots(
  *
  * It also returns this composition's `mountId` — the identity the whole
  * isolation layer is keyed by. It is minted here (one epoch per composition),
- * rides every project module url as `?vgai-mount=`, and is what
+ * rides every project module url as `?volter-mount=`, and is what
  * `gated-globals.ts` resolves a realm and an input gate under.
  *
  * It does NOT return the entry modules' harvested `debug`/`systems` bindings.

package/src/host/browser-transpile.ts

@@ -174,7 +174,7 @@ export function registerRuntimeModules(modules: Record<string, ModuleNamespace>)
   }
   // Exposed on globalThis so shim modules (which run in their own module scope)
   // can reach the live namespaces by specifier.
-  (globalThis as Record<string, unknown>)['__vgaiModules'] = Object.fromEntries(runtimeModules);
+  (globalThis as Record<string, unknown>)['__volterModules'] = Object.fromEntries(runtimeModules);
 }
 
 /**
@@ -259,7 +259,7 @@ function loadRuntimeModule(spec: string): Promise<void> {
 
 /**
  * The call-time half of a literal dynamic import in project code. The rewrite
- * turns `import('tone')` into `globalThis.__vgaiImportRuntimeModule('tone')`,
+ * turns `import('tone')` into `globalThis.__volterImportRuntimeModule('tone')`,
  * so the load — and the wall, if the browser editor does not ship it — happens
  * exactly when the project's own code executes the import, never earlier.
  */
@@ -267,7 +267,7 @@ export async function importRuntimeModule(spec: string): Promise<ModuleNamespace
   if (!runtimeModules.has(spec)) await loadRuntimeModule(spec);
   return runtimeModules.get(spec) as ModuleNamespace;
 }
-(globalThis as Record<string, unknown>)['__vgaiImportRuntimeModule'] = importRuntimeModule;
+(globalThis as Record<string, unknown>)['__volterImportRuntimeModule'] = importRuntimeModule;
 
 /**
  * Bring every static bare import live, then rewrite by the lexer's own byte
@@ -304,7 +304,7 @@ export async function resolveAndRewriteBareImports(code: string): Promise<string
       out = `${out.slice(0, record.s)}${shimUrlFor(record.n)}${out.slice(record.e)}`;
     } else if (record.d >= 0) {
       // Literal dynamic import: swap the whole `import(...)` expression.
-      out = `${out.slice(0, record.ss)}globalThis.__vgaiImportRuntimeModule(${JSON.stringify(
+      out = `${out.slice(0, record.ss)}globalThis.__volterImportRuntimeModule(${JSON.stringify(
         record.n,
       )})${out.slice(record.se)}`;
     }
@@ -379,7 +379,7 @@ function shimUrlFor(spec: string): string {
   // `registerRuntimeModules` user) — the same wall, said the same way.
   if (!ns) throw unregisteredRuntimeModules([spec]);
 
-  const lines = [`const __m = globalThis.__vgaiModules[${JSON.stringify(spec)}];`];
+  const lines = [`const __m = globalThis.__volterModules[${JSON.stringify(spec)}];`];
   for (const key of Object.keys(ns)) {
     if (key === 'default' || !IDENT_RE.test(key) || RESERVED_WORDS.has(key)) continue;
     lines.push(`export const ${key} = __m[${JSON.stringify(key)}];`);
@@ -432,7 +432,7 @@ export async function transpileToModuleUrl(
 
 /**
  * Prepend the game-globals lexical shadow to project source — the browser-side
- * analogue of the dev server's `vgai-game-globals` Vite plugin
+ * analogue of the dev server's `volter-game-globals` Vite plugin
  * (`server/dev.ts` + `shouldShadowGameGlobals`). The server shadows per-module
  * because Vite transforms EVERY module indiscriminately and must be told which
  * ones are game code; the browser has no such firehose — {@link importFromSource}
@@ -541,7 +541,7 @@ export function loaderFor(path: string): esbuild.Loader {
 function resolveServedModulePath(importer: string, specifier: string): string {
   if (specifier.startsWith('/')) return specifier;
   if (/^(?:https?:|blob:|data:)/.test(specifier)) return specifier;
-  const origin = globalThis.location?.origin ?? 'https://vgai.invalid';
+  const origin = globalThis.location?.origin ?? 'https://volter.invalid';
   const resolved = new URL(specifier, new URL(importer, origin));
   return resolved.origin === origin
     ? `${resolved.pathname}${resolved.search}${resolved.hash}`
@@ -572,7 +572,7 @@ export async function bundleServedModule(
     define: PROJECT_MODULE_DEFINES,
     plugins: [
       {
-        name: 'vgai-served-module',
+        name: 'volter-served-module',
         setup(build) {
           build.onResolve({ filter: /.*/ }, (args) => {
             if (
@@ -586,9 +586,9 @@ export async function bundleServedModule(
               args.kind === 'entry-point'
                 ? args.path
                 : resolveServedModulePath(args.importer, args.path);
-            return { path, namespace: 'vgai-served' };
+            return { path, namespace: 'volter-served' };
           });
-          build.onLoad({ filter: /.*/, namespace: 'vgai-served' }, async (args) => {
+          build.onLoad({ filter: /.*/, namespace: 'volter-served' }, async (args) => {
             const response = await fetchImpl(args.path);
             if (!response.ok) {
               throw new Error(

package/src/host/canvas-preview-frames.ts

@@ -17,7 +17,7 @@
  * five callers never had a story in hand (`authoring/canvas-design-mount.ts`,
  * `authoring/pixi-still-presentation.ts`, `components/world-root-stage.ts`,
  * `live-canvas-frame.ts`, and the ingest lane's canvas mount); moving it out is
- * the part of the CSF estate's exit to `@vgai/game` (WORK.md §The open-source
+ * the part of the CSF estate's exit to `@volter/game` (WORK.md §The open-source
  * launch, phase 1 unit 3) that does not wait on anything else.
  */
 

package/src/host/components/CameraAuthoringOverlay.tsx

@@ -56,13 +56,13 @@ function CameraPreview({ previewRef }: CameraAuthoringOverlayProps) {
       : 16 / 9;
 
   return (
-    <div className="vgai-camera-preview" data-testid="camera-preview">
-      <Inline className="vgai-camera-preview-header" gap={4} align="center">
+    <div className="volter-camera-preview" data-testid="camera-preview">
+      <Inline className="volter-camera-preview-header" gap={4} align="center">
         <EditorIcon icon={faCamera} size="sm" />
         <Text
           variant="label"
           truncate
-          className="vgai-camera-preview-title"
+          className="volter-camera-preview-title"
           title={`${preview.name} · ${preview.lens}`}
         >
           {preview.name}
@@ -77,7 +77,7 @@ function CameraPreview({ previewRef }: CameraAuthoringOverlayProps) {
             <EditorIcon icon={faThumbtack} size="sm" />
           </IconButton>
         </Tooltip>
-        <div ref={menuRef} className="vgai-camera-preview-menu-anchor">
+        <div ref={menuRef} className="volter-camera-preview-menu-anchor">
           <Tooltip text="Camera actions">
             <IconButton
               aria-label="Camera actions"
@@ -89,7 +89,7 @@ function CameraPreview({ previewRef }: CameraAuthoringOverlayProps) {
             </IconButton>
           </Tooltip>
           {menuOpen ? (
-            <EditorPopover className="vgai-camera-preview-menu">
+            <EditorPopover className="volter-camera-preview-menu">
               <Button
                 variant="ghost"
                 size="compact"
@@ -130,7 +130,7 @@ function CameraPreview({ previewRef }: CameraAuthoringOverlayProps) {
       </Inline>
       <div
         ref={previewRef}
-        className="vgai-camera-preview-image"
+        className="volter-camera-preview-image"
         style={{ aspectRatio: String(Math.max(0.5, Math.min(3, aspect))) }}
         role="img"
         aria-label={`Live view through ${preview.name}`}
@@ -142,13 +142,13 @@ function CameraPreview({ previewRef }: CameraAuthoringOverlayProps) {
 
 function CompositionGuides() {
   return (
-    <div className="vgai-camera-guides" aria-hidden="true">
-      <div className="vgai-camera-guide vgai-camera-guide-v1" />
-      <div className="vgai-camera-guide vgai-camera-guide-v2" />
-      <div className="vgai-camera-guide vgai-camera-guide-h1" />
-      <div className="vgai-camera-guide vgai-camera-guide-h2" />
-      <div className="vgai-camera-safe-frame" />
-      <div className="vgai-camera-center-mark" />
+    <div className="volter-camera-guides" aria-hidden="true">
+      <div className="volter-camera-guide volter-camera-guide-v1" />
+      <div className="volter-camera-guide volter-camera-guide-v2" />
+      <div className="volter-camera-guide volter-camera-guide-h1" />
+      <div className="volter-camera-guide volter-camera-guide-h2" />
+      <div className="volter-camera-safe-frame" />
+      <div className="volter-camera-center-mark" />
     </div>
   );
 }
@@ -163,7 +163,7 @@ function CameraViewBanner() {
       <EditorSurface
         variant="overlay"
         border
-        className="vgai-camera-view-banner vgai-chrome-island vgai-glass-island"
+        className="volter-camera-view-banner volter-chrome-island volter-glass-island"
         data-testid="camera-view-banner"
       >
         <Inline gap={6} align="center">

package/src/host/components/HeaderTelemetry.tsx

@@ -172,13 +172,13 @@ function AudioTelemetry() {
         : 'Audio quiet';
 
   return (
-    <div className="vgai-header-audio" data-muted={muted || undefined} data-available={!!adapter}>
+    <div className="volter-header-audio" data-muted={muted || undefined} data-available={!!adapter}>
       <Button
         ref={buttonRef}
         type="button"
         variant="ghost"
         size="compact"
-        className="vgai-header-telemetry-button"
+        className="volter-header-telemetry-button"
         data-testid="header-audio-telemetry"
         aria-label={`${stateLabel}; open audio controls`}
         aria-haspopup="menu"
@@ -187,7 +187,7 @@ function AudioTelemetry() {
         onClick={() => setMenuOpen((open) => !open)}
       >
         <EditorIcon icon={muted ? faVolumeXmark : faVolumeHigh} size="sm" />
-        <span className="vgai-audio-vu" aria-hidden="true">
+        <span className="volter-audio-vu" aria-hidden="true">
           {Array.from({ length: AUDIO_METER_SEGMENTS }, (_, index) => (
             <i key={index} data-filled={index < filled || undefined} />
           ))}
@@ -268,7 +268,7 @@ function PerformanceTelemetry() {
       type="button"
       variant="ghost"
       size="compact"
-      className="vgai-header-telemetry-button vgai-header-performance"
+      className="volter-header-telemetry-button volter-header-performance"
       data-testid="header-performance-telemetry"
       data-performance-tone={tone}
       disabled={!source}
@@ -277,24 +277,24 @@ function PerformanceTelemetry() {
       onClick={() => profilerView.open('profiler')}
     >
       <svg
-        className="vgai-performance-graph"
+        className="volter-performance-graph"
         aria-hidden="true"
         viewBox="0 0 72 18"
         width="72"
         height="18"
       >
         <line
-          className="vgai-performance-budget"
+          className="volter-performance-budget"
           x1="0"
           x2="72"
           y1={18 - (FRAME_BUDGET_60_FPS_MS / 50) * 18}
           y2={18 - (FRAME_BUDGET_60_FPS_MS / 50) * 18}
         />
-        {points && <polyline className="vgai-performance-sparkline" points={points} />}
+        {points && <polyline className="volter-performance-sparkline" points={points} />}
       </svg>
-      <span className="vgai-performance-readout">
-        <strong className="vgai-header-fps">{fps ?? '—'} FPS</strong>
-        <span className="vgai-header-frame-ms">{frameMs?.toFixed(1) ?? '—'} ms</span>
+      <span className="volter-performance-readout">
+        <strong className="volter-header-fps">{fps ?? '—'} FPS</strong>
+        <span className="volter-header-frame-ms">{frameMs?.toFixed(1) ?? '—'} ms</span>
       </span>
     </Button>
   );
@@ -322,7 +322,7 @@ export function HeaderTelemetry() {
   if (activeChromeRegions().telemetry === 'hidden') return null;
   return (
     <Inline
-      className="vgai-header-telemetry vgai-chrome-island vgai-glass-island"
+      className="volter-header-telemetry volter-chrome-island volter-glass-island"
       data-island-scale="compact"
       align="center"
       gap={1}

package/src/host/components/PixiIsolationSceneContent.tsx

@@ -184,8 +184,8 @@ export function PixiIsolationSceneContent({
       ref={containerRef}
       data-testid="scene-document-pixi-isolation"
       data-document-id={documentId}
-      data-vgai-backdrop-color={active ? CANVAS_SCENE_BACKGROUND : undefined}
-      data-vgai-backdrop-policy={active ? 'dark-frost' : undefined}
+      data-volter-backdrop-color={active ? CANVAS_SCENE_BACKGROUND : undefined}
+      data-volter-backdrop-policy={active ? 'dark-frost' : undefined}
       onPointerDown={() => setActiveScope('viewport')}
       style={{
         position: 'absolute',

package/src/host/components/ResolutionPicker.tsx

@@ -42,14 +42,14 @@ export function ResolutionPicker({
   const label = isFill ? 'Fill' : `${resolution.width}×${resolution.height}`;
 
   return (
-    <div className="vgai-playbar-popover-anchor">
+    <div className="volter-playbar-popover-anchor">
       <Button
         ref={ref}
         variant="ghost"
         size="comfortable"
         aria-haspopup="menu"
         aria-expanded={open}
-        aria-controls={open ? 'vgai-resolution-picker-menu' : undefined}
+        aria-controls={open ? 'volter-resolution-picker-menu' : undefined}
         onClick={() => setOpen((value) => !value)}
         title={title}
       >
@@ -63,9 +63,9 @@ export function ResolutionPicker({
       </Button>
       {open && (
         <AnchoredMenu
-          id="vgai-resolution-picker-menu"
+          id="volter-resolution-picker-menu"
           anchorRef={ref}
-          className="vgai-resolution-menu"
+          className="volter-resolution-menu"
           gap={4}
           onDismiss={() => setOpen(false)}
         >

package/src/host/components/scene-document.tsx

@@ -3,7 +3,7 @@
  * `Scene` (the subject, not its entry file — see SCENE_DOCUMENT_TITLE),
  * closeable and discoverable in Content, content = the world root's stage.
  *
- * Transcribed from the Scene half of vgai's `components/CenterDocuments.tsx`.
+ * Transcribed from the Scene half of volter's `components/CenterDocuments.tsx`.
  * The kit keeps the other half (`@volter/editor-core/components/CenterDocuments`
  * `useCenterDocuments`): it binds the Game document's tab, reports the
  * live/stopped edge and closes every document on session teardown. What moved
@@ -195,7 +195,7 @@ export class ViewportErrorBoundary extends Component<
     editorConsole.error(`Viewport failed to start: ${error.message}`, 'editor');
     // Keep the component stack in the browser console for developer diagnosis.
     // biome-ignore lint/suspicious/noConsole: renderer startup failures need their React component stack in developer tools as well as the user-facing editor Console entry
-    console.error('[vgai] Viewport failed to start', error, info.componentStack);
+    console.error('[volter] Viewport failed to start', error, info.componentStack);
 
     if (isTransientRendererStartupFailure(error) && this.autoRetryCount < MAX_AUTO_RETRIES) {
       this.clearPendingRetry();
@@ -251,7 +251,7 @@ export class ViewportErrorBoundary extends Component<
         </div>
         <Button
           type="button"
-          className="vgai-btn"
+          className="volter-btn"
           data-testid="retry-viewport"
           onClick={this.handleManualRetry}
         >

package/src/host/components/world-root-stage-binding.tsx

@@ -3,7 +3,7 @@
  * (`@volter/editor-threejs/kit/components/world-root-binding`): the world's surface,
  * its stage, and the overlays the stage shows only over a world.
  *
- * `Overlays` is the world-root half of vgai's `stage-overlay-set.tsx` — every
+ * `Overlays` is the world-root half of volter's `stage-overlay-set.tsx` — every
  * part it rendered only when `worldRoot` held (the root selection layer, the
  * camera-authoring pin, the scene's
  * surface-state card). The rest of that overlay set is the kit's

package/src/host/components/world-root-stage.ts

@@ -454,7 +454,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // DEV/e2e hook: lets the per-game feature matrix assert the viewport camera
   // reframes (view presets / focus / orbit) on an ingested scene.
   if (import.meta.env.DEV) {
-    (window as unknown as Record<string, unknown>)['__vgaiViewport'] = viewport;
+    (window as unknown as Record<string, unknown>)['__volterViewport'] = viewport;
   }
 
   // --- Composer rebuild ---

package/src/host/coverage/authoring-read-probe.ts

@@ -510,7 +510,7 @@ function probeDocumentProviders(adapter: AuthoringAdapter, id: string, record: R
     record(
       'editor.assetDrop.accepts',
       'operation',
-      () => adapter.assetDrop?.accepts(id, '__vgai_read_probe__'),
+      () => adapter.assetDrop?.accepts(id, '__volter_read_probe__'),
       (value) => typeof value === 'boolean',
     );
   }