[RohanFredriksson]

Batch 4 of ROADMAP.md. This is stacked on #4 (batch 3), so it targets that branch and the diff shows only batch 4. Merge #4 first, then change this PR's base to master.

Changes

• CameraFollow component (components/camerafollow.hpp):
  • Follows its own entity by default, or another entity by id (setTarget).
  • Options: an offset, smoothing in seconds (exponential, so it behaves the same at any frame rate), a dead zone, and bounds that keep the view inside them, or centre it when the view is larger.
  • Snaps on start and when the target changes. Serialised and editable in the inspector.
  • The logic is in apply(camera, target, dt), so it is unit-tested without a window.
• Camera shake: Camera::shake(intensity, duration), plus stopShake, isShaking and getShakeOffset.
  • A random offset that fades out quadratically. The stronger of two overlapping shakes is kept.
  • Only getView changes, so getPosition, CameraFollow and mouse world coordinates aren't disturbed. A paused scene holds the offset.
• GamepadListener: polled each frame after glfwPollEvents.
  • Buttons have down, begin down and end down, compared with the previous poll. A disconnect releases every button.
  • Axes have a configurable dead zone, applied radially to sticks. Stick y points up, and triggers go from 0 to 1.
  • setState lets tests and tools fake a pad.
• Console: shake <intensity> [duration] and gamepads.
• Demo: hard impacts shake the camera, a gamepad's left stick pans, and A drops a box.
• Docs: README gets a "Camera and Gamepads" section. CLAUDE.md and ROADMAP.md are updated.

Testing

• New unit test tests/test_camera.cpp covers:
  • shake staying within its intensity, fading, pausing, stopping, and a weaker shake not cutting a stronger one short;
  • follow snapping, frame-rate-independent smoothing (60 and 30 fps land in the same place), dead zone, offset, and bounds (clamped, and centred when the view doesn't fit);
  • follow settings in JSON;
  • gamepad begin, end, disconnect, dead zone, stick direction and trigger range.
• New engine test tests/test_camera_engine.cpp covers following through the scene, switching and losing the target, shake from the console, and that a faked pad is replaced by the next real poll.
• Not covered: a real controller, since none can be connected in this environment. It is worth trying the demo with a gamepad.
• All 12 tests pass locally in the ASan build and the Release build.

🤖 Generated with Claude Code

https://claude.ai/code/session_015cNAkNqoDWA5gFReD1AsqV

---

Generated by Claude Code