@flighthq/camera-controls 0.3.1-next.975.01aea94 → 0.4.0-edge.1908.751021c

package/dist/cameraShake.d.ts

@@ -0,0 +1,7 @@
+import type { CameraShake, CameraShakeOffset, CameraShakeOptions } from '@flighthq/types/contract';
+export declare function addCameraShakeTrauma(shake: CameraShake, amount: number): void;
+export declare function createCameraShake(options?: Readonly<CameraShakeOptions>): CameraShake;
+export declare function createCameraShakeOffset(): CameraShakeOffset;
+export declare function resetCameraShake(shake: CameraShake): void;
+export declare function updateCameraShake(shake: CameraShake, dt: number, out: CameraShakeOffset): void;
+//# sourceMappingURL=cameraShake.d.ts.map

package/dist/cameraShake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraShake.d.ts","sourceRoot":"","sources":["../src/cameraShake.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,WAAW,CASrF;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAGzD;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA8B9F"}

package/dist/cameraShake.js

@@ -0,0 +1,77 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { clamp } from '@flighthq/math/contract';
+export function addCameraShakeTrauma(shake, amount) {
+    shake.trauma = clamp(shake.trauma + amount, 0, 1);
+}
+export function createCameraShake(options) {
+    return createEntity({
+        decay: options?.decay ?? 1.5,
+        frequency: options?.frequency ?? 15,
+        rotationAmplitude: options?.rotationAmplitude ?? 3,
+        time: 0,
+        translationAmplitude: options?.translationAmplitude ?? 0.5,
+        trauma: 0,
+    });
+}
+export function createCameraShakeOffset() {
+    return { rotationX: 0, rotationY: 0, rotationZ: 0, x: 0, y: 0, z: 0 };
+}
+export function resetCameraShake(shake) {
+    shake.trauma = 0;
+    shake.time = 0;
+}
+// Advances the shake clock by `dt`, decays trauma, and writes the resulting additive offset into
+// `out`. When trauma is zero the output is zeroed and no work is done beyond the decay check.
+// The noise uses three incommensurate sine phases per axis — cheap, deterministic, and smooth.
+export function updateCameraShake(shake, dt, out) {
+    shake.time += dt;
+    shake.trauma = Math.max(0, shake.trauma - shake.decay * dt);
+    if (shake.trauma <= 0) {
+        out.x = 0;
+        out.y = 0;
+        out.z = 0;
+        out.rotationX = 0;
+        out.rotationY = 0;
+        out.rotationZ = 0;
+        return;
+    }
+    const intensity = shake.trauma * shake.trauma;
+    const t = shake.time * shake.frequency;
+    const tx = sampleNoise(t, SEED_TX_A, SEED_TX_B, SEED_TX_C);
+    const ty = sampleNoise(t, SEED_TY_A, SEED_TY_B, SEED_TY_C);
+    const tz = sampleNoise(t, SEED_TZ_A, SEED_TZ_B, SEED_TZ_C);
+    const rx = sampleNoise(t, SEED_RX_A, SEED_RX_B, SEED_RX_C);
+    const ry = sampleNoise(t, SEED_RY_A, SEED_RY_B, SEED_RY_C);
+    const rz = sampleNoise(t, SEED_RZ_A, SEED_RZ_B, SEED_RZ_C);
+    out.x = tx * intensity * shake.translationAmplitude;
+    out.y = ty * intensity * shake.translationAmplitude;
+    out.z = tz * intensity * shake.translationAmplitude;
+    out.rotationX = rx * intensity * shake.rotationAmplitude;
+    out.rotationY = ry * intensity * shake.rotationAmplitude;
+    out.rotationZ = rz * intensity * shake.rotationAmplitude;
+}
+// Three-frequency sine composite in [-1, 1]. The frequencies are incommensurate (prime-ratio
+// multiples) so the combined signal has no visible loop period within any realistic shake duration.
+function sampleNoise(t, seedA, seedB, seedC) {
+    return (Math.sin(t * seedA) + Math.sin(t * seedB) + Math.sin(t * seedC)) / 3;
+}
+// Frequency multipliers — irrational-ratio primes keep the combined waveform aperiodic.
+const SEED_TX_A = 1.0;
+const SEED_TX_B = 2.31;
+const SEED_TX_C = 3.53;
+const SEED_TY_A = 1.17;
+const SEED_TY_B = 2.63;
+const SEED_TY_C = 3.89;
+const SEED_TZ_A = 1.37;
+const SEED_TZ_B = 2.41;
+const SEED_TZ_C = 3.71;
+const SEED_RX_A = 1.53;
+const SEED_RX_B = 2.79;
+const SEED_RX_C = 3.47;
+const SEED_RY_A = 1.71;
+const SEED_RY_B = 2.17;
+const SEED_RY_C = 3.91;
+const SEED_RZ_A = 1.89;
+const SEED_RZ_B = 2.53;
+const SEED_RZ_C = 3.29;
+//# sourceMappingURL=cameraShake.js.map

