HLSF done, working on matrix

StgSharp.Common/HighPerformance/Memory/SlabAllocator.cs

@@ -28,17 +28,7 @@
 //     
 // -----------------------------------------------------------------------
 // -----------------------------------------------------------------------
-using StgSharp.HighPerformance.Memory;
-using StgSharp.Threading;
-
 using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Threading;
-using System.Threading.Tasks;
 
 namespace StgSharp.HighPerformance.Memory
 {
@@ -47,12 +37,62 @@ namespace StgSharp.HighPerformance.Memory
 
         public abstract nuint Allocate();
 
-        public static SlabAllocator<T> Create(nuint count, BufferLayout layout)
+        /// <summary>
+        ///   Creates a new SLAB allocator instance with the specified configuration.
+        /// </summary>
+        /// <param name="count">
+        ///   Initial number of objects that can be allocated.
+        /// </param>
+        /// <param name="layout">
+        ///   Memory layout strategy for the SLAB allocator.
+        /// </param>
+        /// <param name="concurrentSupport">
+        ///   Whether to enable concurrent access support.
+        /// </param>
+        /// <returns>
+        ///   A new SLAB allocator instance.
+        /// </returns>
+        /// <exception cref="ArgumentOutOfRangeException">
+        ///   Thrown when an invalid layout is specified.
+        /// </exception>
+        /// <exception cref="NotSupportedException">
+        ///   Thrown when requesting unsupported configurations.
+        /// </exception>
+        /// <remarks>
+        ///   <para><strong> Important Threading Considerations: </strong></para> <para> While SLAB
+        ///   allocators themselves may be designed for single-threaded use, allocated objects  are
+        ///   frequently shared across multiple threads in real-world applications. Due to the
+        ///   special  implementation of expandable concurrent sequential SLAB allocators, they rely
+        ///   on internal  expansion locks to ensure that memory buffer expansions (which involve
+        ///   copying the entire  buffer to a new location) do not occur while other threads are
+        ///   reading from allocated regions.</para> <para><strong> Sequential Layout Limitations:
+        ///   </strong><br /> Sequential layout SLAB allocators cannot provide a single-threaded
+        ///   version because:<list type="bullet"><item><description> They use contiguous memory
+        ///   layout that requires buffer expansion when capacity is exceeded
+        ///   </description></item><item><description> Buffer expansion involves copying all
+        ///   existing data to a new memory location </description></item><item><description>
+        ///   Without proper synchronization, concurrent access to allocated objects during
+        ///   expansion would cause memory corruption </description></item><item><description> The
+        ///   expansion lock mechanism is essential even if allocation itself is single-threaded
+        ///   </description></item></list></para> <para><strong> Chunked Layout: </strong><br />
+        ///   Chunked layout allocators can optionally provide single-threaded versions since they
+        ///   don't  require buffer expansion and copying. Each chunk is allocated independently,
+        ///   avoiding the  memory relocation issues present in sequential layouts.</para>
+        /// </remarks>
+        public static SlabAllocator<T> Create(nuint count, SlabBufferLayout layout, bool concurrentSupport = true)
         {
+            if (concurrentSupport) {
+                return layout switch
+                {
+                    SlabBufferLayout.Sequential => new ConcurrentSequentialSlabAllocator<T>(count),
+                    SlabBufferLayout.Chunked => new ConcurrentChunkedSlabAllocator<T>(count),
+                    _ => throw new ArgumentOutOfRangeException(nameof(layout), layout, null)
+                };
+            }
             return layout switch
             {
-                BufferLayout.Sequential => new SequentialSlabAllocator<T>(count),
-                BufferLayout.Chunked => new ChunkedSlabAllocator<T>(count),
+                SlabBufferLayout.Sequential => throw new NotSupportedException("Non-concurrent version of sequential layout SLAB is not supported due to expansion lock requirements for memory safety during buffer expansion."),
+                SlabBufferLayout.Chunked => new ChunkedSlabAllocator<T>(count),
                 _ => throw new ArgumentOutOfRangeException(nameof(layout), layout, null)
             };
         }
@@ -69,12 +109,11 @@ namespace StgSharp.HighPerformance.Memory
 
     }
 
-    public enum BufferLayout
+    public enum SlabBufferLayout
     {
 
         Sequential,
-        Chunked,
-        HybridLayerSegregatedFit
+        Chunked
 
     }
 }