@tonybfox/threejs-tools 1.0.0

package/dist/camera/index.d.mts

@@ -0,0 +1,82 @@
+import * as THREE from 'three';
+import CameraControls from 'camera-controls';
+
+type Vector3Tuple = [number, number, number];
+type Vector3Like = THREE.Vector3 | Vector3Tuple;
+type CameraMode = 'perspective' | 'orthographic';
+interface PerspectiveCameraConfig {
+    fov?: number;
+    near?: number;
+    far?: number;
+    position?: Vector3Like;
+    zoom?: number;
+}
+interface OrthographicCameraConfig {
+    size?: number;
+    near?: number;
+    far?: number;
+    position?: Vector3Like;
+    zoom?: number;
+}
+interface DualCameraControlsOptions {
+    domElement?: HTMLElement;
+    initialMode?: CameraMode;
+    initialTarget?: Vector3Like;
+    perspective?: PerspectiveCameraConfig;
+    orthographic?: OrthographicCameraConfig;
+}
+interface ModeChangedEvent {
+    type: 'modechange';
+    mode: CameraMode;
+    previousMode: CameraMode;
+    camera: THREE.PerspectiveCamera | THREE.OrthographicCamera;
+}
+/**
+ * Camera controls that manage both perspective and orthographic cameras while
+ * extending {@link CameraControls}. Provides helpers to toggle between the
+ * camera types and keep the framing consistent.
+ */
+declare class DualCameraControls extends CameraControls {
+    readonly perspectiveCamera: THREE.PerspectiveCamera;
+    readonly orthographicCamera: THREE.OrthographicCamera;
+    private readonly renderer;
+    private readonly domElementRef;
+    private activeMode;
+    private readonly minOrthoHalfHeight;
+    private readonly updateClock;
+    constructor(renderer: THREE.WebGLRenderer, options?: DualCameraControlsOptions);
+    get mode(): CameraMode;
+    /**
+     * Returns the currently active camera instance.
+     */
+    get activeCamera(): THREE.PerspectiveCamera | THREE.OrthographicCamera;
+    /**
+     * Switch to the perspective camera while keeping the current framing.
+     */
+    switchToPerspective(enableTransition?: boolean): void;
+    /**
+     * Switch to the orthographic camera while keeping the current framing.
+     */
+    switchToOrthographic(enableTransition?: boolean): void;
+    /**
+     * Toggles between perspective and orthographic camera modes.
+     */
+    toggleCameraMode(enableTransition?: boolean): void;
+    /**
+     * Update camera projection parameters when the viewport size changes.
+     */
+    handleResize(width: number, height: number): void;
+    /**
+     * Moves the camera to a new position and target.
+     */
+    moveCamera(position: Vector3Like, target: Vector3Like, enableTransition?: boolean): Promise<void>;
+    /**
+     * Updates the controls using an internally managed clock.
+     * Useful when you don't want to pass delta time each frame.
+     */
+    updateDelta(): ReturnType<CameraControls['update']>;
+    private updateInputBindingsForMode;
+    private updateOrthographicFrustum;
+}
+
+export { type CameraMode, DualCameraControls, type DualCameraControlsOptions, type ModeChangedEvent, type OrthographicCameraConfig, type PerspectiveCameraConfig };

package/dist/camera/index.d.ts

@@ -0,0 +1,82 @@
+import * as THREE from 'three';
+import CameraControls from 'camera-controls';
+
+type Vector3Tuple = [number, number, number];
+type Vector3Like = THREE.Vector3 | Vector3Tuple;
+type CameraMode = 'perspective' | 'orthographic';
+interface PerspectiveCameraConfig {
+    fov?: number;
+    near?: number;
+    far?: number;
+    position?: Vector3Like;
+    zoom?: number;
+}
+interface OrthographicCameraConfig {
+    size?: number;
+    near?: number;
+    far?: number;
+    position?: Vector3Like;
+    zoom?: number;
+}
+interface DualCameraControlsOptions {
+    domElement?: HTMLElement;
+    initialMode?: CameraMode;
+    initialTarget?: Vector3Like;
+    perspective?: PerspectiveCameraConfig;
+    orthographic?: OrthographicCameraConfig;
+}
+interface ModeChangedEvent {
+    type: 'modechange';
+    mode: CameraMode;
+    previousMode: CameraMode;
+    camera: THREE.PerspectiveCamera | THREE.OrthographicCamera;
+}
+/**
+ * Camera controls that manage both perspective and orthographic cameras while
+ * extending {@link CameraControls}. Provides helpers to toggle between the
+ * camera types and keep the framing consistent.
+ */
+declare class DualCameraControls extends CameraControls {
+    readonly perspectiveCamera: THREE.PerspectiveCamera;
+    readonly orthographicCamera: THREE.OrthographicCamera;
+    private readonly renderer;
+    private readonly domElementRef;
+    private activeMode;
+    private readonly minOrthoHalfHeight;
+    private readonly updateClock;
+    constructor(renderer: THREE.WebGLRenderer, options?: DualCameraControlsOptions);
+    get mode(): CameraMode;
+    /**
+     * Returns the currently active camera instance.
+     */
+    get activeCamera(): THREE.PerspectiveCamera | THREE.OrthographicCamera;
+    /**
+     * Switch to the perspective camera while keeping the current framing.
+     */
+    switchToPerspective(enableTransition?: boolean): void;
+    /**
+     * Switch to the orthographic camera while keeping the current framing.
+     */
+    switchToOrthographic(enableTransition?: boolean): void;
+    /**
+     * Toggles between perspective and orthographic camera modes.
+     */
+    toggleCameraMode(enableTransition?: boolean): void;
+    /**
+     * Update camera projection parameters when the viewport size changes.
+     */
+    handleResize(width: number, height: number): void;
+    /**
+     * Moves the camera to a new position and target.
+     */
+    moveCamera(position: Vector3Like, target: Vector3Like, enableTransition?: boolean): Promise<void>;
+    /**
+     * Updates the controls using an internally managed clock.
+     * Useful when you don't want to pass delta time each frame.
+     */
+    updateDelta(): ReturnType<CameraControls['update']>;
+    private updateInputBindingsForMode;
+    private updateOrthographicFrustum;
+}
+
+export { type CameraMode, DualCameraControls, type DualCameraControlsOptions, type ModeChangedEvent, type OrthographicCameraConfig, type PerspectiveCameraConfig };

package/dist/camera/index.mjs

@@ -0,0 +1,7 @@
+import {
+  DualCameraControls
+} from "../chunk-BYRZCHE7.mjs";
+export {
+  DualCameraControls
+};
+//# sourceMappingURL=index.mjs.map

package/dist/camera/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}