Added second level metadata

bench/src/Serializers/TypeLangAttributesBench.php

@@ -10,9 +10,8 @@
 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\Psr16CacheProvider;
+use TypeLang\Mapper\Mapping\Reader\AttributeReader;
 use TypeLang\Mapper\Platform\StandardPlatform;
 
 #[Revs(30), Warmup(3), Iterations(5), BeforeMethods('prepare')]
@@ -25,22 +24,20 @@ public function prepare(): void
  {
  parent::prepare();
 
- $driver = new AttributeDriver(
- delegate: new ReflectionDriver(),
- );
+ $driver = new AttributeReader();
 
  $this->cached = new Mapper(
  platform: new StandardPlatform(
- driver: new Psr16CachedDriver(
- cache: $this->psr16,
+ meta: new Psr16CacheProvider(
+ psr16: $this->psr16,
  delegate: $driver,
  ),
  ),
  );
 
  $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\Psr16CacheProvider;
+use TypeLang\Mapper\Mapping\Reader\PhpDocReader;
+use TypeLang\Mapper\Mapping\Reader\ReflectionReader;
 use TypeLang\Mapper\Platform\StandardPlatform;
 
 #[Revs(30), Warmup(3), Iterations(5), BeforeMethods('prepare')]
@@ -25,22 +25,20 @@ public function prepare(): void
  {
  parent::prepare();
 
- $driver = new DocBlockDriver(
- delegate: new ReflectionDriver(),
- );
+ $driver = new PhpDocReader();
 
  $this->cached = new Mapper(
  platform: new StandardPlatform(
- driver: new Psr16CachedDriver(
- cache: $this->psr16,
+ meta: new Psr16CacheProvider(
+ psr16: $this->psr16,
  delegate: $driver,
  ),
  ),
  );
 
  $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",
@@ -33,6 +34,8 @@
  "symfony/property-access": "^5.4|^6.0|^7.0",
  "symfony/stopwatch": "^5.4|^6.0|^7.0",
  "symfony/var-dumper": "^5.4|^6.0|^7.0",
+ "symfony/yaml": "^5.4|^6.0|^7.0",
+ "nette/neon": "^3.0",
  "type-lang/phpdoc": "^1.0",
  "type-lang/phpdoc-standard-tags": "^1.0"
  },
@@ -42,8 +45,11 @@
  }
  },
  "suggest": {
- "type-lang/phpdoc-standard-tags": "(^1.0) Required for DocBlockDriver mapping driver support",
- "justinrainbow/json-schema": "(^5.3|^6.0) Required for configuration drivers validation"
+ "ext-json": "Required for JSON mapping configuration files",
+ "nette/neon": "(^3.0) Required for NEON mapping configuration files",
+ "symfony/yaml": "(^5.4|^6.0|^7.0) Required for YAML mapping configuration files",
+ "type-lang/phpdoc-standard-tags": "(^1.0) Required for PhpDoc mapping configuration",
+ "justinrainbow/json-schema": "(^5.3|^6.0) Required for file-based configuration validation"
  },
  "extra": {
  "branch-alias": {

example/01.normalization/06.inherited-types-normalization.php

@@ -30,7 +30,7 @@ public function __construct(
 
 $result = $mapper->normalize($value);
 
-dd($result);
+var_dump($result);
 //
 // array:1 [
 // "items" => array:3 [

example/01.normalization/08.object-output-normalization.php

@@ -37,17 +37,17 @@ public function __construct(
 
 var_dump($result);
 //
-// object{
-// items: array:3 [
-// "key1" => object{
-// value: "first"
-// }
-// "key2" => object{
-// value: "second"
-// }
-// 0 => object{
-// value: "third"
-// }
+// array:1 [
+// "items" => array:3 [
+// "key1" => array:1 [
+// "value" => "first"
+// ]
+// "key2" => array:1 [
+// "value" => "second"
+// ]
+// 0 => array:1 [
+// "value" => "third"
+// ]
 // ]
-// }
+// ]
 //

example/02.errors/01.custom-type-printer.php

@@ -26,19 +26,15 @@ public function __construct(
  ]
  ], ExampleDTO::class);
 } catch (RuntimeException $e) {
- // Before
  var_dump($e->getMessage());
- // - Type: "list<ExampleDTO>"
- // - Message: Passed value in "values" of {"values": 42} must be of type
- // list<ExampleDTO>, but 42 given at $.values[1].values
 
  // Replace all "expected type" definition to PHP-supported printer
  // instead of PrettyPrinter
  $e->template->types = new \TypeLang\Printer\NativeTypePrinter();
 
- // After
+ // Before: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at $.values[1].values
+ // After: Passed value in "values" of {"values": 42} must be of type
+ // array, but 42 given at $.values[1].values
  var_dump($e->getMessage());
- // - Type: "array"
- // - Message: Passed value in "values" of {"values": 42} must be of type
- // array, but 42 given at $.values[1].values
 }

example/02.errors/02.extended-type-printer.php

@@ -28,11 +28,7 @@ public function __construct(
  ],
  ], ExampleDTO::class);
 } catch (RuntimeException $e) {
- // Before
  var_dump($e->getMessage());
- // - Type: "list<ExampleDTO>"
- // - Message: Passed value in "values" of {"values": 42} must be of type
- // list<ExampleDTO>, but 42 given at $.values[1].values
 
  // Print all NamedTypeNode AST statements as "!!!MODIFIED!!!" string
  $e->template->types = new class extends PrettyPrinter {
@@ -42,9 +38,9 @@ protected function printNamedTypeNode(NamedTypeNode $node): string
  }
  };
 
