@volter/editor-game 0.5.65 → 0.5.67

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

@@ -6,7 +6,7 @@
  * entities ARE the `data-oid`-stamped elements of its rendered DOM (the OID
  * instrumentation from the UI visual-edit program, `../ui-source/oid-transform.ts`,
  * whose vite-plugin include this slice widens from the `editable-components` fixture
- * dir to project scope — see `../../vite-plugin-ui-oid.ts`). This adapter derives
+ * dir to project scope — see `@volter/editor-react`'s `serving/ui-oid-plugin.ts`). This adapter derives
  * its hierarchy from the shared DOM projector (`../projection/dom.ts`) under the
  * OID identity, over the world's live DOM root (`RootInstance.reactRoot()`);
  * there is no cached/mirrored state to fall out of sync — every `hierarchy`
@@ -15,7 +15,7 @@
  * Writes (style/className/delete) reuse the EXISTING T3.2-slice-3 source-write seam
  * verbatim (`../ui-source/source-write-backend.ts`'s `SourceWriteBackend`, the same
  * `/__ui-source/write` + `/__ui-source/struct` dev-server endpoints
- * `vite-plugin-ui-oid.ts` serves for `UIAuthoringAdapter`/`SourceEditPanel`) — this
+ * `@volter/editor-react`'s `serving/ui-oid-plugin.ts` serves for `UIAuthoringAdapter`/`SourceEditPanel`) — this
  * file does NOT invent a second source-writer. Every edit prepares complete next-file
  * text and commits it through one checksum-guarded source history resource. Style,
  * text, prop, and structural changes therefore share exact-byte undo/redo semantics.
@@ -27,32 +27,32 @@
  * unavailable via a loud console warning instead of silently no-op'ing).
  */
 
-import { activeBreakpoint } from '@volter/editor-core/authoring/breakpoint-state';
+import { activeBreakpoint } from '@volter/editor-sdk/kit/breakpoint-state';
 import {
   cssTextForStyleValue,
   numericStyleValue,
   preserveNumericStyleUnit,
-} from '@volter/editor-core/authoring/css-numeric-style';
-import { WORLD_SCOPE_NODE_ID } from '@volter/editor-core/authoring/stories-scope';
+} from '@volter/editor-sdk/css-numeric-style';
+import { WORLD_SCOPE_NODE_ID } from '@volter/editor-sdk/kit/stories-scope';
 import { createStructWritePipe, type StructOpOptions } from '../host/authoring/struct-write-pipe';
-import { getRootPan } from '@volter/editor-core/authoring/world-pan-state';
+import { getRootPan } from '@volter/editor-sdk/kit/world-pan-state';
 import {
   resolvesLiveOnly,
   runWritePipe,
   type WriteAck,
   type WriteResolution,
-} from '@volter/editor-core/authoring/write-pipe';
-import { guideClientEdges } from '@volter/editor-core/components/board-guides';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { withProjectSourceHistory } from '@volter/editor-core/history/source-history-backend';
+} from '@volter/editor-sdk/kit/write-pipe';
+import { guideClientEdges } from '@volter/editor-sdk/kit/components/board-guides';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+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 { showTransientHint } from '@volter/editor-core/transient-hint';
+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,
   type ComputedStyleResolver,
@@ -62,26 +62,25 @@ import {
   findClassRuleSource,
   findEmptyContainers,
   firstPartyStylesheetFiles,
-  getCallSiteOid,
   getComponentProps,
   getComputedStyleValue,
   getDesignTokens,
   getMatchedCssRules,
   getReactComponentName,
   type MatchableElement,
-} from '@volter/editor-core/ui-source/inspect';
-import type { ComponentPropSpec, OidEntry } from '@volter/editor-core/ui-source/oid-transform';
-import { relativeImportSpecifier } from '@volter/editor-core/ui-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';
+} 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-sdk/kit/ui-source/source-write-backend';
+import { writeCsfStory, writeNamedStyle } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
 import {
   type CssRuleTarget,
   namedStyleRuleFor,
   pickCssRuleTarget,
   tokenReferenceGuardText,
-} from '@volter/editor-core/ui-source/writer';
-import { UI_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 { UI_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,
@@ -255,20 +254,6 @@ export function mapBoxEditPatchKey(key: string, isPositioned: boolean): BoxEditP
   }
 }
 