package/dist/cameraShake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraShake.js","sourceRoot":"","sources":["../src/cameraShake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGhD,MAAM,UAAU,oBAAoB,CAAC,KAAkB,EAAE,MAAc;IACrE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAsC;IACtE,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG;QAC5B,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE;QACnC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC;QAClD,IAAI,EAAE,CAAC;QACP,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,IAAI,GAAG;QAC1D,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,iGAAiG;AACjG,8FAA8F;AAC9F,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,KAAkB,EAAE,EAAU,EAAE,GAAsB;IACtF,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IACjB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACV,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACV,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACV,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAEvC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAE3D,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,oBAAoB,CAAC;IACpD,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,oBAAoB,CAAC;IACpD,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,oBAAoB,CAAC;IACpD,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACzD,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACzD,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAC3D,CAAC;AAED,6FAA6F;AAC7F,oGAAoG;AACpG,SAAS,WAAW,CAAC,CAAS,EAAE,KAAa,EAAE,KAAa,EAAE,KAAa;IACzE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,wFAAwF;AACxF,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC"}

package/dist/contract.d.ts

@@ -1,3 +1,4 @@
+export * from './cameraShake';
 export * from './flyCameraController';
 export * from './follow';
 export * from './framing';

package/dist/contract.d.ts.map

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

package/dist/contract.js

@@ -1,3 +1,4 @@
+export * from './cameraShake';
 export * from './flyCameraController';
 export * from './follow';
 export * from './framing';

