Add LooselyTypedCollection class

Author: lkrms

src/Concept/LooselyTypedCollection.php

@@ -0,0 +1,26 @@
+<?php declare(strict_types=1);
+
+namespace Lkrms\Concept;
+
+use Lkrms\Concern\TCollection;
+use Lkrms\Contract\ICollection;
+use Lkrms\Contract\IImmutable;
+
+/**
+ * Base class for collections of objects of an unenforced type
+ *
+ * Extend {@see TypedCollection} instead if type safety concerns outweigh
+ * performance.
+ *
+ * @template TKey of array-key
+ * @template TValue of object
+ *
+ * @implements ICollection<TKey,TValue>
+ */
+abstract class LooselyTypedCollection implements ICollection, IImmutable
+{
+    /**
+     * @use TCollection<TKey,TValue>
+     */
+    use TCollection;
+}

src/Concept/TypedCollection.php

@@ -8,7 +8,10 @@
 use LogicException;
 
 /**
- * Base class for collections of objects of a given type
+ * Base class for collections of objects of a strictly enforced type
+ *
+ * Extend {@see LooselyTypedCollection} instead if performance concerns outweigh
+ * type safety.
  *
  * @template TKey of array-key
  * @template TValue of object