feat: add explicit camera clear modes

tests/Components/test_camera_light_component.cpp

@@ -3,6 +3,8 @@
 #include <XCEngine/Components/CameraComponent.h>
 #include <XCEngine/Components/LightComponent.h>
 
+#include <sstream>
+
 using namespace XCEngine::Components;
 
 namespace {
@@ -16,6 +18,7 @@ TEST(CameraComponent_Test, DefaultValues) {
     EXPECT_FLOAT_EQ(camera.GetNearClipPlane(), 0.1f);
     EXPECT_FLOAT_EQ(camera.GetFarClipPlane(), 1000.0f);
     EXPECT_TRUE(camera.IsPrimary());
+    EXPECT_EQ(camera.GetClearMode(), CameraClearMode::Auto);
 }
 
 TEST(CameraComponent_Test, SetterClamping) {
@@ -32,6 +35,19 @@ TEST(CameraComponent_Test, SetterClamping) {
     EXPECT_GT(camera.GetFarClipPlane(), camera.GetNearClipPlane());
 }
 
+TEST(CameraComponent_Test, SerializeRoundTripPreservesClearMode) {
+    CameraComponent source;
+    source.SetClearMode(CameraClearMode::DepthOnly);
+
+    std::stringstream stream;
+    source.Serialize(stream);
+
+    CameraComponent target;
+    target.Deserialize(stream);
+
+    EXPECT_EQ(target.GetClearMode(), CameraClearMode::DepthOnly);
+}
+
 TEST(LightComponent_Test, DefaultValues) {
     LightComponent light;
 

tests/Rendering/unit/test_camera_scene_renderer.cpp

@@ -287,6 +287,7 @@ TEST(SceneRenderer_Test, BuildsSortedRequestsForAllUsableCamerasAndHonorsOverrid
     auto* highCamera = highCameraObject->AddComponent<CameraComponent>();
     highCamera->SetPrimary(true);
     highCamera->SetDepth(5.0f);
+    highCamera->SetClearMode(CameraClearMode::None);
 
     SceneRenderer renderer;
     const RenderContext context = CreateValidContext();
@@ -302,7 +303,7 @@ TEST(SceneRenderer_Test, BuildsSortedRequestsForAllUsableCamerasAndHonorsOverrid
     EXPECT_EQ(defaultRequests[0].surface.GetHeight(), 180u);
     EXPECT_EQ(defaultRequests[1].camera, highCamera);
     EXPECT_EQ(defaultRequests[1].cameraDepth, 5.0f);
-    EXPECT_EQ(defaultRequests[1].clearFlags, RenderClearFlags::Depth);
+    EXPECT_EQ(defaultRequests[1].clearFlags, RenderClearFlags::None);
 
     const std::vector<CameraRenderRequest> overrideRequests =
         renderer.BuildRenderRequests(scene, lowCamera, context, surface);
@@ -311,6 +312,24 @@ TEST(SceneRenderer_Test, BuildsSortedRequestsForAllUsableCamerasAndHonorsOverrid
     EXPECT_EQ(overrideRequests[0].clearFlags, RenderClearFlags::All);
 }
 
+TEST(SceneRenderer_Test, HonorsExplicitOverrideCameraClearMode) {
+    Scene scene("SceneRendererOverrideClearModeScene");
+
+    GameObject* cameraObject = scene.CreateGameObject("Camera");
+    auto* camera = cameraObject->AddComponent<CameraComponent>();
+    camera->SetPrimary(true);
+    camera->SetDepth(2.0f);
+    camera->SetClearMode(CameraClearMode::DepthOnly);
+
+    SceneRenderer renderer;
+    const std::vector<CameraRenderRequest> requests =
+        renderer.BuildRenderRequests(scene, camera, CreateValidContext(), RenderSurface(640, 360));
+
+    ASSERT_EQ(requests.size(), 1u);
+    EXPECT_EQ(requests[0].camera, camera);
+    EXPECT_EQ(requests[0].clearFlags, RenderClearFlags::Depth);
+}
+
 TEST(SceneRenderer_Test, ForwardsPipelineLifetimeAndRenderCallsToCameraRenderer) {
     Scene scene("SceneRendererScene");