@flighthq/camera-controls 0.2.1-next.444.a313478

package/dist/flyCameraController.d.ts

@@ -0,0 +1,6 @@
+import type { Camera3D, FlyCameraController, FlyCameraControllerOptions } from '@flighthq/types';
+export declare function createFlyCameraController(options?: Readonly<FlyCameraControllerOptions>): FlyCameraController;
+export declare function lookFlyCameraController(controller: FlyCameraController, deltaYaw: number, deltaPitch: number): void;
+export declare function moveFlyCameraController(controller: FlyCameraController, forward: number, right: number, up: number): void;
+export declare function updateFlyCameraController(controller: FlyCameraController, camera: Camera3D, deltaTime: number): void;
+//# sourceMappingURL=flyCameraController.d.ts.map

package/dist/flyCameraController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flyCameraController.d.ts","sourceRoot":"","sources":["../src/flyCameraController.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAKjG,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAAG,mBAAmB,CAc7G;AAKD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGnH;AAMD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GACT,IAAI,CAON;AAMD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBpH"}

package/dist/flyCameraController.js

@@ -0,0 +1,70 @@
+import { setCamera3DViewMatrix4FromLookAt } from '@flighthq/camera';
+import { createVector3 } from '@flighthq/geometry';
+import { clamp, damp } from '@flighthq/math';
+// Allocates a fly / first-person controller. `position` defaults to the origin, `yaw`/`pitch` to 0
+// (looking down -Z), `pitch` limits to just inside ±90° (no gimbal flip), and `smoothTime` to 0 (the
+// look angles snap to their goal each update). Current and goal angles start equal.
+export function createFlyCameraController(options) {
+    const yaw = options?.yaw ?? 0;
+    const pitch = options?.pitch ?? 0;
+    const position = options?.position;
+    return {
+        goalPitch: pitch,
+        goalYaw: yaw,
+        maxPitch: options?.maxPitch ?? DEFAULT_MAX_PITCH,
+        minPitch: options?.minPitch ?? DEFAULT_MIN_PITCH,
+        pitch,
+        position: createVector3(position?.x ?? 0, position?.y ?? 0, position?.z ?? 0),
+        smoothTime: options?.smoothTime ?? 0,
+        yaw,
+    };
+}
+// Moves the goal look angles by the given radian deltas: `deltaYaw` turns horizontally (unbounded),
+// `deltaPitch` looks up/down (clamped to [minPitch, maxPitch]). The app maps a mouse-look delta to
+// these; `updateFlyCameraController` eases the current angles toward the goal.
+export function lookFlyCameraController(controller, deltaYaw, deltaPitch) {
+    controller.goalYaw += deltaYaw;
+    controller.goalPitch = clamp(controller.goalPitch + deltaPitch, controller.minPitch, controller.maxPitch);
+}
+// Translates `position` along the current heading (immediate, not eased): `forward`/`right` in the
+// horizontal plane at the current yaw (so movement stays level regardless of pitch), `up` along
+// world-up. The app maps WASD/thrust to these. Reads position into locals before writing so aliasing
+// is safe.
+export function moveFlyCameraController(controller, forward, right, up) {
+    const sinYaw = Math.sin(controller.yaw);
+    const cosYaw = Math.cos(controller.yaw);
+    const position = controller.position;
+    position.x += sinYaw * forward + cosYaw * right;
+    position.y += up;
+    position.z += -cosYaw * forward + sinYaw * right;
+}
+// Advances the controller one step and writes the resulting view into `camera` (in place). Eases the
+// current yaw/pitch toward their clamped goals with `@flighthq/math` `damp` (frame-rate independent;
+// `smoothTime` <= 0 or `deltaTime` <= 0 snaps), builds the forward direction from the angles, and
+// calls look-at from `position` toward `position + forward` with a fixed world-up.
+export function updateFlyCameraController(controller, camera, deltaTime) {
+    const goalPitch = clamp(controller.goalPitch, controller.minPitch, controller.maxPitch);
+    if (controller.smoothTime > 0 && deltaTime > 0) {
+        const lambda = 1 / controller.smoothTime;
+        controller.yaw = damp(controller.yaw, controller.goalYaw, lambda, deltaTime);
+        controller.pitch = damp(controller.pitch, goalPitch, lambda, deltaTime);
+    }
+    else {
+        controller.yaw = controller.goalYaw;
+        controller.pitch = goalPitch;
+    }
+    const cosPitch = Math.cos(controller.pitch);
+    const sinPitch = Math.sin(controller.pitch);
+    const cosYaw = Math.cos(controller.yaw);
+    const sinYaw = Math.sin(controller.yaw);
+    const position = controller.position;
+    scratchTarget.x = position.x + sinYaw * cosPitch;
+    scratchTarget.y = position.y + sinPitch;
+    scratchTarget.z = position.z - cosYaw * cosPitch;
+    setCamera3DViewMatrix4FromLookAt(camera, position, scratchTarget, WORLD_UP);
+}
+const DEFAULT_MAX_PITCH = Math.PI / 2 - 0.01;
+const DEFAULT_MIN_PITCH = -Math.PI / 2 + 0.01;
+const WORLD_UP = createVector3(0, 1, 0);
+const scratchTarget = createVector3();
+//# sourceMappingURL=flyCameraController.js.map

