improved phpDoc

Author: dg

src/Schema/Context.php

@@ -41,6 +41,9 @@ public function addError(string $message, string $code, array $variables = []):
 	}
 
 
+	/**
+	 * @param  string[]  $variables
+	 */
 	public function addWarning(string $message, string $code, array $variables = []): Message
 	{
 		return $this->warnings[] = new Message($message, $code, $this->path, $variables);

src/Schema/Elements/Base.php

@@ -23,10 +23,10 @@ trait Base
 	private bool $required = false;
 	private mixed $default = null;
 
-	/** @var ?callable */
-	private $before;
+	/** @var ?\Closure(mixed): mixed */
+	private ?\Closure $before = null;
 
-	/** @var callable[] */
+	/** @var array<\Closure(mixed, Context): mixed> */
 	private array $transforms = [];
 	private ?string $deprecated = null;
 
@@ -45,9 +45,10 @@ public function required(bool $state = true): self
 	}
 
 
+	/** @param  callable(mixed): mixed  $handler */
 	public function before(callable $handler): self
 	{
-		$this->before = $handler;
+		$this->before = $handler(...);
 		return $this;
 	}
 
@@ -58,16 +59,19 @@ public function castTo(string $type): self
 	}
 
 
+	/** @param  callable(mixed, Context): mixed  $handler */
 	public function transform(callable $handler): self
 	{
-		$this->transforms[] = $handler;
+		$this->transforms[] = $handler(...);
 		return $this;
 	}
 
 
+	/** @param  callable(mixed): bool  $handler */
 	public function assert(callable $handler, ?string $description = null): self
 	{
 		$expected = $description ?? (is_string($handler) ? "$handler()" : '#' . count($this->transforms));
+		$handler = $handler(...);
 		return $this->transform(function ($value, Context $context) use ($handler, $description, $expected) {
 			if ($handler($value)) {
 				return $value;

src/Schema/Elements/Structure.php

@@ -77,6 +77,7 @@ public function skipDefaults(bool $state = true): self
 	}
 
 
+	/** @param  Schema[]|self  $shape */
 	public function extend(array|self $shape): self
 	{
 		$shape = $shape instanceof self ? $shape->items : $shape;

src/Schema/Expect.php

@@ -64,6 +64,7 @@ public static function structure(array $shape): Structure
 	}
 
 
+	/** @param  array<string, Schema>  $items */
 	public static function from(object $object, array $items = []): Structure
 	{
 		$ro = new \ReflectionObject($object);

src/Schema/Helpers.php

@@ -121,6 +121,7 @@ public static function validateType(mixed $value, string $expected, Context $con
 	}
 
 
+	/** @param  array{?float, ?float}  $range */
 	public static function validateRange(mixed $value, array $range, Context $context, string $types = ''): void
 	{
 		if (is_array($value) || is_string($value)) {
@@ -147,6 +148,7 @@ public static function validateRange(mixed $value, array $range, Context $contex
 	}
 
 
+	/** @param  array{?float, ?float}  $range */
 	public static function isInRange(mixed $value, array $range): bool
 	{
 		return ($range[0] === null || $value >= $range[0])
@@ -166,6 +168,7 @@ public static function validatePattern(string $value, string $pattern, Context $
 	}
 
 
+	/** @return \Closure(mixed): mixed */
 	public static function getCastStrategy(string $type): \Closure
 	{
 		if (Nette\Utils\Validators::isBuiltinType($type)) {

src/Schema/Processor.php

@@ -17,6 +17,7 @@
  */
 final class Processor
 {
+	/** @var array<callable(Context): void> */
 	public array $onNewContext = [];
 	private Context $context;
 	private bool $skipDefaults = false;