feat: added initial size

CHANGELOG.md

@@ -6,6 +6,9 @@ All notable changes to **ValueStringBuilder** will be documented in this file. T
 
 ## [Unreleased]
 
+### Added
+- New ctor that accepts an initial size
+
 ## [1.19.1] - 2024-04-19
 
 ### Changed

src/LinkDotNet.StringBuilder/ValueStringBuilder.cs

@@ -55,6 +55,16 @@ public ValueStringBuilder(ReadOnlySpan<char> initialText)
         Append(initialText);
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ValueStringBuilder"/> struct.
+    /// </summary>
+    /// <param name="initialCapacity">The initial capacity that will be allocated for this instance.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public ValueStringBuilder(int initialCapacity)
+    {
+        Grow(initialCapacity);
+    }
+
     /// <summary>
     /// Gets the current length of the represented string.
     /// </summary>

tests/LinkDotNet.StringBuilder.UnitTests/ValueStringBuilderTests.cs

@@ -505,12 +505,20 @@ public void GivenAString_WhenEnumerating_ThenShouldReturnCharacters()
     }
 
     [Fact]
-    public void GivenStringBuilder_WhenDisposed_ThenEmtpyStringReturned()
+    public void GivenStringBuilder_WhenDisposed_ThenEmptyStringReturned()
     {
         var builder = new ValueStringBuilder("Hello World");
 
         builder.Dispose();
 
         builder.ToString().Should().Be(string.Empty);
     }
+
+    [Fact]
+    public void ShouldInitializeWithCapacity()
+    {
+        using var builder = new ValueStringBuilder(128);
+
+        builder.Capacity.Should().Be(128);
+    }
 }