Render graph: native pass merging & heap-based aliasing

Major architecture upgrade:
- Add native render pass merging (hardware pass grouping, load/store op inference)
- Implement heap-based aliasing for textures & buffers (D3D12-style)
- Unify resource model: buffers and textures in one registry
- Extend builder API for buffer creation/usage, access flags, hints
- Improve barrier/state tracking (buffer hints, indirect argument state)
- Update caching, hashing, and debug output for new model
- Add enums/structs: AttachmentLoadOp, StoreOp, BufferHint, etc.
- D3D12 backend: support named resources, temp upload buffers, correct heap usage
- Update docs, benchmarks, and project files for new features

Brings render graph closer to AAA engine standards, enabling efficient memory usage, lower driver overhead, and a more flexible API.

Ghost.Graphics/RHI/IResourceAllocator.cs

@@ -1,32 +1,121 @@
 using Ghost.Core;
 using Ghost.Core.Graphics;
-using Misaki.HighPerformance.LowLevel.Collections;
 using Ghost.Graphics.Core;
+using Misaki.HighPerformance.LowLevel.Collections;
 
 namespace Ghost.Graphics.RHI;
 
+public enum ResourceAllocationType
+{
+    Default,
+    Temporary,
+    RenderGraphTransient,
+}
+
+public struct CreationOptions
+{
+    public ResourceAllocationType AllocationType
+    {
+        get; set;
+    }
+
+    public Handle<GPUResource> Heap
+    {
+        get; set;
+    }
+
+    public ulong Offset
+    {
+        get; set;
+    }
+}
+
+public enum HeapType
+{
+    Default,
+    Upload,
+    Readback
+}
+
+public enum HeapFlags
+{
+    None = 0,
+    AllowBuffers,
+    AllowTextures,
+    AllowRTAndDS,
+    AlowBufferAndTexture,
+}
+
+public struct AllocationDesc
+{
+    public ulong Size
+    {
+        get; set;
+    }
+
+    public ulong Alignment
+    {
+        get; set;
+    }
+
+    public HeapType HeapType
+    {
+        get; set;
+    }
+
+    public HeapFlags HeapFlags
+    {
+        get; set;
+    }
+}
+
 public interface IResourceAllocator : IDisposable
 {
+    /// <summary>
+    /// Allocates a block of memory on the GPU
+    /// </summary>
+    /// <param name="desc">Allocation description</param>
+    /// <param name="name">Debug name of the allocation</param>
+    /// <returns>An <see cref="Handle{GPUResource}"/> point to the allocated memory</returns>
+    Handle<GPUResource> Allocate(ref readonly AllocationDesc desc, string name);
+
     /// <summary>
     /// Creates a texture resource
     /// </summary>
     /// <param name="desc">Texture description</param>
+    /// <param name="name">Debug name of the resource</param>
+    /// <param name="options">Additional options of the resource allocation</param>
     /// <returns>An <see cref="Handle{Texture}"/> point to the resource</returns>
-    Handle<Texture> CreateTexture(ref readonly TextureDesc desc, bool tempResource = false);
+    Handle<Texture> CreateTexture(ref readonly TextureDesc desc, string name, CreationOptions options = default);
 
     /// <summary>
     /// Creates a render Target for off-screen rendering
     /// </summary>
     /// <param name="desc">Render Target description</param>
+    /// <param name="name">Debug name of the resource</param>
+    /// <param name="options">Additional options of the resource allocation</param>
     /// <returns>An <see cref="Handle{Texture}"/> point to the resource</returns>
-    Handle<Texture> CreateRenderTarget(ref readonly RenderTargetDesc desc, bool tempResource = false);
+    Handle<Texture> CreateRenderTarget(ref readonly RenderTargetDesc desc, string name, CreationOptions options = default);
 
     /// <summary>
     /// Creates a buffer resource
     /// </summary>
     /// <param name="desc">Buffer description</param>
+    /// <param name="name">Debug name of the resource</param>
+    /// <param name="options">Additional options of the resource allocation</param>
     /// <returns>An <see cref="Handle{GraphicsBuffer}"/> point to the resource</returns>
-    Handle<GraphicsBuffer> CreateBuffer(ref readonly BufferDesc desc, bool tempResource = false);
+    Handle<GraphicsBuffer> CreateBuffer(ref readonly BufferDesc desc, string name, CreationOptions options = default);
+
+    /// <summary>
+    /// Creates a temporary upload buffer of the specified size in bytes.
+    /// </summary>
+    /// <remarks>
+    /// This method has been optimized for frequent calls during frame updates. It efficiently manages memory to minimize fragmentation and overhead.
+    /// </remarks>
+    /// <param name="sizeInBytes">The size of the upload buffer to create, in bytes.</param>
+    /// <param name="offset">The offset within the upload buffer where the allocation begins.</param>
+    /// <returns>An <see cref="Handle{GraphicsBuffer}"/> pointing to the created upload buffer.</returns>
+    Handle<GraphicsBuffer> CreateTempUploadBuffer(ulong sizeInBytes, out ulong offset);
 
     /// <summary>
     /// Creates a new sampler object using the specified sampler description.