fix: Matching better organization

Author: patrykbaszak

README.md

@@ -8,23 +8,44 @@
 
 ## Attributes
 
+### Groups & Ignore<hr>
+
+`#[Ignore()]` is like `#[Groups()]` with empty array of groups. If You do not define the groups for property, then `Default` will be assignment as a property group. Only `Origin` can decide about group assignment in the process.
+
+| Declaration place | Normalization | Denormalization | Transformation |
+|:-:|:-:|:-:|:-:|
+| **Origin** | Source: ✔️<br>Target: ✔️ | Source: ✔️<br>Target: ✔️ | Source: ✔️<br>Target: ✔️ |
+| **Source** | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ |
+| **Target** | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ |
+
+| Declaration place | Mapping |
+|:-:|:-:|
+| **Origin** | Source: ✔️<br>Target: ✔️ |
+| **Source** | Source: ✖️<br>Target: ✖️ |
+| **Target** | Source: ✖️<br>Target: ✖️ |
+
+###### legend: ✖️ - *has no effect*, ✔️ - *affects*, ➖ - *not implemented*
+
+> **INFO**<br>
+> The table is implemented by `PBaszak\UltraMapper\Mapper\Domain\Matcher\Matcher::matchClassBlueprints()`.
+
 ### TargetProperty<hr>
 
 The behavior of the `#[TargetProperty()]` attribute depends on the class in which you declare it (*origin*, *source*, *target*). The table below presents the relationship between the declaration place and the active process, and how the attribute changes the name (or path) of the property. Placing an attribute in an origin class has no effect on any process unless the origin class is also a source class, a target class, or both.
 
-##### NAME
-
 Target Property attribute works like `Symfony\SerializedName` for Normalization, Denormalization and Transformation. It changes property name when data are normalized.
 
 | Declaration place | Normalization | Denormalization | Transformation |
 |:-:|:-:|:-:|:-:|
+| **Origin** | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✖️ |
 | **Source** | Source: ✖️<br>Target: ✖️ | Source: ✔️<br>Target: ✖️ | Source: ✔️<br>Target: ✖️ |
 | **Target** | Source: ✖️<br>Target: ✔️ | Source: ✖️<br>Target: ✖️ | Source: ✖️<br>Target: ✔️ |
 
 Target Property attribute links properties from different blueprints for Mapping. It works with other processes or alone.
 
 | Declaration place | Mapping |
 |:-:|:-:|
+| **Origin** | Source: ✖️<br>Target: ✖️ |
 | **Source** | Source: ✖️<br>Target: ✔️ |
 | **Target** | Source: ✔️<br>Target: ✖️ |
 

src/Blueprint/Application/Model/Assets/PropertyBlueprint.php

@@ -6,6 +6,7 @@
 
 use PBaszak\UltraMapper\Blueprint\Application\Enum\Visibility;
 use PBaszak\UltraMapper\Blueprint\Application\Model\Type;
+use PBaszak\UltraMapper\Mapper\Application\Attribute\Groups;
 use PBaszak\UltraMapper\Shared\Infrastructure\Normalization\Normalizable;
 
 class PropertyBlueprint implements Normalizable
@@ -96,6 +97,20 @@ public function getReflection(): \ReflectionProperty
         return new \ReflectionProperty($this->class->name, $this->originName);
     }
 
