Arrays: add generic type declaration for some(), every() and map() (#298)

Author: JanTvrdik

src/Utils/Arrays.php

@@ -332,6 +332,10 @@ 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 callback with signature `function ($value, $key, array $array): bool`.
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V> $array
+	 * @param  callable(V, K, ($array is array ? array<K, V> : iterable<K, V>)): bool $callback
 	 */
 	public static function some(iterable $array, callable $callback): bool
 	{
@@ -348,6 +352,10 @@ public static function some(iterable $array, callable $callback): bool
 	/**
 	 * Tests whether all elements in the array pass the test implemented by the provided function,
 	 * which has the signature `function ($value, $key, array $array): bool`.
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V> $array
+	 * @param  callable(V, K, ($array is array ? array<K, V> : iterable<K, V>)): bool $callback
 	 */
 	public static function every(iterable $array, callable $callback): bool
 	{
@@ -364,6 +372,12 @@ public static function every(iterable $array, callable $callback): bool
 	/**
 	 * Calls $callback on all elements in the array and returns the array of return values.
 	 * The callback has the signature `function ($value, $key, array $array): bool`.
+	 * @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 $callback
+	 * @return array<K, R>
 	 */
 	public static function map(iterable $array, callable $callback): array
 	{