Arrays::some(), every(), map() for iteratos & Mapper should be replaced by Iterators

Author: dg

src/Iterators/Mapper.php

@@ -10,9 +10,8 @@
 namespace Nette\Iterators;
 
 
-
 /**
- * Applies the callback to the elements of the inner iterator.
+ * @deprecated use Nette\Utils\Iterables::map()
  */
 class Mapper extends \IteratorIterator
 {

src/Utils/Arrays.php

@@ -369,11 +369,11 @@ public static function pick(array &$array, string|int $key, mixed $default = nul
 
 	/**
 	 * Tests whether at least one element in the array passes the test implemented by the provided function,
-	 * which has the signature `function ($value, $key, $array): bool`.
-	 * @template K
+	 * which has the signature `function (mixed $value, int|string $key, array $array): bool`.
+	 * @template K of array-key
 	 * @template V
-	 * @param  iterable<K, V> $array
-	 * @param  callable(V, K, ($array is array ? array<K, V> : iterable<K, V>)): bool $predicate
+	 * @param  array<K, V> $array
+	 * @param  callable(V, K, array<K, V>): bool $predicate
 	 */
 	public static function some(iterable $array, callable $predicate): bool
 	{
@@ -389,11 +389,11 @@ public static function some(iterable $array, callable $predicate): bool
 
 	/**
 	 * Tests whether all elements in the array pass the test implemented by the provided function,
-	 * which has the signature `function ($value, $key, $array): bool`.
-	 * @template K
+	 * which has the signature `function (mixed $value, int|string $key, array $array): bool`.
+	 * @template K of array-key
 	 * @template V
-	 * @param  iterable<K, V> $array
-	 * @param  callable(V, K, ($array is array ? array<K, V> : iterable<K, V>)): bool $predicate
+	 * @param  array<K, V> $array
+	 * @param  callable(V, K, array<K, V>): bool $predicate
 	 */
 	public static function every(iterable $array, callable $predicate): bool
 	{
@@ -409,7 +409,7 @@ public static function every(iterable $array, callable $predicate): bool
 
 	/**
 	 * Returns a new array containing all key-value pairs matching the given $predicate.
-	 * The callback has the signature `function ($value, $key, $array): bool`.
+	 * The callback has the signature `function (mixed $value, int|string $key, array $array): bool`.
 	 * @template K of array-key
 	 * @template V
 	 * @param  array<K, V> $array
@@ -430,12 +430,12 @@ public static function filter(array $array, callable $predicate): array
 
 	/**
 	 * Returns an array containing the original keys and results of applying the given transform function to each element.
-	 * The function has signature `function ($value, $key, $array): mixed`.
+	 * The function has signature `function (mixed $value, int|string $key, array $array): mixed`.
 	 * @template K of array-key
 	 * @template V
 	 * @template R
-	 * @param  iterable<K, V> $array
-	 * @param  callable(V, K, ($array is array ? array<K, V> : iterable<K, V>)): R $transformer
+	 * @param  array<K, V> $array
+	 * @param  callable(V, K, array<K, V>): R $transformer
 	 * @return array<K, R>
 	 */
 	public static function map(iterable $array, callable $transformer): array