feat: Performance improvements using iterator aggregates.

composer.json

@@ -32,7 +32,7 @@
     ],
     "require": {
         "php": ">= 7.4",
-        "loophp/iterators": "^1.5.6"
+        "loophp/iterators": "^1.5.8"
     },
     "require-dev": {
         "amphp/parallel-functions": "^1",

src/Collection.php

@@ -16,7 +16,6 @@
 use IteratorAggregate;
 use loophp\collection\Contract\Collection as CollectionInterface;
 use loophp\collection\Contract\Operation;
-use loophp\collection\Iterator\ResourceIterator;
 use loophp\collection\Operation\All;
 use loophp\collection\Operation\Append;
 use loophp\collection\Operation\Apply;
@@ -135,6 +134,7 @@
 use loophp\iterators\CachingIteratorAggregate;
 use loophp\iterators\ClosureIterator;
 use loophp\iterators\IterableIterator;
+use loophp\iterators\ResourceIteratorAggregate;
 use loophp\iterators\StringIteratorAggregate;
 use NoRewindIterator;
 use Psr\Cache\CacheItemPoolInterface;
@@ -470,7 +470,7 @@ public static function fromCallable(callable $callable, iterable $parameters = [
     public static function fromFile(string $filepath): self
     {
         return new self(
-            static fn (): Iterator => new ResourceIterator(fopen($filepath, 'rb'), true),
+            static fn (): IteratorAggregate => new ResourceIteratorAggregate(fopen($filepath, 'rb'), true),
         );
     }
 
@@ -515,7 +515,7 @@ public static function fromIterable(iterable $iterable): self
      */
     public static function fromResource($resource): self
     {
-        return new self(static fn (): Iterator => new ResourceIterator($resource));
+        return new self(static fn (): IteratorAggregate => new ResourceIteratorAggregate($resource));
     }
 
     /**

src/Operation/Strict.php

@@ -11,7 +11,8 @@
 
 use Closure;
 use Iterator;
-use loophp\collection\Iterator\TypedIterator;
+use IteratorAggregate;
+use loophp\iterators\TypedIteratorAggregate;
 
 /**
  * @immutable
@@ -24,22 +25,22 @@ final class Strict extends AbstractOperation
     /**
      * @pure
      *
-     * @return Closure(null|callable(mixed): string): Closure(Iterator<TKey, T>): Iterator<TKey, T>
+     * @return Closure(null|callable(mixed): string): Closure(Iterator<TKey, T>): IteratorAggregate<TKey, T>
      */
     public function __invoke(): Closure
     {
         return
             /**
              * @param null|callable(mixed): string $callback
              *
-             * @return Closure(Iterator<TKey, T>): Iterator<TKey, T>
+             * @return Closure(Iterator<TKey, T>): IteratorAggregate<TKey, T>
              */
             static fn (?callable $callback = null): Closure =>
                 /**
                  * @param Iterator<TKey, T> $iterator
                  *
-                 * @return Iterator<TKey, T>
+                 * @return IteratorAggregate<TKey, T>
                  */
-                static fn (Iterator $iterator): Iterator => new TypedIterator($iterator, $callback);
+                static fn (Iterator $iterator): IteratorAggregate => new TypedIteratorAggregate($iterator, $callback);
     }
 }

tests/unit/CollectionGenericOperationTest.php

@@ -21,6 +21,7 @@
 final class CollectionGenericOperationTest extends TestCase
 {
     use GenericCollectionProviders;
+
     use IterableAssertions;
 
     /**

tests/unit/CollectionSpecificOperationTest.php

@@ -33,6 +33,7 @@
 final class CollectionSpecificOperationTest extends TestCase
 {
     use GenericCollectionProviders;
+
     use IterableAssertions;
 
     public function testApplyOperation(): void