package/dist/flyCameraController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flyCameraController.js","sourceRoot":"","sources":["../src/flyCameraController.ts"],"names":[],"mappings":"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"}

package/dist/follow.d.ts

@@ -0,0 +1,3 @@
+import type { Camera2D, Camera2DFollowOptions } from '@flighthq/types';
+export declare function updateCamera2DFollow(camera: Camera2D, targetX: number, targetY: number, deltaTime: number, options?: Readonly<Camera2DFollowOptions>): void;
+//# sourceMappingURL=follow.d.ts.map

package/dist/follow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../src/follow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAevE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACxC,IAAI,CAkDN"}

package/dist/follow.js

@@ -0,0 +1,71 @@
+import { getCamera2DVisibleBounds } from '@flighthq/camera';
+import { createRectangle } from '@flighthq/geometry';
+import { clamp, damp } from '@flighthq/math';
+// Moves the camera toward a follow target for one step, mutating `camera` in place.
+//
+// Three composed stages: (1) a deadzone box (half-extents around the camera center) yields a goal
+// position — inside the box the goal is the current position (no motion); once the target crosses an
+// edge the goal moves the minimum needed to keep the target on that edge. (2) The camera is smoothed
+// toward the goal with `@flighthq/math`'s `damp` using `smoothTime` as the time constant, so motion
+// is frame-rate independent; `smoothTime` <= 0 (or `deltaTime` <= 0) snaps to the goal. (3) If
+// `worldBounds` is given, the camera is clamped so the visible world rectangle stays inside the
+// level, centering on any axis where the level is smaller than the view.
+//
+// Camera3D inputs are read into locals before any write, so passing the same camera as target source is
+// safe. The deadzone box is axis-aligned in world space (it aligns with the view only when
+// `rotation` is 0).
+export function updateCamera2DFollow(camera, targetX, targetY, deltaTime, options) {
+    const camX = camera.x;
+    const camY = camera.y;
+    const deadHalfW = options?.deadzoneHalfWidth ?? 0;
+    const deadHalfH = options?.deadzoneHalfHeight ?? 0;
+    const smoothTime = options?.smoothTime ?? 0;
+    const worldBounds = options?.worldBounds;
+    const dx = targetX - camX;
+    let goalX = camX;
+    if (dx > deadHalfW)
+        goalX = targetX - deadHalfW;
+    else if (dx < -deadHalfW)
+        goalX = targetX + deadHalfW;
+    const dy = targetY - camY;
+    let goalY = camY;
+    if (dy > deadHalfH)
+        goalY = targetY - deadHalfH;
+    else if (dy < -deadHalfH)
+        goalY = targetY + deadHalfH;
+    let nextX;
+    let nextY;
+    if (smoothTime > 0 && deltaTime > 0) {
+        const lambda = 1 / smoothTime;
+        nextX = damp(camX, goalX, lambda, deltaTime);
+        nextY = damp(camY, goalY, lambda, deltaTime);
+    }
+    else {
+        nextX = goalX;
+        nextY = goalY;
+    }
+    if (worldBounds) {
+        // The visible-bounds size is independent of camera position, so it is safe to read before the
+        // camera moves; the rectangle is centered on the camera, so clamping the center by its half-
+        // extents keeps the visible rect inside the level.
+        getCamera2DVisibleBounds(camera, scratchBounds);
+        const halfVisW = scratchBounds.width * 0.5;
+        const halfVisH = scratchBounds.height * 0.5;
+        if (worldBounds.width <= scratchBounds.width) {
+            nextX = worldBounds.x + worldBounds.width * 0.5;
+        }
+        else {
+            nextX = clamp(nextX, worldBounds.x + halfVisW, worldBounds.x + worldBounds.width - halfVisW);
+        }
+        if (worldBounds.height <= scratchBounds.height) {
+            nextY = worldBounds.y + worldBounds.height * 0.5;
+        }
+        else {
+            nextY = clamp(nextY, worldBounds.y + halfVisH, worldBounds.y + worldBounds.height - halfVisH);
+        }
+    }
+    camera.x = nextX;
+    camera.y = nextY;
+}
+const scratchBounds = createRectangle();
+//# sourceMappingURL=follow.js.map

