Add HEX color validation rule

Author: pionl

src/Rules/HexColorRule.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Wrkflow\GetValue\Rules;
+
+use Wrkflow\GetValue\Contracts\RuleContract;
+
+class HexColorRule implements RuleContract
+{
+    public function passes(mixed $value): bool
+    {
+        if (is_string($value) === false) {
+            return false;
+        }
+
+        return (new RegexRule('/^#{0,1}[A-Fa-f0-9]{3,6}$/'))->passes($value);
+    }
+}

src/Rules/RegexRule.php

@@ -17,6 +17,10 @@ public function __construct(protected readonly string $pattern)
 
     public function passes(mixed $value): bool
     {
+        if (is_string($value) === false && is_numeric($value) === false) {
+            return false;
+        }
+
         $result = preg_match($this->pattern, (string) $value);
 
         return $result !== false && $result !== 0;

tests/Rules/HexColorRuleTest.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Wrkflow\GetValueTests\Rules;
+
+use PHPUnit\Framework\TestCase;
+use Wrkflow\GetValue\Rules\HexColorRule;
+
+class HexColorRuleTest extends TestCase
+{
+    public function dataProvider(): array
+    {
+        return [
+            [0.0, false],
+            [1.0, false],
+            [false, false],
+            [true, false],
+            [1, false],
+            [4544, false],
+            ['12', false],
+            ['#1', false],
+            ['#FF', false],
+            ['test', false],
+            [[], false],
+            ['red', false],
+            ['yellow', false],
+            ['#000', true],
+            ['#0000', true],
+            ['#00000', true],
+            ['#00000', true],
+            ['000', true],
+            ['0000', true],
+            ['00000', true],
+            ['00000', true],
+            ['#354D73', true],
+            ['#063971', true],
+            ['#F39F18', true],
+            ['#FFF', true],
+            ['#D84B20', true],
+        ];
+    }
+
+    /**
+     * @dataProvider dataProvider
+     */
+    public function testPassesOnExisting(string|int|array|float|null|bool $arg, bool $expected): void
+    {
+        $this->assertEquals($expected, (new HexColorRule())->passes($arg));
+    }
+}