@volter/editor-game 0.5.65 → 0.5.67

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

@@ -1,4 +1,5 @@
-import { registerAvailableWorkspaceDocument } from '@volter/editor-core/workspace-available-documents';
+import { threeObject } from '@volter/editor-threejs/adapter/three-contract';
+import { registerAvailableWorkspaceDocument } from '@volter/editor-sdk/kit/workspace-available-documents';
 /**
  * The 3D COMPONENTS board — a generated, never-persisted 3D scene laying out
  * every qualifying `three` story's mounted `Object3D` at TRUE SCALE, so a
@@ -52,43 +53,43 @@ import { registerAvailableWorkspaceDocument } from '@volter/editor-core/workspac
  * degradation). Same sentences, same clipboard path, never a silent no-op.
  */
 
-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 { 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 { object3DDocumentSession } from '@volter/editor-threejs/kit/authoring/object3d-document-session-registry';
+import { Object3DDocumentViewport } from '@volter/editor-threejs/kit/components/Object3DDocumentViewport';
+import { STANDARD_COMPONENT_CAMERA_DIRECTION } from '@volter/editor-threejs/kit/components/standard-viewport-dressing';
+import { threeBoardBuildingCopy } from '@volter/editor-sdk/kit/viewport-surface-status';
+import { openRegisteredDocument } from '@volter/editor-sdk/kit/document-open-registry';
+import { listProjectComponents } from '@volter/editor-sdk/kit/editor-api';
+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';
-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';
+} 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-sdk/kit/stories/project-story-regions';
+import { declaredStoryMedium } from '@volter/editor-sdk/kit/stories/story-declared-medium';
+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';
+} from '@volter/editor-sdk/kit/stories/story-registry';
+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';
-import type { WorkspaceStateStore } from '@volter/editor-core/workspace-document-restore';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
+import type { WorkspaceStateStore } from '@volter/editor-sdk/kit/workspace-document-restore';
 import { faCircleInfo } from '@fortawesome/free-solid-svg-icons';
 import { themeVars } from '@volter/editor-sdk/widgets';
 import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react';
@@ -737,7 +738,7 @@ export function BoardExhibitSection({ adapter, nodeId }: InspectorSectionProps)
   useSyncExternalStore(subscribeThreeBoard, threeBoardVersion);
   const candidateIds = [...(nodeId ? [nodeId] : []), ...(adapter.selection?.get() ?? [])];
   const exhibit = candidateIds.reduce<BoardExhibit | null>(
-    (found, id) => found ?? findExhibitIn(_scene, adapter.hierarchy.object3D?.(id) ?? null),
+    (found, id) => found ?? findExhibitIn(_scene, threeObject(adapter.hierarchy, id)),
     null,
   );
   return (
@@ -814,7 +815,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();
@@ -829,7 +830,7 @@ const threeBoardPreview = {
       const { captureAuthoredThreeScenePreview } = await import('../../host/document-preview-three');
       const { createStandardEnvironment } = await import('@volter/editor-threejs/viewport/environment');
       const { applyStandardViewportDressing } = await import(
-        '@volter/editor-core/components/standard-viewport-dressing'
+        '@volter/editor-threejs/kit/components/standard-viewport-dressing'
       );
       const { isEditorOwnedObject } = await import('@volter/editor-threejs/viewport/editor-layers');
       board.root.traverse((object) => {
@@ -881,7 +882,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

@@ -73,30 +73,30 @@
  * only way it comes back.
  */
 
-import { getProjectStoryRegions } from '@volter/editor-core/stories/project-story-regions';
+import { getProjectStoryRegions } from '@volter/editor-sdk/kit/stories/project-story-regions';
 import {
   declaredStoryMedium,
   reportUndeclaredStoryMedium,
-} from '@volter/editor-core/stories/story-declared-medium';
+} from '@volter/editor-sdk/kit/stories/story-declared-medium';
 import {
   deriveStoryGroupPath,
   formatStoryGroupPath,
   storyGroupKey,
-} from '@volter/editor-core/stories/story-grouping';
-import { type ProjectStoryModule, pickComponentPreviewStory } from '@volter/editor-core/stories/story-registry';
+} from '@volter/editor-sdk/kit/stories/story-grouping';
+import { type ProjectStoryModule, pickComponentPreviewStory } from '@volter/editor-sdk/kit/stories/story-registry';
 import {
   lastStoryMountPhaseTiming,
   type MountedStoryObject3D,
   type StoryMountInTurn,
   type StoryPreviewComponent,
   withStoryMountTurn,
-} from '@volter/editor-core/stories/story-three-preview';
-import { mountedStoryHasThreeContent } from '@volter/editor-core/stories/three-story-model';
+} from '../../host/stories/story-three-preview';
+import { mountedStoryHasThreeContent } from '@volter/editor-threejs/kit/stories/three-story-model';
 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 type { ComponentBoard, ComponentBoardContext } from '@volter/editor-core/component-board-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
+import type { ComponentBoard, ComponentBoardContext } from '@volter/editor-sdk/kit/component-board-registry';
+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 { projectStoriesReady, subscribeProjectStoryModules } from '@volter/editor-sdk/kit/stories/story-registry';
+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(),
-    },
-  ],
-};

