Implement second-level metadata (prototypes)

Author: SerafimArts

bench/src/Serializers/TypeLangAttributesBench.php

@@ -10,9 +10,9 @@
 use PhpBench\Attributes\Warmup;
 use TypeLang\Mapper\Bench\Stub\ExampleRequestDTO;
 use TypeLang\Mapper\Mapper;
-use TypeLang\Mapper\Mapping\Driver\AttributeDriver;
-use TypeLang\Mapper\Mapping\Driver\Psr16CachedDriver;
-use TypeLang\Mapper\Mapping\Driver\ReflectionDriver;
+use TypeLang\Mapper\Mapping\Provider\AttributeDriver;
+use TypeLang\Mapper\Mapping\Provider\Psr16CachedDriver;
+use TypeLang\Mapper\Mapping\Provider\ReflectionDriver;
 use TypeLang\Mapper\Platform\StandardPlatform;
 
 #[Revs(30), Warmup(3), Iterations(5), BeforeMethods('prepare')]
@@ -31,7 +31,7 @@ public function prepare(): void
 
         $this->cached = new Mapper(
             platform: new StandardPlatform(
-                driver: new Psr16CachedDriver(
+                meta: new Psr16CachedDriver(
                     cache: $this->psr16,
                     delegate: $driver,
                 ),
@@ -40,7 +40,7 @@ public function prepare(): void
 
         $this->raw = new Mapper(
             platform: new StandardPlatform(
-                driver: $driver,
+                meta: $driver,
             ),
         );
     }

bench/src/Serializers/TypeLangDocBlockBench.php

@@ -10,9 +10,9 @@
 use PhpBench\Attributes\Warmup;
 use TypeLang\Mapper\Bench\Stub\ExampleRequestDTO;
 use TypeLang\Mapper\Mapper;
-use TypeLang\Mapper\Mapping\Driver\DocBlockDriver;
-use TypeLang\Mapper\Mapping\Driver\Psr16CachedDriver;
-use TypeLang\Mapper\Mapping\Driver\ReflectionDriver;
+use TypeLang\Mapper\Mapping\Provider\DocBlockDriver;
+use TypeLang\Mapper\Mapping\Provider\Psr16CachedDriver;
+use TypeLang\Mapper\Mapping\Provider\ReflectionDriver;
 use TypeLang\Mapper\Platform\StandardPlatform;
 
 #[Revs(30), Warmup(3), Iterations(5), BeforeMethods('prepare')]
@@ -31,7 +31,7 @@ public function prepare(): void
 
         $this->cached = new Mapper(
             platform: new StandardPlatform(
-                driver: new Psr16CachedDriver(
+                meta: new Psr16CachedDriver(
                     cache: $this->psr16,
                     delegate: $driver,
                 ),
@@ -40,7 +40,7 @@ public function prepare(): void
 
         $this->raw = new Mapper(
             platform: new StandardPlatform(
-                driver: $driver,
+                meta: $driver,
             ),
         );
     }

composer.json

@@ -10,6 +10,7 @@
     },
     "require": {
         "php": "^8.1",
+        "psr/clock": "^1.0",
         "psr/log": "^1.0|^2.0|^3.0",
         "psr/simple-cache": "^1.0|^2.0|^3.0",
         "type-lang/parser": "^1.4",

example/04.mapping/01.reflection-mapping.php

@@ -18,7 +18,7 @@ public function __construct(
 
 // Create standard platform with reflection driver
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\ReflectionDriver(),
+    meta: new \TypeLang\Mapper\Mapping\Reader\ReflectionReader(),
 );
 
 $mapper = new Mapper($platform);

example/04.mapping/02.attribute-mapping.php

@@ -21,7 +21,7 @@ public function __construct(
 // Which means that we only read those fields that are marked with
 // the "MapProperty" attribute.
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\AttributeDriver(),
+    meta: new \TypeLang\Mapper\Mapping\Reader\AttributeReader(),
 );
 
 $mapper = new Mapper($platform);

example/04.mapping/03.driver-inheritance-mapping.php

@@ -22,8 +22,8 @@ public function __construct(
 // Which means that we read all public fields, as well as those marked
 // with the MapProperty attribute with overwriting.
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\AttributeDriver(
-        delegate: new \TypeLang\Mapper\Mapping\Driver\ReflectionDriver(),
+    meta: new \TypeLang\Mapper\Mapping\Reader\AttributeReader(
+        delegate: new \TypeLang\Mapper\Mapping\Reader\ReflectionReader(),
     ),
 );
 

example/04.mapping/04.phpdoc-mapping.php

@@ -6,6 +6,8 @@
 
 require __DIR__ . '/../../vendor/autoload.php';
 
+die('TODO: Not implemented yet');
+
 class ExampleDTO
 {
     public function __construct(
@@ -17,9 +19,9 @@ public function __construct(
 }
 
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\DocBlockDriver(
-        delegate: new \TypeLang\Mapper\Mapping\Driver\AttributeDriver(
-            delegate: new \TypeLang\Mapper\Mapping\Driver\ReflectionDriver(),
+    meta: new \TypeLang\Mapper\Mapping\Provider\DocBlockDriver(
+        delegate: new \TypeLang\Mapper\Mapping\Provider\AttributeDriver(
+            delegate: new \TypeLang\Mapper\Mapping\Provider\ReflectionDriver(),
         ),
     ),
 );

example/04.mapping/05.phpdoc-custom-tags-mapping.php

@@ -6,6 +6,8 @@
 
 require __DIR__ . '/../../vendor/autoload.php';
 
+die('TODO: Not implemented yet');
+
 class ExampleDTO
 {
     public function __construct(
@@ -18,11 +20,11 @@ public function __construct(
 }
 
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\DocBlockDriver(
+    meta: new \TypeLang\Mapper\Mapping\Provider\DocBlockDriver(
         paramTagName: 'custom-param', // Override "@param" tag by the "@custom-param"
         varTagName: 'custom-var',     // Override "@var" tag by the "@custom-var"
-        delegate: new \TypeLang\Mapper\Mapping\Driver\AttributeDriver(
-            delegate: new \TypeLang\Mapper\Mapping\Driver\ReflectionDriver(),
+        delegate: new \TypeLang\Mapper\Mapping\Provider\AttributeDriver(
+            delegate: new \TypeLang\Mapper\Mapping\Provider\ReflectionDriver(),
         ),
     ),
 );

example/04.mapping/06.cache.php

@@ -6,6 +6,8 @@
 
 require __DIR__ . '/../../vendor/autoload.php';
 
+die('TODO: Not implemented yet');
+
 class ExampleDTO
 {
     /**
@@ -24,10 +26,10 @@ public function __construct(
 );
 
 $platform = new \TypeLang\Mapper\Platform\StandardPlatform(
-    driver: new \TypeLang\Mapper\Mapping\Driver\Psr16CachedDriver(
+    meta: new \TypeLang\Mapper\Mapping\Provider\Psr16CachedDriver(
         cache: $cache,
-        delegate: new \TypeLang\Mapper\Mapping\Driver\DocBlockDriver(
-            delegate: new \TypeLang\Mapper\Mapping\Driver\AttributeDriver(),
+        delegate: new \TypeLang\Mapper\Mapping\Provider\DocBlockDriver(
+            delegate: new \TypeLang\Mapper\Mapping\Provider\AttributeDriver(),
         ),
     ),
 );

src/Exception/Definition/DefinitionException.php

@@ -11,7 +11,8 @@
 /**
  * Occurs when the type was incorrectly defined.
  */
-abstract class DefinitionException extends \InvalidArgumentException implements MapperExceptionInterface
+abstract class DefinitionException extends \InvalidArgumentException implements
+    MapperExceptionInterface
 {
     public readonly Template $template;
 
@@ -36,4 +37,16 @@ public function getType(): TypeStatement
     {
         return $this->type;
     }
+
+    /**
+     * @api
+     *
+     * @param non-empty-string $file
+     * @param int<1, max> $line
+     */
+    public function setSource(string $file, int $line): void
+    {
+        $this->file = $file;
+        $this->line = $line;
+    }
 }