package/dist/follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","sourceRoot":"","sources":["../src/follow.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './flyCameraController';
+export * from './follow';
+export * from './orbitCameraController';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './flyCameraController';
+export * from './follow';
+export * from './orbitCameraController';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC"}

package/dist/orbitCameraController.d.ts

@@ -0,0 +1,7 @@
+import type { Camera3D, OrbitCameraController, OrbitCameraControllerOptions } from '@flighthq/types';
+export declare function createOrbitCameraController(options?: Readonly<OrbitCameraControllerOptions>): OrbitCameraController;
+export declare function dollyCameraController(controller: OrbitCameraController, deltaDistance: number): void;
+export declare function orbitCameraController(controller: OrbitCameraController, deltaAzimuth: number, deltaPolar: number): void;
+export declare function panCameraController(controller: OrbitCameraController, deltaRight: number, deltaUp: number): void;
+export declare function updateOrbitCameraController(controller: OrbitCameraController, camera: Camera3D, deltaTime: number): void;
+//# sourceMappingURL=orbitCameraController.d.ts.map

package/dist/orbitCameraController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbitCameraController.d.ts","sourceRoot":"","sources":["../src/orbitCameraController.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAMrG,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,4BAA4B,CAAC,GAAG,qBAAqB,CAmBnH;AAID,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMpG;AAKD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,qBAAqB,EACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,IAAI,CAGN;AAMD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOhH;AAOD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI,CAuBN"}

package/dist/orbitCameraController.js

