@volter/editor-game 0.5.66 → 0.5.68

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

@@ -34,14 +34,14 @@ import {
   isOccurrenceId,
   ownOidOf,
   rendersSameSourceElement,
-} from '@volter/editor-core/authoring/component-instance-root';
+} from '@volter/editor-threejs/kit/authoring/component-instance-root';
 import { beginLiveGesture, endLiveGesture } from '@volter/editor-sdk/kit/live-gesture-lock';
 import { createStructWritePipe, type StructOpOptions } from '../../host/authoring/struct-write-pipe';
 import {
   CollapsedHierarchyView,
   readLocalTransform,
   StoreSelectionAdoption,
-} from '@volter/editor-core/authoring/three-projection-core';
+} from '@volter/editor-threejs/kit/authoring/three-projection-core';
 import {
   clipboardOutcome,
   LIVE_ONLY_ACK,
@@ -51,15 +51,15 @@ import {
   type WriteAck,
   type WriteResolution,
 } from '@volter/editor-sdk/kit/write-pipe';
-import { componentStatesProvider } from '@volter/editor-core/component-states-registry';
-import { openProjectToolDocument } from '@volter/editor-core/components/project-tool-documents';
+import { componentStatesProvider } from '@volter/editor-sdk/kit/component-states-registry';
+import { openProjectToolDocument } from '@volter/editor-sdk/kit/components/project-tool-documents';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import {
   replaceProjectSource,
   withProjectSourceHistory,
-} from '@volter/editor-core/history/source-history-backend';
-import { warnGuessedFromText } from '@volter/editor-core/inference-diagnostics';
+} from '@volter/editor-sdk/kit/history/source-history-backend';
+import { warnGuessedFromText } from '@volter/editor-sdk/kit/inference-diagnostics';
 import {
   extractedHint,
   extractNoBackendHint,
@@ -79,8 +79,8 @@ import {
   type SourceOidIdentity,
   sourceOidIdentity,
   ThreeProjector,
-} from '@volter/editor-core/projection/three';
-import { getStorageBackend } from '@volter/editor-core/storage/index';
+} from '@volter/editor-threejs/kit/projection/three';
+import { getStorageBackend } from '@volter/editor-sdk/kit/storage/index';
 import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import {
   type ComponentPropSpec,
@@ -100,7 +100,7 @@ import type { ReparentChannel, ReparentRebase } from '@volter/editor-react/sourc
 import type {
   SourceWriteBackend,
   StructReparentContext,
-} from '@volter/editor-core/ui-source/source-write-backend';
+} from '@volter/editor-sdk/kit/ui-source/source-write-backend';
 import {
   analyzeJsxAttributes,
   type DuplicateRewrite,
@@ -598,7 +598,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     // session adopts this scene and `syncAdoptedObjectMap` keeps that index in
     // step — so picking reads the map the viewport itself draws from.
     this.projector = new ThreeProjector(this.identity, { pickScope: 'store-object-map' });
-    this.writeBackend = withProjectSourceHistory(options.writeBackend, store.projectHistory);
+    this.writeBackend = withProjectSourceHistory(options.writeBackend, store.shell.projectHistory);
     this.capabilities = {
       transform: true,
       inspectorFields: true,
@@ -613,7 +613,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
         save: async () => undefined,
         destination: options.entryPath,
         lastError: () => {
-          const error = store.projectHistory?.getSnapshot().lastError;
+          const error = store.shell.projectHistory?.getSnapshot().lastError;
           if (!error) return null;
           return error.code === 'apply-failed' ||
             error.code === 'compensation-failed' ||
@@ -624,7 +624,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       };
     }
     this.selectionState = new StoreSelectionAdoption({
-      store,
+      store: store.shell,
       owns: (id) => this.byId.has(id),
       initial: [this.documentNodeId],
     });
@@ -638,7 +638,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       documentNodeId: this.documentNodeId,
       rootIds: this.definitionRootIds,
     });
-    this.stories = componentStatesProvider('three', store, (id) => this.storyComponent(id));
+    this.stories = componentStatesProvider('three', store.shell, (id) => this.storyComponent(id));
     void this.refreshSourceState();
   }
 
