add CustomizableMessageAttribute interface

src/Processor/Attribute/CustomizableMessageAttribute.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Contract\Processor\Attribute;
+
+/**
+ * Interface CustomizableMessageAttribute.
+ *
+ * Defines the contract for an attribute that can provide custom error messages for validators.
+ *
+ * @category  Processor
+ *
+ * @author    Walmir Silva <walmir.silva@kariricode.org>
+ * @license   MIT
+ *
+ * @see       https://kariricode.org/
+ */
+interface CustomizableMessageAttribute
+{
+    /**
+     * Retrieves a custom message for a specific validator.
+     *
+     * @param string $validatorName The name of the validator
+     *
+     * @return string|null The custom message if set, null otherwise
+     */
+    public function getMessage(string $validatorName): ?string;
+}

src/Processor/ProcessableAttribute.php → src/Processor/Attribute/ProcessableAttribute.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Processor;
+namespace KaririCode\Contract\Processor\Attribute;
 
 /**
  * Interface ProcessableAttribute.
@@ -24,11 +24,4 @@ interface ProcessableAttribute
      * @return array The list of processors
      */
     public function getProcessors(): array;
-
-    /**
-     * Provides a fallback value for the attribute if processing fails or is not available.
-     *
-     * @return mixed The fallback value
-     */
-    public function getFallbackValue(): mixed;
 }

src/Validator/Validator.php

@@ -19,11 +19,11 @@
 interface Validator
 {
     /**
-     * Validates the provided input and returns a boolean indicating if the input is valid.
+     * Validates the provided input and returns the validated result.
      *
      * @param mixed $input The value to be validated
      *
-     * @return bool True if the input is valid, false otherwise
+     * @return mixed The validated result
      */
-    public function validate(mixed $input): bool;
+    public function validate(mixed $input): mixed;
 }

tests/Processor/Attribute/CustomizableMessageAttributeTest.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Contract\Tests\Processor\Attribute;
+
+use KaririCode\Contract\Processor\Attribute\CustomizableMessageAttribute;
+use PHPUnit\Framework\MockObject\MockObject;
+use PHPUnit\Framework\TestCase;
+
+final class CustomizableMessageAttributeTest extends TestCase
+{
+    public function testGetMessage(): void
+    {
+        /** @var CustomizableMessageAttribute|MockObject */
+        $customizableMessageAttribute = $this->createMock(CustomizableMessageAttribute::class);
+
+        $validatorName = 'requiredValidator';
+        $expectedMessage = 'This field is required.';
+
+        $customizableMessageAttribute->expects($this->once())
+            ->method('getMessage')
+            ->with($validatorName)
+            ->willReturn($expectedMessage);
+
+        $this->assertSame($expectedMessage, $customizableMessageAttribute->getMessage($validatorName));
+    }
+
+    public function testGetMessageReturnsNull(): void
+    {
+        /** @var CustomizableMessageAttribute|MockObject */
+        $customizableMessageAttribute = $this->createMock(CustomizableMessageAttribute::class);
+
+        $validatorName = 'nonExistentValidator';
+
+        $customizableMessageAttribute->expects($this->once())
+            ->method('getMessage')
+            ->with($validatorName)
+            ->willReturn(null);
+
+        $this->assertNull($customizableMessageAttribute->getMessage($validatorName));
+    }
+}

tests/Processor/ProcessableAttributeTest.php → tests/Processor/Attribute/ProcessableAttributeTest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KaririCode\Contract\Tests\Processor;
+namespace KaririCode\Contract\Tests\Processor\Attribute;
 
-use KaririCode\Contract\Processor\ProcessableAttribute;
+use KaririCode\Contract\Processor\Attribute\ProcessableAttribute;
 use PHPUnit\Framework\MockObject\MockObject;
 use PHPUnit\Framework\TestCase;
 
@@ -22,17 +22,4 @@ public function testGetProcessors(): void
 
         $this->assertSame($processors, $processableAttribute->getProcessors());
     }
-
-    public function testGetFallbackValue(): void
-    {
-        /** @var ProcessableAttribute|MockObject */
-        $processableAttribute = $this->createMock(ProcessableAttribute::class);
-        $fallbackValue = 'default value';
-
-        $processableAttribute->expects($this->once())
-            ->method('getFallbackValue')
-            ->willReturn($fallbackValue);
-
-        $this->assertSame($fallbackValue, $processableAttribute->getFallbackValue());
-    }
 }