- // After
+ // Before: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at $.values[1].values
+ // After: Passed value in "values" of {"values": 42} must be of type
+ // !!!MODIFIED!!!, but 42 given at $.values[1].values
  var_dump($e->getMessage());
- // - Type: "!!!MODIFIED!!!"
- // - Message: Passed value in "values" of {"values": 42} must be of type
- // !!!MODIFIED!!!, but 42 given at $.values[1].values
 }

example/02.errors/03.custom-value-printer.php

@@ -28,37 +28,30 @@ public function __construct(
  ],
  ], ExampleDTO::class);
 } catch (RuntimeException $e) {
- // Before
  var_dump($e->getMessage());
- // - Value#1: "of {"values": 42}"
- // - Value#2: "but 42 given"
- // - Message: Passed value in "values" of {"values": 42} must be of type
- // list<ExampleDTO>, but 42 given at $.values[1].values
 
  // Print all values using PHP-compatible types
  $e->template->values = new PHPValuePrinter();
 
- // After#1
+ // Before: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at $.values[1].values
+ // After#1: Passed value in string of stdClass must be of type
+ // list<ExampleDTO>, but int given at $.values[1].values
  var_dump($e->getMessage());
- // - Value#1: "of array"
- // - Value#2: "but int given"
- // - Message: Passed value in "values" of array must be of type
- // list<ExampleDTO>, but int given at $.values[1].values
 
 
  // In case of symfony/var-dumper is installed, we can use it
  if (\Composer\InstalledVersions::isInstalled('symfony/var-dumper')) {
  // Print all values using SymfonyValuePrinter
  $e->template->values = new SymfonyValuePrinter();
 
- // After#2
+ // Before: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at $.values[1].values
+ // After#1: Passed value in string of stdClass must be of type
+ // list<ExampleDTO>, but int given at $.values[1].values
+ // After#2: Passed value in "values" of {#394
+ // +"values": 42
+ // } must be of type list<ExampleDTO>, but 42 given at $.values[1].values
  var_dump($e->getMessage());
- // - Value#1: "of array:1 [
- // "values" => 42
- // ]"
- // - Value#2: "but 42 given"
- // - Message: Passed value in "values" of array:1 [
- // "values" => 42
- // ] must be of type list<ExampleDTO>, but 42 given at $.values[1].values
  }
 }

example/02.errors/04.custom-path-printer.php

@@ -28,10 +28,7 @@ public function __construct(
  ],
  ], ExampleDTO::class);
 } catch (RuntimeException $e) {
- // Before: "at $.values[1].values"
  var_dump($e->getMessage());
- // Passed value of field "values" must be of type list<ExampleDTO>,
- // but 42 given at $.values[1].values
 
  // Print full path using ">" delimiter
  $e->template->paths = new class implements PathPrinterInterface {
@@ -41,8 +38,10 @@ public function print(PathInterface $path): string
  }
  };
 