@@ -772,7 +772,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       // child subscriptions when `replaceChild` swaps this adapter in (it used
       // to bind them once at subscribe time, which is why this line carried a
       // note about not being able to rely on the seam).
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     });
   }
 
@@ -790,9 +790,9 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     // Keep selection inside the same authoritative index the hierarchy,
     // picker, and gizmo now consume; otherwise TransformControls can remain
     // attached to a ghost id after the object has disappeared from every row.
-    const retainedSelection = [...this.store.selectedEntityIds].filter((id) => map.has(id));
-    if (retainedSelection.length !== this.store.selectedEntityIds.size) {
-      this.store.selectMultiple(retainedSelection);
+    const retainedSelection = [...this.store.shell.selectedEntityIds].filter((id) => map.has(id));
+    if (retainedSelection.length !== this.store.shell.selectedEntityIds.size) {
+      this.store.shell.selectMultiple(retainedSelection);
     }
   }
 
@@ -888,7 +888,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     this.pendingCreatedSelection = {
       parentId,
       before: new Set(this.hierarchy.node(parentId)?.childIds ?? []),
-      selectionAtWrite: new Set(this.store.selectedEntityIds),
+      selectionAtWrite: new Set(this.store.shell.selectedEntityIds),
       ...(afterId ? { afterId } : {}),
     };
   }
@@ -897,7 +897,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const pending = this.pendingCreatedSelection;
     this.pendingCreatedSelection = null;
     if (!pending) return;
-    const current = this.store.selectedEntityIds;
+    const current = this.store.shell.selectedEntityIds;
     const unchanged =
       current.size === pending.selectionAtWrite.size &&
       [...current].every((id) => pending.selectionAtWrite.has(id));
@@ -905,11 +905,11 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const children = this.hierarchy.node(pending.parentId)?.childIds ?? [];
     const copy = pending.afterId ? this.childWrittenAfter(children, pending.afterId) : null;
     if (copy) {
-      this.store.selectMultiple([copy]);
+      this.store.shell.selectMultiple([copy]);
       return;
     }
     const fresh = children.filter((id) => !pending.before.has(id));
-    if (fresh.length > 0) this.store.selectMultiple(fresh);
+    if (fresh.length > 0) this.store.shell.selectMultiple(fresh);
   }
 
   /** Among `children`, the one whose callsite is the FIRST after `afterId`'s
@@ -969,7 +969,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       this.oidIndex = nextIndex;
       this.sources = next;
       this.reflectionProbeAvailable = reflectionProbeAvailable;
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     } catch {
       // Honest degradation: nodes stay live-projected (read-only) if the
       // index/source can't be fetched.
@@ -1107,7 +1107,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const tag = callsite?.tag ?? 'component';
     if (!oid || !definitionOid || !callsite) return forkUnavailableHint(tag);
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     if (!backend?.forkComponent || !backend.readSource || !backend.applySource || !history) {
       return forkNoBackendHint(tag);
     }
@@ -1169,7 +1169,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const tag = callsite?.tag ?? 'element';
     if (!oid || !callsite) return extractUnavailableHint(tag);
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     if (!backend?.extractComponent || !backend.readSource || !backend.applySource || !history) {
       return extractNoBackendHint(tag);
     }
@@ -1587,7 +1587,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     object3D: (id) => {
       return this.transformObject(id);
     },
-    idForObject3D: (object) => this.idByObject.get(object) ?? null,
+    idForObject3D: (object: THREE.Object3D) => this.idByObject.get(object) ?? null,
   };
 
   /** The same OID source address every guarded JSX write uses, exposed for
@@ -2130,7 +2130,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
   private pipedSourceTokenWrite(write: () => Promise<boolean>): Promise<WriteAck> {
     return runWritePipe({
       resolve: (): WriteResolution =>
-        this.writeBackend && this.store.projectHistory
+        this.writeBackend && this.store.shell.projectHistory
           ? {
               reaches: 'writer',
               anchorKind: 'construction-literal',
@@ -2386,7 +2386,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       if (channel === 'position') object.position.fromArray(edit.position);
       else if (channel === 'rotation') object.quaternion.fromArray(edit.quaternion);
       else object.scale.fromArray(edit.scale);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     };
 
     const backend = selectedBackend ?? this.writeBackend;
@@ -2467,7 +2467,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     } else {
       await run(backend);
     }
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     return persisted;
   }
 
@@ -2689,35 +2689,31 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
    * A mixed explicit+automatic body therefore degrades instead of binding a
    * source tag to the wrong native shape. */
   /**
-   * The physics adapter ONLY while a world is actually stepping.
+   * A body's live colliders or joints, read for the Inspector.
    *
-   * The engine's slot refuses by name when no `<RapierPhysicsBridge>` is
-   * live, and that is right for its declared members: they are gesture-rate
-   * ACTIONS, so a fabricated empty would be a lie about a sim you just tried
-   * to edit (`world3d-react/rapier-physics-bridge.tsx`). The two binding
-   * readers below break that premise — they run from `properties()`, which
-   * the Inspector calls on EVERY RENDER — so selecting a physics object in
-   * edit mode threw the refusal up through React and took the whole editor
-   * surface down with it, which then swallowed the edits the human was
-   * making (runhuman pass 96: added jump pads "didn't add", a delete "doesn't
-   * delete", both actually present after a reload).
-   *
-   * So the presence question is asked POSITIVELY, before the call. A binding
-   * ties a source tag to a LIVE native handle; with nothing stepping there
-   * are no handles, and none is the true answer rather than a refusal. Every
-   * gesture-rate call keeps going straight at the slot and stays loud.
+   * These run from `properties()`, which the Inspector calls on EVERY RENDER,
+   * so a physics adapter that refuses a read (no world live yet, a game's own
+   * adapter that throws) must yield no rows rather than take the editor surface
+   * down with it (runhuman pass 96: a throw here swallowed the edits the human
+   * was making). The design world's own `<Physics>` holds real colliders in
+   * Edit even though it never steps, so the read is not gated on Play, the way
+   * a selected body shows its collider in Unity's and Godot's editors.
    */
