feat(graphics): refactor pipeline keying and allocators

Major refactor of graphics pipeline keying, shader cache, and resource allocation.
Replaced most Allocator usage with AllocationHandle, modernized logger usage,
and unified pipeline state keys. Updated MeshUtility to use AllocationHandle.FreeList.
Added new shader pipeline architecture docs and improved error handling throughout.

BREAKING CHANGE: Pipeline keying and resource allocation APIs have changed.

src/Test/Ghost.Graphics.Test/RenderPipeline/TestRenderPipeline.cs

@@ -139,7 +139,7 @@ public unsafe partial class TestRenderPipeline : IRenderPipeline
                     continue;
                 }
 
-                var rtSize = new uint2(rtResult.Value.TextureDescription.Width, rtResult.Value.TextureDescription.Height);
+                var rtSize = new uint2(rtResult.Value.TextureDescriptor.Width, rtResult.Value.TextureDescriptor.Height);
                 var aspectScreen = (float)rtSize.x / rtSize.y;
 
 

src/Test/Ghost.Graphics.Test/Systems/RenderExtractionSystem.cs

@@ -52,9 +52,9 @@ public class RenderExtractionSystem : ISystem
             ref readonly var camLtwRef = ref camLtw.Get();
 
             // TODO: Classify transparent objects into a separate render list and render via oit.
-            var renderList = new RenderList(1, 64, Allocator.FreeList);
-            var transparentRenderList = new RenderList(1, 64, Allocator.FreeList);
-            var shadowCasterRenderList = new RenderList(1, 64, Allocator.FreeList);
+            var renderList = new RenderList(1, 64, AllocationHandle.FreeList);
+            var transparentRenderList = new RenderList(1, 64, AllocationHandle.FreeList);
+            var shadowCasterRenderList = new RenderList(1, 64, AllocationHandle.FreeList);
 
             // TODO: This chould be done in earallel jobs.
             foreach (var chunk in meshQuery.GetChunkIterator())

src/Test/Ghost.Graphics.Test/UnitTestApp.xaml.cs

@@ -36,11 +36,11 @@ public partial class UnitTestApp : Application
 
         UnhandledException += (sender, e) =>
         {
-            Logger.LogError(e.Exception);
+            Logger.Error(e.Exception);
 #if DEBUG
             System.Diagnostics.Debugger.Break();
 #endif
             Environment.FailFast("Unhandled exception", e.Exception);
         };
     }
-}
+}

src/Test/Ghost.Graphics.Test/Utilities/MeshUtility.cs

@@ -50,7 +50,7 @@ internal static class MeshUtility
             space_conversion = ufbx_space_conversion.UFBX_SPACE_CONVERSION_MODIFY_GEOMETRY,
         };
 
-        using var str = new UnsafeArray<byte>(Encoding.UTF8.GetByteCount(filePath) + 1, Allocator.FreeList);
+        using var str = new UnsafeArray<byte>(Encoding.UTF8.GetByteCount(filePath) + 1, AllocationHandle.FreeList);
         var count = Encoding.UTF8.GetBytes(filePath, str.AsSpan());
         str[count] = 0;
 
@@ -60,7 +60,7 @@ internal static class MeshUtility
             return Result.Failure(error.description.ToString());
         }
 
-        using var flatVertices = new UnsafeList<Vertex>(1024, Allocator.FreeList);
+        using var flatVertices = new UnsafeList<Vertex>(1024, AllocationHandle.FreeList);
 
         var needComputeNormals = false;
 
@@ -83,7 +83,7 @@ internal static class MeshUtility
 
                 var maxScratchIndices = (int)(pMesh->max_face_triangles * 3u);
 
-                using var triIndicesArray = new UnsafeArray<uint>(maxScratchIndices, Allocator.FreeList);
+                using var triIndicesArray = new UnsafeArray<uint>(maxScratchIndices, AllocationHandle.FreeList);
 
                 for (var j = 0u; j < pMesh->num_faces; j++)
                 {
@@ -142,8 +142,8 @@ internal static class MeshUtility
 
         var numIndices = (uint)flatVertices.Count;
 
-        using var weldedIndices = new UnsafeArray<uint>((int)numIndices, Allocator.FreeList);
-        using var cachedIndices = new UnsafeArray<uint>((int)numIndices, Allocator.FreeList);
+        using var weldedIndices = new UnsafeArray<uint>((int)numIndices, AllocationHandle.FreeList);
+        using var cachedIndices = new UnsafeArray<uint>((int)numIndices, AllocationHandle.FreeList);
 
         var stream = new ufbx_vertex_stream
         {