feature #1 Adding phpdoc generics for the interfaces (weaverryan)

This PR was squashed before being merged into the main branch.

Discussion
----------

Adding phpdoc generics for the interfaces

Commits
-------

1259978 Adding phpdoc generics for the interfaces

Author: weaverryan

src/MapperInterface.php

@@ -14,11 +14,26 @@
  *
  * Also add #[AsMapper(from: Foo:class, to: Bar:class)] to each mapper class.
  *
+ * @template TFrom of object
+ * @template TTo of object
+ *
  * @author Ryan Weaver <[email protected]>
  */
 interface MapperInterface
 {
+    /**
+     * @param TFrom             $from
+     * @param class-string<TTo> $toClass
+     *
+     * @return TTo
+     */
     public function load(object $from, string $toClass, array $context): object;
 
+    /**
+     * @param TFrom $from
+     * @param TTo   $to
+     *
+     * @return TTo
+     */
     public function populate(object $from, object $to, array $context): object;
 }

src/MicroMapperInterface.php

@@ -11,10 +11,19 @@
 
 /**
  * Maps one object to another using the configured mappers.
+ *
+ * @template TFrom of object
+ * @template TTo of object
  */
 interface MicroMapperInterface
 {
     public const MAX_DEPTH = 'max_depth';
 
+    /**
+     * @param TFrom             $from
+     * @param class-string<TTo> $toClass
+     *
+     * @return TTo
+     */
     public function map(object $from, string $toClass, array $context = []): object;
 }