package/dist/contract.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { cloneFlyCameraController, cloneOrbitCameraController, copyFlyCameraController, copyOrbitCameraController, createFlyCameraController, createOrbitCameraController, dollyOrbitCameraController, frameOrbitCameraControllerToSphere, getPerspectiveProjectionFrameDistanceToSphere, lookFlyCameraController, moveFlyCameraController, panOrbitCameraController, panOrbitCameraControllerInViewPlane, resetFlyCameraController, resetOrbitCameraController, rotateOrbitCameraController, setOrthographicProjectionFrameToSphere, snapFlyCameraController, snapOrbitCameraController, updateCamera2DFollow, updateFlyCameraController, updateOrbitCameraController, } from './contract';
+export { addCameraShakeTrauma, cloneFlyCameraController, cloneOrbitCameraController, copyFlyCameraController, copyOrbitCameraController, createCameraShake, createCameraShakeOffset, createFlyCameraController, createOrbitCameraController, dollyOrbitCameraController, frameOrbitCameraControllerToSphere, getPerspectiveProjectionFrameDistanceToSphere, lookFlyCameraController, moveFlyCameraController, panOrbitCameraController, panOrbitCameraControllerInViewPlane, resetCameraShake, resetFlyCameraController, resetOrbitCameraController, rotateOrbitCameraController, setOrthographicProjectionFrameToSphere, snapFlyCameraController, snapOrbitCameraController, updateCamera2DFollow, updateCameraShake, updateFlyCameraController, updateOrbitCameraController, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kCAAkC,EAClC,6CAA6C,EAC7C,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,mCAAmC,EACnC,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,sCAAsC,EACtC,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kCAAkC,EAClC,6CAA6C,EAC7C,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,mCAAmC,EACnC,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,sCAAsC,EACtC,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { cloneFlyCameraController, cloneOrbitCameraController, copyFlyCameraController, copyOrbitCameraController, createFlyCameraController, createOrbitCameraController, dollyOrbitCameraController, frameOrbitCameraControllerToSphere, getPerspectiveProjectionFrameDistanceToSphere, lookFlyCameraController, moveFlyCameraController, panOrbitCameraController, panOrbitCameraControllerInViewPlane, resetFlyCameraController, resetOrbitCameraController, rotateOrbitCameraController, setOrthographicProjectionFrameToSphere, snapFlyCameraController, snapOrbitCameraController, updateCamera2DFollow, updateFlyCameraController, updateOrbitCameraController, } from './contract';
+export { addCameraShakeTrauma, cloneFlyCameraController, cloneOrbitCameraController, copyFlyCameraController, copyOrbitCameraController, createCameraShake, createCameraShakeOffset, createFlyCameraController, createOrbitCameraController, dollyOrbitCameraController, frameOrbitCameraControllerToSphere, getPerspectiveProjectionFrameDistanceToSphere, lookFlyCameraController, moveFlyCameraController, panOrbitCameraController, panOrbitCameraControllerInViewPlane, resetCameraShake, resetFlyCameraController, resetOrbitCameraController, rotateOrbitCameraController, setOrthographicProjectionFrameToSphere, snapFlyCameraController, snapOrbitCameraController, updateCamera2DFollow, updateCameraShake, updateFlyCameraController, updateOrbitCameraController, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kCAAkC,EAClC,6CAA6C,EAC7C,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,mCAAmC,EACnC,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,sCAAsC,EACtC,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kCAAkC,EAClC,6CAA6C,EAC7C,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,mCAAmC,EACnC,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,sCAAsC,EACtC,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/camera-controls",
-  "version": "0.3.1-next.975.01aea94",
+  "version": "0.4.0-edge.1908.751021c",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,11 +38,11 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/camera": "0.3.1-next.975.01aea94",
-    "@flighthq/entity": "0.3.1-next.975.01aea94",
-    "@flighthq/geometry": "0.3.1-next.975.01aea94",
-    "@flighthq/math": "0.3.1-next.975.01aea94",
-    "@flighthq/types": "0.3.1-next.975.01aea94"
+    "@flighthq/camera": "0.4.0-edge.1908.751021c",
+    "@flighthq/entity": "0.4.0-edge.1908.751021c",
+    "@flighthq/geometry": "0.4.0-edge.1908.751021c",
+    "@flighthq/math": "0.4.0-edge.1908.751021c",
+    "@flighthq/types": "0.4.0-edge.1908.751021c"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/cameraShake.test.ts

@@ -0,0 +1,157 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  addCameraShakeTrauma,
+  createCameraShake,
+  createCameraShakeOffset,
+  resetCameraShake,
+  updateCameraShake,
+} from './cameraShake';
+
+describe('addCameraShakeTrauma', () => {
+  it('accumulates trauma clamped to 1', () => {
+    const shake = createCameraShake();
+    addCameraShakeTrauma(shake, 0.3);
+    expect(shake.trauma).toBe(0.3);
+    addCameraShakeTrauma(shake, 0.5);
+    expect(shake.trauma).toBe(0.8);
+    addCameraShakeTrauma(shake, 0.5);
+    expect(shake.trauma).toBe(1);
+  });
+
+  it('does not go below zero', () => {
+    const shake = createCameraShake();
+    addCameraShakeTrauma(shake, -1);
+    expect(shake.trauma).toBe(0);
+  });
+});
+
+describe('createCameraShake', () => {
+  it('creates with default values', () => {
+    const shake = createCameraShake();
+    expect(shake.trauma).toBe(0);
+    expect(shake.decay).toBe(1.5);
+    expect(shake.frequency).toBe(15);
+    expect(shake.translationAmplitude).toBe(0.5);
+    expect(shake.rotationAmplitude).toBe(3);
+    expect(shake.time).toBe(0);
+  });
+
+  it('accepts custom options', () => {
+    const shake = createCameraShake({ decay: 2, frequency: 20, translationAmplitude: 1, rotationAmplitude: 5 });
+    expect(shake.decay).toBe(2);
+    expect(shake.frequency).toBe(20);
+    expect(shake.translationAmplitude).toBe(1);
+    expect(shake.rotationAmplitude).toBe(5);
+  });
+});
+
+describe('createCameraShakeOffset', () => {
+  it('creates a zeroed offset', () => {
+    const out = createCameraShakeOffset();
+    expect(out.x).toBe(0);
+    expect(out.y).toBe(0);
+    expect(out.z).toBe(0);
+    expect(out.rotationX).toBe(0);
+    expect(out.rotationY).toBe(0);
+    expect(out.rotationZ).toBe(0);
+  });
+});
+
+describe('resetCameraShake', () => {
+  it('zeros trauma and time', () => {
+    const shake = createCameraShake();
+    addCameraShakeTrauma(shake, 0.8);
+    const out = createCameraShakeOffset();
+    updateCameraShake(shake, 0.1, out);
+    expect(shake.trauma).toBeGreaterThan(0);
+    expect(shake.time).toBeGreaterThan(0);
+    resetCameraShake(shake);
+    expect(shake.trauma).toBe(0);
+    expect(shake.time).toBe(0);
+  });
+});
+
+describe('updateCameraShake', () => {
+  it('produces zero offset when trauma is zero', () => {
+    const shake = createCameraShake();
+    const out = createCameraShakeOffset();
+    updateCameraShake(shake, 1 / 60, out);
+    expect(out.x).toBe(0);
+    expect(out.y).toBe(0);
+    expect(out.z).toBe(0);
+    expect(out.rotationX).toBe(0);
+    expect(out.rotationY).toBe(0);
+    expect(out.rotationZ).toBe(0);
+  });
+
+  it('produces non-zero offset when trauma is active', () => {
+    const shake = createCameraShake();
+    addCameraShakeTrauma(shake, 1);
+    const out = createCameraShakeOffset();
+    updateCameraShake(shake, 0.05, out);
+    const magnitude = Math.hypot(out.x, out.y, out.z);
+    expect(magnitude).toBeGreaterThan(0);
+  });
+
+  it('decays trauma over time', () => {
+    const shake = createCameraShake({ decay: 2 });
+    addCameraShakeTrauma(shake, 1);
+    const out = createCameraShakeOffset();
+    updateCameraShake(shake, 0.25, out);
+    expect(shake.trauma).toBeCloseTo(0.5, 10);
+    updateCameraShake(shake, 0.25, out);
+    expect(shake.trauma).toBe(0);
+  });
+
+  it('scales offset quadratically with trauma', () => {
+    const shake = createCameraShake({ decay: 0 });
+    const out = createCameraShakeOffset();
+
+    shake.trauma = 1;
+    shake.time = 0;
+    updateCameraShake(shake, 0.1, out);
+    const fullX = out.x;
+
+    shake.trauma = 0.5;
+    shake.time = 0;
+    updateCameraShake(shake, 0.1, out);
+    const halfX = out.x;
+
+    expect(Math.abs(halfX / fullX)).toBeCloseTo(0.25, 1);
+  });
+
+  it('advances time deterministically', () => {
+    const shakeA = createCameraShake({ decay: 0 });
+    const shakeB = createCameraShake({ decay: 0 });
+    addCameraShakeTrauma(shakeA, 0.7);
+    addCameraShakeTrauma(shakeB, 0.7);
+    const outA = createCameraShakeOffset();
+    const outB = createCameraShakeOffset();
+
+    updateCameraShake(shakeA, 0.016, outA);
+    updateCameraShake(shakeA, 0.016, outA);
+    updateCameraShake(shakeB, 0.016, outB);
+    updateCameraShake(shakeB, 0.016, outB);
+
+    expect(outA.x).toBe(outB.x);
+    expect(outA.y).toBe(outB.y);
+    expect(outA.rotationZ).toBe(outB.rotationZ);
+  });
+
+  it('keeps offsets within amplitude bounds', () => {
+    const shake = createCameraShake({ decay: 0, translationAmplitude: 1, rotationAmplitude: 5 });
+    addCameraShakeTrauma(shake, 1);
+    const out = createCameraShakeOffset();
+
+    for (let i = 0; i < 100; i += 1) {
+      updateCameraShake(shake, 0.01, out);
+      expect(Math.abs(out.x)).toBeLessThanOrEqual(1);
+      expect(Math.abs(out.y)).toBeLessThanOrEqual(1);
+      expect(Math.abs(out.z)).toBeLessThanOrEqual(1);
+      expect(Math.abs(out.rotationX)).toBeLessThanOrEqual(5);
+      expect(Math.abs(out.rotationY)).toBeLessThanOrEqual(5);
+      expect(Math.abs(out.rotationZ)).toBeLessThanOrEqual(5);
+    }
+  });
+});