wip

Author: mabar

composer.json

@@ -33,7 +33,7 @@
 		"nette/utils": "^3.1.0|^4.0.0",
 		"orisai/exceptions": "^1.0.0",
 		"orisai/object-mapper-contracts": "^1.0.0",
-		"orisai/reflection-meta": "^1.0.0",
+		"orisai/reflection-meta": "^1.0.4",
 		"orisai/source-map": "^1.0.0",
 		"orisai/utils": "^1.0.0",
 		"symfony/polyfill-php80": "^1.27.0"

src/Callbacks/AfterMapping.php

@@ -12,7 +12,7 @@
  * @Target({"CLASS"})
  */
 #[Attribute(Attribute::TARGET_CLASS)]
-final class AfterMapping implements CallbackDefinition
+final class AfterMapping extends CallbackDefinition
 {
 
 	private string $method;
@@ -22,7 +22,7 @@ public function __construct(string $method)
 		$this->method = $method;
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return AfterMappingCallback::class;
 	}

src/Callbacks/AfterValidation.php

@@ -12,7 +12,7 @@
  * @Target({"CLASS", "PROPERTY"})
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_PROPERTY)]
-final class AfterValidation implements CallbackDefinition
+final class AfterValidation extends CallbackDefinition
 {
 
 	private string $method;
@@ -29,7 +29,7 @@ public function __construct(string $method, string $runtime = CallbackRuntime::P
 		$this->runtime = $runtime;
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return AfterValidationCallback::class;
 	}

src/Callbacks/BeforeValidation.php

@@ -12,7 +12,7 @@
  * @Target({"CLASS", "PROPERTY"})
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_PROPERTY)]
-final class BeforeValidation implements CallbackDefinition
+final class BeforeValidation extends CallbackDefinition
 {
 
 	private string $method;
@@ -29,7 +29,7 @@ public function __construct(string $method, string $runtime = CallbackRuntime::P
 		$this->runtime = $runtime;
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return BeforeValidationCallback::class;
 	}

src/Callbacks/CallbackDefinition.php

@@ -5,12 +5,17 @@
 use Orisai\ObjectMapper\Args\Args;
 use Orisai\ObjectMapper\Meta\MetaDefinition;
 
-interface CallbackDefinition extends MetaDefinition
+abstract class CallbackDefinition implements MetaDefinition
 {
 
 	/**
 	 * @return class-string<Callback<Args>>
 	 */
-	public function getType(): string;
+	abstract public function getHandler(): string;
+
+	final public function getScope(): string
+	{
+		return Callback::class;
+	}
 
 }

src/Docs/Description.php

@@ -13,7 +13,7 @@
  * @Target({"CLASS", "PROPERTY"})
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_PROPERTY)]
-final class Description implements DocDefinition
+final class Description extends DocDefinition
 {
 
 	private string $message;
@@ -23,7 +23,7 @@ public function __construct(string $message)
 		$this->message = AnnotationFilter::filterMultilineDocblock($message);
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return DescriptionDoc::class;
 	}
@@ -35,4 +35,9 @@ public function getArgs(): array
 		];
 	}
 
+	public function getScope(): string
+	{
+		return DescriptionDoc::class;
+	}
+
 }

src/Docs/DocDefinition.php

@@ -4,12 +4,12 @@
 
 use Orisai\ObjectMapper\Meta\MetaDefinition;
 
-interface DocDefinition extends MetaDefinition
+abstract class DocDefinition implements MetaDefinition
 {
 
 	/**
 	 * @return class-string<Doc>
 	 */
-	public function getType(): string;
+	abstract public function getHandler(): string;
 
 }

src/Docs/Example.php

@@ -11,7 +11,7 @@
  * @NamedArgumentConstructor()
  * @Target({"ANNOTATION"})
  */
-final class Example implements DocDefinition
+final class Example extends DocDefinition
 {
 
 	private string $content;
@@ -26,7 +26,7 @@ public function __construct(string $content, ?string $description = null)
 			: AnnotationFilter::filterMultilineDocblock($description);
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return ExampleDoc::class;
 	}
@@ -39,4 +39,9 @@ public function getArgs(): array
 		];
 	}
 
+	public function getScope(): string
+	{
+		return ExampleDoc::class;
+	}
+
 }

src/Docs/Examples.php

@@ -5,7 +5,6 @@
 use Attribute;
 use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
 use Orisai\Exceptions\Logic\InvalidArgument;
-use Orisai\ObjectMapper\Meta\Shared\DocMeta;
 use function sprintf;
 
 /**
@@ -14,10 +13,10 @@
  * @Target({"CLASS", "PROPERTY"})
  */
 #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_PROPERTY)]
-final class Examples implements DocDefinition
+final class Examples extends DocDefinition
 {
 
-	/** @var array<DocMeta> */
+	/** @var array<Example> */
 	private array $examples;
 
 	/**
@@ -30,7 +29,7 @@ public function __construct(array $examples)
 
 	/**
 	 * @param array<mixed> $examples
-	 * @return array<DocMeta>
+	 * @return array<Example>
 	 */
 	private function resolveExamples(array $examples): array
 	{
@@ -43,13 +42,13 @@ private function resolveExamples(array $examples): array
 				));
 			}
 
-			$examples[$key] = new DocMeta($example->getType(), $example->getArgs());
+			$examples[$key] = $example;
 		}
 
 		return $examples;
 	}
 
-	public function getType(): string
+	public function getHandler(): string
 	{
 		return ExamplesDoc::class;
 	}
@@ -61,4 +60,9 @@ public function getArgs(): array
 		];
 	}
 
+	public function getScope(): string
+	{
+		return ExamplesDoc::class;
+	}
+
 }

src/Docs/ExamplesDoc.php

@@ -4,7 +4,6 @@
 
 use Orisai\ObjectMapper\Args\ArgsChecker;
 use Orisai\ObjectMapper\Meta\Context\MetaContext;
-use Orisai\ObjectMapper\Meta\Shared\DocMeta;
 
 final class ExamplesDoc implements Doc
 {
@@ -21,14 +20,14 @@ public static function resolveArgs(array $args, MetaContext $context): array
 		$checker->checkAllowedArgs([self::Examples]);
 
 		$checker->checkRequiredArg(self::Examples);
-		/** @var array<DocMeta> $examples */
+		/** @var array<DocDefinition> $examples */
 		$examples = $checker->checkArray(self::Examples);
 
 		$resolver = $context->getMetaResolver();
 		$optimized = [];
 
 		foreach ($examples as $example) {
-			$optimized[$example->getName()::getUniqueName()]
+			$optimized[$example->getHandler()::getUniqueName()]
 				= $resolver->resolveDocMeta($example, $context);
 		}