package/src/react/pasteboard-materialize.ts

@@ -1,154 +0,0 @@
-/**
- * "MATERIALIZE PASTEBOARD" (queue item 4): turn the UI board's DERIVED,
- * ephemeral auto-grid into an AUTHORED pasteboard `.tsx` — the one action the
- * ratified design names ("ephemeral auto-grid when no file; one action
- * materializes it"). The generated file is ordinary project source: it
- * imports each board story's OWNER COMPONENT and places it under `<At x y>`
- * at the position the auto-grid gave its frame, so the derived layout becomes
- * literals a drag can then rewrite. Nothing regenerates the file afterwards —
- * it is the project's, exactly like every `vgai add` copy.
- *
- * Refusals are loud and name their remedy: no open project, no storage, no
- * pasteboard helpers (`vgai add pasteboard`), a file already at the target
- * path, or a board with nothing on it. A story whose owner component cannot
- * be resolved to an importable export is SKIPPED BY NAME in the returned
- * sentence rather than emitting an import that does not compile.
- *
- * ## Why it is this package's
- *
- * Its subject is THE UI BOARD — the design-time surface `@volter/editor-game` registers
- * a mount for (`design-time-react-mount.ts`, unit 12) — and it reads that
- * board's own frame placements. It stayed a host file only because its one
- * caller was a host `action-registry.ts` row; the action POINT
- * (`@volter/editor-sdk/chrome`, `workspace.action`) is what that row becomes,
- * and `contributions/pasteboard.action.ts` is the row now. Unit 12's header
- * called this file "NOT the dom lane's" on the strength of that caller; the
- * caller is what moved (WORK.md §The open-source launch item 17, the edge map
- * in `scripts/validate-editor-closure.mjs`).
- */
-
-import { commandLine } from '@volter/editor-core/product-command';
-import { listProjectComponents } from '@volter/editor-core/api/assets';
-import type { ProjectComponentEntry } from '@volter/editor-core/asset-workflow/project-content';
-import { reactStoryBoardFramePlacements } from '@volter/editor-core/authoring/react-story-board';
-import { getProjectPreviewStories } from '@volter/editor-core/stories/story-registry';
-import { domStoryBoardMembers } from '@volter/editor-core/stories/three-story-model';
-import { createProjectSourceFile } from '@volter/editor-core/ui-source/source-write-backend';
-
-export const PASTEBOARD_HELPERS_PATH = 'src/lib/pasteboard/pasteboard.tsx';
-export const MATERIALIZED_PASTEBOARD_PATH = 'src/design/pasteboard.tsx';
-
-/** The story's owner-module convention: `Hud.stories.tsx` → `Hud.tsx`. */
-function storyOwnerModulePath(storyModulePath: string): string {
-  return storyModulePath.replace(/\.stories(?=\.[^.]+$)/, '');
-}
-
-/** Relative import specifier from `src/design/` to a project-relative path. */
-function importSpecifierFromDesign(componentPath: string): string {
-  const withoutExtension = componentPath.replace(/\.[cm]?[jt]sx?$/, '');
-  return `../${withoutExtension.replace(/^src\//, '')}`;
-}
-
-function componentForOwnerModule(
-  components: readonly ProjectComponentEntry[],
-  ownerModulePath: string,
-): ProjectComponentEntry | null {
-  const inModule = components.filter(
-    (entry) => entry.path === ownerModulePath && (entry.exported || entry.defaultExport),
-  );
-  return (
-    inModule.find((entry) => entry.defaultExport) ?? (inModule.length === 1 ? inModule[0]! : null)
-  );
-}
-
-export async function materializePasteboard(): Promise<string> {
-  const helpers = await fetch('/__ui-source/read', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ file: PASTEBOARD_HELPERS_PATH }),
-  });
-  if (!helpers.ok) {
-    throw new Error(
-      `Materialize pasteboard needs the pasteboard helpers at ${PASTEBOARD_HELPERS_PATH} — ` +
-        `run ${commandLine('add pasteboard')} first.`,
-    );
-  }
-  const layer = document.querySelector<HTMLElement>('[data-vgai-react-story-board="true"]');
-  const placements = reactStoryBoardFramePlacements(layer);
-  if (!placements || placements.length === 0) {
-    throw new Error(
-      'Materialize pasteboard reads the live UI board and it has no frames — open the UI ' +
-        'document (a project with dom stories) first.',
-    );
-  }
-  const stories = domStoryBoardMembers(getProjectPreviewStories());
-  const listing = await listProjectComponents();
-  const components = listing.ok ? listing.entries : [];
-  const placed: Array<{ importLine: string; name: string; x: number; y: number }> = [];
-  const skipped: string[] = [];
-  const importsBySpecifier = new Map<string, string>();
-  for (const placement of placements) {
-    const story = stories.find((candidate) => candidate.id === placement.storyId);
-    if (!story) continue;
-    const owner = storyOwnerModulePath(story.modulePath);
-    const component = componentForOwnerModule(components, owner);
-    if (!component) {
-      skipped.push(story.label ?? story.id);
-      continue;
-    }
-    const specifier = importSpecifierFromDesign(component.path);
-    const importLine = component.defaultExport
-      ? `import ${component.name} from '${specifier}';`
-      : `import { ${component.name} } from '${specifier}';`;
-    importsBySpecifier.set(specifier, importLine);
-    placed.push({ importLine, name: component.name, x: placement.x, y: placement.y });
-  }
-  if (placed.length === 0) {
-    throw new Error(
-      'Materialize pasteboard resolved no importable owner component for any board frame ' +
-        `(skipped: ${skipped.join(', ') || 'none'}). A story's owner module must export the ` +
-        'component its frames render.',
-    );
-  }
-  const width = Math.max(...placed.map((entry) => entry.x)) + 960;
-  const height = Math.max(...placed.map((entry) => entry.y)) + 720;
-  const body = placed
-    .map(
-      (entry) => `      <At x={${entry.x}} y={${entry.y}}>\n        <${entry.name} />\n      </At>`,
-    )
-    .join('\n');
-  const code = `${[...importsBySpecifier.values()].sort().join('\n')}
-import { At, Pasteboard } from '../lib/pasteboard/pasteboard';
-
-/**
- * Materialized from the UI board's derived auto-grid — this file is now the
- * AUTHORED canvas: edit freely, and a drag in the editor writes each At's
- * x/y literals right here.
- */
-export default function DesignPasteboard() {
-  return (
-    <Pasteboard width={${width}} height={${height}}>
-${body}
-    </Pasteboard>
-  );
-}
-`;
-  const created = await createProjectSourceFile(MATERIALIZED_PASTEBOARD_PATH, code);
-  if (!created.created) {
-    throw new Error(
-      created.error ??
-        `${MATERIALIZED_PASTEBOARD_PATH} already exists — the pasteboard is already authored; ` +
-          'edit it directly (there is deliberately no regeneration).',
-    );
-  }
-  // The AssetBrowser owns asset-open routing; the event is its documented door.
-  window.dispatchEvent(
-    new CustomEvent('editor:open-project-asset', {
-      detail: { path: MATERIALIZED_PASTEBOARD_PATH, kind: 'source' },
-    }),
-  );
-  return (
-    `Materialized ${placed.length} frame(s) into ${MATERIALIZED_PASTEBOARD_PATH}` +
-    (skipped.length > 0 ? ` (skipped, no importable owner component: ${skipped.join(', ')})` : '')
-  );
-}