-/**
- * A pasteboard `<At>` mount — detected by the STRUCTURAL marker the pasteboard
- * capability's helper renders (`data-vgai-at="true"`), never by filename or
- * import path, so a project's freely edited copy of the helper keeps working
- * (the LiveModuleDocument precedent: detection is structural). An `x`/`y` drag
- * on one of these writes the callsite's `x`/`y` JSX literals instead of inline
- * `left`/`top` style — the authored form the pasteboard design ratified
- * (docs/PARITY-PROGRAM-HANDOFF.md, queue item 4: "drag = OID literal write to
- * x/y").
- */
-function isPasteboardAtElement(el: OidElementLike): boolean {
-  return el.getAttribute('data-vgai-at') === 'true';
-}
-
 const OID_ATTR = 'data-oid';
 const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
 const VOID_HTML_ELEMENTS = new Set([
@@ -1057,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;
@@ -1993,38 +1978,10 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
           bestOrder = order;
         }
       }
-      return bestId === null ? null : this.resolvePlacementUnit(bestId);
+      return bestId;
     },
   };
 
-  /**
-   * The pasteboard's PICK RULE: a hit anywhere inside an `<At>` subtree
-   * selects the At — the placement unit whose `x`/`y` a drag writes — never
-   * the helper's internals. Without this, the deepest-wins rule above picked
-   * a Swatch's inner chip div (a STATIC node whose x/y drag drops by design),
-   * and the drag gesture that followed re-picked it out from under the
-   * selected At on pointerdown, so no pasteboard drag could ever commit
-   * (measured on the moodboard acceptance run, 2026-08-30). Deeper selection
-   * stays reachable through the hierarchy panel, which projects the full
-   * subtree. Structural (`data-vgai-at`), so it costs nothing outside
-   * pasteboard content.
-   */
-  private resolvePlacementUnit(pickedId: string): string {
-    const { nodes } = this.snapshot();
-    const picked = nodes.get(pickedId);
-    const el = picked?.el as unknown as
-      | { closest?(selector: string): unknown; getAttribute?(name: string): string | null }
-      | undefined;
-    if (!el?.closest) return pickedId;
-    if (el.getAttribute?.('data-vgai-at') === 'true') return pickedId;
-    const at = el.closest('[data-vgai-at="true"]');
-    if (!at) return pickedId;
-    for (const [id, node] of nodes) {
-      if ((node.el as unknown) === at) return id;
-    }
-    return pickedId;
-  }
-
   /** Host rect to subtract for {@link rects}' HOST-RELATIVE geometry — `this.root`
    *  IS the world's own mounted DOM layer (`world.mounted.container` / the ingest
    *  sibling's `layer`, see the constructor call sites), i.e. exactly the
@@ -2308,30 +2265,13 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     priorInline: Map<string, string>,
   ): Promise<void> {
     const wasDirty = this.dirty;
-    // A pasteboard `<At>` mount routes its position to the CALLSITE's `x`/`y`
-    // JSX literals rather than inline `left`/`top` style — the drag's live
-    // preview still moved `el.style.left/top` (the helper renders exactly that
-    // from `x`/`y`), but the AUTHORED truth is the props, so that is what the
-    // commit writes. Resolved from the fiber (the helper's own internal stamp
-    // sits on the same element, so the element's `data-oid` alone would name
-    // the helper file, not the callsite in the pasteboard file).
-    const node = this.snapshot().nodes.get(id);
-    const atCallSiteOid = node && isPasteboardAtElement(node.el) ? getCallSiteOid(node.el) : null;
-    const atPropForStyle = (prop: string): 'x' | 'y' | null =>
-      atCallSiteOid === null ? null : prop === 'left' ? 'x' : prop === 'top' ? 'y' : null;
     // A4 — echo every touched prop BEFORE any write, so the inspector field shows
     // the dragged value at once (same discipline as `inspector.set`). The echo holds
     // the BARE numeric (a `type:'number'` descriptor's `Inspector` field needs an
     // actual number — see `inspector.get`'s `numericStyleValue` note), NOT the
-    // px-suffixed source form D1 writes below. An At placement echoes on the
-    // PROP path instead (its Props section is where x/y render).
+    // px-suffixed source form D1 writes below.
     for (const [prop, value] of touched) {
-      const atProp = atPropForStyle(prop);
-      if (atProp && typeof value === 'number') {
-        this.setEcho(id, `${PROP_PATH_PREFIX}${atProp}`, String(Math.round(value)));
-      } else {
-        this.setEcho(id, `${STYLE_PATH_PREFIX}${prop}`, value);
-      }
+      this.setEcho(id, `${STYLE_PATH_PREFIX}${prop}`, value);
     }
     // A GESTURE THAT WROTE NOTHING SAYS SO. Every refusal below only warned in
     // the browser console, so a drag whose commit was refused looked done —
@@ -2345,12 +2285,6 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     this.lastStyleWriteRefusal = null;
     const commit = async (backend: SourceWriteBackend | undefined): Promise<void> => {
       for (const [prop, value] of touched) {
-        const atProp = atPropForStyle(prop);
-        if (atProp && typeof value === 'number') {
-          await this.writeAtPlacement(id, atCallSiteOid as string, atProp, value, backend);
-          applied += 1;
-          continue;
-        }
         // D1 (spec 27 §4 B2/B3 reload-safety) — a numeric length-prop value must
         // persist to JSX SOURCE in a form React honors on REMOUNT. React 19 DROPS a
         // bare UNITLESS numeric STRING (the writer quotes `String(152)` → `width:
@@ -2396,52 +2330,6 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     }
   }
 
-  /**
-   * The pasteboard placement write: one `<At>` callsite prop (`x` or `y`) as a
-   * JSX NUMBER LITERAL, `addIfMissing` because the helper defaults both to 0
-   * and an author legitimately omits them until the first drag. Refusals
-   * follow {@link writePropEdit}'s contract: a dynamic expression (`x={GRID *
-   * 2}`) is authored truth the drag must not flatten — guarded and warned by
-   * name, never overwritten. Runs inside {@link commitBoxEdit}'s gesture, so a
-   * corner drag that writes both axes stays one undo entry.
-   */
-  private async writeAtPlacement(
-    id: string,
-    callSiteOid: string,
-    prop: 'x' | 'y',
-    value: number,
-    backend: SourceWriteBackend | undefined,
-  ): Promise<void> {
-    const echoPath = `${PROP_PATH_PREFIX}${prop}`;
-    const b = backend ?? this.writeBackend;
-    if (!b?.writeProp) {
-      this.clearEcho(id, echoPath);
-      console.warn(
-        `[ReactRootAuthoringAdapter] cannot write At placement "${prop}" on "${id}": no ` +
-          'source-write backend with prop support in this session (hosted/no dev server).',
-      );
-      return;
-    }
-    const res = await b.writeProp(callSiteOid, prop, String(Math.round(value)), {
-      addIfMissing: true,
-    });
-    if (!res.changed) {
-      this.clearEcho(id, echoPath);
-      if (res.dynamic) this.markGuarded(id, echoPath, DYNAMIC_EXPRESSION_GUARD);
-      this.store.notifyIngestEdit();
-      console.warn(
-        `[ReactRootAuthoringAdapter] At placement write refused/no-op for oid ` +
-          `"${callSiteOid}" prop "${prop}": ${
-            res.dynamic
-              ? 'value is a dynamic expression (guarded) — authored truth the drag must not flatten'
-              : (res.error ?? 'no change')
-          }`,
-      );
-      return;
-    }
-    this.dirty = true;
-  }
-
   /**
    * T0 (spec 27 §2) — brings the react adapter's existing off-contract `editText`
    * (below) onto the contract. `get` is a best-effort CLIENT-side read: the live
@@ -3044,12 +2932,12 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     // `removeMany` here as unsound because the OBVIOUS implementation is N
     // separate `structOp`-style calls, each targeting its OID's `{file,
     // line, col}` from the SERVER's `OidStore.index`
-    // (`vite-plugin-ui-oid.ts`'s `handleStruct`) — exactly the per-id
+    // (`@volter/editor-react`'s `serving/ui-oid-plugin.ts`'s `handleStruct`) — exactly the per-id
     // `remove` loop's own stale-offset hazard (see the CORRECTNESS INVARIANT
     // comment below), just without the ordering discipline that loop needs
     // to stay sound. This implementation is NOT that: `removeManyElements`
     // posts every id's raw oid in ONE request to `/__ui-source/struct-many`
-    // (`handleStructMany`, `vite-plugin-ui-oid.ts`), which resolves every
+    // (`handleStructMany`, `@volter/editor-react`'s `serving/ui-oid-plugin.ts`), which resolves every
     // oid's offset against a SINGLE shared `readFileSync` snapshot (never a
     // per-id re-read, so no write-to-write staleness is even possible) and
     // applies them highest-offset-first in one pass, one write. That is also
@@ -3677,7 +3565,7 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
    * `#n` siblings share ONE raw oid — deleting it once is correct, per
    * `walkOidTree`'s own disambiguation comment), and posts them ALL in ONE
    * `writeStructMany` call — see that method's doc comment on `SourceWriteBackend`
-   * (`source-write-backend.ts`) and `handleStructMany`'s (`vite-plugin-ui-oid.ts`)
+   * (`source-write-backend.ts`) and `handleStructMany`'s (`@volter/editor-react`'s `serving/ui-oid-plugin.ts`)
    * for the soundness argument (one shared file snapshot, highest-offset-first,
    * caller-order-independent). Degrades to a loud no-op — never a silent partial
    * delete — when this session's backend hasn't implemented `writeStructMany` (a

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

@@ -40,44 +40,43 @@ import { Checkbox, TextInput, themeVars } from '@volter/editor-sdk/widgets';
 // `@editor/active-project` and not `@editor/project-manager`: the same
 // function, re-exported, without dragging the whole project-open/storage
 // estate into this package's program.
-import { getCurrentProject } from '@volter/editor-core/active-project';
+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 type { ViewportTab } from '@volter/editor-core/editor-shell-store';
-import { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
+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,
   STORY_ARGS_SECTION_ID,
   STORY_ARGS_SECTION_TITLE,
-} from '@volter/editor-core/inspection/model';
-import { registerInspectorSections } from '@volter/editor-core/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';
+} from '@volter/editor-sdk/kit/inspection-model';
+import { registerInspectorSections } from '@volter/editor-sdk/kit/inspector-section-registry';
+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,
   type StoryDocumentOpenRequest,
-} from '@volter/editor-core/stories/story-document-openers';
+} from '@volter/editor-sdk/kit/story-document-openers';
 import {
   getProjectStoryModules,
   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-core/surface-state';
-import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-core/workspace-core-utilities';
+import { explainSurface, type SurfaceContentState } from '@volter/editor-sdk/kit/surface-state';
+import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-sdk/kit/workspace-core-utilities';
 import {
   activeWorkspaceDocument,
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
-import { registerWorkspaceDocumentRestorer } from '@volter/editor-core/workspace-document-restore';
-import { registerWorkspaceUtility } from '@volter/editor-core/workspace-utility-registry';
-import { fitPresentation } from '@volter/game-runtime/runtime/presentation';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
+import { registerWorkspaceDocumentRestorer } from '@volter/editor-sdk/kit/workspace-document-restore';
+import { registerWorkspaceUtility } from '@volter/editor-sdk/kit/workspace-utility-registry';
+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';
@@ -205,7 +204,6 @@ export function clearStoryActionLog(id: string): void {
 /** The narrow store surface story documents need (T6.3 gate hand-off —
  *  same contract as `asset-documents.tsx`). */
 export interface StoryDocumentStore {
-  setActiveViewportTab(tab: ViewportTab): void;
 }
 
 /**
@@ -254,7 +252,6 @@ export function openStoryDocument(
       closeable: true,
       presentation: () => ({ kind: 'story', modulePath, storyName, mode: 'preview' }),
       persist: () => ({ modulePath, storyName }),
-      onActivate: () => store.setActiveViewportTab('edit'),
       onDispose: (documentId) => {
         if (_states.delete(documentId)) notifyChanged();
       },
@@ -298,7 +295,6 @@ export function openStoryDocsDocument(
     closeable: true,
     presentation: () => ({ kind: 'story', modulePath, storyName, mode: 'docs' }),
     persist: () => ({ modulePath, storyName, view: 'docs' }),
-    onActivate: () => store.setActiveViewportTab('edit'),
     onDispose: (documentId) => {
       if (_states.delete(documentId)) notifyChanged();
     },

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,17 +29,17 @@ 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';
-import type { DocumentPreviewSource } from '@volter/editor-core/document-preview-source';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
+} 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-sdk/kit/active-project';
 import {
   getProjectPreviewStories,
   subscribeProjectStoryModules,
-} from '@volter/editor-core/stories/story-registry';
-import { UI_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
-import type { WorkspaceDocumentContentProps } from '@volter/editor-core/workspace-document-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';
 
 import { UI_COMPONENTS_TITLE } from './ui-board-title';
 
@@ -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);
   },
 };
@@ -85,7 +85,6 @@ export function installUiBoard({ store, composite }: ComponentBoardContext): voi
           ...(story ? { story } : {}),
         };
       },
-      onActivate: () => store.setActiveViewportTab('edit'),
     },
     // A board NEVER steals focus — presence is answered asynchronously, so a
     // board that arrives late would otherwise yank the author off whatever

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

@@ -12,15 +12,15 @@
  * whose verdict is `'present'`.
  */
 
-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 { UI_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+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';
 
 export const uiComponentBoard: ComponentBoard = {

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);
+}