updated streamline-setup v2

docker/streamline-src/vendor/nette/utils/src/Utils/Iterables.php

@@ -49,10 +49,11 @@ final class Iterables
 
 	/**
 	 * Returns the first item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
-	 * The $predicate has the signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
-	 * @template T
-	 * @param  iterable<T>  $iterable
-	 * @return ?T
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V>  $iterable
+	 * @param  ?callable(V, K, iterable<K, V>): bool  $predicate
+	 * @return ?V
 	 */
 	public static function first(iterable $iterable, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -67,10 +68,11 @@ final class Iterables
 
 	/**
 	 * Returns the key of first item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
-	 * The $predicate has the signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
-	 * @template T
-	 * @param  iterable<T, mixed>  $iterable
-	 * @return ?T
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V>  $iterable
+	 * @param  ?callable(V, K, iterable<K, V>): bool  $predicate
+	 * @return ?K
 	 */
 	public static function firstKey(iterable $iterable, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -84,11 +86,10 @@ final class Iterables
 
 
 	/**
-	 * Tests whether at least one element in the iterator passes the test implemented by the
-	 * provided callback with signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
+	 * Tests whether at least one element in the iterator passes the test implemented by the provided function.
 	 * @template K
 	 * @template V
-	 * @param  iterable<K, V> $iterable
+	 * @param  iterable<K, V>  $iterable
 	 * @param  callable(V, K, iterable<K, V>): bool  $predicate
 	 */
 	public static function some(iterable $iterable, callable $predicate): bool
@@ -103,11 +104,10 @@ final class Iterables
 
 
 	/**
-	 * Tests whether all elements in the iterator pass the test implemented by the provided function,
-	 * which has the signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
+	 * Tests whether all elements in the iterator pass the test implemented by the provided function.
 	 * @template K
 	 * @template V
-	 * @param  iterable<K, V> $iterable
+	 * @param  iterable<K, V>  $iterable
 	 * @param  callable(V, K, iterable<K, V>): bool  $predicate
 	 */
 	public static function every(iterable $iterable, callable $predicate): bool
@@ -123,11 +123,10 @@ final class Iterables
 
 	/**
 	 * Iterator that filters elements according to a given $predicate. Maintains original keys.
-	 * The callback has the signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
 	 * @template K
 	 * @template V
-	 * @param  iterable<K, V> $iterable
-	 * @param  callable(V, K, iterable<K, V>): bool $predicate
+	 * @param  iterable<K, V>  $iterable
+	 * @param  callable(V, K, iterable<K, V>): bool  $predicate
 	 * @return \Generator<K, V>
 	 */
 	public static function filter(iterable $iterable, callable $predicate): \Generator
@@ -142,12 +141,11 @@ final class Iterables
 
 	/**
 	 * Iterator that transforms values by calling $transformer. Maintains original keys.
-	 * The callback has the signature `function (mixed $value, mixed $key, iterable $iterable): bool`.
 	 * @template K
 	 * @template V
 	 * @template R
-	 * @param  iterable<K, V> $iterable
-	 * @param  callable(V, K, iterable<K, V>): R $transformer
+	 * @param  iterable<K, V>  $iterable
+	 * @param  callable(V, K, iterable<K, V>): R  $transformer
 	 * @return \Generator<K, R>
 	 */
 	public static function map(iterable $iterable, callable $transformer): \Generator
@@ -156,4 +154,85 @@ final class Iterables
 			yield $k => $transformer($v, $k, $iterable);
 		}
 	}
+
+
+	/**
+	 * Iterator that transforms keys and values by calling $transformer. If it returns null, the element is skipped.
+	 * @template K
+	 * @template V
+	 * @template ResV
+	 * @template ResK
+	 * @param  iterable<K, V>  $iterable
+	 * @param  callable(V, K, iterable<K, V>): ?array{ResV, ResK}  $transformer
+	 * @return \Generator<ResV, ResK>
+	 */
+	public static function mapWithKeys(iterable $iterable, callable $transformer): \Generator
+	{
+		foreach ($iterable as $k => $v) {
+			$pair = $transformer($v, $k, $iterable);
+			if ($pair) {
+				yield $pair[0] => $pair[1];
+			}
+		}
+	}
+
+
+	/**
+	 * Wraps around iterator and caches its keys and values during iteration.
+	 * This allows the data to be re-iterated multiple times.
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V>  $iterable
+	 * @return \IteratorAggregate<K, V>
+	 */
+	public static function memoize(iterable $iterable): iterable
+	{
+		return new class (self::toIterator($iterable)) implements \IteratorAggregate {
+			public function __construct(
+				private \Iterator $iterator,
+				private array $cache = [],
+			) {
+			}
+
+
+			public function getIterator(): \Generator
+			{
+				if (!$this->cache) {
+					$this->iterator->rewind();
+				}
+				$i = 0;
+				while (true) {
+					if (isset($this->cache[$i])) {
+						[$k, $v] = $this->cache[$i];
+					} elseif ($this->iterator->valid()) {
+						$k = $this->iterator->key();
+						$v = $this->iterator->current();
+						$this->iterator->next();
+						$this->cache[$i] = [$k, $v];
+					} else {
+						break;
+					}
+					yield $k => $v;
+					$i++;
+				}
+			}
+		};
+	}
+
+
+	/**
+	 * Creates an iterator from anything that is iterable.
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V>  $iterable
+	 * @return \Iterator<K, V>
+	 */
+	public static function toIterator(iterable $iterable): \Iterator
+	{
+		return match (true) {
+			$iterable instanceof \Iterator => $iterable,
+			$iterable instanceof \IteratorAggregate => self::toIterator($iterable->getIterator()),
+			is_array($iterable) => new \ArrayIterator($iterable),
+		};
+	}
 }