@volter/editor-threejs 0.5.202 → 0.5.204

package/src/kit/live-module-source.ts

@@ -1,7 +1,7 @@
 /**
  * The module→`Object3D` step, IN THE BROWSER — the live twin of the bake
  * lane's Node-side `module-source.ts`
- * (`catalog/project-source/src/tools/module-source.ts`), and deliberately the
+ * (`catalog/project-source/editor/tools/module-source.ts`), and deliberately the
  * SAME contract: a project TypeScript module whose export builds a native
  * `THREE.Object3D`. `project.bake.module` / `project.bake.preview` /
  * the editor's `screenshot <module>` command already define that contract; the live modeling
@@ -25,7 +25,7 @@
  * else falls back to the ordinary source viewer.
  */
 
-import { liveModuleImportUrl } from '@volter/editor-sdk/session/project-module-url';
+import { liveModuleImportUrl } from '@volter/sdk/session/project-module-url';
 import type * as THREE from 'three';
 
 /** Why this module is not a live model module — the sentence the document
@@ -100,7 +100,7 @@ export function pickLiveModuleExport(
 
 /**
  * THE TWO SHAPES A MODEL MODULE MAY PRODUCE — the same pair the Node twin
- * normalizes (`catalog/project-source/src/tools/module-source.ts`'s
+ * normalizes (`catalog/project-source/editor/tools/module-source.ts`'s
  * `asModuleBuild`), because a module that bakes must open and a module that
  * opens must bake:
  *

package/src/kit/model-thumbnail.ts

@@ -12,7 +12,7 @@
  * - Self-cleaning: each loaded object is disposed after the thumbnail is captured.
  */
 
-import { registerAssetThumbnailRenderer } from '@volter/editor-sdk/kit/asset-thumbnails';
+import { registerAssetThumbnailRenderer } from '@volter/sdk/kit/asset-thumbnails';
 import type { SparkRenderer, SplatMesh } from '@sparkjsdev/spark';
 import { markHostRenderer } from '@volter/editor-threejs/viewport/renderer-ownership';
 import { loadSplat } from '@volter/editor-threejs/asset-loaders';
