@volter/editor-game 0.5.66 → 0.5.67

package/src/play-bar/PlayBar.tsx

@@ -1,10 +1,13 @@
+import { type ConfigurationStatus, listConfigurations } from '../host/api/configurations';
 import {
-  type ConfigurationStatus,
-  listConfigurations,
-  startConfiguration,
-  stopConfiguration,
-} from '../host/api/configurations';
-import { isGameplayExportActive, subscribeGameplayExport } from '@volter/editor-core/gameplay-export-state';
+  chooseRunConfiguration,
+  chosenRunConfiguration,
+  PLAY_CONFIGURATION,
+  selectedRunConfiguration,
+  startSelectedRunConfiguration,
+  stopStartedRunConfiguration,
+} from '../play/run-selection';
+import { isGameplayExportActive, subscribeGameplayExport } from '@volter/editor-sdk/kit/gameplay-export-state';
 import { PLAY_CONTROL_TEST_ID } from '../host/play-control-hook';
 import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
 import { faChevronDown } from '@fortawesome/free-solid-svg-icons';
@@ -31,7 +34,6 @@ import {
   getRestartRequiredReason,
   pausePlayMode,
   resumePlayMode,
-  setDesiredExtraInstances,
   stepPlayMode,
   subscribeRestartRequired,
 } from '../play/play-mode';