@@ -0,0 +1,86 @@
+import { setCamera3DViewMatrix4FromLookAt } from '@flighthq/camera';
+import { createVector3 } from '@flighthq/geometry';
+import { clamp, damp } from '@flighthq/math';
+// Allocates an orbit controller. `target` defaults to the origin, `distance` to 10, angles to 0;
+// `polar` limits default to just inside ±90° so the look-at up vector never degenerates, `distance`
+// to (0.01, +∞), and `smoothTime` to 0 (no damping — the camera snaps to the goal each update). The
+// current and goal coordinates start equal, so a controller with no verb calls holds a fixed view.
+export function createOrbitCameraController(options) {
+    const azimuth = options?.azimuth ?? 0;
+    const polar = options?.polar ?? 0;
+    const distance = options?.distance ?? 10;
+    const target = options?.target;
+    return {
+        azimuth,
+        distance,
+        goalAzimuth: azimuth,
+        goalDistance: distance,
+        goalPolar: polar,
+        maxDistance: options?.maxDistance ?? Number.POSITIVE_INFINITY,
+        maxPolar: options?.maxPolar ?? DEFAULT_MAX_POLAR,
+        minDistance: options?.minDistance ?? DEFAULT_MIN_DISTANCE,
+        minPolar: options?.minPolar ?? DEFAULT_MIN_POLAR,
+        polar,
+        smoothTime: options?.smoothTime ?? 0,
+        target: createVector3(target?.x ?? 0, target?.y ?? 0, target?.z ?? 0),
+    };
+}
+// Moves the goal distance (dolly / zoom) by `deltaDistance`, clamped to [minDistance, maxDistance].
+// Negative moves the eye toward the target.
+export function dollyCameraController(controller, deltaDistance) {
+    controller.goalDistance = clamp(controller.goalDistance + deltaDistance, controller.minDistance, controller.maxDistance);
+}
+// Moves the goal orbit angles by the given radian deltas: `deltaAzimuth` rotates horizontally
+// (unbounded), `deltaPolar` vertically (clamped to [minPolar, maxPolar]). The app maps a pointer drag
+// to these; `updateOrbitCameraController` eases the current angles toward the goal.
+export function orbitCameraController(controller, deltaAzimuth, deltaPolar) {
+    controller.goalAzimuth += deltaAzimuth;
+    controller.goalPolar = clamp(controller.goalPolar + deltaPolar, controller.minPolar, controller.maxPolar);
+}
+// Slides the orbit `target` in the view plane: `deltaRight` along the camera's horizontal right axis
+// (at the current goal azimuth), `deltaUp` along world-up. Because the eye is derived from the target
+// each update, panning the target pans the whole view. Reads the target into locals before writing so
+// aliasing is safe.
+export function panCameraController(controller, deltaRight, deltaUp) {
+    const cosAzimuth = Math.cos(controller.goalAzimuth);
+    const sinAzimuth = Math.sin(controller.goalAzimuth);
+    const target = controller.target;
+    target.x += cosAzimuth * deltaRight;
+    target.y += deltaUp;
+    target.z += -sinAzimuth * deltaRight;
+}
+// Advances the controller one step and writes the resulting view into `camera` (in place). Eases the
+// current azimuth/polar/distance toward their clamped goals with `@flighthq/math` `damp`
+// (frame-rate independent; `smoothTime` <= 0 or `deltaTime` <= 0 snaps), places the eye on the sphere
+// around `target`, and calls look-at with a fixed world-up. The polar clamp keeps the eye off the
+// poles so the up vector stays valid.
+export function updateOrbitCameraController(controller, camera, deltaTime) {
+    const goalPolar = clamp(controller.goalPolar, controller.minPolar, controller.maxPolar);
+    const goalDistance = clamp(controller.goalDistance, controller.minDistance, controller.maxDistance);
+    if (controller.smoothTime > 0 && deltaTime > 0) {
+        const lambda = 1 / controller.smoothTime;
+        controller.azimuth = damp(controller.azimuth, controller.goalAzimuth, lambda, deltaTime);
+        controller.polar = damp(controller.polar, goalPolar, lambda, deltaTime);
+        controller.distance = damp(controller.distance, goalDistance, lambda, deltaTime);
+    }
+    else {
+        controller.azimuth = controller.goalAzimuth;
+        controller.polar = goalPolar;
+        controller.distance = goalDistance;
+    }
+    const cosPolar = Math.cos(controller.polar);
+    const sinPolar = Math.sin(controller.polar);
+    const cosAzimuth = Math.cos(controller.azimuth);
+    const sinAzimuth = Math.sin(controller.azimuth);
+    const target = controller.target;
+    scratchEye.x = target.x + controller.distance * sinAzimuth * cosPolar;
+    scratchEye.y = target.y + controller.distance * sinPolar;
+    scratchEye.z = target.z + controller.distance * cosAzimuth * cosPolar;
+    setCamera3DViewMatrix4FromLookAt(camera, scratchEye, target, WORLD_UP);
+}
+const DEFAULT_MAX_POLAR = Math.PI / 2 - 0.01;
+const DEFAULT_MIN_DISTANCE = 0.01;
+const DEFAULT_MIN_POLAR = -Math.PI / 2 + 0.01;
+const WORLD_UP = createVector3(0, 1, 0);
+const scratchEye = createVector3();
+//# sourceMappingURL=orbitCameraController.js.map

