docblocks

Author: samsonasik

src/AtLeast.php

@@ -4,12 +4,13 @@
 
 namespace ArrayLookup;
 
+use Traversable;
 use Webmozart\Assert\Assert;
 
 final class AtLeast
 {
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed>  $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function once(iterable $data, callable $filter): bool
@@ -18,7 +19,7 @@ public static function once(iterable $data, callable $filter): bool
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function twice(iterable $data, callable $filter): bool
@@ -27,16 +28,16 @@ public static function twice(iterable $data, callable $filter): bool
     }
 
     /**
-     * @param mixed[]|iterable        $data
-     * @param callable(mixed $datum): bool $filter
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
+     * @param callable(mixed $datum): bool  $filter
      */
     public static function times(iterable $data, callable $filter, int $count): bool
     {
         return self::hasFoundTimes($data, $filter, $count);
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     private static function hasFoundTimes(iterable $data, callable $filter, int $maxCount): bool

src/Finder.php

@@ -18,7 +18,7 @@
 final class Finder
 {
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function first(iterable $data, callable $filter): mixed
@@ -40,8 +40,8 @@ public static function first(iterable $data, callable $filter): mixed
     }
 
     /**
-     * @param Traversable<mixed, mixed> $traversable
-     * @return mixed[]
+     * @param Traversable<int|string, mixed> $traversable
+     * @return array<int|string, mixed>
      */
     private static function resolveArrayFromTraversable(Traversable $traversable): array
     {
@@ -53,7 +53,7 @@ private static function resolveArrayFromTraversable(Traversable $traversable): a
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function last(iterable $data, callable $filter): mixed

src/Only.php

@@ -4,12 +4,13 @@
 
 namespace ArrayLookup;
 
+use Traversable;
 use Webmozart\Assert\Assert;
 
 final class Only
 {
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function once(iterable $data, callable $filter): bool
@@ -18,7 +19,7 @@ public static function once(iterable $data, callable $filter): bool
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function twice(iterable $data, callable $filter): bool
@@ -27,7 +28,7 @@ public static function twice(iterable $data, callable $filter): bool
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     public static function times(iterable $data, callable $filter, int $count): bool
@@ -36,7 +37,7 @@ public static function times(iterable $data, callable $filter, int $count): bool
     }
 
     /**
-     * @param mixed[]|iterable        $data
+     * @param array<int|string, mixed>|Traversable<int|string, mixed> $data
      * @param callable(mixed $datum): bool $filter
      */
     private static function onlyFoundTimes(iterable $data, callable $filter, int $maxCount): bool