package/src/services/game-audio-unlock.ts

@@ -1,48 +0,0 @@
-/**
- * HOST-LEVEL audio unlock for game-created AudioContexts.
- *
- * A game running in the editor's page can create its AudioContext before the
- * visitor's first gesture (survivor's auto-attack lands kills while they are
- * still reading), and browsers with a strict autoplay policy then hold it
- * suspended until `resume()` runs INSIDE a trusted input handler. The game's
- * own unlock listeners go through the realm's gated re-dispatch, which is no
- * longer that trusted stack — two human passes heard both flagship canvas
- * games silent on first load and cured them only by restarting under a
- * gesture (runhuman 23/33).
- *
- * The EDITOR owns the page, so it does what a game cannot: wrap the page's
- * AudioContext constructor once at boot to track instances, and resume any
- * suspended one from capture-phase pointerdown/keydown handlers — the real,
- * trusted stack. Contexts already running are untouched; the listeners stay
- * (cheap) so a context created later unlocks on the next gesture.
- */
-
-const tracked = new Set<WeakRef<AudioContext>>();
-
-function resumeSuspended(): void {
-  for (const ref of tracked) {
-    const ctx = ref.deref();
-    if (!ctx || ctx.state === 'closed') {
-      tracked.delete(ref);
-      continue;
-    }
-    if (ctx.state === 'suspended') void ctx.resume();
-  }
-}
-
-/** Install once at editor boot (main.tsx). Idempotent. */
-export function installGameAudioUnlock(): void {
-  const host = window as unknown as { __vgaiAudioUnlock?: boolean } & typeof window;
-  if (host.__vgaiAudioUnlock) return;
-  host.__vgaiAudioUnlock = true;
-  const Orig = window.AudioContext;
-  if (typeof Orig !== 'function') return;
-  window.AudioContext = class extends Orig {
-    constructor(...args: ConstructorParameters<typeof AudioContext>) {
-      super(...args);
-      tracked.add(new WeakRef(this));
-    }
-  };
-  window.addEventListener('pointerdown', resumeSuspended, { capture: true });
-  window.addEventListener('keydown', resumeSuspended, { capture: true });
-}