package/dist/orbitCameraController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbitCameraController.js","sourceRoot":"","sources":["../src/orbitCameraController.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@flighthq/camera-controls",
+  "version": "0.2.1-next.444.a313478",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/camera-controls"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/camera": "0.2.1-next.444.a313478",
+    "@flighthq/geometry": "0.2.1-next.444.a313478",
+    "@flighthq/math": "0.2.1-next.444.a313478",
+    "@flighthq/types": "0.2.1-next.444.a313478"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Subjective camera controllers: 2D follow and 3D orbit / fly over the pure camera",
+  "sideEffects": false
+}

package/src/flyCameraController.test.ts

@@ -0,0 +1,71 @@
+import { createCamera3D, createPerspectiveProjection, setCamera3DViewMatrix4FromLookAt } from '@flighthq/camera';
+import { createVector3 } from '@flighthq/geometry';
+import { describe, expect, it } from 'vitest';
+
+import {
+  createFlyCameraController,
+  lookFlyCameraController,
+  moveFlyCameraController,
+  updateFlyCameraController,
+} from './flyCameraController';
+
+function testCamera() {
+  return createCamera3D({ far: 100, near: 0.1, projection: createPerspectiveProjection({ aspect: 1, fovY: 1 }) });
+}
+
+describe('createFlyCameraController', () => {
+  it('applies documented defaults with current equal to goal', () => {
+    const c = createFlyCameraController();
+    expect(c.yaw).toBe(0);
+    expect(c.pitch).toBe(0);
+    expect(c.goalYaw).toBe(c.yaw);
+    expect(c.maxPitch).toBeLessThan(Math.PI / 2);
+    expect(c.minPitch).toBeGreaterThan(-Math.PI / 2);
+  });
+
+  it('seeds from options', () => {
+    const c = createFlyCameraController({ yaw: 0.5, pitch: 0.25, position: createVector3(1, 2, 3) });
+    expect(c.yaw).toBe(0.5);
+    expect(c.position.z).toBe(3);
+  });
+});
+
+describe('lookFlyCameraController', () => {
+  it('adds to the goal angles and clamps pitch', () => {
+    const c = createFlyCameraController({ minPitch: -1, maxPitch: 1 });
+    lookFlyCameraController(c, 0.5, 2);
+    expect(c.goalYaw).toBe(0.5);
+    expect(c.goalPitch).toBe(1); // clamped
+  });
+});
+
+describe('moveFlyCameraController', () => {
+  it('translates along the horizontal heading at yaw 0', () => {
+    const c = createFlyCameraController(); // yaw 0 => forward (0,0,-1), right (1,0,0)
+    moveFlyCameraController(c, 2, 3, 1);
+    expect(c.position.x).toBeCloseTo(3); // right
+    expect(c.position.y).toBeCloseTo(1); // up
+    expect(c.position.z).toBeCloseTo(-2); // forward is -Z
+  });
+});
+
+describe('updateFlyCameraController', () => {
+  it('snaps to the goal when smoothTime is 0 and writes the look-at view', () => {
+    const c = createFlyCameraController({ position: createVector3(0, 0, 5) }); // yaw/pitch 0 => looks toward -Z
+    const camera = testCamera();
+    updateFlyCameraController(c, camera, 0.016);
+    expect(c.yaw).toBe(c.goalYaw);
+
+    const expected = testCamera();
+    setCamera3DViewMatrix4FromLookAt(expected, createVector3(0, 0, 5), createVector3(0, 0, 4), createVector3(0, 1, 0));
+    for (let i = 0; i < 16; i++) expect(camera.view.m[i]).toBeCloseTo(expected.view.m[i]);
+  });
+
+  it('eases toward the goal when smoothTime is positive', () => {
+    const c = createFlyCameraController({ smoothTime: 0.5 });
+    lookFlyCameraController(c, 1, 0);
+    updateFlyCameraController(c, testCamera(), 0.016);
+    expect(c.yaw).toBeGreaterThan(0);
+    expect(c.yaw).toBeLessThan(1);
+  });
+});

