used generics in phpDoc [WIP]

src/ComponentModel/ArrayAccess.php

@@ -14,13 +14,14 @@
 
 /**
  * Implementation of \ArrayAccess for IContainer.
+ * @template T of IComponent
  */
 trait ArrayAccess
 {
 	/**
 	 * Adds the component to the container.
 	 * @param  string|int  $name
-	 * @param  IComponent  $component
+	 * @param  T  $component
 	 */
 	public function offsetSet($name, $component): void
 	{
@@ -32,6 +33,7 @@ public function offsetSet($name, $component): void
 	/**
 	 * Returns component specified by name. Throws exception if component doesn't exist.
 	 * @param  string|int  $name
+	 * @return T
 	 * @throws Nette\InvalidArgumentException
 	 */
 	public function offsetGet($name): IComponent

src/ComponentModel/Component.php

@@ -17,8 +17,10 @@
  *
  * Components are objects implementing IComponent. They has parent component and own name.
  *
+ * @template T of IContainer
+ * @implements IComponent<T>
  * @property-read string $name
- * @property-read IContainer|null $parent
+ * @property-read T|null $parent
  */
 abstract class Component implements IComponent
 {
@@ -151,6 +153,7 @@ final public function getName(): ?string
 
 	/**
 	 * Returns the parent container if any.
+	 * @return T
 	 */
 	final public function getParent(): ?IContainer
 	{
@@ -161,6 +164,7 @@ final public function getParent(): ?IContainer
 	/**
 	 * Sets or removes the parent of this component. This method is managed by containers and should
 	 * not be called by applications
+	 * @param  T  $parent
 	 * @throws Nette\InvalidStateException
 	 * @internal
 	 */
@@ -202,6 +206,7 @@ public function setParent(?IContainer $parent, ?string $name = null): static
 	/**
 	 * Is called by a component when it is about to be set new parent. Descendant can
 	 * override this method to disallow a parent change by throwing an Nette\InvalidStateException
+	 * @param  T  $parent
 	 * @throws Nette\InvalidStateException
 	 */
 	protected function validateParent(IContainer $parent): void

src/ComponentModel/Container.php

@@ -15,6 +15,8 @@
 /**
  * ComponentContainer is default implementation of IContainer.
  *
+ * @template T of IComponent
+ * @implements IContainer<T>
  * @property-read iterable $components
  */
 class Container extends Component implements IContainer

src/ComponentModel/IComponent.php

@@ -12,6 +12,7 @@
 
 /**
  * Provides functionality required by all components.
+ * @template T of IContainer
  */
 interface IComponent
 {
@@ -25,11 +26,13 @@ function getName(): ?string;
 
 	/**
 	 * Returns the parent container if any.
+	 * @return ?T
 	 */
 	function getParent(): ?IContainer;
 
 	/**
 	 * Sets the parent of this component.
+	 * @param  ?T  $parent
 	 */
 	function setParent(?IContainer $parent, ?string $name = null): static;
 }

src/ComponentModel/IContainer.php

@@ -14,29 +14,33 @@
 
 /**
  * Containers are objects that logically contain zero or more IComponent components.
+ * @template T of IComponent
  */
 interface IContainer extends IComponent
 {
 	/**
 	 * Adds the component to the container.
+	 * @param  T  $component
 	 * @return static
 	 */
 	function addComponent(IComponent $component, ?string $name);
 
 	/**
 	 * Removes the component from the container.
+	 * @param  T  $component
 	 */
 	function removeComponent(IComponent $component): void;
 
 	/**
 	 * Returns component specified by name or path.
+	 * @return T
 	 * @throws Nette\InvalidArgumentException  if component doesn't exist
 	 */
 	function getComponent(string $name): ?IComponent;
 
 	/**
 	 * Iterates over descendants components.
-	 * @return iterable<int|string,IComponent>
+	 * @return iterable<int|string,T>
 	 */
 	function getComponents(): iterable;
 }