Add prepend() to Collection interface

src/AbstractLazyCollection.php

@@ -41,6 +41,13 @@ public function add(mixed $element): void
         $this->collection->add($element);
     }
 
+    public function prepend(mixed $element): void
+    {
+        $this->initialize();
+
+        $this->collection->prepend($element);
+    }
+
     public function clear(): void
     {
         $this->initialize();

src/ArrayCollection.php

@@ -18,6 +18,7 @@
 use function array_reverse;
 use function array_search;
 use function array_slice;
+use function array_unshift;
 use function array_values;
 use function count;
 use function current;
@@ -272,6 +273,16 @@ public function add(mixed $element): void
         $this->elements[] = $element;
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @psalm-suppress InvalidPropertyAssignmentValue
+     */
+    public function prepend(mixed $element): void
+    {
+        array_unshift($this->elements, $element);
+    }
+
     public function isEmpty(): bool
     {
         return empty($this->elements);

src/Collection.php

@@ -39,6 +39,14 @@ interface Collection extends ReadableCollection, ArrayAccess
      */
     public function add(mixed $element): void;
 
+    /**
+     * Adds an element at the beginning of the collection.
+     *
+     * @param mixed $element The element to add.
+     * @psalm-param T $element
+     */
+    public function prepend(mixed $element): void;
+
     /**
      * Clears the collection, removing all elements.
      */

tests/CollectionTestCase.php

@@ -184,6 +184,14 @@ public function testPartition(): void
         self::assertEquals($partition[1][0], false);
     }
 
+    public function testPrepend(): void
+    {
+        $this->collection->add('one');
+        $this->collection->add('two');
+        $this->collection->prepend('zero');
+        self::assertEquals('zero', $this->collection->get(0));
+    }
+
     public function testClear(): void
     {
         $this->collection[] = 'one';