Add overloads that accept capacity

Author: xPaw

ValveKeyValue/ValveKeyValue.Test/KVObjectApiTestCase.cs

@@ -496,6 +496,46 @@ public void EmptyArrayFactory()
             Assert.That((string)arr[0], Is.EqualTo("element"));
         }
 
+        [Test]
+        public void ArrayFactoryWithCapacity()
+        {
+            var arr = KVObject.Array(4);
+
+            Assert.That(arr.IsArray, Is.True);
+            Assert.That(arr.ValueType, Is.EqualTo(KVValueType.Array));
+            Assert.That(arr.Count, Is.EqualTo(0));
+
+            arr.Add("a");
+            arr.Add("b");
+            Assert.That(arr.Count, Is.EqualTo(2));
+        }
+
+        [Test]
+        public void CollectionFactoryWithCapacity()
+        {
+            var obj = KVObject.Collection(4);
+
+            Assert.That(obj.ValueType, Is.EqualTo(KVValueType.Collection));
+            Assert.That(obj.Count, Is.EqualTo(0));
+
+            obj.Add("key", "value");
+            Assert.That(obj.Count, Is.EqualTo(1));
+            Assert.That((string)obj["key"], Is.EqualTo("value"));
+        }
+
+        [Test]
+        public void ListCollectionFactoryWithCapacity()
+        {
+            var obj = KVObject.ListCollection(4);
+
+            Assert.That(obj.ValueType, Is.EqualTo(KVValueType.Collection));
+            Assert.That(obj.Count, Is.EqualTo(0));
+
+            obj.Add("key", "value");
+            Assert.That(obj.Count, Is.EqualTo(1));
+            Assert.That((string)obj["key"], Is.EqualTo("value"));
+        }
+
         [Test]
         public void DefaultConstructorCreatesDictBacked()
         {

ValveKeyValue/ValveKeyValue.Test/Test Data/apisurface.txt

@@ -156,12 +156,14 @@ public class ValveKeyValue.KVObject
     public void Add(string key, ValveKeyValue.KVObject value);
     public void Add(ValveKeyValue.KVObject value);
     public static ValveKeyValue.KVObject Array();
+    public static ValveKeyValue.KVObject Array(int capacity);
     public static ValveKeyValue.KVObject Array(System.Collections.Generic.IEnumerable`1[[ValveKeyValue.KVObject]] elements);
     public byte[] AsBlob();
     public ReadOnlySpan`1[[byte]] AsSpan();
     public static ValveKeyValue.KVObject Blob(byte[] data);
     public void Clear();
     public static ValveKeyValue.KVObject Collection();
+    public static ValveKeyValue.KVObject Collection(int capacity);
     public static ValveKeyValue.KVObject Collection(System.Collections.Generic.IEnumerable`1[[System.Collections.Generic.KeyValuePair`2[[string, ValveKeyValue.KVObject]]]] children);
     public bool ContainsKey(string name);
     public bool Equals(object obj);
@@ -181,6 +183,7 @@ public class ValveKeyValue.KVObject
     public int GetHashCode();
     public Type GetType();
     public static ValveKeyValue.KVObject ListCollection();
+    public static ValveKeyValue.KVObject ListCollection(int capacity);
     public static ValveKeyValue.KVObject ListCollection(System.Collections.Generic.IEnumerable`1[[System.Collections.Generic.KeyValuePair`2[[string, ValveKeyValue.KVObject]]]] children);
     protected object MemberwiseClone();
     public static ValveKeyValue.KVObject Null();

ValveKeyValue/ValveKeyValue/KVObject.cs

@@ -368,6 +368,12 @@ public void Clear()
         public static KVObject Collection()
             => new();
 
+        /// <summary>
+        /// Creates an empty dictionary-backed collection with the specified capacity.
+        /// </summary>
+        public static KVObject Collection(int capacity)
+            => new(KVValueType.Collection, new Dictionary<string, KVObject>(capacity));
+
         /// <summary>
         /// Creates a dictionary-backed collection from the given children.
         /// </summary>
@@ -392,6 +398,13 @@ public static KVObject Collection(IEnumerable<KeyValuePair<string, KVObject>> ch
         public static KVObject ListCollection()
             => new(KVValueType.Collection, new List<KeyValuePair<string, KVObject>>());
 
+        /// <summary>
+        /// Creates an empty list-backed collection with the specified capacity.
+        /// Preserves insertion order and allows duplicate keys (used for KV1 format).
+        /// </summary>
+        public static KVObject ListCollection(int capacity)
+            => new(KVValueType.Collection, new List<KeyValuePair<string, KVObject>>(capacity));
+
         /// <summary>
         /// Creates a list-backed collection from the given children.
         /// Preserves insertion order and allows duplicate keys (used for KV1 format).
@@ -408,6 +421,12 @@ public static KVObject ListCollection(IEnumerable<KeyValuePair<string, KVObject>
         public static KVObject Array()
             => new(KVValueType.Array, new List<KVObject>());
 
+        /// <summary>
+        /// Creates an empty array-valued <see cref="KVObject"/> with the specified capacity.
+        /// </summary>
+        public static KVObject Array(int capacity)
+            => new(KVValueType.Array, new List<KVObject>(capacity));
+
         /// <summary>
         /// Creates an array-valued <see cref="KVObject"/> from the given elements.
         /// </summary>