improved phpDoc

Author: dg

src/ComponentModel/Component.php

@@ -30,7 +30,7 @@ abstract class Component implements IComponent
 	/** @var string|null */
 	private $name;
 
-	/** @var array of [type => [obj, depth, path, array of [attached, detached]]] */
+	/** @var array<string, array{?IComponent, ?int, ?string, array<int, array{?callable, ?callable}>}> means [type => [obj, depth, path, [attached, detached]]] */
 	private $monitors = [];
 
 
@@ -203,7 +203,8 @@ protected function validateParent(IContainer $parent): void
 
 	/**
 	 * Refreshes monitors.
-	 * @param  array|null  $missing  (array = attaching, null = detaching)
+	 * @param  array<string,true>|null  $missing  (array = attaching, null = detaching)
+	 * @param  array<int,array{callable,IComponent}>  $listeners
 	 */
 	private function refreshMonitors(int $depth, array &$missing = null, array &$listeners = []): void
 	{

src/ComponentModel/Container.php

@@ -166,6 +166,7 @@ protected function createComponent(string $name): ?IComponent
 
 	/**
 	 * Iterates over descendants components.
+	 * @return \Iterator<int|string,IComponent>
 	 */
 	final public function getComponents(bool $deep = false, string $filterType = null): \Iterator
 	{

src/ComponentModel/IContainer.php

@@ -28,12 +28,13 @@ function removeComponent(IComponent $component): void;
 
 	/**
 	 * Returns component specified by name or path.
-	 * @throws Nette\InvalidArgumentException  if component doesn't exist
+	 * @throws \Nette\InvalidArgumentException  if component doesn't exist
 	 */
 	function getComponent(string $name): ?IComponent;
 
 	/**
 	 * Iterates over descendants components.
+	 * @return \Iterator<int|string,IComponent>
 	 */
 	function getComponents(): \Iterator;
 }

src/ComponentModel/RecursiveComponentIterator.php

@@ -27,6 +27,7 @@ public function hasChildren(): bool
 
 	/**
 	 * The sub-iterator for the current element.
+	 * @return \RecursiveIterator<int|string,IComponent>
 	 */
 	public function getChildren(): \RecursiveIterator
 	{