Added PHPDoc for generic functions

Author: JulianFun123

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "interaapps/jsonplus",
-    "version": "1.0.1",
+    "version": "1.0.2",
     "type": "library",
     "authors": [
         {

src/main/de/interaapps/jsonplus/JSONPlus.php

@@ -36,11 +36,23 @@ public function __construct(
         ];
     }
 
-    public function fromJson($json, $type=null){
+    /**
+     * @template T
+     * @param string $json The input json
+     * @param null|class-string<T> $type A class (className::class), type (example: "array", "int"...) or null (Detects type automatically)
+     * @return T
+     * */
+    public function fromJson(string $json, string|null $type = null){
         return $this->map($this->serializationAdapter->fromJson($json), $type);
     }
 
-    public function map($o, $type = null){
+    /**
+     * @template T
+     * @param $o
+     * @param null|class-string<T> $type $type A class (className::class), type (example: "array", "int"...) or null (Detects type automatically)
+     * @return T
+     * */
+    public function map($o, null|string $type = null){
         if ($type == null) {
             $type = gettype($o);
 

src/main/de/interaapps/jsonplus/typemapper/EnumTypeMapper.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace de\interaapps\jsonplus\typemapper;
+
+class EnumTypeMapper implements TypeMapper {
+
+    public function map(mixed $o, string $type): mixed {
+        return $type::{$o}->value;
+    }
+
+    public function mapToJson(mixed $o, string $type): mixed {
+        return $o->name;
+    }
+}

src/main/de/interaapps/jsonplus/typemapper/TypeMapper.php

@@ -2,6 +2,13 @@
 namespace de\interaapps\jsonplus\typemapper;
 
 interface TypeMapper {
+    /**
+     * @template T
+     * @param mixed $o
+     * @param class-string<T> $type
+     * @return T
+     * */
     public function map(mixed $o, string $type) : mixed;
+
     public function mapToJson(mixed $o, string $type) : mixed;
 }

src/test/testbootstrap.php

@@ -49,4 +49,6 @@ public function setName(string $name): Test {
 
 //echo Test::fromJson(JSON)->toJson();
 $json = new JSONPlus(new JsonSerializationAdapter());
-echo $json->toJson($json->fromJson(JSON, Test::class));
+$var = $json->fromJson(JSON, Test::class);
+echo $var->test."\n";
+echo $json->toJson($var);

uppm.json

@@ -1,6 +1,6 @@
 {
     "name": "interaapps/jsonplus",
-    "version": "1.0.1",
+    "version": "1.0.2",
     "phpVersion": ">8.0",
     "repositories": [],
     "run": {