chore: improve Country error message by including the iso code being used

Author: andrepimpao

docs/03x-rules-country.md

@@ -5,7 +5,7 @@ Validates that a value is a valid country code.
 ```php
 Country(
     string $code = 'alpha-2',
-    string $message = 'The "{{ name }}" value is not a valid country code, "{{ value }}" given.'
+    string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
 );
 ```
 
@@ -42,7 +42,7 @@ Available options:
 
 ### `message`
 
-type: `string` default: `The "{{ name }}" value is not a valid country code, "{{ value }}" given.`
+type: `string` default: `The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.`
 
 Message that will be shown if the input value is not a valid country code.
 

src/ChainedValidatorInterface.php

@@ -34,7 +34,7 @@ public function choice(
 
     public function country(
         string $code = 'alpha-2',
-        string $message = 'The "{{ name }}" value is not a valid country code, "{{ value }}" given.'
+        string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
     ): ChainedValidatorInterface;
 
     public function greaterThan(
@@ -70,6 +70,12 @@ public function range(
 
     public function rule(RuleInterface $constraint): ChainedValidatorInterface;
 
+    public function timezone(
+        int $timezoneGroup = \DateTimeZone::ALL,
+        ?string $countryCode = null,
+        string $message = 'The "{{ name }}" value is not a valid timezone, "{{ value }}" given.'
+    ): ChainedValidatorInterface;
+
     public function type(
         string|array $constraint,
         string $message = 'The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.'

src/Rule/Country.php

@@ -18,7 +18,7 @@ class Country extends AbstractRule implements RuleInterface
 
     public function __construct(
         private readonly string $code = self::ALPHA_2_CODE,
-        private readonly string $message = 'The "{{ name }}" value is not a valid country code, "{{ value }}" given.'
+        private readonly string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
     ) {}
 
     public function assert(mixed $value, string $name): void

src/StaticValidatorInterface.php

@@ -24,7 +24,7 @@ public static function choice(
 
     public static function country(
         string $code = 'alpha-2',
-        string $message = 'The "{{ name }}" value is not a valid country code, "{{ value }}" given.'
+        string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
     ): ChainedValidatorInterface;
 
     public static function greaterThan(
@@ -60,6 +60,12 @@ public static function range(
 
     public static function rule(RuleInterface $constraint): ChainedValidatorInterface;
 
+    public static function timezone(
+        int $timezoneGroup = \DateTimeZone::ALL,
+        ?string $countryCode = null,
+        string $message = 'The "{{ name }}" value is not a valid timezone, "{{ value }}" given.'
+    ): ChainedValidatorInterface;
+
     public static function type(
         string|array $constraint,
         string $message = 'The "{{ name }}" value should be of type "{{ constraint }}", "{{ value }}" given.'

tests/CountryTest.php

@@ -28,7 +28,7 @@ public static function provideRuleUnexpectedValueData(): \Generator
     public static function provideRuleFailureConditionData(): \Generator
     {
         $exception = CountryException::class;
-        $message = '/The "(.*)" value is not a valid country code, "(.*)" given./';
+        $message = '/The "(.*)" value is not a valid "(.*)" country code, "(.*)" given./';
 
         yield 'default' => [new Country(), 'PRT', $exception, $message];
         yield 'alpha2' => [new Country(code: 'alpha-2'), 'PRT', $exception, $message];