fix(quality): pass all kcode quality checks — psalm, phpstan, cs-fixer, phpunit

Psalm fixes:
- Add #[Override] attribute to all TransformationRule implementations
  (transform() and getName() methods) via psalm --alter
- AgeRule: remove redundant (int) cast, DateInterval->y is already int
- DateToIso8601Rule: ensure $tz is non-empty-string before DateTimeZone()
- RelativeDateRule: use intdiv(int, int) instead of / operator;
  cast abs() result to (int) since abs(int) returns float|int in Psalm
- PercentageRule: use 100.0 instead of 100 to fix float * int InvalidOperand

CS-Fixer: auto-format new source and test files to project code style

Author: walmir-silva

src/Configuration/TransformerConfiguration.php

@@ -16,5 +16,6 @@
     public function __construct(
         public bool $trackTransformations = true,
         public bool $preserveOriginal = true,
-    ) {}
+    ) {
+    }
 }

src/Contract/RuleRegistry.php

@@ -14,8 +14,11 @@
 interface RuleRegistry
 {
     public function register(string $alias, TransformationRule $rule): void;
+
     public function resolve(string $alias): TransformationRule;
+
     public function has(string $alias): bool;
+
     /** @return list<string> */
     public function aliases(): array;
 }

src/Core/InMemoryRuleRegistry.php

@@ -20,6 +20,7 @@ final class InMemoryRuleRegistry implements RuleRegistry
     /** @var array<string, TransformationRule> */
     private array $rules = [];
 
+    #[\Override]
     public function register(string $alias, TransformationRule $rule): void
     {
         if (isset($this->rules[$alias])) {
@@ -28,11 +29,21 @@ public function register(string $alias, TransformationRule $rule): void
         $this->rules[$alias] = $rule;
     }
 
+    #[\Override]
     public function resolve(string $alias): TransformationRule
     {
         return $this->rules[$alias] ?? throw InvalidRuleException::unknownAlias($alias);
     }
 
-    public function has(string $alias): bool { return isset($this->rules[$alias]); }
-    public function aliases(): array { return array_keys($this->rules); }
+    #[\Override]
+    public function has(string $alias): bool
+    {
+        return isset($this->rules[$alias]);
+    }
+
+    #[\Override]
+    public function aliases(): array
+    {
+        return array_keys($this->rules);
+    }
 }

src/Core/TransformAttributeHandler.php

