Merge branch 'mitelg-add-more-generics' into 2.3

Author: jakzal

.gitignore

@@ -1,3 +1,4 @@
 composer.lock
 doc/_build
 vendor/
+.idea/

src/Context/PageObjectContext.php

@@ -15,11 +15,11 @@ class PageObjectContext implements Context, PageObjectAware
     private $pageObjectFactory = null;
 
     /**
-     * @template T of Page
+     * @template TPage of Page
      *
-     * @param class-string<T> $name
+     * @param class-string<TPage> $name
      *
-     * @return T
+     * @return TPage
      *
      * @throws \RuntimeException
      */
@@ -33,9 +33,11 @@ public function getPage($name)
     }
 
     /**
-     * @param string $name
+     * @template TElement of Element
      *
-     * @return Element
+     * @param class-string<TElement> $name
+     *
+     * @return TElement
      *
      * @throws \RuntimeException
      */

src/PageObject/Element.php

@@ -47,9 +47,11 @@ public function __call($name, $arguments)
     }
 
     /**
-     * @param string $name
+     * @template TElement of Element
+     *
+     * @param class-string<TElement> $name
      *
-     * @return Element
+     * @return TElement
      */
     public function getElement($name)
     {
@@ -63,9 +65,11 @@ public function getElement($name)
     }
 
     /**
-     * @param string $name
+     * @template TPage of Page
      *
-     * @return Page
+     * @param class-string<TPage> $name
+     *
+     * @return TPage
      */
     protected function getPage($name)
     {
@@ -83,9 +87,11 @@ protected function hasElement($name)
     }
 
     /**
-     * @param string $name
+     * @template TElement of Element
+     *
+     * @param class-string<TElement> $name
      *
-     * @return Element
+     * @return TElement
      */
     protected function createElement($name)
     {

src/PageObject/Factory.php

@@ -5,16 +5,18 @@
 interface Factory
 {
     /**
-     * @template T of Page
+     * @template TPage of Page
      *
-     * @param class-string<T> $name
+     * @param class-string<TPage> $name
      *
-     * @return T
+     * @return TPage
      */
     public function createPage($name);
 
     /**
-     * @param string $name
+     * @template TElement of Element
+     *
+     * @param class-string<TElement> $name
      *
      * @return Element
      */

src/PageObject/Page.php

@@ -86,9 +86,11 @@ public function __call($name, $arguments)
     }
 
     /**
-     * @param string $name
+     * @template TElement of Element
+     *
+     * @param class-string<TElement> $name
      *
-     * @return Element
+     * @return TElement
      */
     public function getElement($name)
     {
@@ -102,9 +104,11 @@ public function getElement($name)
     }
 
     /**
-     * @param string $name
+     * @template TPage of Page
      *
-     * @return Page
+     * @param class-string<TPage> $name
+     *
+     * @return TPage
      */
     protected function getPage($name)
     {
@@ -122,9 +126,11 @@ protected function hasElement($name)
     }
 
     /**
-     * @param string $name
+     * @template TElement of Element
+     *
+     * @param class-string<TElement> $name
      *
-     * @return Element
+     * @return TElement
      */
     protected function createElement($name)
     {