@volter/editor-game 0.5.65 → 0.5.66

package/src/three/authoring/r3f-source-authoring-adapter.ts

@@ -6,7 +6,7 @@
  * (projected directly, SourceObject3DAuthoringAdapter-style — no
  * mirror); the project's `.tsx` source is truth for persistence. Nodes whose
  * Object3D carries `userData.oid` (stamped by W1's `userData-oid` dialect in
- * `vite-plugin-ui-oid.ts`) are SOURCE-ADDRESSABLE: their JSX props (including
+ * `@volter/editor-react`'s `serving/ui-oid-plugin.ts`) are SOURCE-ADDRESSABLE: their JSX props (including
  * W2's number-tuple transforms) read from the real source text
  * (`analyzeJsxAttributes` over the oid index location) and write back through
  * the same `/__ui-source/*` seam the DOM adapter (`dom-authoring-adapter.ts`) uses — wrapped
@@ -35,7 +35,7 @@ import {
   ownOidOf,
   rendersSameSourceElement,
 } from '@volter/editor-core/authoring/component-instance-root';
-import { beginLiveGesture, endLiveGesture } from '@volter/editor-core/authoring/live-gesture-lock';
+import { beginLiveGesture, endLiveGesture } from '@volter/editor-sdk/kit/live-gesture-lock';
 import { createStructWritePipe, type StructOpOptions } from '../../host/authoring/struct-write-pipe';
 import {
   CollapsedHierarchyView,
@@ -50,10 +50,10 @@ import {
   runWritePipe,
   type WriteAck,
   type WriteResolution,
-} from '@volter/editor-core/authoring/write-pipe';
+} from '@volter/editor-sdk/kit/write-pipe';
 import { componentStatesProvider } from '@volter/editor-core/component-states-registry';
 import { openProjectToolDocument } from '@volter/editor-core/components/project-tool-documents';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import {
   replaceProjectSource,
@@ -81,7 +81,7 @@ import {
   ThreeProjector,
 } from '@volter/editor-core/projection/three';
 import { getStorageBackend } from '@volter/editor-core/storage/index';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import {
   type ComponentPropSpec,
   lineColToOffset,
@@ -90,13 +90,13 @@ import {
   type R3fEnvironmentBinding,
   type R3fEnvironmentNumberBinding,
   type R3fEnvironmentStringBinding,
-} from '@volter/editor-core/ui-source/oid-transform';
-import { mergeRowDiagnostics } from '@volter/editor-core/ui-source/r3f-diagnostic-index';
-import type { R3fJointLiteral, R3fJointLiteralRange } from '@volter/editor-core/ui-source/r3f-joint-binding';
-import type { R3fLodNumberBinding } from '@volter/editor-core/ui-source/r3f-lod-binding';
-import { bodyPlacedChannel, physicsRefusal } from '@volter/editor-core/ui-source/r3f-physics-binding';
-import { relativeImportSpecifier } from '@volter/editor-core/ui-source/relative-import-specifier';
-import type { ReparentChannel, ReparentRebase } from '@volter/editor-core/ui-source/reparent-guard';
+} from '@volter/editor-react/source/oid-transform';
+import { mergeRowDiagnostics } from '@volter/editor-react/source/r3f-diagnostic-index';
+import type { R3fJointLiteral, R3fJointLiteralRange } from '@volter/editor-react/source/r3f-joint-binding';
+import type { R3fLodNumberBinding } from '@volter/editor-react/source/r3f-lod-binding';
+import { bodyPlacedChannel, physicsRefusal } from '@volter/editor-react/source/r3f-physics-binding';
+import { relativeImportSpecifier } from '@volter/editor-react/source/relative-import-specifier';
+import type { ReparentChannel, ReparentRebase } from '@volter/editor-react/source/reparent-guard';
 import type {
   SourceWriteBackend,
   StructReparentContext,
@@ -109,9 +109,9 @@ import {
   isNumberTupleLiteral,
   type JsxAttrInfo,
   offsetSnippetPositions,
-} from '@volter/editor-core/ui-source/writer';
-import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
-import { activateWorkspaceDocument } from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-react/source/writer';
+import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
+import { activateWorkspaceDocument } from '@volter/editor-sdk/kit/workspace-document-registry';
 import type {
   AssetDropContext,
   AssetDropProvider,
@@ -1026,7 +1026,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
    * WRITTEN, as opposed to {@link sourceLocation}'s callsite (where it is USED).
    *
    * Both live in the same OID index; they are different entries reached through
-   * different keys on the SAME object. `vite-plugin-ui-oid`'s transform stamps a
+   * different keys on the SAME object. `@volter/editor-react`'s `serving/ui-oid-plugin.ts`'s transform stamps a
    * host element inside a component definition with BOTH
    * `userData-oid="<this element, in the definition file>"` AND
    * `userData-authoringInstance={__vgaiOid}` (the callsite oid, passed in as a
@@ -1771,7 +1771,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
           id: `definition:project-tool:${reference.name}`,
           title: reference.title,
           open: () => {
-            openProjectToolDocument(this.store, reference.name);
+            openProjectToolDocument(reference.name);
           },
         },
       ];

package/src/three/authoring/reflection-probe-inspector-section.tsx

@@ -1,5 +1,5 @@
-import { useEditorStore } from '@volter/editor-core/editor-runtime';
-import type { InspectorSectionProps } from '@volter/editor-core/inspector-section-registry';
+import { useThreeEditorStore } from '@volter/editor-core/editor-runtime';
+import type { InspectorSectionProps } from '@volter/editor-sdk/kit/inspector-section-registry';
 import type { AuthoringAdapter, EditorNode } from '@volter/editor-project/adapter';
 import { type ReflectionProbeSnapshot, reflectionProbeOf } from '@volter/threejs-runtime/adapter/reflection-probe';
 import { Button, EditorBanner, FieldGroup, FieldRow, Text } from '@volter/editor-sdk/widgets';
@@ -20,7 +20,7 @@ const STATUS_LABEL: Record<ReflectionProbeSnapshot['status'], string> = {
 const EMPTY_SNAPSHOT: ReflectionProbeSnapshot = { status: 'idle', lastCapturedAt: null };
 
 export function ReflectionProbeCaptureSection({ adapter, nodeId }: InspectorSectionProps) {
-  const store = useEditorStore();
+  const store = useThreeEditorStore();
   const object = nodeId
     ? (store.objectMap.get(nodeId) ?? adapter.hierarchy.object3D?.(nodeId))
     : null;

package/src/three/authoring/spatial-joint-handles.ts

@@ -1,6 +1,6 @@
 /** Native Rapier impulse-joint anchors projected onto generic viewport guides. */
 
-import type { R3fJointBinding, R3fJointLiteral } from '@volter/editor-core/ui-source/r3f-joint-binding';
+import type { R3fJointBinding, R3fJointLiteral } from '@volter/editor-react/source/r3f-joint-binding';
 import type { PhysicsJointSnapshot, SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/spatial-lod-handles.ts

@@ -1,6 +1,6 @@
 /** Native THREE.LOD distance thresholds projected onto generic viewport guides. */
 
-import type { R3fLodBinding } from '@volter/editor-core/ui-source/r3f-lod-binding';
+import type { R3fLodBinding } from '@volter/editor-react/source/r3f-lod-binding';
 import type { SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/spatial-particle-handles.ts

@@ -3,7 +3,7 @@
 import type {
   QuarksEmitterShape,
   R3fParticleBinding,
-} from '@volter/editor-core/ui-source/r3f-particle-binding';
+} from '@volter/editor-react/source/r3f-particle-binding';
 import type { SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/three-authoring-adapter.ts

@@ -76,7 +76,7 @@ import {
   runWritePipe,
   type WriteAck,
   type WriteResolution,
-} from '@volter/editor-core/authoring/write-pipe';
+} from '@volter/editor-sdk/kit/write-pipe';
 import { componentStatesProvider } from '@volter/editor-core/component-states-registry';
 import {
   type ChannelValue,
@@ -87,8 +87,8 @@ import {
   creationSiteAnchor,
   instancesAtSite,
   NO_OBJECT_REASON,
-} from '@volter/editor-core/creation-site-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
+} from '@volter/editor-sdk/kit/creation-site-registry';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import { type JournalSubject, JsonHistoryResource } from '../../host/history/json-history-resource';
 import {
@@ -1337,7 +1337,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     // world constructs every object inside `node_modules`, so the creation-site
     // registry below answers "constructed outside project source" for all of
     // them — while the game's own JSX says exactly where each one is written,
-    // and `vite-plugin-ui-oid.ts` stamped that callsite onto the object. The
+    // and `@volter/editor-react`'s `serving/ui-oid-plugin.ts` stamped that callsite onto the object. The
     // stamped answer is the SAME KIND of fact as a `new` site (a source
     // file:line an edit can be written at), so it belongs in the same slot
     // rather than beside it.

package/src/three/component-verbs/extract-menu.ts

@@ -20,7 +20,7 @@ import {
   EXTRACT_COMPONENT_LABEL,
   type InstanceExtractSource,
 } from '../../host/instance-extract-actions';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 
 /** The extract surface for `nodeId`, or `null` — the host's own owner walk. */

package/src/three/component-verbs/fork-menu.ts

@@ -26,7 +26,7 @@ import {
   FORK_COMPONENT_LABEL,
   type InstanceForkSource,
 } from '../../host/instance-fork-actions';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 
 /** The fork surface for `nodeId`, or `null` — the host's own owner walk. */

package/src/three/component-verbs/internals-menu.ts

@@ -25,7 +25,7 @@ import {
   isInternalsRevealed,
   revealedInternalsIds,
   toggleInternalsRevealed,
-} from '@volter/editor-core/hierarchy-internals';
+} from '@volter/editor-sdk/kit/hierarchy-internals';
 import { registerHierarchyMenuItems } from '@volter/editor-core/hierarchy-menu-registry';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 

package/src/three/drei-asset-caches.ts

@@ -0,0 +1,13 @@
+/**
+ * drei's parsed-asset caches (`useGLTF`, `useTexture`) outlive a mount. A lane
+ * that reloads after project asset bytes change clears the changed paths
+ * first, or the next mount is handed the old bytes.
+ */
+export async function evictDreiCaches(paths: readonly string[]): Promise<void> {
+  if (paths.length === 0) return;
+  const { useGLTF, useTexture } = await import('@react-three/drei');
+  for (const path of paths) {
+    useGLTF.clear(path);
+    useTexture.clear(path);
+  }
+}

package/src/three/story-documents/three-story-documents.tsx

@@ -30,14 +30,13 @@ import type { SourceDocumentAuthoringFactory } from '@volter/editor-core/compone
 import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
 import { STANDARD_COMPONENT_CAMERA_DIRECTION } from '@volter/editor-core/components/standard-viewport-dressing';
 import { registerDocumentOpener } from '@volter/editor-core/document-open-registry';
-import type { ViewportTab } from '@volter/editor-core/editor-shell-store';
-import { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
+import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
 import {
   CONTRIBUTED_SECTION_ORDER,
   STORY_ARGS_SECTION_ID,
   STORY_ARGS_SECTION_TITLE,
-} from '@volter/editor-core/inspection/model';
-import { registerInspectorSections } from '@volter/editor-core/inspector-section-registry';
+} from '@volter/editor-sdk/kit/inspection-model';
+import { registerInspectorSections } from '@volter/editor-sdk/kit/inspector-section-registry';
 import type { ComposedProjectStory } from '@volter/editor-core/stories/compose-project-stories';
 import {
   type MountedStoryViewportSource,
@@ -49,7 +48,7 @@ import { declaredStoryMedium } from '@volter/editor-core/stories/story-declared-
 import {
   type StoryDocumentOpenRequest,
   THREE_STORY_DOCUMENT_OPENER,
-} from '@volter/editor-core/stories/story-document-openers';
+} from '@volter/editor-sdk/kit/story-document-openers';
 import {
   getProjectStoryModules,
   subscribeProjectStoryModules,
@@ -60,14 +59,14 @@ import {
   type StoryPreviewComponent,
 } from '@volter/editor-core/stories/story-three-preview';
 import { mountedStoryHasThreeContent } from '@volter/editor-core/stories/three-story-model';
-import { explainSurface } from '@volter/editor-core/surface-state';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import { sourceWriteBackendIfPrimed } from '@volter/editor-core/ui-source/tier-source-write-backend';
 import {
   activeWorkspaceDocument,
   closeWorkspaceDocument,
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { registerWorkspaceDocumentRestorer } from '@volter/editor-core/workspace-document-restore';
 import { STORY_ARGS_SECTION_ICON } from '../../react/story-documents/story-args-section';
 import {
@@ -84,10 +83,6 @@ const THREE_STORY_ARG_PATH_PREFIX = 'threeStory.arg.';
 
 /** The narrow store surface a three-story document needs — the T6.3 input-gate
  *  hand-off, identical to `story-documents.tsx`'s `StoryDocumentStore`. */
-export interface ThreeStoryDocumentStore {
-  setActiveViewportTab(tab: ViewportTab): void;
-}
-
 interface ThreeStoryDocumentState {
   readonly modulePath: string;
   readonly storyName: string;
@@ -149,7 +144,6 @@ export function setThreeStoryArgOverride(id: string, key: string, value: unknown
  * exhibit click-through target.
  */
 export function openThreeStoryDocument(
-  store: ThreeStoryDocumentStore,
   modulePath: string,
   storyName: string,
   title = storyName,
@@ -187,7 +181,6 @@ export function openThreeStoryDocument(
       // a board-scoped rule (`board-scene.ts`) that one story cannot
       // re-derive.
       persist: ({ title: liveTitle }) => ({ modulePath, storyName, title: liveTitle }),
-      onActivate: () => store.setActiveViewportTab('edit'),
       onDispose: (documentId) => {
         if (_states.delete(documentId)) notifyChanged();
       },
@@ -217,7 +210,6 @@ export function threeStoryDocumentState(
  * story registry (`refreshProjectStories`) first — this reads it synchronously.
  */
 export function restoreThreeStoryDocument(
-  store: ThreeStoryDocumentStore,
   modulePath: string,
   storyName: string,
   title?: string,
@@ -233,7 +225,7 @@ export function restoreThreeStoryDocument(
   // which no single story can re-derive — so the tab is restored with the text
   // it had, falling back to the registry's own label for a record that
   // predates this or came from another opener.
-  openThreeStoryDocument(store, modulePath, storyName, title ?? story.label);
+  openThreeStoryDocument(modulePath, storyName, title ?? story.label);
   return true;
 }
 
@@ -242,10 +234,8 @@ export function restoreThreeStoryDocument(
 registerDocumentOpener<StoryDocumentOpenRequest>({
   id: THREE_STORY_DOCUMENT_OPENER,
   owner: 'three-story-documents',
-  open: (store, request) =>
-    openThreeStoryDocument(
-      store,
-      request.modulePath,
+  open: (_store, request) =>
+    openThreeStoryDocument(request.modulePath,
       request.storyName,
       request.title ?? request.storyName,
       request.activate === undefined ? {} : { activate: request.activate },
@@ -259,7 +249,7 @@ registerWorkspaceDocumentRestorer({
   kind: 'world',
   owner: 'three-story-documents',
   prepare: prepareStoryDocumentRestore,
-  restore: ({ state, store }) => {
+  restore: ({ state }) => {
     const record = state as
       | { modulePath?: unknown; storyName?: unknown; title?: unknown }
       | null
@@ -268,7 +258,7 @@ registerWorkspaceDocumentRestorer({
     const storyName = typeof record?.storyName === 'string' ? record.storyName : null;
     if (!modulePath || !storyName) return false;
     const title = typeof record?.title === 'string' ? record.title : undefined;
-    return restoreThreeStoryDocument(store, modulePath, storyName, title);
+    return restoreThreeStoryDocument(modulePath, storyName, title);
   },
 });
 

package/src/three/three-board/ThreeBoardDocument.tsx

@@ -55,39 +55,39 @@ import { registerAvailableWorkspaceDocument } from '@volter/editor-core/workspac
 import { object3DDocumentSession } from '@volter/editor-core/authoring/object3d-document-session-registry';
 import { Object3DDocumentViewport } from '@volter/editor-core/components/Object3DDocumentViewport';
 import { STANDARD_COMPONENT_CAMERA_DIRECTION } from '@volter/editor-core/components/standard-viewport-dressing';
-import { threeBoardBuildingCopy } from '@volter/editor-core/components/viewport-surface-status';
+import { threeBoardBuildingCopy } from '@volter/editor-sdk/kit/viewport-surface-status';
 import { openRegisteredDocument } from '@volter/editor-core/document-open-registry';
 import { listProjectComponents } from '@volter/editor-core/editor-api';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
-import { CONTRIBUTED_SECTION_ORDER } from '@volter/editor-core/inspection/model';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
+import { CONTRIBUTED_SECTION_ORDER } from '@volter/editor-sdk/kit/inspection-model';
 import {
   type InspectorSectionProps,
   registerInspectorSections,
-} from '@volter/editor-core/inspector-section-registry';
-import { type ClipboardWriter, runInstanceSourceAction } from '@volter/editor-core/instance-source-actions';
+} from '@volter/editor-sdk/kit/inspector-section-registry';
+import { type ClipboardWriter, runInstanceSourceAction } from '@volter/editor-sdk/kit/instance-source-actions';
 import { getProjectStoryRegions } from '@volter/editor-core/stories/project-story-regions';
 import { declaredStoryMedium } from '@volter/editor-core/stories/story-declared-medium';
-import { THREE_STORY_DOCUMENT_OPENER } from '@volter/editor-core/stories/story-document-openers';
+import { THREE_STORY_DOCUMENT_OPENER } from '@volter/editor-sdk/kit/story-document-openers';
 import {
   getProjectStoryModules,
   type ProjectStoryModule,
   subscribeProjectStoryModules,
   whenProjectStoriesReady,
 } from '@volter/editor-core/stories/story-registry';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import {
   beginViewportBreakdown,
   cancelViewportBreakdown,
   markViewportBoardReady,
   markViewportReactActive,
   markViewportSegment,
-} from '@volter/editor-core/viewport-activation-timings';
-import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+} from '@volter/editor-sdk/kit/viewport-activation-timings';
+import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import {
   activeWorkspaceDocument,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import type { WorkspaceStateStore } from '@volter/editor-core/workspace-document-restore';
 import { faCircleInfo } from '@fortawesome/free-solid-svg-icons';
 import { themeVars } from '@volter/editor-sdk/widgets';
@@ -814,7 +814,7 @@ const threeBoardPreview = {
   revision: () => JSON.stringify(getProjectStoryModules().map((module_) => module_.modulePath)),
   subscribe: subscribeProjectStoryModules,
   capture: async (
-    request: import('@volter/editor-core/document-preview-source').DocumentPreviewCaptureRequest,
+    request: import('@volter/editor-sdk/kit/document-preview-source').DocumentPreviewCaptureRequest,
   ) => {
     await whenProjectStoriesReady();
     const regions = getProjectStoryRegions();
@@ -881,7 +881,6 @@ export function installThreeBoardDocument(store: ThreeBoardStore): string {
       readOnly: true,
       preview: threeBoardPreview,
       presentation: () => ({ kind: 'workspace', id: THREE_COMPONENTS_DOCUMENT_ID }),
-      onActivate: () => store.setActiveViewportTab('edit'),
     },
     { category: 'canvas' },
   );

package/src/three/three-board/board-scene.ts

@@ -96,7 +96,7 @@ import {
   markViewportSegment,
   noteViewportBreakdownCounts,
   recordViewportStoryMount,
-} from '@volter/editor-core/viewport-activation-timings';
+} from '@volter/editor-sdk/kit/viewport-activation-timings';
 import { collectContentNodeRecords } from '@volter/editor-threejs/viewport/content-bounds';
 import { EDITOR_LAYER } from '@volter/editor-threejs/viewport/editor-layers';
 import { setUserData } from '@volter/threejs-runtime/ecs/user-data';

package/src/three/three-board/three-component-board.ts

@@ -9,15 +9,15 @@
  * when it does not.
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
 import type { ComponentBoard, ComponentBoardContext } from '@volter/editor-core/component-board-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import {
   getStoryMediaPresence,
   subscribeStoryMediaPresence,
 } from '../../host/stories/story-media-presence';
 import { projectStoriesReady, subscribeProjectStoryModules } from '@volter/editor-core/stories/story-registry';
-import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+import { THREE_COMPONENTS_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 
 /** The tab reads `3D`, the peer of `Scene` and `UI` in the center strip. */
 const THREE_COMPONENTS_TITLE = '3D';

package/contributions/react/pasteboard.action.ts

@@ -1,41 +0,0 @@
-/**
- * "MATERIALIZE PASTEBOARD FROM UI BOARD" in the command palette
- * (`@volter/editor-sdk/chrome`, a `workspace.action` contribution) — the ONE
- * action that turns the UI board's derived auto-grid into an authored
- * pasteboard `.tsx`.
- *
- * It was a row in the host's own `action-registry.ts:404-423`, lazily
- * importing `pasteboard-materialize.ts` — a host action about THIS package's
- * design-time surface, which is the only thing that kept both files in the
- * host (WORK.md §The open-source launch item 17). Shape transcribed from
- * `@volter/editor-game/contributions/profiler.action.ts`: a static `actions` array, no
- * subscribe, because this action's availability never changes — it either
- * materializes or it refuses by name.
- *
- * THE OUTCOME LANDS IN THE EDITOR CONSOLE EITHER WAY, unchanged from the row
- * it left: the success sentence names the file (which also opens), a refusal
- * names its remedy.
- */
-
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { ActionContribution } from '@volter/editor-sdk/chrome';
-
-export const point = 'workspace.action';
-
-export const actions: ActionContribution['actions'] = [
-  {
-    id: 'pasteboard.materialize',
-    label: 'Materialize Pasteboard from UI Board',
-    execute: async () => {
-      const { materializePasteboard } = await import('../../src/react/pasteboard-materialize');
-      try {
-        editorConsole.log(`[pasteboard] ${await materializePasteboard()}`, 'authoring');
-      } catch (error) {
-        editorConsole.error(
-          `[pasteboard] materialize refused: ${error instanceof Error ? error.message : String(error)}`,
-          'authoring',
-        );
-      }
-    },
-  },
-];

package/contributions/xstate-behavior.action.ts

@@ -1,42 +0,0 @@
-/**
- * The Behavior debugger's palette actions (`@volter/editor-sdk/chrome`, a
- * `workspace.action` contribution) — a LIVE set: `Inspect Behavior` (the
- * first truthful live actor, the same reveal as Debug ▸ Inspect Behavior)
- * plus one `Inspect Behavior: <machine>` per running XState actor. The host
- * asks `actions` when the palette opens and re-lists on `subscribe`: an
- * actor registering or a hierarchy change (any shell-store notification, so
- * the listing walks the object map only while a palette is open).
- */
-
-import type { ActionContribution } from '@volter/editor-sdk/chrome';
-import { editorHost } from '@volter/editor-sdk/host';
-import { subscribeXStateBehaviorInspections } from '@volter/threejs-runtime/behavior/xstate-inspection';
-import {
-  listLiveBehaviors,
-  openBehaviorDocument,
-  openFirstBehaviorDocument,
-} from '../src/xstate/live-behaviors';
-
-export const point = 'workspace.action';
-
-export const actions: ActionContribution['actions'] = () => [
-  {
-    id: 'inspect-behavior',
-    label: 'Inspect Behavior',
-    execute: () => void openFirstBehaviorDocument(),
-  },
-  ...listLiveBehaviors().map((entry) => ({
-    id: `xstate-machine:${entry.machineId}:${entry.nodeId}`,
-    label: `Inspect Behavior: ${entry.machineId}`,
-    execute: () => void openBehaviorDocument(entry.nodeId),
-  })),
-];
-
-export const subscribe: ActionContribution['subscribe'] = (listener) => {
-  const stopInspections = subscribeXStateBehaviorInspections(listener);
-  const stopHierarchy = editorHost().hierarchy.subscribe(listener);
-  return () => {
-    stopInspections();
-    stopHierarchy();
-  };
-};

package/contributions/xstate-behavior.document.tsx

@@ -1,73 +0,0 @@
-/**
- * THE BEHAVIOR DOCUMENT (`workspace.document`): the REAL live actor of the
- * machine you asked to inspect, drawn as its graph — the same asset-document
- * pattern the animation and model editors use, inspect-only.
- *
- * Its subject is `live-behaviors.ts`'s (`openBehaviorDocument(nodeId)` sets it
- * and opens this tab, from the section's button, the Debug menu and each
- * `Inspect Behavior: <id>` palette action). With no live actor for that node —
- * the game stopped, the actor detached — the document says so rather than
- * drawing a machine nothing is running.
- *
- * No `tool`: it drives no registered callable.
- */
-
-import type { ToolContributionProps, ToolDocumentToolbar } from '@volter/editor-sdk/contributions';
-import {
-  subscribeXStateBehaviorInspections,
-  xstateBehaviorInspectionsVersion,
-} from '@volter/threejs-runtime/behavior/xstate-inspection';
-import { useSyncExternalStore } from 'react';
-import {
-  behaviorSubject,
-  behaviorSubjectVersion,
-  liveBehaviorFor,
-  subscribeBehaviorSubject,
-} from '../src/xstate/live-behaviors';
-import { XStateMachineInspector } from '../src/xstate/XStateMachineInspector';
-
-export const point = 'workspace.document';
-export const title = 'Behavior';
-
-/** Re-render on both live facts this document draws: which node it is on, and
- *  whether that node still carries an inspection. */
-function useSubjectBehavior() {
-  useSyncExternalStore(subscribeBehaviorSubject, behaviorSubjectVersion, behaviorSubjectVersion);
-  useSyncExternalStore(
-    subscribeXStateBehaviorInspections,
-    xstateBehaviorInspectionsVersion,
-    xstateBehaviorInspectionsVersion,
-  );
-  const nodeId = behaviorSubject();
-  return nodeId ? liveBehaviorFor(nodeId) : undefined;
-}
-
-/** The document's header, in the host's own strip: which machine, and that it
- *  is a live actor you may read but not edit. */
-export const Toolbar: ToolDocumentToolbar = () => {
-  const behavior = useSubjectBehavior();
-  return (
-    <span data-testid="xstate-behavior-toolbar" style={{ fontSize: 11 }}>
-      {behavior ? `${behavior.machine.id} · Live actor · inspect-only` : 'Behavior unavailable'}
-    </span>
-  );
-};
-
-export default function XStateBehaviorDocument(_props: ToolContributionProps) {
-  const behavior = useSubjectBehavior();
-  return (
-    <div className="vgai-behavior-document" data-testid="xstate-behavior-document">
-      {behavior ? (
-        <XStateMachineInspector
-          machine={behavior.machine}
-          actor={behavior.actor}
-          title={behavior.machine.id}
-        />
-      ) : (
-        <div className="vgai-behavior-document__empty">
-          This live behavior is no longer registered.
-        </div>
-      )}
-    </div>
-  );
-}

package/contributions/xstate-behavior.inspector.tsx

@@ -1,28 +0,0 @@
-/**
- * The Behavior Inspector section (`selection.inspector`, §4.3): the machine a
- * selected entity is actually running.
- *
- * `match` reads the hierarchy door for the node's own live inspection mark, so
- * it matches ONLY a real live actor — a template entity (no machine) never
- * matches, and the section cannot render for it.
- */
-import type {
-  ToolContributionNode,
-  ToolInspectorContributionProps,
-} from '@volter/editor-sdk/contributions';
-import { liveBehaviorFor } from '../src/xstate/live-behaviors';
-import { XStateMachineSection } from '../src/xstate/XStateBehaviorSection';
-
-export const point = 'selection.inspector';
-export const title = 'Behavior';
-/** Where the host registered it before the move: the contributed band's own
- *  base, ahead of modules that claim no place. */
-export const order = 0;
-
-export function match(node: ToolContributionNode | null): boolean {
-  return node !== null && liveBehaviorFor(node.id) !== undefined;
-}
-
-export default function XStateBehaviorInspector({ nodeId }: ToolInspectorContributionProps) {
-  return <XStateMachineSection nodeId={nodeId} />;
-}

package/contributions/xstate-behavior.menu.ts

@@ -1,23 +0,0 @@
-/**
- * Debug ▸ Inspect Behavior — opens the first truthful live actor as the
- * Behavior document. Disabled while no live actor is registered, which is the
- * same predicate the open path itself refuses on; `disabled` is asked at
- * render, so it follows the session.
- */
-import type { MenuContribution } from '@volter/editor-sdk/chrome';
-import { listLiveBehaviors, openFirstBehaviorDocument } from '../src/xstate/live-behaviors';
-
-export const point = 'workspace.menu';
-
-export const menu: MenuContribution = {
-  menu: 'debug',
-  items: [
-    {
-      id: 'inspect-behavior',
-      label: 'Inspect Behavior',
-      testId: 'menu-inspect-behavior',
-      disabled: () => listLiveBehaviors().length === 0,
-      execute: () => void openFirstBehaviorDocument(),
-    },
-  ],
-};