@@ -31,13 +31,13 @@ final class TransformAttributeHandler implements PropertyAttributeHandler, Prope
     #[\Override]
     public function handleAttribute(string $propertyName, object $attribute, mixed $value): mixed
     {
-        if (!$attribute instanceof Transform) {
+        if (! $attribute instanceof Transform) {
             return null;
         }
 
         $this->data[$propertyName] = $value;
 
-        if (!isset($this->fieldRules[$propertyName])) {
+        if (! isset($this->fieldRules[$propertyName])) {
             $this->fieldRules[$propertyName] = [];
         }
 
@@ -84,7 +84,7 @@ public function applyChanges(object $object): void
     {
         foreach ($this->processedValues as $property => $value) {
             try {
-                (new PropertyAccessor($object, $property))->setValue($value);
+                new PropertyAccessor($object, $property)->setValue($value);
             } catch (\ReflectionException) {
                 // Property doesn't exist — skip silently
             }

src/Core/TransformationContextImpl.php

@@ -24,7 +24,8 @@ private function __construct(
         private string $fieldName,
         private array $rootData,
         private array $parameters,
-    ) {}
+    ) {
+    }
 
     /**
      * @param array<string, mixed> $rootData
@@ -34,19 +35,33 @@ public static function create(array $rootData): self
         return new self('', $rootData, []);
     }
 
-    public function getFieldName(): string { return $this->fieldName; }
+    #[\Override]
+    public function getFieldName(): string
+    {
+        return $this->fieldName;
+    }
 
     /** @return array<string, mixed> */
-    public function getRootData(): array { return $this->rootData; }
+    #[\Override]
+    public function getRootData(): array
+    {
+        return $this->rootData;
+    }
 
+    #[\Override]
     public function getParameter(string $key, mixed $default = null): mixed
     {
         return $this->parameters[$key] ?? $default;
     }
 
     /** @return array<string, mixed> */
-    public function getParameters(): array { return $this->parameters; }
+    #[\Override]
+    public function getParameters(): array
+    {
+        return $this->parameters;
+    }
 
+    #[\Override]
     public function withField(string $field): static
     {
         return new self($field, $this->rootData, $this->parameters);
@@ -55,6 +70,7 @@ public function withField(string $field): static
     /**
      * @param array<string, mixed> $parameters
      */
+    #[\Override]
     public function withParameters(array $parameters): static
     {
         return new self($this->fieldName, $this->rootData, [...$this->parameters, ...$parameters]);

src/Core/TransformerEngine.php

@@ -25,7 +25,8 @@ final class TransformerEngine
     public function __construct(
         private readonly RuleRegistry $registry,
         private readonly ?TransformerConfiguration $configuration = null,
-    ) {}
+    ) {
+    }
 
     /**
      * @param array<string, mixed> $data
@@ -62,17 +63,18 @@ public function transform(array $data, array $fieldRules): TransformationResult
     /** @param array<string, mixed> $data */
     private function resolveValue(array $data, string $field): mixed
     {
-        if (array_key_exists($field, $data)) {
+        if (\array_key_exists($field, $data)) {
             return $data[$field];
         }
         $segments = explode('.', $field);
         $current = $data;
         foreach ($segments as $segment) {
-            if (!is_array($current) || !array_key_exists($segment, $current)) {
+            if (! \is_array($current) || ! \array_key_exists($segment, $current)) {
                 return null;
             }
             $current = $current[$segment];
         }
+
         return $current;
     }
 
@@ -85,12 +87,13 @@ private function resolveRule(string|array|TransformationRule $definition): array
         if ($definition instanceof TransformationRule) {
             return [$definition, []];
         }
-        if (is_string($definition)) {
+        if (\is_string($definition)) {
             return [$this->registry->resolve($definition), []];
         }
         $ruleRef = $definition[0];
         $params = $definition[1] ?? [];
         $rule = $ruleRef instanceof TransformationRule ? $ruleRef : $this->registry->resolve($ruleRef);
+
         return [$rule, $params];
     }
 }

src/Event/TransformationCompletedEvent.php

@@ -15,5 +15,7 @@
  */
 final readonly class TransformationCompletedEvent
 {
-    public function __construct(public TransformationResult $result, public float $durationMs, public float $timestamp = 0) {}
+    public function __construct(public TransformationResult $result, public float $durationMs, public float $timestamp = 0)
+    {
+    }
 }

src/Event/TransformationStartedEvent.php

@@ -14,5 +14,7 @@
 final readonly class TransformationStartedEvent
 {
     /** @param list<string> $fields */
-    public function __construct(public array $fields, public float $timestamp = 0) {}
+    public function __construct(public array $fields, public float $timestamp = 0)
+    {
+    }
 }

src/Integration/ProcessorBridge.php

@@ -19,7 +19,9 @@
     /**
      * @param array<string, list<string|array{0: string, 1: array<string, mixed>}>> $fieldRules
      */
-    public function __construct(private TransformerEngine $engine, private array $fieldRules) {}
+    public function __construct(private TransformerEngine $engine, private array $fieldRules)
+    {
+    }
 
     /**
      * @param array<string, mixed> $data
@@ -28,6 +30,7 @@ public function __construct(private TransformerEngine $engine, private array $fi
     public function process(array $data): array
     {
         $result = $this->engine->transform($data, $this->fieldRules);
+
         return ['data' => $result->getTransformedData(), 'result' => $result];
     }
 }

src/Result/FieldTransformation.php

@@ -18,7 +18,11 @@ public function __construct(
         public string $ruleName,
         public mixed $before,
         public mixed $after,
-    ) {}
+    ) {
+    }
 
-    public function wasTransformed(): bool { return $this->before !== $this->after; }
+    public function wasTransformed(): bool
+    {
+        return $this->before !== $this->after;
+    }
 }