-  private steppingPhysics(): PhysicsAdapter | null {
-    if (this.store.playState === 'stopped') return null;
-    return this.options.physics?.() ?? null;
+  private physicsRead<T>(read: (physics: PhysicsAdapter) => readonly T[] | undefined): T[] {
+    const physics = this.options.physics?.();
+    if (!physics) return [];
+    try {
+      return [...(read(physics) ?? [])];
+    } catch {
+      return [];
+    }
   }
 
   private colliderBindingsOf(id: string): ColliderSourceBinding[] {
     const rigidBodyOid = this.rigidBodyOidOf(id);
-    const physics = this.steppingPhysics();
-    if (!rigidBodyOid || !physics?.colliders) return [];
+    if (!rigidBodyOid) return [];
     const sourceOids = this.explicitColliderOids(rigidBodyOid);
-    const snapshots = [...physics.colliders(id)];
+    const snapshots = this.physicsRead((physics) => physics.colliders?.(id));
     if (sourceOids.length === 0 || sourceOids.length !== snapshots.length) return [];
     const bindings: ColliderSourceBinding[] = [];
     for (let index = 0; index < sourceOids.length; index += 1) {
@@ -2769,12 +2765,21 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
         : binding.sourceTag === 'CapsuleCollider'
           ? ['Half height', 'Radius']
           : ['Radius'];
+    const args = this.attrsOfOid(binding.sourceOid)?.find((attr) => attr.name === 'args');
+    const readonlyReason = binding.writable
+      ? null
+      : !this.writeBackend?.writeProp
+        ? 'Source writes are unavailable in this session.'
+        : !args?.isLiteral
+          ? `\`<${binding.sourceTag} args>\` is an expression in source, not a number list; edit it there.`
+          : 'This size is computed while the game runs; edit it in source.';
     return labels.map((label, index) => ({
       path: `${COLLIDER_ARG_PATH_PREFIX}${encodeURIComponent(binding.sourceOid)}.arg.${index}`,
       label,
       type: 'number' as const,
       group: humanizeIdentifier(binding.sourceTag),
       readonly: !binding.writable,
+      ...(readonlyReason ? { readonlyReason } : {}),
     }));
   }
 
@@ -2784,9 +2789,8 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
   private jointBindingsOf(id: string): JointSourceBinding[] {
     const rigidBodyOid = this.rigidBodyOidOf(id);
     const entry = rigidBodyOid ? this.oidIndex.get(rigidBodyOid) : undefined;
-    const physics = this.steppingPhysics();
-    if (!rigidBodyOid || !entry?.jointBindings || !physics?.joints) return [];
-    const snapshots = [...physics.joints(id)];
+    if (!rigidBodyOid || !entry?.jointBindings) return [];
+    const snapshots = this.physicsRead((physics) => physics.joints?.(id));
     if (entry.jointBindings.length !== snapshots.length) return [];
     const result: JointSourceBinding[] = [];
     for (let index = 0; index < entry.jointBindings.length; index += 1) {
@@ -2803,7 +2807,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
           !!source.paramRanges &&
           !!this.writeBackend?.readSource &&
           !!this.writeBackend.applySource &&
-          !!this.store.projectHistory,
+          !!this.store.shell.projectHistory,
       });
     }
     return result;
@@ -2976,7 +2980,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
             () =>
               !!this.writeBackend?.readSource &&
               !!this.writeBackend.applySource &&
-              !!this.store.projectHistory,
+              !!this.store.shell.projectHistory,
           ),
         ),
       });
