add docblock iterable

Author: samsonasik

rector.php

@@ -26,6 +26,9 @@
             __DIR__ . '/tests/FilterTest.php',
         ],
     ])
+    ->withSets([
+        __DIR__ . '/vendor/rector/rector/config/set/type-declaration-docblocks.php',
+    ])
     ->withParallel()
     ->withRootFiles()
     ->withPaths([__DIR__ . '/src', __DIR__ . '/tests'])

tests/AtLeastTest.php

@@ -11,6 +11,9 @@
 
 final class AtLeastTest extends TestCase
 {
+    /**
+     * @param int[]|string[] $data
+     */
     #[DataProvider('onceDataProvider')]
     public function testOnce(array $data, callable $filter, bool $expected): void
     {
@@ -20,6 +23,9 @@ public function testOnce(array $data, callable $filter, bool $expected): void
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function onceDataProvider(): Iterator
     {
         yield [
@@ -44,6 +50,9 @@ public static function onceDataProvider(): Iterator
         ];
     }
 
+    /**
+     * @param int[]|string[] $data
+     */
     #[DataProvider('twiceDataProvider')]
     public function testTwice(array $data, callable $filter, bool $expected): void
     {
@@ -54,6 +63,9 @@ public function testTwice(array $data, callable $filter, bool $expected): void
     }
 
     // phpcs:disable
+    /**
+     * @return Iterator<mixed>
+     */
     public static function twiceDataProvider(): Iterator
     {
         yield [
@@ -79,6 +91,9 @@ public static function twiceDataProvider(): Iterator
     }
 
     // phpcs:enable
+    /**
+     * @param int[]|bool[]|null[]|string[] $data
+     */
     #[DataProvider('timesDataProvider')]
     public function testTimes(array $data, callable $filter, bool $expected): void
     {
@@ -88,6 +103,9 @@ public function testTimes(array $data, callable $filter, bool $expected): void
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function timesDataProvider(): Iterator
     {
         yield [

tests/FinderTest.php

@@ -30,6 +30,9 @@ public function testFirst(iterable $data, callable $filter, mixed $expected): vo
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function firstDataProvider(): Iterator
     {
         yield [
@@ -63,6 +66,9 @@ public function testFirstReturnKey(iterable $data, callable $filter, mixed $expe
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function firstReturnKeyDataProvider(): Iterator
     {
         yield [
@@ -96,6 +102,9 @@ public function testLast(iterable $data, callable $filter, mixed $expected): voi
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function lastDataProvider(): Iterator
     {
         $generator = static function (): Generator {
@@ -165,6 +174,9 @@ public function testLastReturnKey(iterable $data, callable $filter, mixed $expec
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function lastReturnKeyDataProvider(): Iterator
     {
         $generator = static function (): Generator {
@@ -234,6 +246,9 @@ public function testLastReturnKeyResortKey(iterable $data, callable $filter, mix
         );
     }
 
+    /**
+     * @return Iterator<array<int, (array<int, int>|Closure(mixed $datum):bool|int|null)>>
+     */
     public static function lastReturnKeyResortKeyDataProvider(): Iterator
     {
         yield [
@@ -260,6 +275,9 @@ public function testLastKeepCurrentOriginalData(): void
         $this->assertSame(DateTime::class, current($data)::class);
     }
 
+    /**
+     * @param array<int|string, int> $expected
+     */
     #[DataProvider('rowsDataProvider')]
     public function testRows(iterable $data, callable $filter, array $expected): void
     {
@@ -269,6 +287,9 @@ public function testRows(iterable $data, callable $filter, array $expected): voi
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function rowsDataProvider(): Iterator
     {
         yield [
@@ -299,6 +320,9 @@ public static function rowsDataProvider(): Iterator
         ];
     }
 
+    /**
+     * @param int[] $expected
+     */
     #[DataProvider('rowsDataProviderPreserveKey')]
     public function testRowsPreserveKey(iterable $data, callable $filter, array $expected): void
     {
@@ -308,6 +332,9 @@ public function testRowsPreserveKey(iterable $data, callable $filter, array $exp
         );
     }
 
+    /**
+     * @return Iterator<array<int, (array|Closure(mixed $datum):bool)>>
+     */
     public static function rowsDataProviderPreserveKey(): Iterator
     {
         yield [

tests/OnlyTest.php

@@ -12,6 +12,9 @@
 
 final class OnlyTest extends TestCase
 {
+    /**
+     * @param int[]|string[] $data
+     */
     #[DataProvider('onceDataProvider')]
     public function testOnce(array $data, callable $filter, bool $expected): void
     {
@@ -22,6 +25,9 @@ public function testOnce(array $data, callable $filter, bool $expected): void
     }
 
     // phpcs:disable
+    /**
+     * @return Iterator<mixed>
+     */
     public static function onceDataProvider(): Iterator
     {
         yield [
@@ -47,6 +53,9 @@ public static function onceDataProvider(): Iterator
     }
 
     // phpcs:enable
+    /**
+     * @param stdClass[]|int[]|string[]|bool[] $data
+     */
     #[DataProvider('twiceDataProvider')]
     public function testTwice(array $data, callable $filter, bool $expected): void
     {
@@ -57,6 +66,9 @@ public function testTwice(array $data, callable $filter, bool $expected): void
     }
 
     // phpcs:disable
+    /**
+     * @return Iterator<mixed>
+     */
     public static function twiceDataProvider(): Iterator
     {
         yield [
@@ -82,6 +94,9 @@ public static function twiceDataProvider(): Iterator
     }
 
     // phpcs:enable
+    /**
+     * @param int[]|string[] $data
+     */
     #[DataProvider('timesDataProvider')]
     public function testTimes(array $data, callable $filter, bool $expected): void
     {
@@ -91,6 +106,9 @@ public function testTimes(array $data, callable $filter, bool $expected): void
         );
     }
 
+    /**
+     * @return Iterator<mixed>
+     */
     public static function timesDataProvider(): Iterator
     {
         yield [