From 3c5529c4bc99b106cdb1e9844a2fa0fcd71b61cc Mon Sep 17 00:00:00 2001
From: ssdfasd <2156608475@qq.com>
Date: Sun, 5 Apr 2026 19:37:20 +0800
Subject: [PATCH] Constrain visible render object compatibility alias

---
 engine/include/XCEngine/Rendering/VisibleRenderItem.h   | 2 --
 engine/include/XCEngine/Rendering/VisibleRenderObject.h | 8 ++++++++
 tests/Rendering/unit/test_render_scene_utility.cpp      | 6 ++++++
 3 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/engine/include/XCEngine/Rendering/VisibleRenderItem.h b/engine/include/XCEngine/Rendering/VisibleRenderItem.h
index 2e9528a8..8e4e4e30 100644
--- a/engine/include/XCEngine/Rendering/VisibleRenderItem.h
+++ b/engine/include/XCEngine/Rendering/VisibleRenderItem.h
@@ -27,7 +27,5 @@ struct VisibleRenderItem {
     Math::Matrix4x4 localToWorld = Math::Matrix4x4::Identity();
 };
 
-using VisibleRenderObject = VisibleRenderItem;
-
 } // namespace Rendering
 } // namespace XCEngine
diff --git a/engine/include/XCEngine/Rendering/VisibleRenderObject.h b/engine/include/XCEngine/Rendering/VisibleRenderObject.h
index 66a0c1f9..6e683c30 100644
--- a/engine/include/XCEngine/Rendering/VisibleRenderObject.h
+++ b/engine/include/XCEngine/Rendering/VisibleRenderObject.h
@@ -1,3 +1,11 @@
 #pragma once
 
 #include <XCEngine/Rendering/VisibleRenderItem.h>
+
+namespace XCEngine {
+namespace Rendering {
+
+using VisibleRenderObject = VisibleRenderItem;
+
+} // namespace Rendering
+} // namespace XCEngine
diff --git a/tests/Rendering/unit/test_render_scene_utility.cpp b/tests/Rendering/unit/test_render_scene_utility.cpp
index ad8c9594..da0ea095 100644
--- a/tests/Rendering/unit/test_render_scene_utility.cpp
+++ b/tests/Rendering/unit/test_render_scene_utility.cpp
@@ -6,6 +6,7 @@
 #include <XCEngine/Core/Asset/IResource.h>
 #include <XCEngine/Core/Math/Quaternion.h>
 #include <XCEngine/Rendering/RenderSceneUtility.h>
+#include <XCEngine/Rendering/VisibleRenderObject.h>
 #include <XCEngine/Resources/Mesh/Mesh.h>
 #include <XCEngine/Scene/Scene.h>
 
@@ -29,6 +30,7 @@ using XCEngine::Rendering::BuildRenderCameraData;
 using XCEngine::Rendering::CompareVisibleRenderItemsStable;
 using XCEngine::Rendering::CollectRenderItemsForEntityIds;
 using XCEngine::Rendering::VisibleRenderItem;
+using XCEngine::Rendering::VisibleRenderObject;
 using XCEngine::Resources::Mesh;
 using XCEngine::Resources::MeshSection;
 using XCEngine::Resources::StaticMeshVertex;
@@ -244,4 +246,8 @@ TEST(RenderSceneUtilityStandaloneTest, CompareVisibleRenderItemsUsesStableObject
     lowerIdHigherAddress->~GameObject();
 }
 
+TEST(RenderSceneUtilityStandaloneTest, LegacyVisibleRenderObjectAliasRemainsAvailableViaCompatibilityHeader) {
+    EXPECT_TRUE((std::is_same_v<VisibleRenderObject, VisibleRenderItem>));
+}
+
 } // namespace