- // After: "at ExampleDTO > values > 1 > ExampleDTO > values"
+ // Before: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at $.values[1].values
+ // After: Passed value in "values" of {"values": 42} must be of type
+ // list<ExampleDTO>, but 42 given at ExampleDTO > values >
+ // 1 > ExampleDTO > values
  var_dump($e->getMessage());
- // Passed value of field "values" must be of type list<ExampleDTO>,
- // but 42 given at ExampleDTO > values > 1 > ExampleDTO > values
 }

example/03.types/03.custom-type-template-arguments.php

@@ -87,19 +87,30 @@ public function cast(mixed $value, Context $context): mixed
 // ]
 //
 
-var_dump($mapper->normalize([], 'non-empty<string>'));
+try {
+ var_dump($mapper->normalize([], 'non-empty<string>'));
+} catch (\Throwable $e) {
+ echo $e->getMessage() . "\n";
+}
 //
 // InvalidValueException: Passed value [] is invalid
 //
 
-
-var_dump($mapper->normalize('example', 'non-empty'));
+try {
+ var_dump($mapper->normalize('example', 'non-empty'));
+} catch (\Throwable $e) {
+ echo $e->getMessage() . "\n";
+}
 //
 // MissingTemplateArgumentsException: Type "non-empty" expects at least 1
 // template argument(s), but 0 were passed
 //
 
-var_dump($mapper->normalize('', 'non-empty<string>'));
+try {
+ var_dump($mapper->normalize('', 'non-empty<string>'));
+} catch (\Throwable $e) {
+ echo $e->getMessage() . "\n";
+}
 //
 // InvalidValueException: Passed value "" is invalid
 //

example/03.types/04.custom-platform.php

@@ -45,13 +45,22 @@ public function __construct(
 
 $mapper = new Mapper(new SimplePlatform());
 
-var_dump($mapper->normalize(new ExampleDTO()));
+try {
+ var_dump($mapper->normalize(new ExampleDTO()));
+} catch (\Throwable $e) {
+ echo $e->getMessage() . "\n";
+}
 //
 // TypeRequiredException: Type "int" for property ExampleDTO::$value
 // is not defined
 //
 
-var_dump($mapper->normalize([new ExampleDTO()], 'array<ExampleDTO>'));
+try {
+ var_dump($mapper->normalize([new ExampleDTO()], 'array<ExampleDTO>'));
+} catch (\Throwable $e) {
+ echo $e->getMessage() . "\n";
+}
 //
-// ParseException: Template arguments not allowed in "array<ExampleDTO>" at column 6
+// ParseException: Template arguments not allowed in "array<ExampleDTO>"
+// at column 6
 //

example/03.types/06.custom-type-psr-container.php

@@ -8,7 +8,6 @@
 use TypeLang\Mapper\Platform\DelegatePlatform;
 use TypeLang\Mapper\Platform\StandardPlatform;
 use TypeLang\Mapper\Runtime\Context;
-use TypeLang\Mapper\Type\Builder\CallableTypeBuilder;
 use TypeLang\Mapper\Type\Builder\PsrContainerTypeBuilder;
 use TypeLang\Mapper\Type\TypeInterface;
 

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

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+use TypeLang\Mapper\Mapper;
+
+require __DIR__ . '/../../vendor/autoload.php';
+
+class ExampleDTO
+{
+ public function __construct(
+ public readonly array $value = [],
+ ) {}
+}
+
+// Create standard platform with REFLECTION READER
+$platform = new \TypeLang\Mapper\Platform\StandardPlatform(
+ meta: new \TypeLang\Mapper\Mapping\Reader\ReflectionReader(),
+);
+
+$mapper = new Mapper($platform);
+
+var_dump($mapper->denormalize([
+ 'value' => ['string', 'string 2'],
+], ExampleDTO::class));
+
+//
+// Because NATIVE type hint is "array" that infers to "array<array-key, mixed>"
+//
+// object(ExampleDTO)#345 (1) {
+// ["value"] => array(2) {
+// [0] => string(6) "string"
+// [1] => string(8) "string 2"
+// }
+// }
+//
+
+