package/src/follow.test.ts

@@ -0,0 +1,55 @@
+import { createCamera2D } from '@flighthq/camera';
+import { getCamera2DVisibleBounds } from '@flighthq/camera';
+import { createRectangle } from '@flighthq/geometry';
+import { describe, expect, it } from 'vitest';
+
+import { updateCamera2DFollow } from './follow';
+
+describe('updateCamera2DFollow', () => {
+  it('does not move when the target is inside the deadzone', () => {
+    const camera = createCamera2D(800, 600);
+    updateCamera2DFollow(camera, 50, 30, 0.016, { deadzoneHalfWidth: 100, deadzoneHalfHeight: 100 });
+    expect(camera.x).toBe(0);
+    expect(camera.y).toBe(0);
+  });
+
+  it('moves partway toward the target with smoothing over one step', () => {
+    const camera = createCamera2D(800, 600);
+    updateCamera2DFollow(camera, 100, 0, 0.016, { smoothTime: 0.1 });
+    expect(camera.x).toBeGreaterThan(0);
+    expect(camera.x).toBeLessThan(100);
+    expect(camera.y).toBeCloseTo(0, 9);
+  });
+
+  it('snaps the target onto the deadzone edge when smoothTime is 0', () => {
+    const camera = createCamera2D(800, 600);
+    updateCamera2DFollow(camera, 300, 0, 0.016, { deadzoneHalfWidth: 100, smoothTime: 0 });
+    // Goal moves the minimum so the target sits exactly on the deadzone edge (300 - 100).
+    expect(camera.x).toBe(200);
+    expect(camera.y).toBe(0);
+  });
+
+  it('clamps the camera so the visible bounds stay inside world bounds', () => {
+    const camera = createCamera2D(800, 600);
+    const worldBounds = createRectangle(0, 0, 2000, 2000);
+    updateCamera2DFollow(camera, 1900, 1000, 0.016, { smoothTime: 0, worldBounds });
+    // Half view is 400x300, so the center clamps to [400, 1600] x [300, 1700].
+    expect(camera.x).toBe(1600);
+    expect(camera.y).toBe(1000);
+    const visible = createRectangle();
+    getCamera2DVisibleBounds(camera, visible);
+    expect(visible.x).toBeGreaterThanOrEqual(worldBounds.x - 1e-9);
+    expect(visible.y).toBeGreaterThanOrEqual(worldBounds.y - 1e-9);
+    expect(visible.x + visible.width).toBeLessThanOrEqual(worldBounds.x + worldBounds.width + 1e-9);
+    expect(visible.y + visible.height).toBeLessThanOrEqual(worldBounds.y + worldBounds.height + 1e-9);
+  });
+
+  it('centers the camera on an axis where the world is smaller than the view', () => {
+    const camera = createCamera2D(800, 600);
+    // World is only 400 wide (< 800 view), so x centers on the world midpoint.
+    const worldBounds = createRectangle(0, 0, 400, 2000);
+    updateCamera2DFollow(camera, 1900, 1000, 0.016, { smoothTime: 0, worldBounds });
+    expect(camera.x).toBe(200);
+    expect(camera.y).toBe(1000);
+  });
+});

package/src/orbitCameraController.test.ts

