@volter/editor-game 0.5.65 → 0.5.67

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

@@ -16,10 +16,10 @@ import type {
   Transform,
   WriteAck,
 } from '@volter/editor-project/adapter';
-import type { ChannelValue } from '@volter/editor-core/creation-site-edit';
-import { creationSiteAnchor, instancesAtSite } from '@volter/editor-core/creation-site-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { ChannelValue } from '@volter/editor-sdk/kit/creation-site-edit';
+import { creationSiteAnchor, instancesAtSite } from '@volter/editor-sdk/kit/creation-site-registry';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { type JournalSubject, JsonHistoryResource } from '../history/json-history-resource';
 import { createEphemeralPersistence } from './ephemeral-persistence';
 import { persistChannelWrite } from './gesture-persist';
@@ -240,7 +240,7 @@ export class BabylonAuthoringAdapter implements AuthoringAdapter {
     // used to journal NOTHING, so the edit landed on the live node and
     // Ctrl+Z was a correct no-op over an empty stack — "undo is not working"
     // (runhuman pass 149; traced on production build 75).
-    const history = store.projectHistory;
+    const history = store.shell.projectHistory;
     this.historyResource =
       backend && history && options.journal
         ? new JsonHistoryResource<BabylonHistoryState>({
@@ -389,9 +389,9 @@ export class BabylonAuthoringAdapter implements AuthoringAdapter {
   };
 
   readonly selection = {
-    get: (): string[] => [...this.store.selectedEntityIds],
+    get: (): string[] => [...this.store.shell.selectedEntityIds],
     set: (ids: string[]): void => {
-      this.store.selectMultiple(ids);
+      this.store.shell.selectMultiple(ids);
       this.attachGizmos(ids[0] ?? null);
       this.notify();
     },
@@ -698,6 +698,6 @@ export class BabylonAuthoringAdapter implements AuthoringAdapter {
 
   private notify(): void {
     for (const listener of this.listeners) listener();
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 }

package/src/host/authoring/contract-hierarchy-authoring.ts

@@ -11,7 +11,7 @@ import type {
   VgaiGameHierarchyGroup,
   VgaiGameHierarchyProvider,
 } from '@volter/editor-project/adapter/ingest/game-contract';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 
 const GROUP_PREFIX = 'contract-hierarchy:group:';
 const RENDER_TREE_ID = 'contract-hierarchy:render-tree';

package/src/host/authoring/contract-scenes-stories.ts

@@ -31,7 +31,7 @@ import type {
 import type { StoriesProvider, StoryRef } from '@volter/editor-project/adapter';
 import type { VgaiGameContract, VgaiGameScene } from '@volter/editor-project/adapter/ingest/game-contract';
 import { readGameScenes } from '@volter/editor-project/adapter/ingest/game-contract';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 
 function assertScenes(value: unknown): VgaiGameScene[] {
   if (!Array.isArray(value)) throw new Error('scenes.list() did not return an array');

package/src/host/authoring/creation-site-related.ts

@@ -22,8 +22,8 @@
  */
 
 import type { NodeCreationSite, RelatedSubjectsProvider } from '@volter/editor-project/adapter';
-import { type InstanceSourceLocator, runInstanceSourceAction } from '@volter/editor-core/instance-source-actions';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { type InstanceSourceLocator, runInstanceSourceAction } from '@volter/editor-sdk/kit/instance-source-actions';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 
 /** The related provider for an adapter whose truth can place a subject at a
  *  creation site. `resolveSite` is the adapter's own id→site hop. */

package/src/host/authoring/ephemeral-persistence.ts

@@ -15,7 +15,7 @@
  */
 
 import type { PersistenceProvider } from '@volter/editor-project/adapter';
-import { EPHEMERAL_DESTINATION } from '@volter/editor-core/authoring/write-pipe';
+import { EPHEMERAL_DESTINATION } from '@volter/editor-sdk/kit/write-pipe';
 
 export function createEphemeralPersistence(): PersistenceProvider {
   return {

package/src/host/authoring/gesture-persist.ts

@@ -29,9 +29,9 @@
  */
 
 import type { WriteAck, WriteAnchorKind } from '@volter/editor-project/adapter';
-import type { ChannelValue } from '@volter/editor-core/creation-site-edit';
+import type { ChannelValue } from '@volter/editor-sdk/kit/creation-site-edit';
 import type { SourcePersistenceBackend, SourceWriteSubject } from './source-persistence-backend';
-import { resolvesLiveOnly, runWritePipe, type WriteResolution } from '@volter/editor-core/authoring/write-pipe';
+import { resolvesLiveOnly, runWritePipe, type WriteResolution } from '@volter/editor-sdk/kit/write-pipe';
 
 /** The one-property-per-gesture refusal, spelled once — it is the persistence
  *  pipeline's own rule, not any substrate's voice. */

package/src/host/authoring/ingest-data-writer.ts

@@ -40,7 +40,7 @@
  */
 
 import type { NodeCreationSite } from '@volter/editor-project/adapter';
-import type { ChannelValue } from '@volter/editor-core/creation-site-edit';
+import type { ChannelValue } from '@volter/editor-sdk/kit/creation-site-edit';
 
 /**
  * The one `userData` key that anchors a live object to a record in its game's

package/src/host/authoring/ingest-source-persistence.ts

@@ -25,19 +25,19 @@
  */
 
 import type { NodeCreationSite } from '@volter/editor-project/adapter';
-import { base64ToBytes, bytesToBase64, sha256Hex } from '@volter/editor-core/bytes-codec';
+import { base64ToBytes, bytesToBase64, sha256Hex } from '@volter/editor-sdk/kit/bytes-codec';
 import type {
   ChannelValue,
   CreationSiteLiteralReport,
   CreationSiteSurface,
   CreationSiteWriteScope,
-} from '@volter/editor-core/creation-site-edit';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { editorIsAuthoring } from '@volter/editor-core/editor-session-mode';
-import type { HistoryService } from '@volter/editor-core/history/history-service';
-import { projectSourceAppliedChange } from '@volter/editor-core/history/source-history-backend';
-import type { ResourceDriver, ResourceKey } from '@volter/editor-core/history/types';
-import type { SourceWriteBackend } from '@volter/editor-core/ui-source/source-write-backend';
+} from '@volter/editor-sdk/kit/creation-site-edit';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { editorIsAuthoring } from '@volter/editor-sdk/kit/editor-session-mode';
+import type { HistoryService } from '@volter/editor-sdk/kit/history/history-service';
+import { projectSourceAppliedChange } from '@volter/editor-sdk/kit/history/source-history-backend';
+import type { ResourceDriver, ResourceKey } from '@volter/editor-sdk/kit/history-types';
+import type { SourceWriteBackend } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
 import {
   type DataEditPlan,
   dataPlacementRefusal,

package/src/host/authoring/mount-isolated-pixi-screen.ts

@@ -17,7 +17,7 @@ import { type CanvasPixiNamespace, resolveCanvasPixiForEditor } from '../canvas-
 import { createWithOwnedPixiTickerListeners } from './owned-pixi-ticker-listeners';
 import { initializePixiIsolationAssets } from './pixi-isolation-assets';
 import { fitSceneView, registerStillFramePresenter } from './pixi-still-presentation';
-import type { RootViewController } from '@volter/editor-core/authoring/world-pan-state';
+import type { RootViewController } from '@volter/editor-sdk/kit/world-pan-state';
 
 export type IsolatedPixiScreenCtor = (new () => IsolatedPixiScreen) & {
   readonly assetBundles?: readonly string[];

package/src/host/authoring/mounted-authoring.ts

@@ -1,7 +1,7 @@
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import type * as THREE from 'three';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { stampEntityId } from '@volter/editor-core/entity-object';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { stampEntityId } from '@volter/editor-threejs/kit/entity-object';
 
 /**
  * Selection is editor-global UI state. A mounted adapter may deliberately own
@@ -14,8 +14,8 @@ export function withStoreSelection(
 ): AuthoringAdapter {
   if (authoring.selection) return authoring;
   const selection = {
-    get: () => [...store.selectedEntityIds],
-    set: (ids: string[]) => store.selectMultiple(ids),
+    get: () => [...store.shell.selectedEntityIds],
+    set: (ids: string[]) => store.shell.selectMultiple(ids),
   };
   return new Proxy(authoring, {
     get(target, property) {

package/src/host/authoring/phaser-live-authoring-adapter.ts

@@ -17,7 +17,7 @@ import type {
   PropertyDescriptor,
   Transform,
 } from '@volter/editor-project/adapter';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { createEphemeralPersistence } from './ephemeral-persistence';
 
 export interface PhaserGameObjectLike {
@@ -172,9 +172,9 @@ export class PhaserLiveAuthoringAdapter implements AuthoringAdapter {
   };
 
   readonly selection = {
-    get: (): string[] => [...this.store.selectedEntityIds],
+    get: (): string[] => [...this.store.shell.selectedEntityIds],
     set: (ids: string[]): void => {
-      this.store.selectMultiple(ids);
+      this.store.shell.selectMultiple(ids);
       this.notify();
     },
   };
@@ -260,6 +260,6 @@ export class PhaserLiveAuthoringAdapter implements AuthoringAdapter {
 
   private notify(): void {
     for (const listener of this.listeners) listener();
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 }

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

@@ -34,7 +34,7 @@ import {
   AuthoringAdapter2D,
   type CanvasIdentity,
   type Transform2DValue,
-} from '@volter/game-runtime/pixi/authoring';
+} from '../../runtime/pixi/authoring';
 import type {
   AssetDropContext,
   AssetDropProvider,
@@ -70,9 +70,9 @@ import type {
 import type { Container, Graphics, Matrix, PointData, Sprite, Text, Texture } from 'pixi.js';
 import * as shellPixi from 'pixi.js';
 import type { CanvasPixiNamespace } from '../canvas-entry-runtime';
-import { componentStatesProvider } from '@volter/editor-core/component-states-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import { componentStatesProvider } from '@volter/editor-sdk/kit/component-states-registry';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import type { JournalSubject } from '../history/json-history-resource';
 import { PixiProjector } from '../projection/pixi';
 import { creationSiteRelated } from './creation-site-related';
@@ -83,7 +83,7 @@ import {
 } from './pixi-source-identity';
 import { CanvasStructureHistory } from './pixi-structure-history';
 import { fromNeutralTransform, toNeutralTransform } from './pixi-transform-channels';
-import { resolvesLiveOnly, runWritePipe } from '@volter/editor-core/authoring/write-pipe';
+import { resolvesLiveOnly, runWritePipe } from '@volter/editor-sdk/kit/write-pipe';
 
 /**
  * What a write target is handed at construction — the live view it edits
@@ -347,7 +347,7 @@ const ORIGIN_UNWRITABLE_REASON =
  * from the one this prebuilt shell bundles — so a real `Sprite` from the world
  * fails `instanceof Sprite` here and every selected sprite would silently read
  * as a pivot node. The engine's own 2D authoring walk already refuses class
- * identity for the same reason (`@volter/game-runtime/pixi/authoring`'s `kindOf` keys on the
+ * identity for the same reason (`@volter/editor-game/runtime/pixi/authoring`'s `kindOf` keys on the
  * constructor NAME); asking for the two fields the anchor question is actually
  * about is the same move without depending on a name a minifier may mangle.
  *
@@ -670,6 +670,9 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
   private listeners = new Set<() => void>();
   private boxEditSessions = new Map<string, CanvasBoxEditSession>();
   private lockedIds = new Set<string>();
+  /** Godot's Group: a click on any node inside a grouped one selects the group. Session-local, as
+   *  the lock is. */
+  private groupedIds = new Set<string>();
 
   constructor(
     private readonly root: Container,
@@ -721,13 +724,16 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     const surface = opts.surface;
     if (surface) {
       this.pickable = {
-        pick: (clientX, clientY) =>
-          this.projector.pick(clientX, clientY, (id) => this.isPickLocked(id)),
+        pick: (clientX, clientY) => {
+          const hit = this.projector.pick(clientX, clientY, (id) => this.isPickLocked(id));
+          return hit ? this.groupOf(hit) : hit;
+        },
         candidates: (clientX, clientY) =>
           this.projector.candidates(clientX, clientY, (id) => this.isPickLocked(id)),
       };
       this.rects = {
         rect: (id) => this.projector.rect(id),
+        frame: (id) => this.projector.frame(id),
         contextRects: (id) => this.projector.contextRects(id),
       };
     }
@@ -767,7 +773,7 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     if (!opts.stories && this.target.componentIdentity) {
       this.stories = componentStatesProvider(
         'canvas',
-        store,
+        store.shell,
         (id) => this.target.componentIdentity?.(id) ?? null,
       );
     }
@@ -848,7 +854,7 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
       this.watchStructure(this.root);
       this.target.onReindex();
       this.notify();
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     });
   };
 
@@ -914,9 +920,9 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
   }
 
   readonly selection: SelectionProvider = {
-    get: () => [...this.store.selectedEntityIds],
+    get: () => [...this.store.shell.selectedEntityIds],
     set: (ids) => {
-      this.store.selectMultiple(ids);
+      this.store.shell.selectMultiple(ids);
       this.notify();
     },
   };
@@ -1012,7 +1018,7 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     this.watchStructure(this.root);
     this.target.onReindex();
     this.notify();
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 
   private idOf(object: Container): string {
@@ -1504,12 +1510,19 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     properties: (id) => [
       ...this.target.properties(id),
       { path: 'locked', label: 'Locked', type: 'boolean', group: 'Visibility' },
+      { path: 'grouped', label: 'Grouped', type: 'boolean', group: 'Visibility' },
     ],
-    get: (id, path) => (path === 'locked' ? this.lockedIds.has(id) : this.target.get(id, path)),
+    get: (id, path) =>
+      path === 'locked'
+        ? this.lockedIds.has(id)
+        : path === 'grouped'
+          ? this.groupedIds.has(id)
+          : this.target.get(id, path),
     set: (id, path, value) => {
-      if (path === 'locked') {
-        if (value === true) this.lockedIds.add(id);
-        else this.lockedIds.delete(id);
+      if (path === 'locked' || path === 'grouped') {
+        const set = path === 'locked' ? this.lockedIds : this.groupedIds;
+        if (value === true) set.add(id);
+        else set.delete(id);
         this.notify();
         return;
       }
@@ -1519,6 +1532,17 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
     remove: (id, path) => this.target.remove?.(id, path),
   };
 
+  /** The outermost grouped node that contains `id`, or `id` itself when none does. */
+  private groupOf(id: string): string {
+    let group = id;
+    let current: string | null = id;
+    while (current) {
+      if (this.groupedIds.has(current)) group = current;
+      current = this.projector.node(current)?.parentId ?? null;
+    }
+    return group;
+  }
+
   private isPickLocked(id: string): boolean {
     let current: string | null = id;
     while (current) {
@@ -1542,6 +1566,7 @@ export class PixiAuthoringAdapter implements AuthoringAdapter {
   dispose(): void {
     this.boxEditSessions.clear();
     this.lockedIds.clear();
+    this.groupedIds.clear();
     for (const object of this.watchedForStructure) {
       object.off('childAdded', this.onStructureChanged);
       object.off('childRemoved', this.onStructureChanged);

package/src/host/authoring/pixi-creation-site-write-target.ts

@@ -27,8 +27,8 @@
  * place a fallback could quietly pretend to persist.
  */
 
-import type { PhysicsAdapter2D } from '@volter/game-runtime/pixi/system-adapters';
-import type { HistoryService } from '@volter/editor-core/history/history-service';
+import type { PhysicsAdapter2D } from '../../runtime/pixi/system-adapters';
+import type { HistoryService } from '@volter/editor-sdk/kit/history/history-service';
 import type { IngestSourcePersistence } from './ingest-source-persistence';
 import type { CanvasWriteTarget } from './pixi-authoring-adapter';
 import { createLiveCanvasWriteTarget } from './pixi-live-write-target';

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

@@ -34,8 +34,8 @@ import type {
   AuthoringAdapter2D,
   Overlay2D,
   Transform2DValue,
-} from '@volter/game-runtime/pixi/authoring';
-import type { PhysicsAdapter2D } from '@volter/game-runtime/pixi/system-adapters';
+} from '../../runtime/pixi/authoring';
+import type { PhysicsAdapter2D } from '../../runtime/pixi/system-adapters';
 import type {
   ComponentInstanceApplyResult,
   ComponentInstanceDescription,
@@ -48,9 +48,9 @@ import type {
   TransformEditability,
 } from '@volter/editor-project/adapter';
 import type { Container } from 'pixi.js';
-import type { ChannelValue, CreationSiteLiteralReport } from '@volter/editor-core/creation-site-edit';
-import { creationSiteAnchor, instancesAtSite } from '@volter/editor-core/creation-site-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import type { ChannelValue, CreationSiteLiteralReport } from '@volter/editor-sdk/kit/creation-site-edit';
+import { creationSiteAnchor, instancesAtSite } from '@volter/editor-sdk/kit/creation-site-registry';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { JsonHistoryResource } from '../history/json-history-resource';
 import { createEphemeralPersistence } from './ephemeral-persistence';
 import { multiChannelRefusal, persistChannelWrite } from './gesture-persist';
@@ -64,7 +64,7 @@ import {
   runWritePipe,
   type WriteAck,
   type WriteResolution,
-} from '@volter/editor-core/authoring/write-pipe';
+} from '@volter/editor-sdk/kit/write-pipe';
 
 interface PixiLiveHistoryState {
   overlay: Overlay2D;
@@ -750,7 +750,7 @@ export function createLiveCanvasWriteTarget(
     bind(context: CanvasWriteContext): void {
       a2d = context.a2d;
       notify = context.notify;
-      const history = context.store.projectHistory;
+      const history = context.store.shell.projectHistory;
       historyResource = history
         ? new JsonHistoryResource({
             history,

package/src/host/authoring/pixi-source-identity.ts

@@ -1,6 +1,6 @@
 /**
  * The OID half of the canvas authoring surface's IDENTITY axis
- * (`@volter/game-runtime/pixi/authoring`'s {@link CanvasIdentity}) — what a row is called
+ * (`@volter/editor-game/runtime/pixi/authoring`'s {@link CanvasIdentity}) — what a row is called
  * when the display tree was authored as first-party `@pixi/react` TSX, and the
  * resolution from such an id back to the source tag it addresses.
  *
@@ -34,9 +34,9 @@
  * selection survives one.
  */
 
-import type { CanvasIdentity } from '@volter/game-runtime/pixi/authoring';
+import type { CanvasIdentity } from '../../runtime/pixi/authoring';
 import type { Container } from 'pixi.js';
-import { occurrenceId } from '@volter/editor-core/authoring/component-instance-root';
+import { occurrenceId } from '@volter/editor-threejs/kit/authoring/component-instance-root';
 
 const PREFIX = 'pixi';