ohzi-core 13.2.2 → 14.0.0

package/src/dev_bridge/ViewNavigator.ts

@@ -0,0 +1,101 @@
+export interface ViewSummary
+{
+  name: string;
+  url: string;
+  current: boolean;
+}
+
+export interface ViewManagerLike
+{
+  views: Array<{ name?: unknown; url?: unknown }>;
+  get_current_view(): { name?: unknown } | undefined;
+  go_to_view(name: string, change_url?: boolean, skip?: boolean): void;
+}
+
+export interface NavigateRequest
+{
+  name?: unknown;
+  change_url?: unknown;
+  skip?: unknown;
+}
+
+export interface NavigateResult
+{
+  requested: string;
+  current: string | null;
+  change_url: boolean;
+  skip: boolean;
+}
+
+// ViewManager.get() returns undefined for an unknown name and go_to_view then
+// dereferences v.url, so the name is validated here before it can throw.
+class ViewNavigator
+{
+  list(manager: ViewManagerLike): { current: string | null; views: ViewSummary[] }
+  {
+    const current = this.current(manager);
+
+    return {
+      current,
+      views: this.names(manager).map((view) => ({
+        name: view.name,
+        url: view.url,
+        current: view.name === current
+      }))
+    };
+  }
+
+  go(manager: ViewManagerLike, request: NavigateRequest): NavigateResult
+  {
+    const name = typeof request.name === 'string' ? request.name : null;
+    const available = this.names(manager);
+
+    if (name === null || !available.some((view) => view.name === name))
+    {
+      const listed = available.map((view) => view.name).join(', ');
+
+      throw this.error('not_found', `Unknown view. Available views: ${listed}.`);
+    }
+
+    const change_url = request.change_url === undefined ? true : request.change_url === true;
+    const skip = request.skip === true;
+
+    manager.go_to_view(name, change_url, skip);
+
+    return { requested: name, current: this.current(manager), change_url, skip };
+  }
+
+  private names(manager: ViewManagerLike): Array<{ name: string; url: string }>
+  {
+    const views = Array.isArray(manager.views) ? manager.views : [];
+
+    return views
+      .filter((view) => typeof view.name === 'string')
+      .map((view) => ({
+        name: view.name as string,
+        url: typeof view.url === 'string' ? view.url : ''
+      }));
+  }
+
+  private current(manager: ViewManagerLike): string | null
+  {
+    const view = manager.get_current_view();
+
+    if (typeof view !== 'object' || view === null || typeof view.name !== 'string')
+    {
+      return null;
+    }
+
+    return view.name;
+  }
+
+  private error(code: string, message: string): Error
+  {
+    const error: Error & { code?: string } = new Error(message);
+    error.code = code;
+
+    return error;
+  }
+}
+
+export { ViewNavigator };

package/src/dev_bridge/protocol.ts

@@ -0,0 +1,31 @@
+// This file MUST stay in sync with mcp/src/protocol.ts.
+// A mismatch is caught at handshake time and refuses the connection.
+export const PROTOCOL_VERSION = 1;
+
+export interface CanvasInfo
+{
+  width: number;
+  height: number;
+  dpr: number;
+}
+
+export interface AppInfo
+{
+  core_version: string;
+  components_version: string;
+  pit_version: string;
+  active_view: string | null;
+  has_camera: boolean;
+  canvas: CanvasInfo;
+}
+
+export interface Command
+{
+  id: string;
+  cmd: string;
+  args?: Record<string, unknown>;
+}
+
+export type Reply =
+  | { id: string; ok: true; result: unknown }
+  | { id: string; ok: false; error: { code: string; message: string } };

package/src/index.ts

@@ -17,7 +17,17 @@ import { CameraManager } from './CameraManager';
 import { CanvasDrawer } from './canvas_drawer/CanvasDrawer';
 import { SimpleTextDrawer } from './canvas_drawer/SimpleTextDrawer';
 import { Capabilities } from './Capabilities';
+import { CameraBridge } from './dev_bridge/CameraBridge';
+import { CaptureService } from './dev_bridge/CaptureService';
+import { ConsoleBuffer } from './dev_bridge/ConsoleBuffer';
+import { InputSynthesizer } from './dev_bridge/InputSynthesizer';
+import { PerformanceProbe } from './dev_bridge/PerformanceProbe';
+import { RenderModeRegistry } from './dev_bridge/RenderModeRegistry';
+import { SceneEditor } from './dev_bridge/SceneEditor';
+import { SceneInspector } from './dev_bridge/SceneInspector';
+import { ViewNavigator } from './dev_bridge/ViewNavigator';
 import { Debug } from './Debug';