+    /** 
+     * @return object[]
+     */
+    public function getAttributes(string $class): array
+    {
+        /** @var array<AttributeBlueprint> $attrs */
+        $attrs = $this->attributes[$class];
+
+        /** @var object[] $attrs */
+        array_walk($attrs, fn (AttributeBlueprint $attr): object => $attr->newInstance());
+
+        return $attrs;
+    }
+
     public function normalize(): array
     {
         return [

src/Mapper/Application/Attribute/Groups.php

@@ -18,6 +18,7 @@ class Groups implements AttributeInterface
      */
     public function __construct(
         public readonly string|array $groups,
+        public int $processType = self::DENORMALIZATION | self::NORMALIZATION | self::TRANSFORMATION | self::MAPPING,
         public readonly array $options = []
     ) {
     }
@@ -26,4 +27,9 @@ public function validate(\ReflectionProperty|\ReflectionParameter|\ReflectionCla
     {
         // todo implement
     }
+    
+    public function getProcessType(): int
+    {
+        return $this->processType;
+    }
 }

src/Mapper/Application/Attribute/Ignore.php

@@ -13,18 +13,6 @@ class Ignore implements AttributeInterface
 {
     use ThrowAttributeValidationExceptionTrait;
 
-    public const DENORMALIZATION = 1; // 0001
-    public const NORMALIZATION = 2; // 0010
-    public const MAPPING = 4; // 0100
-    public const TRANSFORMATION = 8; // 1000
-
-    public const PROCESS_TYPE_MAP = [
-        Process::DENORMALIZATION_PROCESS => self::DENORMALIZATION,
-        Process::NORMALIZATION_PROCESS => self::NORMALIZATION,
-        Process::MAPPING_PROCESS => self::MAPPING,
-        Process::TRANSFORMATION_PROCESS => self::TRANSFORMATION,
-    ];
-
     /**
      * @param array<string, mixed> $options Options are for modificators of the mapping process. If You need them, You can use them.
      */
@@ -38,4 +26,9 @@ public function validate(\ReflectionProperty|\ReflectionParameter|\ReflectionCla
     {
         // todo implement
     }
+
+    public function getProcessType(): int
+    {
+        return $this->processType;
+    }
 }

src/Mapper/Application/Contract/AttributeInterface.php

@@ -4,7 +4,23 @@
 
 namespace PBaszak\UltraMapper\Mapper\Application\Contract;
 
+use PBaszak\UltraMapper\Mapper\Domain\Model\Process;
+
 interface AttributeInterface
 {
+    public const DENORMALIZATION = 1; // 0001
+    public const NORMALIZATION = 2; // 0010
+    public const MAPPING = 4; // 0100
+    public const TRANSFORMATION = 8; // 1000
+
+    public const PROCESS_TYPE_MAP = [
+        Process::DENORMALIZATION_PROCESS => self::DENORMALIZATION,
+        Process::NORMALIZATION_PROCESS => self::NORMALIZATION,
+        Process::MAPPING_PROCESS => self::MAPPING,
+        Process::TRANSFORMATION_PROCESS => self::TRANSFORMATION,
+    ];
+
     public function validate(\ReflectionProperty|\ReflectionParameter|\ReflectionClass $reflection): void;
+
+    public function getProcessType(): int;
 }

src/Mapper/Application/Model/Context.php

@@ -15,4 +15,16 @@ public function __construct(
         public bool $isCollection = false,
     ) {
     }
+
+    /**
+     * @param string[] $groups
+     * 
+     * @return bool Success if the group is matching.
+     */
+    public function isGroupMatching(array $groups): bool
+    {
+        $groups = empty($groups) ? ['Default'] : $groups;
+
+        return !empty(array_intersect($this->groups, $groups));
+    }
 }

src/Mapper/Domain/Matcher/Contract/ClassMatchingStrategy.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PBaszak\UltraMapper\Mapper\Domain\Matcher\Contract;
+
+use PBaszak\UltraMapper\Blueprint\Application\Model\Assets\ClassBlueprint;
+use PBaszak\UltraMapper\Mapper\Application\Model\Context;
+use PBaszak\UltraMapper\Mapper\Domain\Model\Process;
+
+interface ClassMatchingStrategy
+{
+    /**
+     * Method checks if the strategy conditions are met.
+     * 
+     * @return bool Success if the conditions are met.
+     */
+    public function isStrategyConditionsMet(
+        Context $context,
+        Process $process,
+        ClassBlueprint $origin,
+        ClassBlueprint $source,
+        ClassBlueprint $target
+    ): bool;
+
+    /**
+     * Method matches classes in the way defined by the strategy.
+     * 
+     * @return void
+     */
+    public function matchClasses(
+        Context $context,
+        Process $process,
+        ClassBlueprint $origin,
+        ClassBlueprint $source,
+        ClassBlueprint $target
+    ): void;
+}

src/Mapper/Domain/Contract/MatcherInterface.php src/Mapper/Domain/Matcher/Contract/MatcherInterface.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PBaszak\UltraMapper\Mapper\Domain\Contract;
+namespace PBaszak\UltraMapper\Mapper\Domain\Matcher\Contract;
 
 use PBaszak\UltraMapper\Blueprint\Application\Model\Blueprint;
 use PBaszak\UltraMapper\Mapper\Application\Contract\MapperInterface;
@@ -16,9 +16,12 @@ interface MatcherInterface
     public const OPTION_SOURCE = MapperInterface::FROM_PROCESS_USE;
     public const OPTION_TARGET = MapperInterface::TO_PROCESS_USE;
 
+    /**
+     * Main method of the matcher. It matches blueprints and their all assets.
+     */
     public function matchBlueprints(
         Context $context,
-        Process $processType,
+        Process $process,
         Blueprint $origin,
         Blueprint $source,
         Blueprint $target

src/Mapper/Domain/Matcher/Contract/PropertyMatchingStrategy.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PBaszak\UltraMapper\Mapper\Domain\Matcher\Contract;
+
+use PBaszak\UltraMapper\Blueprint\Application\Model\Assets\PropertyBlueprint;
+use PBaszak\UltraMapper\Mapper\Application\Model\Context;
+use PBaszak\UltraMapper\Mapper\Domain\Model\Process;
+
+interface PropertyMatchingStrategy
+{
+    /**
+     * Method checks if the strategy conditions are met.
+     * 
+     * @return bool Success if the conditions are met.
+     */
+    public function isStrategyConditionsMet(
+        Context $context,
+        Process $process,
+        PropertyBlueprint $origin,
+        PropertyBlueprint $source,
+        PropertyBlueprint $target
+    ): bool;
+
+    /**
+     * Method matches properties in the way defined by the strategy.
+     * 
+     * @return void
+     */
+    public function matchProperties(
+        Context $context,
+        Process $process,
+        PropertyBlueprint $origin,
+        PropertyBlueprint $source,
+        PropertyBlueprint $target
+    ): void;
+}

src/Mapper/Domain/Exception/PropertyNotMatchedException.php src/Mapper/Domain/Matcher/Exception/PropertyNotMatchedException.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PBaszak\UltraMapper\Mapper\Domain\Exception;
+namespace PBaszak\UltraMapper\Mapper\Domain\Matcher\Exception;
 
 use PBaszak\UltraMapper\Shared\Application\Exception\UltraMapperException;