@@ -524,7 +524,7 @@ if (import.meta.hot) {
 }
 
 /** This renderer, as the asset browser's thumbnail for every model format it
- *  loads (`@volter/editor-sdk/kit/asset-thumbnails`). */
+ *  loads (`@volter/sdk/kit/asset-thumbnails`). */
 export function registerModelThumbnails(): () => void {
   return registerAssetThumbnailRenderer({
     accepts: (url) => modelThumbnailFormat(url) !== undefined,

package/src/kit/play-camera-flight.ts

@@ -1,13 +1,13 @@
 /**
  * THE PLAY ENTRY CAMERA FLIGHT — the Three integration's half of Play's immersive entry
- * (`@volter/editor-sdk/kit/play-camera-flight`). The kit's transition owns the phases and the
+ * (`@volter/sdk/kit/play-camera-flight`). The kit's transition owns the phases and the
  * chrome; this owns the camera: the editor viewport flies along a Catmull-Rom spline from its
  * preview pose to the AUTHORED game camera's pose, retargets to the game's live camera once it
  * boots so the cross-fade is pixel-continuous, and restores the preview pose when Play ends. The
  * flight reads the authored viewport's rig through the viewport door and rides its frame hook, so
  * flight pacing rides the editor's own frame clock.
  */
-import { registerPlayCameraFlight, type LiveCameraLookup } from '@volter/editor-sdk/kit/play-camera-flight';
+import { registerPlayCameraFlight, type LiveCameraLookup } from '@volter/sdk/kit/play-camera-flight';
 import { onViewportFrame, viewportRig } from '../viewport-door';
 import * as THREE from 'three';
 import { threeStoreForHost } from './three-state';

package/src/kit/projection/three.ts

@@ -37,7 +37,7 @@
  * every consumer uses, and it takes the `Object3D` this index resolves.
  */
 
-import type { EditorNode } from '@volter/editor-project/adapter';
+import type { EditorNode } from '@volter/project/adapter';
 import { isEditorOwnedObject } from '@volter/editor-threejs/viewport/editor-layers';
 import { constraintsOf } from '@volter/editor-threejs/adapter/constraint';
 import {
@@ -52,9 +52,9 @@ import { authoringOidOf, occurrenceId } from '../authoring/component-instance-ro
 import { raycastCandidates, raycastPick } from '../authoring/viewport-raycast';
 import type { EditorShellStore } from '../editor-shell-store';
 import { entityIdOf, stampEntityId } from '../entity-object';
-import type { ProjectedNode, Projection } from '@volter/editor-sdk/kit/projection-types';
+import type { ProjectedNode, Projection } from '@volter/sdk/kit/projection-types';
 
-export type { ProjectedNode, Projection } from '@volter/editor-sdk/kit/projection-types';
+export type { ProjectedNode, Projection } from '@volter/sdk/kit/projection-types';
 
 /** One projected authoring node over a live three graph. */
 export type ThreeNode = ProjectedNode<THREE.Object3D>;

package/src/kit/scene-document-viewport.ts

@@ -1,12 +1,12 @@
 /**
- * THE SCENE'S VIEWPORT (`@volter/editor-sdk/kit/document-viewports`): the world
+ * THE SCENE'S VIEWPORT (`@volter/sdk/kit/document-viewports`): the world
  * stage draws the Scene through the session store's own camera, shading and
  * grid, and frames the shell's selection. It keeps no selection of its own, so a
  * view's selection is the shell's.
  */
-import type { DocumentViewport } from '@volter/editor-sdk/kit/document-viewports';
+import type { DocumentViewport } from '@volter/sdk/kit/document-viewports';
 import type { EditorShellStore } from './editor-shell-store';
-import { viewGridVisible } from '@volter/editor-sdk/kit/viewport-presentation';
+import { viewGridVisible } from '@volter/sdk/kit/viewport-presentation';
 
 type ShadingMode = Parameters<EditorShellStore['setShadingMode']>[0];
 

package/src/kit/spatial-handle-visuals.ts

@@ -4,7 +4,7 @@ import type {
   SpatialDragHandle,
   SpatialHandleGuide,
   SpatialHandleLayer,
-} from '@volter/editor-project/adapter';
+} from '@volter/project/adapter';
 import { EDITOR_LAYER } from '@volter/editor-threejs/viewport/editor-layers';
 import * as THREE from 'three';
 

package/src/kit/stories/three-story-model.ts

@@ -14,8 +14,8 @@
  */
 
 import type * as THREE from 'three';
-import { getProjectStoryRegions } from '@volter/editor-sdk/kit/stories/project-story-regions';
-import { declaredStoryMedium, reportUndeclaredStoryMedium } from '@volter/editor-sdk/kit/stories/story-declared-medium';
+import { getProjectStoryRegions } from '@volter/sdk/kit/stories/project-story-regions';
+import { declaredStoryMedium, reportUndeclaredStoryMedium } from '@volter/sdk/kit/stories/story-declared-medium';
 
 /**
  * Whether a mounted story's root wrapper actually holds `three` content.

package/src/kit/three-canvas-render.ts

@@ -1,13 +1,13 @@
 /**
  * The Three set's canvases, rendered at a caller's scale
- * (`@volter/editor-sdk/kit/canvas-frames`): the Scene viewport's presented frame
+ * (`@volter/sdk/kit/canvas-frames`): the Scene viewport's presented frame
  * or a fresh render of it, and an Object3D document's presented frame or an
  * offscreen render of its subject. The editor-chrome photograph asks here, so a
  * 2x capture of a viewport gets a 2x render rather than a 1x one stretched.
  */
-import { registerCanvasRender } from '@volter/editor-sdk/kit/canvas-frames';
+import { registerCanvasRender } from '@volter/sdk/kit/canvas-frames';
 import { allObject3DDocumentSessions } from './authoring/object3d-document-session-registry';
-import { liveCanvasFrame } from '@volter/editor-sdk/kit/live-canvas-frame';
+import { liveCanvasFrame } from '@volter/sdk/kit/live-canvas-frame';
 import { threeStoreForHost } from './three-state';
 
 async function imageOf(dataUrl: string): Promise<HTMLImageElement> {

package/src/kit/three-hierarchy-row-media.ts

@@ -1,10 +1,10 @@
 /**
  * The Three integration's answers to the hierarchy panel's row questions
- * (`@volter/editor-sdk/kit/hierarchy-row-media`): an instanced mesh's row names the units it
+ * (`@volter/sdk/kit/hierarchy-row-media`): an instanced mesh's row names the units it
  * draws, a node's component marks come off its `Object3D`, and the store's Three half logs which
  * projected parents its object map changed so the panel can patch rows.
  */
-import { registerHierarchyRowMedia } from '@volter/editor-sdk/kit/hierarchy-row-media';
+import { registerHierarchyRowMedia } from '@volter/sdk/kit/hierarchy-row-media';
 import { entityObject3D } from './entity-object';
 import { markReaderFor } from './hierarchy-mark-reader';
 import { instancedRowDetail } from './instanced-presentation';

package/src/kit/three-inspection-media.ts

@@ -1,6 +1,6 @@
 /**
  * THE THREE.JS ANSWER TO "what does this node look like"
- * (`@volter/editor-sdk/kit/inspection-node-media`): a selected node the shell's
+ * (`@volter/sdk/kit/inspection-node-media`): a selected node the shell's
  * Three store resolves to a live `Object3D` is previewed as an isolated live
  * view of that object, a camera has no Preview section (its view is the
  * viewport's), an instanced mesh names its units, and a node in the object map
@@ -10,12 +10,12 @@
 import {
   type InspectionNodeMedia,
   registerInspectionNodeMedia,
-} from '@volter/editor-sdk/kit/inspection-node-media';
+} from '@volter/sdk/kit/inspection-node-media';
 import { contentWorldBounds } from '@volter/editor-threejs/viewport/content-bounds';
 import { createElement, lazy } from 'react';
 import type * as THREE from 'three';
-import { openRegisteredDocument } from '@volter/editor-sdk/kit/document-open-registry';
-import { InspectorPreviewBody } from '@volter/editor-sdk/kit/components/inspector-preview-section';
+import { openRegisteredDocument } from '@volter/sdk/kit/document-open-registry';
+import { InspectorPreviewBody } from '@volter/sdk/kit/components/inspector-preview-section';
 import { entityObject3D } from './entity-object';
 import { describeInstancedPresentation } from './instanced-presentation';
 import { threeStoreForHost } from './three-state';

package/src/kit/three-integration.ts

@@ -6,11 +6,11 @@
  * Three half saves. The kit constructs none of it; the integration installs it once, and every
  * Three surface asks for it before it mounts (`ensureThreeIntegration`).
  */
-import { registerContributedCommands } from '@volter/editor-sdk/kit/command-registry';
-import { saveThumbnail } from '@volter/editor-sdk/kit/editor-api';
+import { registerContributedCommands } from '@volter/sdk/kit/command-registry';
+import { saveThumbnail } from '@volter/sdk/kit/editor-api';
 import { registerHostHierarchyObjects } from '../host-hierarchy-objects';
-import { registerContributionSurfaces } from '@volter/editor-sdk/kit/contribution-surfaces';
-import { registerRendererResourceCounts } from '@volter/editor-sdk/kit/renderer-resource-counts';
+import { registerContributionSurfaces } from '@volter/sdk/kit/contribution-surfaces';
+import { registerRendererResourceCounts } from '@volter/sdk/kit/renderer-resource-counts';
 import { interactiveViewportRendererCounts } from './three-viewport/interactive-renderer';
 import { inspectorPreviewRendererCounts } from '../viewport/preview-renderer';
 import { liveHostRendererCount } from '../viewport/renderer-ownership';
@@ -20,8 +20,8 @@ import { Object3DAuthoringSurface, Object3DPreviewSurface } from './components/o
 import { registerThreeAssetViewers } from './components/asset-viewers/three-asset-viewers';
 import type { EditorStatePersistence } from './editor-shell-store';
 import { registerModelThumbnails } from './model-thumbnail';
-import { writeProjectLocalSection } from '@volter/editor-sdk/kit/project-local-state';
-import { onShellStore } from '@volter/editor-sdk/kit/shell-store-door';
+import { writeProjectLocalSection } from '@volter/sdk/kit/project-local-state';
+import { onShellStore } from '@volter/sdk/kit/shell-store-door';
 import { registerThreeCanvasRender } from './three-canvas-render';
 import { registerThreeHierarchyRowMedia } from './three-hierarchy-row-media';
 import { registerThreePlayCameraFlight } from './play-camera-flight';

package/src/kit/three-state.ts

@@ -1,8 +1,8 @@
 /** A shell store's Three half (`threeStateOf`, beside the half in `editor-shell-store.ts`). */
-import type { ShellStore } from '@volter/editor-sdk/kit/shell-store';
+import type { ShellStore } from '@volter/sdk/kit/shell-store';
 import { type EditorShellStore, threeStateOf } from './editor-shell-store';
-import { useEditorStore, useOptionalEditorStore } from '@volter/editor-sdk/kit/editor-runtime';
-import { onShellStore, shellStoreForHost } from '@volter/editor-sdk/kit/shell-store-door';
+import { useEditorStore, useOptionalEditorStore } from '@volter/sdk/kit/editor-runtime';
+import { onShellStore, shellStoreForHost } from '@volter/sdk/kit/shell-store-door';
 
 export { threeStateOf };
 

package/src/kit/viewport-actions.ts

@@ -5,7 +5,7 @@
  * stage is bound (`components/stage-keyboard.tsx`), and they act on that
  * stage's own store: the same stage its keys drive (`viewport-hotkeys.ts`).
  */
-import type { ActionContribution, ContributedAction } from '@volter/editor-sdk/chrome';
+import type { ActionContribution, ContributedAction } from '@volter/sdk/chrome';
 import {
   alignCameraToViewport,
   cameraAuthoringPresentation,
@@ -16,16 +16,16 @@ import {
   toggleCameraPreviewPin,
   viewThroughCamera,
 } from './camera-authoring';
-import { registerContributedActions } from '@volter/editor-sdk/kit/chrome-registry';
+import { registerContributedActions } from '@volter/sdk/kit/chrome-registry';
 import type { EditorShellStore } from './editor-shell-store';
 import { object3DDocumentSession } from './authoring/object3d-document-session-registry';
-import { requestTransformMode } from '@volter/editor-sdk/kit/transform-mode-request';
-import { activeWorkspaceDocumentId } from '@volter/editor-sdk/kit/workspace-document-registry';
+import { requestTransformMode } from '@volter/sdk/kit/transform-mode-request';
+import { activeWorkspaceDocumentId } from '@volter/sdk/kit/workspace-document-registry';
 import {
   setViewGridVisible,
   viewGridVisible,
   viewPresentationBinding,
-} from '@volter/editor-sdk/kit/viewport-presentation';
+} from '@volter/sdk/kit/viewport-presentation';
 
 function cameraActions(): ContributedAction[] {
   const presentation = cameraAuthoringPresentation();

package/src/kit/viewport-authoring-policy.ts

@@ -40,13 +40,13 @@
  * defaults.
  */
 
-import type { AuthoringAdapter } from '@volter/editor-project/adapter';
-import { adapterOnlyToolOwner, type ViewportToolOwner } from '@volter/editor-sdk/kit/authoring/viewport-tool-owner';
+import type { AuthoringAdapter } from '@volter/project/adapter';
+import { adapterOnlyToolOwner, type ViewportToolOwner } from '@volter/sdk/kit/authoring/viewport-tool-owner';
 
 export { adapterOnlyToolOwner, type ViewportToolOwner };
 import type * as THREE from 'three';
-import { makeNoAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/no-authoring-adapter';
-import type { ShellStore } from '@volter/editor-sdk/kit/shell-store';
+import { makeNoAuthoringAdapter } from '@volter/sdk/kit/authoring/no-authoring-adapter';
+import type { ShellStore } from '@volter/sdk/kit/shell-store';
 
 
 export interface ViewportAuthoringPolicy {

package/src/kit/viewport-commands.ts

@@ -2,7 +2,7 @@
  * THE THREE VIEWPORT'S RELAY VERBS — framing, the camera, view presets, the
  * open Object3D document's orbit/turntable/frame, the viewport photograph and
  * the display and transform toggles. They are the Three viewport's, so they
- * reach the relay as a command contribution (`@volter/editor-sdk/commands`,
+ * reach the relay as a command contribution (`@volter/sdk/commands`,
  * `command-registry.ts`) rather than as rows of the kit's own table: a
  * composition with no Three viewport has none of them. Each budget travelled
  * with its verb from `command-table.ts`.
@@ -13,23 +13,23 @@ import type {
   CommandSpec,
   EditorCommandMessage,
   EditorCommandResult,
-} from '@volter/editor-sdk/commands';
-import { commandLine } from '@volter/editor-sdk/kit/product-command';
-import { activeWorkspaceDocumentId } from '@volter/editor-sdk/kit/workspace-document-registry';
+} from '@volter/sdk/commands';
+import { commandLine } from '@volter/sdk/kit/product-command';
+import { activeWorkspaceDocumentId } from '@volter/sdk/kit/workspace-document-registry';
 import { object3DDocumentSession } from './authoring/object3d-document-session-registry';
-import { activeDocumentAuthoring } from '@volter/editor-sdk/kit/authoring/shell-document-ops';
+import { activeDocumentAuthoring } from '@volter/sdk/kit/authoring/shell-document-ops';
 import { handleAssetPreviewCommand } from './asset-preview-command';
-import { captureSizeFromCommand } from '@volter/editor-sdk/kit/capture-size';
+import { captureSizeFromCommand } from '@volter/sdk/kit/capture-size';
 import type { EditorShellStore, HelperVisibility } from './editor-shell-store';
-import { editorHost } from '@volter/editor-sdk/host';
+import { editorHost } from '@volter/sdk/host';
 import { entityObject3D } from './entity-object';
 import { VIEWPORT_SHADING_MODES } from '../render/viewport-shading';
-import { focusedStageStore } from '@volter/editor-sdk/kit/stage-context';
+import { focusedStageStore } from '@volter/sdk/kit/stage-context';
 import {
   setViewGridVisible,
   startingPresentation,
   viewPresentationBinding,
-} from '@volter/editor-sdk/kit/viewport-presentation';
+} from '@volter/sdk/kit/viewport-presentation';
 import { threeStoreForHost } from './three-state';
 import { viewportStages } from '../viewport-door';
 import { threeStateOf } from './three-state';

package/src/kit/viewport-hotkeys.ts

@@ -6,12 +6,12 @@
  * what each action does, and the active KEYMAP decides which keys land on it —
  * W/E/R under `volter`, G/R/S under `blender`.
  */
-import { editorHost } from '@volter/editor-sdk/host';
-import { getActiveScope, installHotkeys, setActiveScope } from '@volter/editor-sdk/kit/hotkeys';
-import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
+import { editorHost } from '@volter/sdk/host';
+import { getActiveScope, installHotkeys, setActiveScope } from '@volter/sdk/kit/hotkeys';
+import { showTransientHint } from '@volter/sdk/kit/transient-hint';
 import type { EditorShellStore, TransformMode } from './editor-shell-store';
 import type { EditorViewport } from './editor-viewport';
-import { requestTransformMode } from '@volter/editor-sdk/kit/transform-mode-request';
+import { requestTransformMode } from '@volter/sdk/kit/transform-mode-request';
 
 export function registerViewportHotkeys(
   store: EditorShellStore,

package/src/kit/viewport-status-facet.ts

@@ -5,11 +5,11 @@
  * the person is looking at (`focusedStageStore`, ARCHITECTURE-CORE §One stage
  * unit 4), with an Object3D document's own presentation where it has one.
  */
-import { editorHost } from '@volter/editor-sdk/host';
-import { activeWorkspaceDocumentId } from '@volter/editor-sdk/kit/workspace-document-registry';
+import { editorHost } from '@volter/sdk/host';
+import { activeWorkspaceDocumentId } from '@volter/sdk/kit/workspace-document-registry';
 import { object3DDocumentSession } from './authoring/object3d-document-session-registry';
-import { focusedStageStore } from '@volter/editor-sdk/kit/stage-context';
-import { viewGridVisible } from '@volter/editor-sdk/kit/viewport-presentation';
+import { focusedStageStore } from '@volter/sdk/kit/stage-context';
+import { viewGridVisible } from '@volter/sdk/kit/viewport-presentation';
 import { threeStoreForHost } from './three-state';
 import { threeStateOf } from './three-state';
 

package/src/object3d-contributions.ts

@@ -7,12 +7,12 @@
  * the Three integration registers what renders them (`kit/three-integration.ts`).
  */
 
-import type { AuthoringAdapter } from '@volter/editor-project/adapter';
+import type { AuthoringAdapter } from '@volter/project/adapter';
 import type {
   DocumentPersistenceBinding,
   DocumentPersistenceResource,
-} from '@volter/editor-sdk/kit/authoring/object3d-document-persistence';
-import type { PresentationLayer } from '@volter/editor-sdk/kit/viewport-presentation';
+} from '@volter/sdk/kit/authoring/object3d-document-persistence';
+import type { PresentationLayer } from '@volter/sdk/kit/viewport-presentation';
 import type { ComponentType } from 'react';
 import type {
   AnimationClip,
@@ -213,7 +213,7 @@ export interface ToolObject3DAuthoringProps {
   /** Per-document overrides of the standard viewport dressing. */
   readonly dressing?: ToolViewportDressing;
   /** The kind of stage this view is, for its starting presentation
-   *  (`@volter/editor-sdk/kit/viewport-presentation`): the document's own kind (`'model'`).
+   *  (`@volter/sdk/kit/viewport-presentation`): the document's own kind (`'model'`).
    *  Without it the kind is read off the document id's prefix. */
   readonly stageKind?: string;
   /** How far the OPENING view stands back from a fit of the content: `1` fills the view (the
@@ -494,7 +494,7 @@ export interface ToolDocumentSourceBinding {
   readonly serialize: (document: ToolObject3DDocumentState) => string | null;
 }
 
-declare module '@volter/editor-sdk/contributions' {
+declare module '@volter/sdk/contributions' {
   interface ToolContributionSurfaces {
     readonly Object3DPreview: ComponentType<ToolObject3DPreviewProps>;
     readonly Object3DAuthoring: ComponentType<ToolObject3DAuthoringProps>;

package/src/viewport/environment.ts

@@ -28,7 +28,7 @@ export function createStandardEnvironment(renderer: THREE.WebGLRenderer): Standa
 }
 
 /**
- * An environment image (`@volter/editor-sdk/kit/environment-images`) as an equirectangular
+ * An environment image (`@volter/sdk/kit/environment-images`) as an equirectangular
  * texture in scene-referred light. Read as half float: a sun past white stays bright, and half
  * float filters linearly where full float cannot (phones).
  */

package/src/viewport-api.ts

@@ -4,9 +4,9 @@
  * shows, every mounted stage, and the one verb that swaps the viewport's subject for a live
  * instance's roots (Play's adoption of the running scene).
  */
-import type { MountedRoot } from '@volter/editor-project/adapter/root-adapter';
+import type { MountedRoot } from '@volter/project/adapter/root-adapter';
 import type * as THREE from 'three';
-import type { StageFrameCostReading } from '@volter/editor-sdk';
+import type { StageFrameCostReading } from '@volter/sdk';
 
 /** A live instance's roots, presented as the authored viewport's subject. */
 export interface ViewportPresentation {

package/src/viewport-door.ts

@@ -16,11 +16,11 @@
  * one (a helper `Object3D` has one parent, so it is set per stage).
  *
  * Until the lanes move, the host's own lanes import this registry directly; a
- * package reads `@volter/editor-sdk/host`'s `viewport` member, which is this.
+ * package reads `@volter/sdk/host`'s `viewport` member, which is this.
  */
 
 import type { ViewportDoor, ViewportPresentation, ViewportRig, ViewportRoot, ViewportStage } from './viewport-api';
-import { activeWorkspaceDocumentId } from '@volter/editor-sdk/kit/workspace-document-registry';
+import { activeWorkspaceDocumentId } from '@volter/sdk/kit/workspace-document-registry';
 
 type Presenter = (roots: readonly ViewportRoot[]) => ViewportPresentation | null;
 /** An editor-only helper object, typed by the host door it is shown through. */
@@ -204,7 +204,7 @@ export function viewportStages(): readonly ViewportStage[] {
 
 /**
  * WHICH HELPER KINDS A STAGE IS HOLDING — the kinds something has actually
- * shown on it through `setHelper` (`@volter/editor-sdk/host`,
+ * shown on it through `setHelper` (`@volter/sdk/host`,
  * `ViewportStage.setHelper`), cleared ones excluded.
  *
  * It exists because a 3D document's own OVERLAYS MENU must follow what the