@@ -0,0 +1,87 @@
+import { createCamera3D, createPerspectiveProjection, setCamera3DViewMatrix4FromLookAt } from '@flighthq/camera';
+import { createMatrix4, createVector3 } from '@flighthq/geometry';
+import { describe, expect, it } from 'vitest';
+
+import {
+  createOrbitCameraController,
+  dollyCameraController,
+  orbitCameraController,
+  panCameraController,
+  updateOrbitCameraController,
+} from './orbitCameraController';
+
+function testCamera() {
+  return createCamera3D({ far: 100, near: 0.1, projection: createPerspectiveProjection({ aspect: 1, fovY: 1 }) });
+}
+
+describe('createOrbitCameraController', () => {
+  it('applies documented defaults with current equal to goal', () => {
+    const c = createOrbitCameraController();
+    expect(c.distance).toBe(10);
+    expect(c.azimuth).toBe(0);
+    expect(c.goalDistance).toBe(c.distance);
+    expect(c.goalAzimuth).toBe(c.azimuth);
+    expect(c.maxPolar).toBeLessThan(Math.PI / 2);
+    expect(c.minPolar).toBeGreaterThan(-Math.PI / 2);
+  });
+
+  it('seeds from options', () => {
+    const c = createOrbitCameraController({ azimuth: 1, polar: 0.5, distance: 4, target: createVector3(1, 2, 3) });
+    expect(c.distance).toBe(4);
+    expect(c.polar).toBe(0.5);
+    expect(c.target.x).toBe(1);
+    expect(c.target.z).toBe(3);
+  });
+});
+
+describe('dollyCameraController', () => {
+  it('moves the goal distance, clamped to the range', () => {
+    const c = createOrbitCameraController({ distance: 5, minDistance: 2, maxDistance: 8 });
+    dollyCameraController(c, 2);
+    expect(c.goalDistance).toBe(7);
+    dollyCameraController(c, 100);
+    expect(c.goalDistance).toBe(8);
+    dollyCameraController(c, -100);
+    expect(c.goalDistance).toBe(2);
+  });
+});
+
+describe('orbitCameraController', () => {
+  it('adds to the goal angles and clamps polar', () => {
+    const c = createOrbitCameraController({ minPolar: -1, maxPolar: 1 });
+    orbitCameraController(c, 0.5, 2);
+    expect(c.goalAzimuth).toBe(0.5);
+    expect(c.goalPolar).toBe(1); // clamped
+  });
+});
+
+describe('panCameraController', () => {
+  it('slides the target along right (at azimuth 0) and world up', () => {
+    const c = createOrbitCameraController();
+    panCameraController(c, 3, 2);
+    expect(c.target.x).toBeCloseTo(3); // right = (cos0, 0, -sin0) = (1,0,0)
+    expect(c.target.y).toBeCloseTo(2);
+    expect(c.target.z).toBeCloseTo(0);
+  });
+});
+
+describe('updateOrbitCameraController', () => {
+  it('snaps to the goal when smoothTime is 0 and writes the look-at view', () => {
+    const c = createOrbitCameraController({ distance: 10 }); // azimuth 0, polar 0 => eye (0,0,10)
+    const camera = testCamera();
+    updateOrbitCameraController(c, camera, 0.016);
+    expect(c.azimuth).toBe(c.goalAzimuth);
+
+    const expected = testCamera();
+    setCamera3DViewMatrix4FromLookAt(expected, createVector3(0, 0, 10), createVector3(0, 0, 0), createVector3(0, 1, 0));
+    for (let i = 0; i < 16; i++) expect(camera.view.m[i]).toBeCloseTo(expected.view.m[i]);
+  });
+
+  it('eases toward the goal when smoothTime is positive', () => {
+    const c = createOrbitCameraController({ smoothTime: 0.5 });
+    orbitCameraController(c, 1, 0);
+    updateOrbitCameraController(c, testCamera(), 0.016);
+    expect(c.azimuth).toBeGreaterThan(0);
+    expect(c.azimuth).toBeLessThan(1); // has not reached the goal in one small step
+  });
+});