feat: Add Support for Alphanumeric CNPJ

Adds validation and tests for new CNPJ registrations, which will
accept alphanumeric characters starting from July 2026.

The change was instituted through "Instrução Normativa RFB
nº 2.119/2022."

Author: valdeirpsr

src/Validators/Cnpj.php

@@ -34,6 +34,8 @@
 )]
 final class Cnpj extends Simple
 {
+    private const int BASE_ASCII = 48;
+
     public function isValid(mixed $input): bool
     {
         if (!is_scalar($input)) {
@@ -42,7 +44,8 @@ public function isValid(mixed $input): bool
 
         // Code ported from jsfromhell.com
         $bases = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];
-        $digits = $this->getDigits((string) $input);
+        $chars = $this->getChars((string) $input);
+        $digits = $this->transformToAscii($chars);
 
         if (array_sum($digits) < 1) {
             return false;
@@ -72,13 +75,22 @@ public function isValid(mixed $input): bool
     }
 
     /** @return int[] */
-    private function getDigits(string $input): array
+    private function getChars(string $input): array
     {
         return array_map(
-            'intval',
+            'strtoupper',
             str_split(
-                (string) preg_replace('/\D/', '', $input),
+                (string) preg_replace('/[\W_]/', '', $input),
             ),
         );
     }
+
+    /** @return int[] */
+    private function transformToAscii(array $input): array
+    {
+        return array_map(
+            fn (string $character) => ord($character) - self::BASE_ASCII,
+            $input
+        );
+    }
 }

tests/unit/Validators/CnpjTest.php

@@ -39,11 +39,14 @@ public static function providerForValidInput(): iterable
             [$validator, '24.760.428/0001-09'],
             [$validator, '27.355.204/0001-00'],
             [$validator, '36.310.327/0001-07'],
+            [$validator, '12.ABC.345/01DE-35'],
+            [$validator, '12.ABC.345/01DE_35'],
             [$validator, '38175021000110'],
             [$validator, '37550610000179'],
             [$validator, '12774546000189'],
             [$validator, '77456211000168'],
             [$validator, '02023077000102'],
+            [$validator, '12ABC34501DE35'],
         ];
     }
 
@@ -75,6 +78,8 @@ public static function providerForInvalidInput(): iterable
             [$validator, '992999999999929384'],
             [$validator, '99-010-0.'],
             [$validator, null],
+            [$validator, '12ABC34501DE00'],
+            [$validator, '12ABC34501DEFG'],
         ];
     }
 }