ohzi-core 13.3.0 → 15.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ohzi-core",
-  "version": "13.3.0",
+  "version": "15.0.0",
   "description": "OHZI Interactive Core Library",
   "type": "module",
   "source": "src/index.ts",
@@ -21,12 +21,16 @@
     "build": "rollup -c",
     "create-tag": "node tasks/app/create_tag.mjs",
     "fix-syntax": "npx eslint src --fix || echo 'Done.'",
+    "test": "vitest run",
+    "test-watch": "vitest",
     "generate-types": "npx -p typescript tsc",
     "upload": "yarn build && npm publish && yarn create-tag",
     "create-view": "node ./tasks/create_view/create_view.mjs",
     "create-scene": "node ./tasks/create_scene/create_scene.mjs",
     "create-component": "node ./tasks/create_component/create_component.mjs",
-    "create-transition": "node ./tasks/create_transition/create_transition.mjs"
+    "create-transition": "node ./tasks/create_transition/create_transition.mjs",
+    "test-unit": "vitest run --project unit",
+    "test-browser": "vitest run --project browser"
   },
   "repository": {
     "type": "git",
@@ -46,22 +50,24 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "three": "0.183.0"
+    "three": "0.186.0"
   },
   "devDependencies": {
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/node": "^25.0.3",
-    "@types/three": "0.183.0",
+    "@types/three": "0.186.0",
     "@typescript-eslint/eslint-plugin": "^8.18.2",
     "@typescript-eslint/parser": "^8.18.2",
+    "@vitest/browser-playwright": "4.1.11",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^10.1.8",
+    "playwright": "^1.63.0",
     "rollup": "^2.44.0",
-    "rollup-plugin-glslify": "^1.2.0",
     "rollup-plugin-sourcemaps": "^0.6.3",
     "rollup-plugin-terser": "^7.0.2",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.18.2"
+    "typescript-eslint": "^8.18.2",
+    "vitest": "^4.1.11"
   }
 }

package/src/Capabilities.ts

@@ -1,13 +1,11 @@
 class Capabilities
 {
-  fp_textures_available: boolean;
   max_anisotropy: number;
   vertex_texture_sampler_available: boolean;
   init()
   {
     this.max_anisotropy = 0;
     this.vertex_texture_sampler_available = false;
-    this.fp_textures_available = false;
   }
 }
 

package/src/Debug.ts

@@ -1,4 +1,5 @@
 import { AxisHelper } from './components/AxisHelper';
+import { Text2D } from './components/Text2D';
 
 import { ScreenSpaceTextureMaterial } from './materials/ScreenSpaceTextureMaterial';
 import { OScreen } from './OScreen';
@@ -8,12 +9,17 @@ import { Cube } from './primitives/Cube';
 import { Sphere } from './primitives/Sphere';
 import { SceneManager } from './SceneManager';
 
-import type { RenderTarget, Texture, Vector2 } from 'three';
-import { Box3, Box3Helper, BufferGeometry, CatmullRomCurve3, Line, LineBasicMaterial, Mesh, MeshBasicMaterial, PlaneGeometry, Scene, ShaderMaterial, SphereGeometry, Vector3, Vector4 } from 'three';
+import type { RenderTarget, Texture } from 'three';
+import { Box3, Box3Helper, BufferGeometry, CatmullRomCurve3, Color, Line, LineBasicMaterial, Mesh, MeshBasicMaterial, PlaneGeometry, Scene, SphereGeometry, Vector2, Vector3 } from 'three';
+import { MeshBasicNodeMaterial } from 'three/webgpu';
 import { CameraManager } from './CameraManager';
