improved phpDoc

Author: dg

src/Application/Helpers.php

@@ -34,7 +34,7 @@ public static function splitName(string $name): array
 
 
 	/**
-	 * return string[]
+	 * @return array<string, class-string>
 	 */
 	public static function getClassesAndTraits(string $class): array
 	{

src/Application/Routers/CliRouter.php

@@ -22,6 +22,7 @@ final class CliRouter implements Nette\Routing\Router
 
 
 	public function __construct(
+		/** @var array<string, mixed> */
 		private readonly array $defaults = [],
 	) {
 	}
@@ -99,6 +100,7 @@ public function constructUrl(array $params, Nette\Http\UrlScript $refUrl): ?stri
 
 	/**
 	 * Returns default values.
+	 * @return array<string, mixed>
 	 */
 	public function getDefaults(): array
 	{

src/Application/Routers/Route.php

@@ -98,6 +98,7 @@ public function match(Nette\Http\IRequest $httpRequest): ?array
 
 	/**
 	 * Constructs absolute URL from array.
+	 * @param  array<string, mixed>  $params
 	 */
 	public function constructUrl(array $params, Nette\Http\UrlScript $refUrl): ?string
 	{
@@ -121,7 +122,10 @@ public function constructUrl(array $params, Nette\Http\UrlScript $refUrl): ?stri
 	}
 
 
-	/** @internal */
+	/**
+	 * @return array<string, mixed>
+	 * @internal
+	 */
 	public function getConstantParameters(): array
 	{
 		$res = parent::getConstantParameters();

src/Application/Routers/RouteList.php

@@ -33,6 +33,8 @@ public function __construct(?string $module = null)
 
 	/**
 	 * Support for modules.
+	 * @param  array<string, mixed>  $params
+	 * @return array<string, mixed>|null
 	 */
 	protected function completeParameters(array $params): ?array
 	{
@@ -47,6 +49,7 @@ protected function completeParameters(array $params): ?array
 
 	/**
 	 * Constructs absolute URL from array.
+	 * @param  array<string, mixed>  $params
 	 */
 	public function constructUrl(array $params, Nette\Http\UrlScript $refUrl): ?string
 	{

src/Application/UI/AccessPolicy.php

@@ -63,7 +63,8 @@ private function getAttributes(): array
 
 
 	/**
-	 * @param  Requires[]  $attrs
+	 * @param  Attributes\Requires[]  $attrs
+	 * @return Attributes\Requires[]
 	 */
 	private function applyInternalRules(array $attrs, Component $component): array
 	{

src/Application/UI/Component.php

@@ -29,6 +29,8 @@ abstract class Component extends Nette\ComponentModel\Container implements Signa
 
 	/** @var array<callable(self): void>  Occurs when component is attached to presenter */
 	public array $onAnchor = [];
+
+	/** @var array<string, mixed> */
 	protected array $params = [];
 
 
@@ -99,6 +101,7 @@ protected function validateParent(Nette\ComponentModel\IContainer $parent): void
 
 	/**
 	 * Calls public method if exists.
+	 * @param  array<string, mixed>  $params
 	 */
 	protected function tryCall(string $method, array $params): bool
 	{
@@ -146,6 +149,7 @@ public static function getReflection(): ComponentReflection
 
 	/**
 	 * Loads state information.
+	 * @param  array<string, mixed>  $params
 	 */
 	public function loadState(array $params): void
 	{
@@ -174,6 +178,7 @@ public function loadState(array $params): void
 
 	/**
 	 * Saves state information for next request.
+	 * @param  array<string, mixed>  $params
 	 */
 	public function saveState(array &$params): void
 	{
@@ -235,6 +240,7 @@ final public function getParameter(string $name): mixed
 
 	/**
 	 * Returns component parameters.
+	 * @return array<string, mixed>
 	 */
 	final public function getParameters(): array
 	{

src/Application/UI/ComponentReflection.php

@@ -115,6 +115,9 @@ public function getPersistentComponents(): array
 	}
 
 
+	/**
+	 * @return string[] names of public properties with #[TemplateVariable] attribute
+	 */
 	public function getTemplateVariables(Control $control): array
 	{
 		$res = [];

src/Application/UI/Link.php

@@ -19,6 +19,7 @@ final class Link
 	public function __construct(
 		private readonly Component $component,
 		private readonly string $destination,
+		/** @var array<string, mixed> */
 		private array $params = [],
 	) {
 	}
@@ -63,6 +64,7 @@ public function getParameter(string $key): mixed
 
 	/**
 	 * Returns link parameters.
+	 * @return array<string, mixed>
 	 */
 	public function getParameters(): array
 	{

src/Application/UI/ParameterConverter.php

@@ -24,6 +24,7 @@ final class ParameterConverter
 
 	/**
 	 * @param  array<string, mixed>  $args
+	 * @return mixed[]
 	 */
 	public static function toArguments(\ReflectionFunctionAbstract $method, array $args): array
 	{

src/Application/UI/Presenter.php

@@ -96,7 +96,11 @@ abstract class Presenter extends Control implements Application\IPresenter
 	public array $allowedMethods = ['GET', 'POST', 'HEAD', 'PUT', 'DELETE', 'PATCH'];
 	private ?Nette\Application\Request $request = null;
 	private ?Nette\Application\Response $response = null;
+
+	/** @var array<string, array<string, mixed>> */
 	private array $globalParams = [];
+
+	/** @var array<string, mixed> */
 	private array $globalState;
 	private ?array $globalStateSinces;
 	private string $action = '';
@@ -912,6 +916,7 @@ public static function getPersistentComponents(): array
 
 	/**
 	 * Saves state information for all subcomponents to $this->globalState.
+	 * @return array<string, mixed>
 	 */
 	public function getGlobalState(?string $forClass = null): array
 	{
@@ -1061,6 +1066,7 @@ private function initGlobalParameters(): void
 
 	/**
 	 * Pops parameters for specified component.
+	 * @return array<string, mixed>
 	 * @internal
 	 */
 	final public function popGlobalParameters(string $id): array