@volter/editor-game 0.5.65 → 0.5.66

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

@@ -43,9 +43,9 @@
  * mount ends — which is also when the edits themselves expire.
  */
 
-import { numericStyleValue } from '@volter/editor-core/authoring/css-numeric-style';
+import { numericStyleValue } from '@volter/editor-sdk/css-numeric-style';
 import { createEphemeralPersistence } from '../host/authoring/ephemeral-persistence';
-import { LIVE_ONLY_DESTINATION } from '@volter/editor-core/authoring/write-pipe';
+import { LIVE_ONLY_DESTINATION } from '@volter/editor-sdk/kit/write-pipe';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import { type JournalSubject, JsonHistoryResource } from '../host/history/json-history-resource';
 import { DomProjector, structuralDomIdentity } from '../host/projection/dom';

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

@@ -52,13 +52,13 @@ import {
   activeBreakpoint,
   setActiveBreakpoint,
   subscribeBreakpoint,
-} from '@volter/editor-core/authoring/breakpoint-state';
+} from '@volter/editor-sdk/kit/breakpoint-state';
 import { CompositeAuthoringAdapter } from '@volter/editor-core/authoring/composite-authoring-adapter';
-import { numericStyleValue, UNITLESS_NUMBER_PROPS } from '@volter/editor-core/authoring/css-numeric-style';
-import { beginEyedropperSession } from '@volter/editor-core/authoring/eyedropper-session';
-import { groupProperties } from '@volter/editor-core/components/inspector-property-grouping';
+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 { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
+import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
 import { groupIcon } from '@volter/editor-core/inspection/compose';
 import {
   GROUP_SECTION_ORDER,
@@ -66,10 +66,10 @@ import {
   type InspectionSection,
   PROPERTIES_SECTION_ID,
   PROPERTIES_SECTION_ORDER,
-} 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 { effectiveColorFromChain, getAvailableFonts } from '@volter/editor-core/ui-source/inspect';
-import type { OidEntry } from '@volter/editor-core/ui-source/oid-transform';
+import type { OidEntry } from '@volter/editor-react/source/oid-transform';
 import type { AuthoringAdapter, EditorNode, PropertyDescriptor } from '@volter/editor-project/adapter';
 import {
   AlignmentGrid,

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,23 +27,23 @@
  * 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';
+} from '@volter/editor-sdk/kit/write-pipe';
 import { guideClientEdges } from '@volter/editor-core/components/board-guides';
-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 { withProjectSourceHistory } from '@volter/editor-core/history/source-history-backend';
 import { DomProjector, oidDomIdentity, projectOidDom } from '../host/projection/dom';
@@ -52,7 +52,7 @@ import { storyDiscoveryUnavailable } from '@volter/editor-core/stories/story-dis
 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 { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import {
   browserOrInlineResolver,
   type ComputedStyleResolver,
@@ -62,7 +62,6 @@ import {
   findClassRuleSource,
   findEmptyContainers,
   firstPartyStylesheetFiles,
-  getCallSiteOid,
   getComponentProps,
   getComputedStyleValue,
   getDesignTokens,
@@ -70,8 +69,8 @@ import {
   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 { 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 {
@@ -79,9 +78,9 @@ import {
   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([
@@ -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,18 +40,17 @@ 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 { 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 { getProjectStoryRegions } from '@volter/editor-core/stories/project-story-regions';
 import { mountIsolatedStory, runStoryPlay } from '@volter/editor-core/stories/StoryPreviewMount';
@@ -60,7 +59,7 @@ 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,
@@ -68,15 +67,15 @@ import {
   whenProjectStoriesReady,
 } from '@volter/editor-core/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';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { registerWorkspaceDocumentRestorer } from '@volter/editor-core/workspace-document-restore';
-import { registerWorkspaceUtility } from '@volter/editor-core/workspace-utility-registry';
+import { registerWorkspaceUtility } from '@volter/editor-sdk/kit/workspace-utility-registry';
 import { fitPresentation } from '@volter/game-runtime/runtime/presentation';
 import { Button, fontMono, fontSizeVar, spaceVar } from '@volter/editor-sdk/widgets';
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
@@ -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

@@ -32,14 +32,14 @@ import {
 } 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 type { DocumentPreviewSource } from '@volter/editor-sdk/kit/document-preview-source';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
 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';
+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';
 
@@ -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 { 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 { UI_COMPONENTS_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+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/three/authoring/camera-runtime-inspector-section.tsx

@@ -10,7 +10,7 @@
  */
 
 import { getActiveCamera } from '@volter/editor-core/authoring/active-systems';
-import type { InspectorSectionProps } from '@volter/editor-core/inspector-section-registry';
+import type { InspectorSectionProps } from '@volter/editor-sdk/kit/inspector-section-registry';
 import type {
   AuthoringAdapter,
   CameraAdapter,

package/src/three/authoring/constraint-inspector-section.tsx

@@ -1,7 +1,7 @@
 import { instanceStampOf } from '@volter/editor-core/authoring/component-instance-root';
 import { setAuthoringSelection } from '@volter/editor-core/authoring/consumer-actions';
-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 ConstraintMark,
@@ -65,7 +65,7 @@ function typeLabel(type: ConstraintMark['config']['type']): string {
 }
 
 export function ConstraintStackSection({ adapter, nodeId }: InspectorSectionProps) {
-  const store = useEditorStore();
+  const store = useThreeEditorStore();
   const object = nodeId
     ? (store.objectMap.get(nodeId) ?? objectFor(adapter, nodeId) ?? null)
     : null;

package/src/three/authoring/model-asset-inspector-section.tsx

@@ -14,18 +14,17 @@ import {
 import { setAuthoringSelection } from '@volter/editor-core/authoring/consumer-actions';
 import { SourceObject3DAuthoringAdapter } from '@volter/editor-core/authoring/source-object3d-authoring-adapter';
 import { openToolDocument } from '@volter/editor-core/components/tool-documents';
-import { useEditorStore } from '@volter/editor-core/editor-runtime';
-import { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
+import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
 import {
   CONTRIBUTED_SECTION_ORDER,
   type InspectionSection,
   PROPERTIES_SECTION_ID,
-} 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 ProjectOutputProvenance,
   provenanceForProjectAsset,
-} from '@volter/editor-core/project-provenance';
+} from '@volter/editor-sdk/kit/project-provenance';
 import {
   getDocumentToolContributions,
   getGlobalToolContributions,
@@ -372,7 +371,6 @@ function SourceBody({
   readonly provenance: ProjectOutputProvenance | null;
   readonly provenanceLoaded: boolean;
 }) {
-  const store = useEditorStore();
   useSyncExternalStore(subscribeToolContributions, getGlobalToolContributions);
   const sourceContribution = provenance
     ? getDocumentToolContributions().find(
@@ -387,7 +385,7 @@ function SourceBody({
             type="button"
             variant="ghost"
             size="compact"
-            onClick={() => openToolDocument(store, sourceContribution.id)}
+            onClick={() => openToolDocument(sourceContribution.id)}
           >
             Open Source
           </Button>
@@ -647,10 +645,8 @@ const MODEL_SECTION_ORDER = {
   splat: CONTRIBUTED_SECTION_ORDER,
   geometry: CONTRIBUTED_SECTION_ORDER + 10,
   rig: CONTRIBUTED_SECTION_ORDER + 20,
-  // +25 is the RAGDOLL's, and it is `@volter/editor-game`'s
-  // (`contributions/ragdoll.inspector.tsx`, `export const order = 25`) — a
-  // contributed section's order is this same base plus what it declares, so
-  // the slot after Rig is held from there.
+  // A contributed section's order is this same base plus what it declares, so
+  // a package's section after Rig takes a slot in this gap.
   materials: CONTRIBUTED_SECTION_ORDER + 40,
   source: CONTRIBUTED_SECTION_ORDER + 50,
 } as const;

package/src/three/authoring/oid-source-persistence.ts

@@ -10,7 +10,7 @@
  * `constructed outside project source` for EVERY object in the world and the
  * creation-site writer can never fire once. The game's own source still says
  * exactly where each object came from — it says it in JSX
- * (`<mesh position={[0, 1, 0]}>`), and `vite-plugin-ui-oid.ts` already stamps
+ * (`<mesh position={[0, 1, 0]}>`), and `@volter/editor-react`'s `serving/ui-oid-plugin.ts` already stamps
  * that callsite onto the constructed object as `userData.oid`. This backend is
  * the other end of that stamp.
  *
@@ -37,16 +37,16 @@
 
 import { reportIngestSourceRefusal } from '../../host/authoring/ingest-source-persistence';
 import type { SourcePersistenceBackend } from '../../host/authoring/source-persistence-backend';
-import { LIVE_ONLY_DESTINATION } from '@volter/editor-core/authoring/write-pipe';
+import { LIVE_ONLY_DESTINATION } from '@volter/editor-sdk/kit/write-pipe';
 import type { ChannelValue } from '@volter/editor-core/creation-site-edit';
 import { channelFor } from '@volter/editor-core/creation-site-edit';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { editorIsAuthoring } from '@volter/editor-core/editor-session-mode';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { editorIsAuthoring } from '@volter/editor-sdk/kit/editor-session-mode';
 import type { HistoryService } from '@volter/editor-core/history/history-service';
 import { withProjectSourceHistory } from '@volter/editor-core/history/source-history-backend';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
-import type { OidEntry } from '@volter/editor-core/ui-source/oid-transform';
-import { bodyPlacedChannel, physicsRefusal } from '@volter/editor-core/ui-source/r3f-physics-binding';
+import type { OidEntry } from '@volter/editor-react/source/oid-transform';
+import { bodyPlacedChannel, physicsRefusal } from '@volter/editor-react/source/r3f-physics-binding';
 import type { SourceWriteBackend } from '@volter/editor-core/ui-source/source-write-backend';
 import { sourceWriteBackendIfPrimed } from '@volter/editor-core/ui-source/tier-source-write-backend';
 import type { NodeCreationSite, WriteAck } from '@volter/editor-project/adapter';

package/src/three/authoring/r3f-design-session.ts

@@ -1,4 +1,4 @@
-import { onAssetReload } from '@volter/editor-core/project-asset-refresh';
+import { onAssetReload } from '@volter/editor-sdk/kit/project-asset-refresh';
 
 /**
  * R3F design session (W4) — mounts an entry-based R3F three world at DESIGN
@@ -71,7 +71,12 @@ import {
   collaborationSnapshot,
   subscribeCollaborationRevision,
 } from '@volter/editor-core/collaboration-client';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import {
+  describeModuleFetch,
+  diagnoseModuleFetch,
+  failedImportEntry,
+} from '@volter/editor-sdk/kit/module-fetch-diagnosis';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import { adjudicateThreeEntry } from '../../host/entry-adjudication';
 import { onPlayTransitionSettled } from '@volter/editor-core/live-transition';
@@ -132,12 +137,12 @@ import {
   parseEditModeManifest,
   queueEditModeRebuild,
 } from '@volter/editor-core/authoring/edit-mode-authoring';
-import { liveGestureActive, whenLiveGestureIdle } from '@volter/editor-core/authoring/live-gesture-lock';
+import { liveGestureActive, whenLiveGestureIdle } from '@volter/editor-sdk/kit/live-gesture-lock';
 import {
   addMountFailureReport,
   clearMountFailureReport,
   formatMountFailureMessage,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} from '@volter/editor-sdk/kit/mount-failure-report';
 import { SelectionRemountHandoff } from '../../host/authoring/selection-remount-handoff';
 import {
   type RefreshSource,
@@ -145,6 +150,7 @@ import {
 } from '../../host/authoring/source-refresh-revisions';
 import type { R3fSourceAuthoringAdapter } from './r3f-source-authoring-adapter';
 import { isThreeScene } from './three-scene-identity';
+import { evictDreiCaches } from '../drei-asset-caches';
 
 // The world root's stage is recreated when the workspace changes.
 // The outgoing panel restores the editor scene and the incoming panel loads
@@ -178,6 +184,12 @@ export function unresolvedDesignEntryError(
 export function reportDesignMountFailure(worldId: string, err: unknown): string {
   const message = formatMountFailureMessage(err);
   editorConsole.error(`[r3f-design] world "${worldId}" failed to mount: ${message}`, 'authoring');
+  const entry = failedImportEntry(message);
+  if (entry) {
+    void diagnoseModuleFetch(entry).then((diagnosis) =>
+      editorConsole.error(`[r3f-design] world "${worldId}": ${describeModuleFetch(diagnosis)}`, 'authoring'),
+    );
+  }
   addMountFailureReport({
     worldId,
     kind: 'three',
@@ -1042,9 +1054,11 @@ export async function mountR3FDesignSession(
     }, 80);
   };
 
-  const stopAssetReload = onAssetReload(() => {
-    writeStamp += 1;
-    scheduleRemount();
+  const stopAssetReload = onAssetReload((paths) => {
+    void evictDreiCaches(paths).then(() => {
+      writeStamp += 1;
+      scheduleRemount();
+    });
   });
 
   const hot = import.meta.hot;