@@ -3059,7 +3063,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     rawValue: number,
   ): Promise<boolean> {
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     const token = binding.source.fields[field];
     const source = this.sources.get(binding.sourceFile);
     if (
@@ -3077,7 +3081,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const value = normalizeParticleField(field, rawValue);
     const previous = (binding.shape as unknown as Record<string, unknown>)[field];
     previewParticleEdit({ binding, field, value });
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     const next = `${source.slice(0, token.start)}${fmt(value)}${source.slice(token.end)}`;
     try {
       await replaceProjectSource(backend, history, {
@@ -3090,7 +3094,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       return true;
     } catch (error) {
       (binding.shape as unknown as Record<string, unknown>)[field] = previous;
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       throw error;
     }
   }
@@ -3108,7 +3112,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const canWrite =
       !!this.writeBackend?.readSource &&
       !!this.writeBackend.applySource &&
-      !!this.store.projectHistory;
+      !!this.store.shell.projectHistory;
     return lods.map((lod, index) => {
       const sourceOid = ownOidOf(lod) ?? authoringOidOf(lod);
       const entry = sourceOid ? this.oidIndex.get(sourceOid) : undefined;
@@ -3234,7 +3238,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     rollback: () => void,
   ): Promise<boolean> {
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     const file = binding.sourceFile;
     const source = file ? this.sources.get(file) : undefined;
     if (
@@ -3249,7 +3253,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       return false;
     }
     preview();
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     const next = `${source.slice(0, token.start)}${fmt(value)}${source.slice(token.end)}`;
     try {
       await replaceProjectSource(backend, history, { file, source: next, label });
@@ -3258,7 +3262,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       return true;
     } catch (error) {
       rollback();
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       throw error;
     }
   }
@@ -3311,7 +3315,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     params: readonly R3fJointLiteral[],
   ): Promise<boolean> {
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     const source = this.sources.get(binding.sourceFile);
     const before = binding.source.params;
     const ranges = binding.source.paramRanges;
@@ -3490,7 +3494,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       !token ||
       !this.writeBackend?.readSource ||
       !this.writeBackend.applySource ||
-      !this.store.projectHistory
+      !this.store.shell.projectHistory
     ) {
       return false;
     }
@@ -3797,7 +3801,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     rollback: () => void,
   ): Promise<boolean> {
     const backend = this.writeBackend;
-    const history = this.store.projectHistory;
+    const history = this.store.shell.projectHistory;
     const text = this.sources.get(source.file);
     if (
       !backend ||
@@ -3817,7 +3821,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       replacement = fmt(value);
     }
     preview();
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     const next = `${text.slice(0, token.start)}${replacement}${text.slice(token.end)}`;
     try {
       await replaceProjectSource(backend, history, { file: source.file, source: next, label });
@@ -3826,7 +3830,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       return true;
     } catch (error) {
       rollback();
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       throw error;
     }
   }
@@ -3900,7 +3904,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const echoKey = this.echoKey(id, 'visible');
     object.visible = value;
     this.valueEcho.set(echoKey, value);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     try {
       const result = await backend.writeProp(oid, 'visible', this.serializeValue(value), {
         addIfMissing: true,
@@ -3909,7 +3913,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       if (result.dynamic) this.dynamicPaths.add(echoKey);
       object.visible = previous;
       this.valueEcho.delete(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] visibility write refused for oid "${oid}": ` +
           `${result.dynamic ? 'dynamic expression (guarded)' : (result.error ?? 'no change')} — reverting.`,
@@ -3918,7 +3922,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     } catch (error) {
       object.visible = previous;
       this.valueEcho.delete(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] visibility write failed for oid "${oid}": ${String(error)} — reverting.`,
       );
@@ -3942,7 +3946,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       );
       if (!field || field.type === 'asset') return;
       applyTypedField(object, firstMaterial(object), field, value);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     },
     properties: (id): PropertyDescriptor[] => {
       if (id === this.documentNodeId) {
@@ -4147,7 +4151,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       if (path === 'locked') {
         if (value) this.lockedIds.add(id);
         else this.lockedIds.delete(id);
-        this.store.notifyIngestEdit();
+        this.store.shell.notifyIngestEdit();
         return;
       }
       const typedField = typedFieldForPath(
@@ -4395,7 +4399,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     this.valueEcho.delete(this.echoKey(id, path));
     const res = await this.writeBackend.removeProp(oid, prop);
     if (!res.changed) {
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] revert refused/no-op for oid "${oid}" prop "${prop}": ` +
           `${res.dynamic ? 'dynamic expression (guarded)' : (res.error ?? 'no change')}`,
@@ -4427,7 +4431,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     }
     const echoKey = this.echoKey(id, path);
     this.valueEcho.set(echoKey, value);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     let res: Awaited<ReturnType<NonNullable<SourceWriteBackend['writeProp']>>>;
     try {
       res = await this.writeBackend.writeProp(oid, prop, this.serializeValue(value), {
@@ -4435,7 +4439,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       });
     } catch (error) {
       this.valueEcho.delete(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] prop write failed for oid "${oid}" prop "${prop}": ${String(error)}`,
       );
@@ -4444,7 +4448,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     if (!res.changed) {
       this.valueEcho.delete(echoKey);
       if (res.dynamic) this.dynamicPaths.add(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] prop write refused/no-op for oid "${oid}" prop "${prop}": ` +
           `${res.dynamic ? 'dynamic expression (guarded)' : (res.error ?? 'no change')}`,
@@ -4470,7 +4474,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     }
     const echoKey = `${id}|${path}`;
     this.valueEcho.set(echoKey, value);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     let res: Awaited<ReturnType<NonNullable<SourceWriteBackend['writeProp']>>>;
     try {
       res = await this.writeBackend.writeProp(oid, prop, this.serializeValue(value), {
@@ -4488,7 +4492,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       });
     } catch (error) {
       this.valueEcho.delete(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] prop write failed for oid "${oid}" prop "${prop}": ${String(error)}`,
       );
@@ -4497,7 +4501,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     if (!res.changed) {
       this.valueEcho.delete(echoKey);
       if (res.dynamic) this.dynamicPaths.add(echoKey);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] prop write refused/no-op for oid "${oid}" prop "${prop}": ` +
           `${res.dynamic ? 'dynamic expression (guarded)' : (res.error ?? 'no change')}`,
@@ -4620,7 +4624,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     const applied = applyTypedField(object, material, field, value);
     if (applied !== null) {
       this.valueEcho.set(`${id}|${field.path}`, readTypedField(object, material, field));
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     }
     return runWritePipe({
       resolve: (): WriteResolution =>
@@ -4656,7 +4660,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       const before = readTypedField(object, material, field);
       const applied = applyTypedField(object, material, field, value);
       if (applied === null) return false;
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       const wrote = await this.writeJsxProp(
         id,
         `${JSX_PATH_PREFIX}${routedProp}`,
@@ -4665,7 +4669,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       );
       if (!wrote && before !== null && before !== undefined) {
         applyTypedField(object, material, field, before);
-        this.store.notifyIngestEdit();
+        this.store.shell.notifyIngestEdit();
       }
       return wrote;
     }
@@ -4683,7 +4687,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     if (applied === null) return false;
     const echoKey = `${id}|${field.path}`;
     this.valueEcho.set(echoKey, readTypedField(object, material, field));
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     let res: Awaited<ReturnType<NonNullable<SourceWriteBackend['writeProp']>>>;
     try {
       res = await this.writeBackend.writeProp(oid, field.prop, this.serializeValue(applied), {
@@ -4692,7 +4696,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     } catch (error) {
       this.valueEcho.delete(echoKey);
       await this.refreshSourceState();
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       console.warn(
         `[R3fSourceAuthoringAdapter] typed "${field.prop}" write failed for oid "${oid}": ${String(error)}`,
       );
@@ -4723,7 +4727,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       // next remount disagreed — runhuman pass 41). The narration goes to the
       // EDITOR console: a raw console.warn is invisible in the product.
       if (before !== null && before !== undefined) applyTypedField(object, material, field, before);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       editorConsole.warn(
         `“${field.prop}” on “${this.hierarchy.node(id)?.label ?? id}” is ${
           res.dynamic
@@ -5786,7 +5790,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
           return false;
         }
         if (res.warning) showTransientHint(res.warning);
-        this.store.notifyIngestEdit();
+        this.store.shell.notifyIngestEdit();
         return true;
       },
       'reparent',
@@ -5808,7 +5812,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     report: (message) => console.warn(`[R3fSourceAuthoringAdapter] ${message}`),
     noWriterReason: NO_SOURCE_WRITER_REASON,
     backend: () => this.writeBackend,
-    onChanged: () => this.store.notifyIngestEdit(),
+    onChanged: () => this.store.shell.notifyIngestEdit(),
   });
 
   /**
@@ -5894,8 +5898,8 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
     ack: Promise<WriteAck>,
   ): Promise<WriteAck> {
     const removed = new Set(ids);
-    const wasSelected = [...this.store.selectedEntityIds].some((id) => removed.has(id));
-    if (wasSelected) this.store.selectMultiple([]);
+    const wasSelected = [...this.store.shell.selectedEntityIds].some((id) => removed.has(id));
+    if (wasSelected) this.store.shell.selectMultiple([]);
     return ack;
   }
 
@@ -5923,7 +5927,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
   }
 
   subscribe(listener: () => void): () => void {
-    return this.store.subscribe(listener);
+    return this.store.shell.subscribe(listener);
   }
 
   get documentId(): string {

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

@@ -1,9 +1,10 @@
-import { useThreeEditorStore } from '@volter/editor-core/editor-runtime';
+import { threeObject } from '@volter/editor-threejs/adapter/three-contract';
 import type { InspectorSectionProps } from '@volter/editor-sdk/kit/inspector-section-registry';
 import type { AuthoringAdapter, EditorNode } from '@volter/editor-project/adapter';
 import { type ReflectionProbeSnapshot, reflectionProbeOf } from '@volter/threejs-runtime/adapter/reflection-probe';
 import { Button, EditorBanner, FieldGroup, FieldRow, Text } from '@volter/editor-sdk/widgets';
 import { useSyncExternalStore } from 'react';
+import { useThreeEditorStore } from '@volter/editor-threejs/kit/three-state';
 
 export function matches(node: EditorNode | null, adapter: AuthoringAdapter): boolean {
   void adapter;
@@ -22,7 +23,7 @@ const EMPTY_SNAPSHOT: ReflectionProbeSnapshot = { status: 'idle', lastCapturedAt
 export function ReflectionProbeCaptureSection({ adapter, nodeId }: InspectorSectionProps) {
   const store = useThreeEditorStore();
   const object = nodeId
-    ? (store.objectMap.get(nodeId) ?? adapter.hierarchy.object3D?.(nodeId))
+    ? (store.objectMap.get(nodeId) ?? threeObject(adapter.hierarchy, nodeId))
     : null;
   const probe = reflectionProbeOf(object);
   const snapshot = useSyncExternalStore(