Checkpoint.

Author: electricessence

source/CollectionWrapper.cs

@@ -20,18 +20,17 @@ protected virtual void AddInternal(T item)
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     public virtual void Add(T item) => AddInternal(item);
 
-    /// <inheritdoc cref="ICollection&lt;T&gt;" />
+    /// <summary>Adds more than one item.</summary>
     /// <param name="item1">First item to add.</param>
     /// <param name="item2">Additional item to add.</param>
     /// <param name="items">Extended param items to add.</param>
-    [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public virtual void Add(T item1, T item2, params T[] items)
-	{
-		AddInternal(item1);
-		AddInternal(item2);
-		foreach (T? i in items)
-			AddInternal(i);
-	}
+    public virtual void AddThese(T item1, T item2, params T[] items)
+    {
+        AddInternal(item1);
+        AddInternal(item2);
+        foreach (T? i in items)
+            AddInternal(i);
+    }
 
     /// <summary>
     /// Adds mutliple items to the collection.

source/DictionaryWrapper.cs

@@ -0,0 +1,50 @@
+using System.Collections.Generic;
+using System.Runtime.CompilerServices;
+
+namespace Open.Collections;
+
+/// <inheritdoc />
+public class DictionaryWrapper<TKey, TValue>
+    : CollectionWrapper<KeyValuePair<TKey, TValue>, IDictionary<TKey, TValue>>, IDictionary<TKey, TValue>
+{
+    /// <inheritdoc />
+    public DictionaryWrapper(int capacity = 0)
+        : base(new Dictionary<TKey, TValue>(capacity))
+    {
+    }
+
+    /// <inheritdoc />
+    public virtual TValue this[TKey key]
+    {
+        get => InternalSource[key];
+        set => InternalSource[key] = value;
+    }
+
+    /// <inheritdoc />
+    public virtual ICollection<TKey> Keys
+        => InternalSource.Keys;
+
+    /// <inheritdoc />
+    public virtual ICollection<TValue> Values
+        => InternalSource.Values;
+
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    /// <inheritdoc />
+    public virtual void Add(TKey key, TValue value)
+        => InternalSource.Add(key, value);
+
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    /// <inheritdoc />
+    public bool ContainsKey(TKey key)
+        => InternalSource.ContainsKey(key);
+
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    /// <inheritdoc />
+    public virtual bool Remove(TKey key)
+        => InternalSource.Remove(key);
+
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    /// <inheritdoc />
+    public bool TryGetValue(TKey key, out TValue value)
+        => InternalSource.TryGetValue(key, out value);
+}

source/IOrderedDictionary.cs

@@ -0,0 +1,68 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace Open.Collections;
+
+/// <summary>
+/// Represents a generic items of key/value pairs that are ordered independently of the key and value.
+/// </summary>
+/// <inheritdoc />
+public interface IOrderedDictionary<TKey, TValue> : IDictionary<TKey, TValue>
+{
+    /// <summary>
+    /// Adds an entry with the specified key and value into the <see cref="IOrderedDictionary{TKey,TValue}"/>.
+    /// </summary>
+    /// <returns>The index of the newly added entry</returns>
+    /// <inheritdoc cref="Insert(int, TKey, TValue)"/>
+    new int Add(TKey key, TValue value);
+
+    /// <summary>
+    /// Inserts a new entry into the <see cref="IOrderedDictionary{TKey,TValue}"/> items with the specified key and value at the specified index.
+    /// </summary>
+    /// <param name="index">The zero-based index at which the element should be inserted.</param>
+    /// <param name="key">The key of the entry to add.</param>
+    /// <param name="value">The value of the entry to add. The value can be <see langword="null"/> if the type of the values in the dictionary is a reference type.</param>
+    /// <exception cref="ArgumentOutOfRangeException"><paramref name="index"/> is less than 0.<br/>
+    /// -or-<br/>
+    /// <paramref name="index"/> is greater than <see cref="System.Collections.ICollection.Count"/>.</exception>
+    /// <exception cref="ArgumentException">An element with the same key already exists in the <see cref="IOrderedDictionary{TKey,TValue}"/>.</exception>
+    /// <exception cref="NotSupportedException">The <see cref="IOrderedDictionary{TKey,TValue}"/> is read-only.<br/>
+    /// -or-<br/>
+    /// The <see cref="IOrderedDictionary{TKey,TValue}"/> has a fized size.</exception>
+    void Insert(int index, TKey key, TValue value);
+
+    /// <summary>
+    /// Updates or creates and item.
+    /// </summary>
+    /// <returns>The index that was updated or added.</returns>
+    int SetValue(TKey key, TValue value);
+
+    /// <summary>
+    /// Returns the key at the requested <paramref name="index"/>.
+    /// </summary>
+    /// <exception cref="ArgumentOutOfRangeException">The index is less than zero or greater than the length of the collection.</exception>
+    TKey GetKeyAt(int index);
+
+    /// <summary>
+    /// Returns the value at the requested <paramref name="index"/>.
+    /// </summary>
+    /// <exception cref="ArgumentOutOfRangeException">The index is less than zero or greater than the length of the collection.</exception>
+    TValue GetValueAt(int index);
+
+    /// <summary>
+    /// Sets the <paramref name="value"/> of an item at the specified <paramref name="index"/>.
+    /// </summary>
+    /// <remarks><see langword="true"/> if the value changed; otherwise <see langword="false"/>.</remarks>
+    /// <exception cref="ArgumentOutOfRangeException">The index is less than zero or greater than the length of the collection.</exception>
+    bool SetValueAt(int index, TValue value);
+
+    /// <summary>
+    /// Removes the entry at the specified index from the <see cref="IOrderedDictionary{TKey,TValue}"/> items.
+    /// </summary>
+    /// <param name="index">The zero-based index of the entry to remove.</param>
+    /// <exception cref="ArgumentOutOfRangeException"><paramref name="index"/> is less than 0.<br/>
+    /// -or-<br/>
+    /// index is equal to or greater than <see cref="Count"/>.</exception>
+    void RemoveAt(int index);
+}