Support creating collections using Collection::mapFrom()

CHANGELOG.md

@@ -8,6 +8,7 @@ Change Log
 - Added helper methods `Collection::isEmpty()` and `Collection::isNotEmpty()`.
 - Added `Collection::reverse()` helper to reverse the order of the collection.
 - Support creating collections from Doctrine Collections using `Collection::fromDoctrine()`.
+- Support creating collections by mapping array of other objects using `Collection::mapFrom()`.
 
 # 0.2.0
 - Minimum PHP version bumped to 8.1.

src/AbstractImmutableCollection.php

@@ -66,6 +66,18 @@ public static function fromDoctrine(DoctrineCollection $items): static
         return new $class($items->toArray());
     }
 
+    /**
+     * @param array<mixed> $items
+     */
+    public static function mapFrom(array $items, callable $mapper): static
+    {
+        $class = static::class;
+
+        return new $class(
+            array_map($mapper, $items)
+        );
+    }
+
     public static function empty(): static
     {
         $class = static::class;

tests/unit/ImmutableCollectionTest.php

@@ -81,6 +81,19 @@ public function test_can_create_collection_from_doctrine_collection(): void
         $this->assertEquals($collectionItem2, $sut->lastOrFail());
     }
 
+    public function test_can_create_collection_by_mapping_array_of_other_objects(): void
+    {
+        $collectionItem1 = new CompanionObject('one');
+        $collectionItem2 = new CompanionObject('two');
+
+        $sut = DummyImmutableCollection::mapFrom(
+            [$collectionItem1, $collectionItem2],
+            fn (CompanionObject $companionObject): DummyCollectionItem => new DummyCollectionItem($collectionItem2->name)
+        );
+
+        $this->assertEquals(2, $sut->count());
+    }
+
     public function test_is_empty_check_is_correct(): void
     {
         $sut = DummyImmutableCollection::empty();