feat(validation): add HexColor validation rule (#1332)

Co-authored-by: Brent Roose <[email protected]>

Author: tizianozonta

packages/validation/src/Rules/HexColor.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Validation\Rules;
+
+use Attribute;
+use Tempest\Validation\Rule;
+
+#[Attribute]
+final readonly class HexColor implements Rule
+{
+    public function __construct(
+        private bool $orNull = false,
+    ) {}
+
+    public function isValid(mixed $value): bool
+    {
+        if ($this->orNull && $value === null) {
+            return true;
+        }
+
+        if (! is_string($value)) {
+            return false;
+        }
+
+        return preg_match('/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/i', $value) === 1;
+    }
+
+    public function message(): string
+    {
+        return 'Value should be a valid hexadecimal color.';
+    }
+}

packages/validation/tests/Rules/HexColorTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Validation\Tests\Rules;
+
+use PHPUnit\Framework\TestCase;
+use Tempest\Validation\Rules\HexColor;
+
+/**
+ * @internal
+ */
+final class HexColorTest extends TestCase
+{
+    public function test_uuid(): void
+    {
+        $rule = new HexColor();
+
+        $this->assertSame('Value should be a valid hexadecimal color.', $rule->message());
+
+        $this->assertFalse($rule->isValid('string_123'));
+        $this->assertFalse($rule->isValid([])); // Should return false, not a TypeError from preg_match
+        $this->assertFalse($rule->isValid('ffffff'));
+        $this->assertFalse($rule->isValid('#fffffff'));
+        $this->assertFalse($rule->isValid('#fffaa'));
+
+        $this->assertTrue($rule->isValid('#ffffff'));
+        $this->assertTrue($rule->isValid('#FFFFFF'));
+        $this->assertTrue($rule->isValid('#FFFFFFAA'));
+        $this->assertTrue($rule->isValid('#fff'));
+        $this->assertTrue($rule->isValid('#fffa'));
+    }
+}