[Feature] Support editor and scene-camera piloting workflows

[JeanPhilippeKernel]

Type

• Bug
• Feature
• Refactor / cleanup
• Task / chore

Overview

Allow an editor to pilot a scene camera, align a scene camera to the current editor view, and preview the active game camera in the viewport. This closes the practical handoff between free editor navigation and authored gameplay/cinematic cameras.

Context

The editor FlyCamera is deliberately independent from scene camera actors. That separation must remain: piloting is an explicit temporary mode, never an accidental write to an actor transform. Camera selection should build on the Outliner selection model (#672) and coexist with editor camera navigation from #784.

What needs to be done

1. Define explicit Enter Pilot, Exit Pilot, Align Active Camera to View, and Preview Active Camera commands.
2. Add a small camera-mode state machine that preserves/restores the editor camera state when piloting begins and ends.
3. Synchronize pilot movement to the selected scene-camera actor through its transform/component contract.
4. Add viewport status feedback for editor, pilot, and game-camera-preview modes.
5. Specify undo/redo behavior: one meaningful transform command for an interaction, with no edit when merely previewing.
6. Define safe behavior for deleted, hidden, invalid, or non-selected cameras while piloting.
7. Add platform-mapped shortcuts and command routing consistent with [Feature] Deliver standard editor navigation commands and preferences #784.

Resources

• [Feature] Deliver standard editor navigation commands and preferences #784 — navigation commands and preferences
• feat(editor): multi-actor selection in Outliner #672 — multi-actor Outliner selection
• Tetragrama/Controllers/EditorCameraController.cpp
• ZEngine/ZEngine/Rendering/Cameras/FlyCamera.*

Testing

• Unit-test state transitions, camera-state restoration, and invalid actor handling.
• Add editor tests for align-to-view and pilot transform updates.
• Manually pilot a camera, preview it, exit, undo/redo an edit, and verify editor controls resume on macOS, Windows, and Linux.

Acceptance criteria

• A scene camera can be explicitly piloted and safely exited.
• The editor can align a selected/active scene camera to its current view.
• Game-camera preview is available without mutating the actor transform.
• Pilot edits have deterministic undo/redo behavior.
• Camera mode and active target are visible in the viewport.
• Builds without warnings in Debug and Release.
• All relevant unit tests pass.
• No regression in existing functionality.

Estimated effort

4–7 days