Upgrade to 4.0.0

kirby/src/Toolkit/LazyValue.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Kirby\Toolkit;
+
+use Closure;
+
+/**
+ * Store a lazy value (safe from processing inside a closure)
+ * in this class wrapper to also protect it from being unwrapped
+ * by normal `Closure`/`is_callable()` checks
+ *
+ * @package   Kirby Toolkit
+ * @author    Nico Hoffmann <nico@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://opensource.org/licenses/MIT
+ */
+class LazyValue
+{
+	public function __construct(
+		protected Closure $value
+	) {
+	}
+
+	/**
+	 * Resolve the lazy value to its actual value
+	 */
+	public function resolve(mixed ...$args): mixed
+	{
+		return call_user_func_array($this->value, $args);
+	}
+
+	/**
+	 * Unwrap a single value or an array of values
+	 */
+	public static function unwrap(mixed $data, mixed ...$args): mixed
+	{
+		if (is_array($data) === true) {
+			return A::map($data, fn ($value) => static::unwrap($value, $args));
+		}
+
+		if ($data instanceof static) {
+			return $data->resolve(...$args);
+		}
+
+		return $data;
+	}
+}