@@ -288,36 +290,17 @@ export function PlayBar({ placement = 'launcher' }: { placement?: 'launcher' | '
   const selected = run.configurations.find((c) => c.id === run.selectedId) ?? null;
   const instances = selected?.kind === 'compound' ? (selected.instances ?? null) : null;
   const play = async () => {
-    if (selected && selected.kind !== PLAY_ID) {
-      const outcome = await startConfiguration(selected.id).catch((error: unknown) => {
-        editorHost().notify({
-          tone: 'error',
-          title: `Run "${selected.id}"`,
-          detail: error instanceof Error ? error.message : String(error),
-        });
-        return null;
-      });
-      if (!outcome) return;
-      if (!outcome.ready) {
-        editorHost().notify({
-          tone: 'error',
-          title: `Run "${selected.id}" is not ready`,
-          detail: Object.entries(outcome.logs)
-            .map(([id, lines]) => `${id}: ${lines.slice(-3).join(' | ') || 'no output'}`)
-            .join('\n'),
-        });
-        return;
-      }
-      if (instances !== null) setDesiredExtraInstances(Math.max(0, instances - 1));
-      void run.refresh();
+    const start = await startSelectedRunConfiguration();
+    if (!start.ok) {
+      editorHost().notify({ tone: 'error', title: start.title, detail: start.detail });
+      return;
     }
+    if (start.started) void run.refresh();
     await enterPlayMode();
   };
   const stop = () => {
     exitPlayMode();
-    if (selected && selected.kind !== PLAY_ID) {
-      void stopConfiguration(selected.id).then(() => run.refresh());
-    }
+    void stopStartedRunConfiguration().then(() => run.refresh());
   };
   return (
     <PlayBarView
@@ -388,8 +371,7 @@ function PlayOptions() {
 }
 
 /** The implicit configuration: mount every root in the host. */
-const PLAY_ID = 'play';
-const RUN_SELECTION_SECTION = 'runSelection';
+const PLAY_ID = PLAY_CONFIGURATION;
 
 interface RunState {
   readonly configurations: readonly ConfigurationStatus[];
@@ -403,9 +385,7 @@ interface RunState {
  *  document, the way an IDE remembers the chosen launch configuration. */
 function useRunConfigurations(): RunState {
   const [declared, setDeclared] = useState<readonly ConfigurationStatus[]>([]);
-  const [selectedId, setSelectedId] = useState<string>(
-    () => editorHost().projectLocalState.read<string>(RUN_SELECTION_SECTION) ?? PLAY_ID,
-  );
+  const [chosenId, setChosenId] = useState<string | null>(chosenRunConfiguration);
   const refresh = useCallback(async () => {
     const list = await listConfigurations().catch(() => []);
     setDeclared(list);
@@ -426,9 +406,10 @@ function useRunConfigurations(): RunState {
     ],
     [declared],
   );
+  const selectedId = selectedRunConfiguration(declared, chosenId);
   const select = useCallback((id: string) => {
-    setSelectedId(id);
-    editorHost().projectLocalState.write(RUN_SELECTION_SECTION, id);
+    setChosenId(id);
+    chooseRunConfiguration(id);
   }, []);
   return { configurations, selectedId, select, refresh };
 }

package/src/profiler/FrameDebuggerPanel.tsx

@@ -32,7 +32,7 @@ import { Button, themeVars } from '@volter/editor-sdk/widgets';
 import type {
   FrameCapture,
   FrameCaptureDrawCall,
-} from '@volter/game-runtime/dev/webgl-frame-capture';
+} from '../runtime/dev/webgl-frame-capture';
 import { useEffect, useState, useSyncExternalStore } from 'react';
 import {
   captureFrame,

package/src/profiler/PerformancePanel.tsx

@@ -30,13 +30,13 @@ import {
   spaceVar,
   themeVars,
 } from '@volter/editor-sdk/widgets';
-import { buildChromeTrace } from '@volter/game-runtime/dev/chrome-trace';
+import { buildChromeTrace } from '../runtime/dev/chrome-trace';
 import type {
   PerformanceFrame,
   PerformanceProfiler,
   PerformanceSnapshot,
-} from '@volter/game-runtime/dev/performance-profiler';
-import type { RenderMemorySnapshot } from '@volter/game-runtime/dev/render-memory';
+} from '../runtime/dev/performance-profiler';
+import type { RenderMemorySnapshot } from '../runtime/dev/render-memory';
 import { useEffect, useRef, useState } from 'react';
 import { createMainThreadBusySampler, type MainThreadBusySampler } from './main-thread-busy';
 

package/src/react/design-time-react-mount.ts

@@ -4,8 +4,7 @@
  * composed story of the project laid out as an isolated, labeled frame, with
  * the root entry's own story (derived, never labeled — the story whose CSF
  * `meta.component` is the entry's default export) as the frame it opens on.
- * A project with no stories falls back to mounting the entry once against an
- * inert Game.
+ * A project with no stories falls back to mounting the entry once, bare.
  *
  * ## Why this is a package and not the host's
  *
@@ -58,36 +57,33 @@
 import type {
   DesignTimeRootDescriptor,
   LayerMountResult,
-} from '@volter/editor-core/authoring/design-time-layers';
+} from '@volter/editor-sdk/kit/authoring/design-time-layers';
 import {
   rememberedPortableStory,
   rememberPortableStory,
-} from '@volter/editor-core/authoring/design-time-layers';
-import type { DesignTimeMountContext } from '@volter/editor-core/authoring/design-time-mount-registry';
+} from '@volter/editor-sdk/kit/authoring/design-time-layers';
+import type { DesignTimeMountContext } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
 import { formatMountFailureMessage } from '@volter/editor-sdk/kit/mount-failure-report';
-import type { ReactStoryBoardSelectionIntent } from '@volter/editor-core/authoring/react-story-board';
-import { createReactStoryBoard } from '@volter/editor-core/authoring/react-story-board';
+import type { ReactStoryBoardSelectionIntent } from '@volter/editor-sdk/kit/authoring/react-story-board';
+import { createReactStoryBoard } from '@volter/editor-sdk/kit/authoring/react-story-board';
 import {
   getRootCanvasViewport,
   setRootCanvasViewport,
 } from '@volter/editor-sdk/kit/world-canvas-viewport-state';
 import { recordAuthoringConsumerUse } from '@volter/editor-sdk/kit/authoring-seam-evidence';
 import { CrashNullBoundary } from '@volter/editor-sdk/kit/crash-null-boundary';
-import { readProjectTextFile } from '@volter/editor-core/editor-api';
+import { readProjectTextFile } from '@volter/editor-sdk/kit/editor-api';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import {
-  resolveReactRootMountRuntime,
-  resolveWorldProviderForProject,
-} from '../host/react-mount-runtime';
+import { resolveReactRootMountRuntime } from '../host/react-mount-runtime';
 import { activeRealmServices } from '../host/realm-services';
 import { resolveReactAdapterRootComponent } from '../host/roots/react-root';
-import { scopedGameStylesState } from '@volter/editor-core/scoped-game-css';
-import { componentIdentityName } from '@volter/editor-core/stories/compose-project-stories';
-import { mountIsolatedStory } from '@volter/editor-core/stories/StoryPreviewMount';
+import { scopedGameStylesState } from '@volter/editor-sdk/kit/scoped-game-css';
+import { componentIdentityName } from '@volter/editor-sdk/kit/stories/compose-project-stories';
+import { mountIsolatedStory } from '@volter/editor-sdk/kit/stories/StoryPreviewMount';
 import {
   createStoryPresentationIndex,
   storyBoardPresentation,
-} from '@volter/editor-core/stories/story-presentation';
+} from '@volter/editor-sdk/kit/stories/story-presentation';
 import {
   getComponentPreviewStory,
   getProjectPreviewStories,
@@ -96,15 +92,12 @@ import {
   projectStoriesReady,
   refreshProjectStories,
   subscribeProjectStoryModules,
-} from '@volter/editor-core/stories/story-registry';
-import { domStoryBoardMembers } from '@volter/editor-core/stories/three-story-model';
-import { getDesignTokens } from '@volter/editor-core/ui-source/inspect';
-import { tierSourceWriteBackend } from '@volter/editor-core/ui-source/tier-source-write-backend';
+} from '@volter/editor-sdk/kit/stories/story-registry';
+import { domStoryBoardMembers } from '@volter/editor-threejs/kit/stories/three-story-model';
+import { getDesignTokens } from '@volter/editor-sdk/kit/ui-source/inspect';
+import { tierSourceWriteBackend } from '@volter/editor-sdk/kit/ui-source/tier-source-write-backend';
 import { recordViewportFirstFrame } from '@volter/editor-sdk/kit/viewport-activation-timings';
-import { createAssetCache } from '@volter/threejs-runtime/assets';
-import { createGameLoop } from '@volter/game-runtime/core/game-loop';
 import type { ResolvedAdapterRoot } from '@volter/editor-project/manifest/load';
-import { createGame, type GameInternal } from '@volter/game-runtime/runtime/game';
 import { beginProjectMountEpoch } from '@volter/editor-sdk/session/project-module-url';
 import type { ComponentType } from 'react';
 import { type OidElementLike, ReactRootAuthoringAdapter } from './react-world-authoring-adapter';
@@ -167,35 +160,6 @@ async function seedRootViewportFromManifest(): Promise<void> {
     // An unreadable manifest declares nothing; Fill stands.
   }
 }
-/**
- * The inert design-time Game stand-in (B1's one genuine design
- * decision). A REAL `Game` — never a hand-typed duck-typed literal, mirroring
- * this repo's own test convention (`packages/editor/test/adapter-conformance-kit.ts`'s
- * `headlessGame()`) — built with a loop that is constructed but NEVER
- * started/ticked, and with NO roots ever registered. This satisfies
- * `useGame`/`useWorldState` (`@volter/game-runtime/react/world-state`, and any project's own
- * re-export of it) without throwing, genuinely inertly:
- *  - `state.subscribe` never fires — nothing ever calls
- *    `GameStateBridgeInternal.bump()` (only `GameInternal.runFrame` does, and
- *    this Game's loop never runs a frame);
- *  - `state.frameVersion` stays `0` forever;
- *  - `queryByComponent`/`world()`/`roots` are empty/`null` because `roots`
- *    stays `[]` (nothing ever calls `registerRoot`).
- * `defaultRoot`/`components`/`input`/`audio` throw descriptively if touched
- * (same as any fresh `createGame()` before a world registers) — a HUD that
- * reaches for those is out of scope for a design-time stand-in and SHOULD
- * throw loudly, caught by the crash-null boundary below, degrading to the
- * #18 error node rather than silently faking a value.
- *
- * B2 swaps this stand-in's DATA for story-sourced data (a `data`/services
- * seam) — this function is the seam B2 replaces/extends, not a permanent
- * fixture; it never constructs a live Game/sockets.
- */
-function createDesignTimeGame(): GameInternal {
-  const loop = createGameLoop({ fixedTimestep: 1 / 60, maxSubSteps: 8, update: () => {} });
-  return createGame({ loop, assets: createAssetCache() });
-}
-
 /**
  * A minimal `ResolvedAdapterRoot` satisfying `resolveReactAdapterRootComponent`
  * (`../binding-resolver.ts`, which reads only `id`/`kind`/`entry` off
@@ -231,7 +195,7 @@ type EntryResolution = { ok: true; Entry: ComponentType } | { ok: false; error:
 /**
  * Load a React root's entry component ONCE per layer mount, without throwing.
  * Both of this layer's paths need it: the derived default story is joined
- * against this component's identity, and the inert-Game fallback renders it.
+ * against this component's identity, and the no-story fallback renders it.
  * A failure is carried rather than thrown so the story board can still open
  * over a project whose entry is broken; only the fallback (which has nothing
  * else to render) rethrows it.
@@ -254,16 +218,14 @@ async function resolveEntryComponent(
 /**
  * React design-time mount — the entry
  * via the EXISTING #31 loader (`resolveReactAdapterRootComponent`, reused
- * verbatim), wrapped in the canonical engine `WorldProvider`
- * (`resolveWorldProviderForProject`) around the inert
- * `createDesignTimeGame()` stand-in and a React error boundary.
+ * verbatim), rendered inside a React error boundary.
  * `flushSync` forces the initial render/commit/error-boundary-recovery to
  * finish before this call returns (mirrors `ingest-siblings.ts`'s
  * `mountDefaultReactSibling`), so a throwing entry is caught HERE —
  * synchronously — rather than discovered later on react's own schedule.
  *
  * Portable CSF stories take the board path above. This branch is only the
- * explicit no-story fallback and mounts the entry once against the inert Game.
+ * explicit no-story fallback and mounts the entry once.
  * On success, it mints the world's live `ReactRootAuthoringAdapter` over this
  * layer's now-mounted DOM — the adapter reflects
  * an already-mounted root, it never mounts one itself; this function is the
@@ -297,8 +259,7 @@ export async function mountReactDesignLayer(
   // Edit mode lays EVERY composed story of the project out as an isolated,
   // labeled frame on one editor-only board — board membership is
   // project-global, the project's own component gallery. Play still tears
-  // this entire surface down and mounts only the manifest entry against the
-  // real Game.
+  // this entire surface down and mounts only the manifest entry.
   //
   // A remount that the registry's own publish requested already has fresh
   // stories: refreshing again would reload every story module in parallel —
@@ -315,7 +276,7 @@ export async function mountReactDesignLayer(
 
   // The root's composed default preview is DERIVED, never labeled: it is the
   // story whose CSF `meta.component` is this root entry's default-exported
-  // component. Resolve that component first (the same loader the inert-Game
+  // component. Resolve that component first (the same loader the no-story
   // fallback below reuses), then ask the registry for its story.
   //
   // The join is by component NAME, not function identity, and that is
@@ -615,12 +576,11 @@ export async function mountReactDesignLayer(
     `[design-time-layers] React root "${candidate.worldId}" has no portable CSF preview — the ` +
       'project declares no UI stories. Add a *.stories.tsx; give it a `meta.component` of ' +
       `this root's entry component${entryComponentName ? ` (${entryComponentName}, ${candidate.path})` : ''} ` +
-      'to make it this root’s default preview. Falling back to the inert-Game preview.',
+      'to make it this root’s default preview. Falling back to rendering the entry bare.',
     'authoring',
   );
 
   const Entry = entry.Entry;
-  const WorldProvider = await resolveWorldProviderForProject();
   // C1 (phase-b/c1-react-mount): this layer's own react-world mount is a
   // SECOND call site with the identical packaged-runtime dual-React-instance
   // exposure `binding-resolver.ts`'s `ReactRootAdapter.mount()` has — under
@@ -628,14 +588,13 @@ export async function mountReactDesignLayer(
   // from the PROJECT's own react, not this module's (removed) static
   // imports. See `resolveReactRootMountRuntime`'s doc comment.
   const { createElement, createRoot, flushSync } = await resolveReactRootMountRuntime();
-  const game = createDesignTimeGame();
   const root = createRoot(layer);
   const render = (onCaught: (error: unknown) => void): void => {
     root.render(
       createElement(CrashNullBoundary, {
         key: '__entry__',
         onCaught,
-        children: createElement(WorldProvider, { game }, createElement(Entry)),
+        children: createElement(Entry),
       }),
     );
   };
@@ -668,7 +627,6 @@ export async function mountReactDesignLayer(
       // but this keeps teardown clean).
       adapter.disposeReactRootAdapter();
       root.unmount();
-      game.dispose();
     },
   };
 }

package/src/react/dom-authoring-adapter.ts

@@ -46,10 +46,10 @@
 import { numericStyleValue } from '@volter/editor-sdk/css-numeric-style';
 import { createEphemeralPersistence } from '../host/authoring/ephemeral-persistence';
 import { LIVE_ONLY_DESTINATION } from '@volter/editor-sdk/kit/write-pipe';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { type JournalSubject, JsonHistoryResource } from '../host/history/json-history-resource';
 import { DomProjector, structuralDomIdentity } from '../host/projection/dom';
-import { browserOrInlineResolver, getComputedStyleValue } from '@volter/editor-core/ui-source/inspect';
+import { browserOrInlineResolver, getComputedStyleValue } from '@volter/editor-sdk/kit/ui-source/inspect';
 import type {
   AssetSubjectProvider,
   AuthoringAdapter,
@@ -271,7 +271,7 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
     private readonly store: EditorShellStore,
     opts: DomAuthoringOptions,
   ) {
-    const history = store.projectHistory;
+    const history = store.shell.projectHistory;
     this.historyResource = history
       ? new JsonHistoryResource({
           history,
@@ -372,8 +372,8 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
   };
 
   readonly selection: SelectionProvider = {
-    get: () => [...this.store.selectedEntityIds],
-    set: (ids) => this.store.selectMultiple(ids),
+    get: () => [...this.store.shell.selectedEntityIds],
+    set: (ids) => this.store.shell.selectMultiple(ids),
   };
 
   /**
@@ -650,7 +650,7 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
       if (path === 'locked') {
         if (value) this.lockedIds.add(id);
         else this.lockedIds.delete(id);
-        this.store.notifyIngestEdit();
+        this.store.shell.notifyIngestEdit();
         return;
       }
       if (path === 'visible') {
@@ -700,7 +700,7 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
 
     this.applyStyleToElement(n.el, prop, value);
     this.recordStyleEdit(id, prop, value);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
 
     return true;
   }
@@ -747,11 +747,11 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
         this.applyStyleToElement(node.el, prop, values[prop] ?? '');
       }
     }
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 
   subscribe(listener: () => void): () => void {
-    return this.store.subscribe(listener);
+    return this.store.shell.subscribe(listener);
   }
 
   /**

package/src/react/react-inspector-section.tsx

@@ -1,4 +1,4 @@
-import { setAuthoringSelection } from '@volter/editor-core/authoring/consumer-actions';
+import { setAuthoringSelection } from '@volter/editor-sdk/kit/authoring/consumer-actions';
 import { faBookBookmark, faCode, faPalette } from '@fortawesome/free-solid-svg-icons';
 import {
   Button,
@@ -53,13 +53,13 @@ import {
   setActiveBreakpoint,
   subscribeBreakpoint,
 } from '@volter/editor-sdk/kit/breakpoint-state';
-import { CompositeAuthoringAdapter } from '@volter/editor-core/authoring/composite-authoring-adapter';
+import { CompositeAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/composite-authoring-adapter';
 import { numericStyleValue, UNITLESS_NUMBER_PROPS } from '@volter/editor-sdk/css-numeric-style';
 import { beginEyedropperSession } from '@volter/editor-sdk/kit/eyedropper-session';
 import { groupProperties } from '@volter/editor-sdk/kit/inspector-property-grouping';
-import { useEditorStore } from '@volter/editor-core/editor-runtime';
+import { useEditorStore } from '@volter/editor-sdk/kit/editor-runtime';
 import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
-import { groupIcon } from '@volter/editor-core/inspection/compose';
+import { groupIcon } from '@volter/editor-sdk/kit/inspection/compose';
 import {
   GROUP_SECTION_ORDER,
   groupSectionId,
@@ -68,7 +68,7 @@ import {
   PROPERTIES_SECTION_ORDER,
 } from '@volter/editor-sdk/kit/inspection-model';
 import { registerInspectorSections } from '@volter/editor-sdk/kit/inspector-section-registry';
-import { effectiveColorFromChain, getAvailableFonts } from '@volter/editor-core/ui-source/inspect';
+import { effectiveColorFromChain, getAvailableFonts } from '@volter/editor-sdk/kit/ui-source/inspect';
 import type { OidEntry } from '@volter/editor-react/source/oid-transform';
 import type { AuthoringAdapter, EditorNode, PropertyDescriptor } from '@volter/editor-project/adapter';
 import {

package/src/react/react-world-authoring-adapter.ts

@@ -42,16 +42,16 @@ import {
   type WriteAck,
   type WriteResolution,
 } from '@volter/editor-sdk/kit/write-pipe';
-import { guideClientEdges } from '@volter/editor-core/components/board-guides';
+import { guideClientEdges } from '@volter/editor-sdk/kit/components/board-guides';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { withProjectSourceHistory } from '@volter/editor-core/history/source-history-backend';
+import type { ShellStore } from '@volter/editor-sdk/kit/shell-store';
+import { withProjectSourceHistory } from '@volter/editor-sdk/kit/history/source-history-backend';
 import { DomProjector, oidDomIdentity, projectOidDom } from '../host/projection/dom';
 import { storyArgPropertyDescriptors } from '../host/stories/story-arg-descriptors';
-import { storyDiscoveryUnavailable } from '@volter/editor-core/stories/story-discovery';
-import { deriveStoryGroupPath, formatStoryGroupPath } from '@volter/editor-core/stories/story-grouping';
-import type { StoryPresentationIndex } from '@volter/editor-core/stories/story-presentation';
-import { subscribeProjectStoryModules } from '@volter/editor-core/stories/story-registry';
+import { storyDiscoveryUnavailable } from '@volter/editor-sdk/kit/stories/story-discovery';
+import { deriveStoryGroupPath, formatStoryGroupPath } from '@volter/editor-sdk/kit/stories/story-grouping';
+import type { StoryPresentationIndex } from '@volter/editor-sdk/kit/stories/story-presentation';
+import { subscribeProjectStoryModules } from '@volter/editor-sdk/kit/stories/story-registry';
 import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import {
   browserOrInlineResolver,
@@ -68,11 +68,11 @@ import {
   getMatchedCssRules,
   getReactComponentName,
   type MatchableElement,
-} from '@volter/editor-core/ui-source/inspect';
+} from '@volter/editor-sdk/kit/ui-source/inspect';
 import type { ComponentPropSpec, OidEntry } from '@volter/editor-react/source/oid-transform';
 import { relativeImportSpecifier } from '@volter/editor-react/source/relative-import-specifier';
-import type { SourceWriteBackend } from '@volter/editor-core/ui-source/source-write-backend';
-import { writeCsfStory, writeNamedStyle } from '@volter/editor-core/ui-source/source-write-backend';
+import type { SourceWriteBackend } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
+import { writeCsfStory, writeNamedStyle } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
 import {
   type CssRuleTarget,
   namedStyleRuleFor,
@@ -1042,7 +1042,7 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
 
   constructor(
     private readonly root: OidElementLike,
-    private readonly store: EditorShellStore,
+    private readonly store: ShellStore,
     opts: ReactRootAuthoringOptions = {},
   ) {
     this.assetRoot = opts.assetRoot ?? root;

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

@@ -42,8 +42,8 @@ import { Checkbox, TextInput, themeVars } from '@volter/editor-sdk/widgets';
 // estate into this package's program.
 import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
 import { type Resolution, ResolutionPicker } from '../../host/components/ResolutionPicker';
-import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
-import { registerDocumentOpener } from '@volter/editor-core/document-open-registry';
+import { SurfaceStateOverlay } from '@volter/editor-sdk/kit/components/SurfaceStateOverlay';
+import { registerDocumentOpener } from '@volter/editor-sdk/kit/document-open-registry';
 import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
 import {
   CONTRIBUTED_SECTION_ORDER,
@@ -51,10 +51,10 @@ import {
   STORY_ARGS_SECTION_TITLE,
 } 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 { getProjectStoryRegions } from '@volter/editor-core/stories/project-story-regions';
-import { mountIsolatedStory, runStoryPlay } from '@volter/editor-core/stories/StoryPreviewMount';
-import { declaredStoryMedium } from '@volter/editor-core/stories/story-declared-medium';
+import type { ComposedProjectStory } from '@volter/editor-sdk/kit/stories/compose-project-stories';
+import { getProjectStoryRegions } from '@volter/editor-sdk/kit/stories/project-story-regions';
+import { mountIsolatedStory, runStoryPlay } from '@volter/editor-sdk/kit/stories/StoryPreviewMount';
+import { declaredStoryMedium } from '@volter/editor-sdk/kit/stories/story-declared-medium';
 import {
   ISOLATED_STORY_DOCUMENT_OPENER,
   STORY_DOCS_DOCUMENT_OPENER,
@@ -65,7 +65,7 @@ import {
   refreshProjectStories,
   subscribeProjectStoryModules,
   whenProjectStoriesReady,
-} from '@volter/editor-core/stories/story-registry';
+} from '@volter/editor-sdk/kit/stories/story-registry';
 import { domHasRenderableContent } from '../../host/surface-content';
 import { explainSurface, type SurfaceContentState } from '@volter/editor-sdk/kit/surface-state';
 import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-sdk/kit/workspace-core-utilities';
@@ -74,9 +74,9 @@ import {
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
 } from '@volter/editor-sdk/kit/workspace-document-registry';
-import { registerWorkspaceDocumentRestorer } from '@volter/editor-core/workspace-document-restore';
+import { registerWorkspaceDocumentRestorer } from '@volter/editor-sdk/kit/workspace-document-restore';
 import { registerWorkspaceUtility } from '@volter/editor-sdk/kit/workspace-utility-registry';
-import { fitPresentation } from '@volter/game-runtime/runtime/presentation';
+import { fitPresentation } from '../../runtime/presentation';
 import { Button, fontMono, fontSizeVar, spaceVar } from '@volter/editor-sdk/widgets';
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
 import { STORY_ARGS_SECTION_ICON } from './story-args-section';

package/src/react/ui-board-document.tsx

@@ -1,4 +1,4 @@
-import { registerAvailableWorkspaceDocument } from '@volter/editor-core/workspace-available-documents';
+import { registerAvailableWorkspaceDocument } from '@volter/editor-sdk/kit/workspace-available-documents';
 /**
  * THE `UI` BOARD's DOCUMENT — what `ui-component-board.ts` installs, kept in
  * its own module so the registration's eager closure is the verdict and
@@ -29,15 +29,15 @@ import {
   designTimeRootDescriptors,
   projectStoryBoardDescriptor,
   rememberedPortableStory,
-} from '@volter/editor-core/authoring/design-time-layers';
-import type { ComponentBoardContext } from '@volter/editor-core/component-board-registry';
-import { RootDocumentContent } from '@volter/editor-core/components/world-documents';
+} from '@volter/editor-sdk/kit/authoring/design-time-layers';
+import type { ComponentBoardContext } from '@volter/editor-sdk/kit/component-board-registry';
+import { RootDocumentContent } from '@volter/editor-sdk/kit/components/world-documents';
 import type { DocumentPreviewSource } from '@volter/editor-sdk/kit/document-preview-source';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
 import {
   getProjectPreviewStories,
   subscribeProjectStoryModules,
-} from '@volter/editor-core/stories/story-registry';
+} from '@volter/editor-sdk/kit/stories/story-registry';
 import { UI_COMPONENTS_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import type { WorkspaceDocumentContentProps } from '@volter/editor-sdk/kit/workspace-document-registry';
 
@@ -48,7 +48,7 @@ const uiCanvasPreview: DocumentPreviewSource = {
     JSON.stringify(getProjectPreviewStories().map(({ id, modulePath }) => [id, modulePath])),
   subscribe: subscribeProjectStoryModules,
   capture: async ({ width, height }) => {
-    const { captureDomStoryBoardPreview } = await import('@volter/editor-core/stories/story-capture');
+    const { captureDomStoryBoardPreview } = await import('@volter/editor-sdk/kit/stories/story-capture');
     return captureDomStoryBoardPreview(width, height);
   },
 };

package/src/react/ui-component-board.ts

@@ -13,13 +13,13 @@
  */
 
 import { commandLine } from '@volter/editor-sdk/kit/product-command';
-import type { ComponentBoard, ComponentBoardContext } from '@volter/editor-core/component-board-registry';
+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 { projectStoriesReady, subscribeProjectStoryModules } from '@volter/editor-sdk/kit/stories/story-registry';
 import { UI_COMPONENTS_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import { UI_COMPONENTS_TITLE } from './ui-board-title';
 

package/src/runtime/adapter/audio-meter.ts

@@ -0,0 +1,21 @@
+/**
+ * Meter arithmetic over an `AudioAdapter`'s `AudioMeterFrame.level` — the one
+ * place a linear RMS level becomes dBFS and a bar fill. Lives beside the
+ * adapter because both readers of a level (the editor's header meter and the
+ * `@vgai/game` audio debugger) are consumers of the adapter, and neither may
+ * import the other.
+ */
+
+/** Linear RMS level → dBFS. Silence clamps to `floorDb` (log of 0 is -∞). */
+export function levelToDb(level: number, floorDb = -60): number {
+  if (!(level > 0)) return floorDb;
+  return Math.max(floorDb, 20 * Math.log10(level));
+}
+
+/** Meter-bar fill percentage: dB-scaled from a -60 dBFS floor (a linear
+ *  scale would pin every real-world level into the bottom pixels). 0 for
+ *  silence, 100 at/above full scale. */
+export function meterPercent(level: number, floorDb = -60): number {
+  const db = levelToDb(level, floorDb);
+  return Math.round(((db - floorDb) / -floorDb) * 100);
+}