-import type { AbstractScene, Graphics } from './index';
-import basic_color_frag from './shaders/basic_color/basic_color.frag';
-import basic_color_vert from './shaders/basic_color/basic_color.vert';
+import type { Graphics } from './index';
+
+// 20% opaque, and never hides what is drawn after it.
+function see_through_material(color: number | string): MeshBasicNodeMaterial
+{
+  return new MeshBasicNodeMaterial({ color, opacity: 0.2, transparent: true, depthWrite: false });
+}
 
 class Debug
 {
@@ -22,9 +28,9 @@ class Debug
   camera: PerspectiveCamera;
   canvas_renderer: any;
   ctx: any;
-  display_texture_meshes: Mesh[];
+  display_texture_meshes: Mesh<PlaneGeometry, ScreenSpaceTextureMaterial>[];
   rt_debug: RenderTarget;
-  scene: AbstractScene;
+  scene: Scene;
   
   init()
   {
@@ -104,7 +110,7 @@ class Debug
   draw_cube(pos?: Vector3, size?: number, color?: number | string)
   {
     size = size || 1;
-    color = color || 0xff0000;
+    color = color ?? 0xff0000;
     pos = pos || new Vector3();
 
     const cube = new Cube(new Vector3(size, size, size), undefined, color);
@@ -135,18 +141,10 @@ class Debug
     return cube;
   }
 
-  draw_plane(width?: number, height?: number, color?: number | string) 
+  draw_plane(width?: number, height?: number, color: number | string = 0x00ff00)
   {
     const geometry = new PlaneGeometry(width, height);
-    const material = new ShaderMaterial({
-      uniforms: {
-        _Color: { value: new Vector4(0, 1, 0, 0.2) }
-      },
-      vertexShader: basic_color_vert,
-      fragmentShader: basic_color_frag,
-      transparent: true,
-      depthWrite: false
-    });
+    const material = see_through_material(color);
 
     const plane = new Mesh(geometry, material);
     plane.renderOrder = -10000;
@@ -157,7 +155,7 @@ class Debug
   draw_empty_cube(pos: Vector3, size: number, color: number | string)
   {
     size = size || 1;
-    color = color || 0xff0000;
+    color = color ?? 0xff0000;
 
     const box = new Box3().setFromCenterAndSize(new Vector3(), new Vector3(size, size, size));
     const helper = new Box3Helper(box, color);
@@ -168,7 +166,7 @@ class Debug
   draw_sphere(pos: Vector3, size: number, color: number | string)
   {
     size = size || 1;
-    color = color || 0xff0000;
+    color = color ?? 0xff0000;
     pos = pos || new Vector3();
 
     const sphere = new Sphere(size, color);
@@ -189,7 +187,7 @@ class Debug
 
   draw_sphere_helper(sphere: any, color: number | string)
   {
-    color = color || 0xff0000;
+    color = color ?? 0xff0000;
     const geometry = new SphereGeometry(sphere.radius, 32, 32);
     const material = new MeshBasicMaterial({ color: color });
     const sphere_mesh = new Mesh(geometry, material);
@@ -198,27 +196,21 @@ class Debug
     return sphere_mesh;
   }
 
-  draw_math_sphere(sphere: any)
+  draw_math_sphere(sphere: any, color: number | string = 0xff0000)
   {
     const geometry = new SphereGeometry(sphere.radius, 32, 32);
-    const material = new ShaderMaterial({
-      uniforms: {
-        _Color: { value: new Vector4(1, 0, 0, 0.2) }
-      },
-      vertexShader: basic_color_vert,
-      fragmentShader: basic_color_frag,
-      transparent: true
-    });
-    // var material = new MeshBasicMaterial( {color: 0xff0000, transparent = true} );
+    const material = see_through_material(color);
     const sphere1 = new Mesh(geometry, material);
     sphere1.position.copy(sphere.center);
     SceneManager.current.add(sphere1);
+    return sphere1;
   }
 
-  draw_bounding_box(bb: Box3)
+  draw_bounding_box(bb: Box3, color: number | string = 0xffff00)
   {
-    const helper = new Box3Helper(bb, 0xffff00);
+    const helper = new Box3Helper(bb, color);
     SceneManager.current.add(helper);
+    return helper;
   }
 
   draw_curve(curve: Vector3[], options: { offset: number })
@@ -238,6 +230,8 @@ class Debug
   draw_texture(tex: Texture, w: number, h: number)
   {
     const mesh = new Mesh(new PlaneGeometry(1, 1), new ScreenSpaceTextureMaterial());
+    // Placed in screen space by its material, so the camera frustum says nothing about it.
+    mesh.frustumCulled = false;
     this.display_texture_meshes.push(mesh);
     this.scene.add(mesh);
 
@@ -245,6 +239,17 @@ class Debug
     return mesh;
   }
 
+  // Text that always faces the camera, size world units tall, centered on pos.
+  draw_label(text: string, pos?: Vector3, size: number = 1, color: number | string = 0xffffff)
+  {
+    const label = new Text2D(text, 'bold 48px Arial', new Color(color).getStyle(), new Vector2());
+    label.size = new Vector3(size, size, size);
+    label.screen_aligned = true;
+    label.position.copy(pos || new Vector3());
+    this.scene.add(label);
+    return label;
+  }
+
   render(graphics: typeof Graphics)
   {
     for (let i = 0; i < this.display_texture_meshes.length; i++)

package/src/Graphics.ts

@@ -124,7 +124,7 @@ class Graphics
     }
   }
 
-  render(scene?: AbstractScene, camera?: PerspectiveCamera | OrthographicCamera, RT?: RenderTarget, override_mat?: Material): void
+  render(scene?: Scene, camera?: PerspectiveCamera | OrthographicCamera, RT?: RenderTarget, override_mat?: Material): void
   {
     this.__apply_override_material(scene, override_mat);
 
@@ -181,7 +181,7 @@ class Graphics
     }
   }
 
-  __apply_override_material(scene: AbstractScene, mat: Material): void
+  __apply_override_material(scene: Scene, mat: Material): void
   {
     mat = mat === undefined ? null : mat;
     if (scene)

package/src/Initializer.ts

@@ -10,6 +10,7 @@ import { OScreen } from './OScreen';
 import { ReflectionPlaneContext } from './ReflectionPlaneContext';
 import { ResourceContainer } from './ResourceContainer';
 import { SceneManager } from './SceneManager';
+import { AbstractScene } from './scenes/AbstractScene';
 import { Time } from './Time';
 import { CameraUtilities } from './utilities/CameraUtilities';
 
@@ -29,7 +30,7 @@ class Initializer
     Browser.init();
     ReflectionPlaneContext.init();
     ResourceContainer.init();
-    SceneManager.init();
+    SceneManager.init(new AbstractScene({ name: 'default_scene', compilators: {} }));
     OScreen.init();
     Time.init();
 

package/src/SceneManager.ts

@@ -1,14 +1,13 @@
 import type { Mesh } from 'three';
-import { AbstractScene } from './scenes/AbstractScene';
+import type { AbstractScene } from './scenes/AbstractScene';
 
 class SceneManager
 {
   _current: AbstractScene;
-  
-  init(): void
+
+  init(default_scene: AbstractScene): void
   {
-    this._current = new AbstractScene({ name: 'default_scene', compilators: {} });
-    this._current.name = 'default_scene';
+    this._current = default_scene;
   }
 
   add_scene(name: string): void 

package/src/action_sequencer/NumberInterpolator.ts

@@ -3,6 +3,8 @@ import { ActionInterpolator } from './ActionInterpolator';
 
 class NumberInterpolator extends ActionInterpolator
 {
+  declare from: number;
+  declare to: number;
   initial: boolean;
 
   constructor(attribute_name: string, from: number = 0, to: number = 1, initial: boolean = false, easing_function: string = 'linear')

package/src/blitter_index.ts

@@ -1,9 +1,8 @@
 import { Blitter } from './render_utilities/Blitter';
 import { Blurrer } from './render_utilities/Blurrer';
 import { GaussianBlurrer } from './render_utilities/GaussianBlurrer';
-import { MedianFilter } from './render_utilities/MedianFilter';
 
 import { DualFilteringBlurMaterial } from './materials/DualFilteringBlurMaterial';
 export {
-    Blitter, Blurrer, DualFilteringBlurMaterial, GaussianBlurrer, MedianFilter
+    Blitter, Blurrer, DualFilteringBlurMaterial, GaussianBlurrer
 };

package/src/camera_controller/CameraController.ts

@@ -1,6 +1,6 @@
 import { ImmediateMode } from './movement_mode/ImmediateMode';
 
-import type { Camera, Points } from 'three';
+import type { OrthographicCamera, PerspectiveCamera, Points } from 'three';
 import { PlaneHelper, Quaternion, Vector3 } from 'three';
 // import { PlaneHelper } from 'three';
 import { Plane } from 'three';
@@ -8,8 +8,6 @@ import { Plane } from 'three';
 import { Box3, Ray } from 'three';
 
 import { OScreen } from '../OScreen';
-import type { OrthographicCamera } from '../OrthographicCamera';
-import type { PerspectiveCamera } from '../PerspectiveCamera';
 import type { Input } from '../lib/Input';
 import type { Cube } from '../primitives/Cube';
 import type { Sphere } from '../primitives/Sphere';
@@ -22,7 +20,7 @@ import { AbstractCameraState } from './states/common/AbstractCameraState';
 export class CameraController
 {
   __last_reference_position: Vector3;
-  camera: PerspectiveCamera;
+  camera: PerspectiveCamera | OrthographicCamera;
   camera_initial_pos: Vector3;
   camera_initial_rot: Quaternion;
   current_azimuth: number;
@@ -119,7 +117,7 @@ export class CameraController
     this.input_enabled = false;
   }
 
-  set_camera(camera: Camera)
+  set_camera(camera: PerspectiveCamera | OrthographicCamera)
   {
     this.camera = camera;
     this.camera_initial_rot = camera.quaternion.clone();
@@ -185,13 +183,15 @@ export class CameraController
     return this.normalized_zoom < 0.2;
   }
 
-  set_rotation(tilt: number, orientation: number, azimuth = 0)
+  // Arguments are nullish-checked, not falsy-checked: a falsy check discards a
+  // value of 0, which made it impossible to return any angle to zero.
+  set_rotation(tilt?: number, orientation?: number, azimuth?: number)
   {
     this.old_orientation = this.current_orientation;
 
-    this.current_tilt = tilt || this.current_tilt;
-    this.current_orientation = orientation || this.current_orientation;
-    this.current_azimuth = azimuth || this.current_azimuth;
+    this.current_tilt = tilt ?? this.current_tilt;
+    this.current_orientation = orientation ?? this.current_orientation;
+    this.current_azimuth = azimuth ?? this.current_azimuth;
 
     this.set_quaternion(this.build_rotation(this.current_tilt, this.current_orientation)); //, this.current_azimuth
   }
@@ -220,8 +220,11 @@ export class CameraController
     const xΘ = Math.atan2(q.x, q.w)  * 2;
     const yΘ = Math.atan2(q.y, q.w)  * 2;
 
-    this.current_orientation = OMath.radToDeg(yΘ) % 360;
-    this.current_tilt        = OMath.radToDeg(xΘ) * -1;
+    // Both angles come out up to 360 degrees off: past an orientation of 180,
+    // and for -q, which is the same rotation. Orientation is kept in [0, 360),
+    // like build_rotation, and tilt in (-180, 180].
+    this.current_orientation = OMath.euclideanModulo(OMath.radToDeg(yΘ), 360);
+    this.current_tilt        = 180 - OMath.euclideanModulo(180 + OMath.radToDeg(xΘ), 360);
 
     this.reference_rotation.copy(q);
   }
@@ -283,42 +286,21 @@ export class CameraController
 
   focus_on_bounding_box(bb: Box3, scale = 1)
   {
-    if ((this.camera as OrthographicCamera).isOrthographicCamera)
-    {
-      bb.getSize(this.tmp_size);
-
-      const obj_x = this.tmp_size.x;
-      const obj_y = this.tmp_size.y;
-      const object_aspect = obj_x / obj_y;
-      if (OScreen.aspect_ratio / object_aspect > 1)
-      {
-        (this.camera).zoom = OScreen.height / obj_y;
-      }
-      else
-      {
-        (this.camera).zoom = OScreen.width / obj_x;
-      }
-
-      bb.getCenter(this.reference_position);
-    }
-    else
-    {
-      const dir = new Vector3();
-      dir.copy(bb.max).sub(bb.min);
+    const dir = new Vector3();
+    dir.copy(bb.max).sub(bb.min);
 
-      const p1 = bb.min.clone();
+    const p1 = bb.min.clone();
 
-      const p2 = p1.clone().add(new Vector3(dir.x, 0, 0));
-      const p3 = p1.clone().add(new Vector3(0, dir.y, 0));
-      const p4 = p1.clone().add(new Vector3(0, 0, dir.z));
+    const p2 = p1.clone().add(new Vector3(dir.x, 0, 0));
+    const p3 = p1.clone().add(new Vector3(0, dir.y, 0));
+    const p4 = p1.clone().add(new Vector3(0, 0, dir.z));
 
-      const p5 = p1.clone().add(new Vector3(dir.x, 0, dir.z));
-      const p6 = p1.clone().add(new Vector3(0, dir.y, dir.z));
-      const p7 = bb.max.clone();
-      const p8 = p1.clone().add(new Vector3(dir.x, dir.y, 0));
+    const p5 = p1.clone().add(new Vector3(dir.x, 0, dir.z));
+    const p6 = p1.clone().add(new Vector3(0, dir.y, dir.z));
+    const p7 = bb.max.clone();
+    const p8 = p1.clone().add(new Vector3(dir.x, dir.y, 0));
 
-      this.focus_camera_on_points([p1, p2, p3, p4, p5, p6, p7, p8], scale);
-    }
+    this.focus_camera_on_points([p1, p2, p3, p4, p5, p6, p7, p8], scale);
   }
 
   // get_zoom_to_focus_on_bounding_box(bb, tilt, orientation)
@@ -345,6 +327,11 @@ export class CameraController
 
   get_zoom_to_focus_on_points(points: Vector3[], scale: number)
   {
+    if (this.__is_orthographic())
+    {
+      return this.__fit_orthographic(this.reference_rotation, points, scale).zoom;
+    }
+
     const old_zoom = this.reference_zoom;
     const old_pos = new Vector3().copy(this.reference_position);
     this.focus_camera_on_points(points, scale);
@@ -356,6 +343,11 @@ export class CameraController
 
   get_target_pos_to_focus_on_points(points: Vector3[], scale: number)
   {
+    if (this.__is_orthographic())
+    {
+      return this.__fit_orthographic(this.reference_rotation, points, scale).center;
+    }
+
     const old_zoom = this.reference_zoom;
     const old_pos = new Vector3().copy(this.reference_position);
     this.focus_camera_on_points(points, scale);
@@ -369,14 +361,29 @@ export class CameraController
 
   focus_camera_on_sphere(sphere: Sphere, debug: boolean)
   {
-    this.reference_zoom = this.get_zoom_to_sphere(sphere, debug);
+    if (this.__is_orthographic())
+    {
+      this.__set_orthographic_zoom(this.get_zoom_to_sphere(sphere, debug));
+      this.reference_zoom = this.__get_orthographic_distance(sphere.radius);
+    }
+    else
+    {
+      this.reference_zoom = this.get_zoom_to_sphere(sphere, debug);
+    }
     this.reference_position.copy(sphere.center);
   }
 
+  // For a perspective camera this is a distance; for an orthographic camera it
+  // is the camera zoom.
   get_zoom_to_sphere(sphere: Sphere, debug: boolean)
   {
-    const v_fov = ((this.camera).fov / 2) * Math.PI / 180;
-    const h_fov = (2 * Math.atan(Math.tan(v_fov) * (this.camera).aspect)) / 2;
+    if (this.__is_orthographic())
+    {
+      return this.__get_orthographic_zoom(sphere.radius * 2, sphere.radius * 2);
+    }
+
+    const v_fov = ((this.camera as PerspectiveCamera).fov / 2) * Math.PI / 180;
+    const h_fov = (2 * Math.atan(Math.tan(v_fov) * (this.camera as PerspectiveCamera).aspect)) / 2;
 
     // if(debug )
     // {
@@ -425,7 +432,7 @@ export class CameraController
 
   fit_points(quaternion: Quaternion, points: Vector3[], zoom_scale = 1)
   {
-    if ((this.camera).isPerspectiveCamera)
+    if ((this.camera as PerspectiveCamera).isPerspectiveCamera)
     {
       const camera_forward_dir = new Vector3(0, 0, -1).applyQuaternion(quaternion);
       const camera_backward_dir = camera_forward_dir.clone().multiplyScalar(-1);
@@ -434,7 +441,7 @@ export class CameraController
 
       const aspect_ratio = OScreen.aspect_ratio;
 
-      const camera_pos = fitter.fit_points(points, quaternion, ((this.camera).fov * zoom_scale), aspect_ratio);
+      const camera_pos = fitter.fit_points(points, quaternion, ((this.camera as PerspectiveCamera).fov * zoom_scale), aspect_ratio);
       const box = new Box3().setFromPoints(points);
       const center = new Vector3();
       box.getCenter(center);
@@ -456,24 +463,20 @@ export class CameraController
     }
     else
     {
-      const fitter = new OrthographicFrustumPointFitter();
-      const result = fitter.fit_points(points, this.reference_rotation, ((this.camera).fov * zoom_scale), OScreen.aspect_ratio);
-
-      this.reference_position.copy(result.center);
-      this.reference_zoom = result.distance_to_center;
+      const result = this.__fit_orthographic(quaternion, points, zoom_scale);
+      const camera_backward_dir = new Vector3(0, 0, 1).applyQuaternion(quaternion);
 
-      const forward = new Vector3(0, 0, 1).applyQuaternion(quaternion);
       return {
-        zoom: result.distance_to_center,
+        zoom: result.zoom,
         reference_position: result.center,
-        camera_position: forward.multiplyScalar(result.distance_to_center)
+        camera_position: result.center.clone().add(camera_backward_dir.multiplyScalar(result.distance))
       };
     }
   }
 
   focus_camera_on_points(points: Vector3[], zoom_scale = 1)
   {
-    if ((this.camera).isPerspectiveCamera)
+    if ((this.camera as PerspectiveCamera).isPerspectiveCamera)
     {
       const camera_forward_dir = new Vector3(0, 0, -1).applyQuaternion(this.reference_rotation);
       const camera_backward_dir = camera_forward_dir.clone().multiplyScalar(-1);
@@ -482,7 +485,7 @@ export class CameraController
 
       const aspect_ratio = OScreen.aspect_ratio;
 
-      const camera_pos = fitter.fit_points(points, this.reference_rotation, ((this.camera).fov * zoom_scale), aspect_ratio);
+      const camera_pos = fitter.fit_points(points, this.reference_rotation, ((this.camera as PerspectiveCamera).fov * zoom_scale), aspect_ratio);
       const box = new Box3().setFromPoints(points);
       const center = new Vector3();
       box.getCenter(center);
@@ -501,11 +504,11 @@ export class CameraController
     }
     else
     {
-      const fitter = new OrthographicFrustumPointFitter();
-      const result = fitter.fit_points(points, this.reference_rotation, ((this.camera).fov * zoom_scale), OScreen.aspect_ratio);
+      const result = this.__fit_orthographic(this.reference_rotation, points, zoom_scale);
 
+      this.__set_orthographic_zoom(result.zoom);
+      this.reference_zoom = result.distance;
       this.reference_position.copy(result.center);
-      this.reference_zoom = result.distance_to_center;
     }
   }
 
@@ -526,12 +529,52 @@ export class CameraController
 
   __get_zoom_to_show_rect(width: number, height: number, scale = 1)
   {
+    if (this.__is_orthographic())
+    {
+      return this.__get_orthographic_zoom(width * 2, height * 2, scale);
+    }
+
     // let v_fov = (this.camera.fov/2) * Math.PI/180;
-    const v_fov = OMath.degToRad((this.camera).fov / 2);
-    const h_fov = (2 * Math.atan(Math.tan(v_fov) * (this.camera).aspect)) / 2;
+    const v_fov = OMath.degToRad((this.camera as PerspectiveCamera).fov / 2);
+    const h_fov = (2 * Math.atan(Math.tan(v_fov) * (this.camera as PerspectiveCamera).aspect)) / 2;
 
     const distV = height / Math.tan(v_fov * scale);
     const distH = width / Math.tan(h_fov * scale);
     return Math.max(Math.abs(distH), Math.abs(distV));
   }
+
+  __is_orthographic()
+  {
+    return (this.camera as OrthographicCamera).isOrthographicCamera === true;
+  }
+
+  __fit_orthographic(quaternion: Quaternion, points: Vector3[], zoom_scale: number)
+  {
+    const bounds = new OrthographicFrustumPointFitter().get_view_bounds(points, quaternion);
+
+    return {
+      zoom: this.__get_orthographic_zoom(bounds.size.x, bounds.size.y, zoom_scale),
+      center: bounds.center,
+      distance: this.__get_orthographic_distance(bounds.size.z / 2)
+    };
+  }
+
+  // The current distance is kept when it fits the depth. ImmediateMode still
+  // clamps it to max_zoom, which must cover half the depth plus near.
+  __get_orthographic_distance(half_depth: number)
+  {
+    return new OrthographicFrustumPointFitter().get_distance_to_fit_depth(this.camera as OrthographicCamera, half_depth, this.reference_zoom);
+  }
+
+  __get_orthographic_zoom(width: number, height: number, scale = 1)
+  {
+    return new OrthographicFrustumPointFitter().get_zoom_to_fit_size(this.camera as OrthographicCamera, width, height, scale);
+  }
+
+  __set_orthographic_zoom(zoom: number)
+  {
+    const camera = this.camera as OrthographicCamera;
+    camera.zoom = zoom;
+    camera.updateProjectionMatrix();
+  }
 }

package/src/camera_controller/states/common/CommonCameraState.ts

@@ -1,3 +1,4 @@
+import type { PerspectiveCamera } from 'three';
 import { Vector2 } from 'three';
 
 import type { Input } from '../../../lib/Input';
@@ -70,7 +71,7 @@ export class CommonCameraState extends AbstractCameraState
         tilt: camera_controller.current_tilt,
         azimuth: camera_controller.current_azimuth,
         zoom: camera_controller.reference_zoom,
-        fov: (camera_controller.camera).fov
+        fov: (camera_controller.camera as PerspectiveCamera).fov
       });
     }
   }

package/src/components/AxisHelper.ts

@@ -48,6 +48,7 @@ class AxisHelper extends Object3D
 
   dispose(): void
   {
+    super.dispose();
   }
 }