+import { DevBridge } from './dev_bridge/DevBridge';
 import { Graphics } from './Graphics';
 import { CSSAnimator } from './html_utilities/CSSAnimator';
 import { Initializer } from './Initializer';
@@ -125,12 +135,12 @@ import { AbstractCameraState } from './camera_controller/states/common/AbstractC
 import { CommonCameraState } from './camera_controller/states/common/CommonCameraState';
 
 export {
-    AbstractCameraState, AbstractLoader, AbstractScene, ActionEvent, ActionInterpolator, ActionSequencer, ActionSequencerBuilder, AddMaterial, ApplicationView, ArrayUtilities, Arrow, AsyncAbstractLoader, AsyncAudiosLoader, AsyncObjectsLoader, AsyncTextureLoader, AsyncTexturesLoader, AudioLoader, BaseApplication, BaseRender, BaseShaderMaterial, BasisLoader, BlitMaterial, Blurrer, Browser, BufferGeometryUtils, CameraController, CameraManager, CameraMovementMode, CameraUtilities, CanvasDrawer, Capabilities, CommonCameraState, Compilator, CSSAnimator, Cube, CubemapLoader, DAELoader, Debug, DebugNormalsRender, DrawIOAnimationSheet, DualFilteringBlurMaterial, DualFilteringBlurrer, EasingFunctions, FileLoader,
+    AbstractCameraState, AbstractLoader, AbstractScene, ActionEvent, ActionInterpolator, ActionSequencer, ActionSequencerBuilder, AddMaterial, ApplicationView, ArrayUtilities, Arrow, AsyncAbstractLoader, AsyncAudiosLoader, AsyncObjectsLoader, AsyncTextureLoader, AsyncTexturesLoader, AudioLoader, BaseApplication, BaseRender, BaseShaderMaterial, BasisLoader, BlitMaterial, Blurrer, Browser, BufferGeometryUtils, CameraBridge, CameraController, CameraManager, CameraMovementMode, CameraUtilities, CanvasDrawer, Capabilities, CaptureService, CommonCameraState, Compilator, ConsoleBuffer, CSSAnimator, Cube, CubemapLoader, DAELoader, Debug, DebugNormalsRender, DevBridge, DrawIOAnimationSheet, DualFilteringBlurMaterial, DualFilteringBlurrer, EasingFunctions, FileLoader,
     FontLoader, FrustumPointFitter, GaussianBlurrer, GeometryUtilities, GLTFDRACOLoader, GLTFLoader, GPUParticleSystem, Graphics, Grid, HDRCubeTextureLoader, HDRTextureLoader, HighQualityLoadingState, HorizontalPlane, HTMLUtilities,
-    ImageUtilities, ImmediateMode, Initializer, JSONLoader, KeyboardInput, Line, LoadingState, MedianFilter, MeshSampler,
+    ImageUtilities, ImmediateMode, Initializer, InputSynthesizer, JSONLoader, KeyboardInput, Line, LoadingState, MedianFilter, MeshSampler,
     ModelUtilities, NormalAORender,
     NormalRender, NumberInterpolator, ObjectUtilities, OBJLoader, OMath, OrthographicCamera, OrthographicFrustumPointFitter, OS, OScreen, ParticleAttribute,
-    ParticlePositionAttribute, PerspectiveCamera, PerspectiveFrustumPointFitter, PointArrayLoader, RegularLoadingState, RenderLoop, ResourceBatch,
-    ResourceContainer, SceneManager, Screen, SDFTextBatch, SimpleTextDrawer, Sphere, StringUtilities, Text2D, TextLoader, TextureLoader, Time, TimeUtilities, TransitionManager, TransitionTable, UnrealBloomComposeMaterial, UnrealBloomRender, UpdatableMaterialMesh, Validation, VectorInterpolator, VerticalPlane, VideoLoader, ViewComponent,
-    ViewComponentManager, ViewManager, VRRender, WorldImage
+    ParticlePositionAttribute, PerformanceProbe, PerspectiveCamera, PerspectiveFrustumPointFitter, PointArrayLoader, RegularLoadingState, RenderLoop, RenderModeRegistry, ResourceBatch,
+    ResourceContainer, SceneEditor, SceneInspector, SceneManager, Screen, SDFTextBatch, SimpleTextDrawer, Sphere, StringUtilities, Text2D, TextLoader, TextureLoader, Time, TimeUtilities, TransitionManager, TransitionTable, UnrealBloomComposeMaterial, UnrealBloomRender, UpdatableMaterialMesh, Validation, VectorInterpolator, VerticalPlane, VideoLoader, ViewComponent,
+    ViewComponentManager, ViewManager, ViewNavigator, VRRender, WorldImage
 };