Improve error messages consistency

Author: nyamsprod

src/InnerList.php

@@ -36,11 +36,11 @@ public static function fromHttpValue(string $httpValue): self
         $field = trim($httpValue);
 
         if (1 !== preg_match("/^\((?<content>.*)\)(?<parameters>[^,]*)/", $field, $found)) {
-            throw new SyntaxError("InnerList field `$httpValue` contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation `$httpValue` for a inner list contains invalid characters.");
         }
 
         if ('' !== $found['parameters'] && !str_starts_with($found['parameters'], ';')) {
-            throw new SyntaxError("InnerList field `$httpValue` contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation `$httpValue` for a inner list contains invalid characters.");
         }
 
         /** @var string $content */

src/Item.php

@@ -60,13 +60,13 @@ public static function fromHttpValue(string $httpValue): self
         [$value, $parameters] = match (true) {
             $httpValue === '',
             1 === preg_match("/[\r\t\n]/", $httpValue),
-            1 === preg_match("/[^\x20-\x7E]/", $httpValue) => throw new SyntaxError("Item field `$httpValue` contains invalid characters."),
+            1 === preg_match("/[^\x20-\x7E]/", $httpValue) => throw new SyntaxError("The HTTP textual representation `$httpValue` for an item contains invalid characters."),
             1 === preg_match('/^(-?[0-9])/', $httpValue) => self::parseNumber($httpValue),
             $httpValue[0] == '"' => self::parseString($httpValue),
             $httpValue[0] == ':' => self::parseBytesSequence($httpValue),
             $httpValue[0] == '?' => self::parseBoolean($httpValue),
             1 === preg_match('/^([a-z*])/i', $httpValue) => self::parseToken($httpValue),
-            default => throw new SyntaxError("Item field `$httpValue` is unknown or unsupported."),
+            default => throw new SyntaxError("The HTTP textual representation `$httpValue` for an item is unknown or unsupported."),
         };
 
         return new self($value, Parameters::fromHttpValue($parameters));
@@ -83,7 +83,7 @@ private static function parseToken(string $string): array
         }
 
         if (1 !== preg_match('/'.$regexp.'/i', $string, $matches)) {
-            throw new SyntaxError("The token item `$string` contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation `$string` for a token contains invalid characters.");
         }
 
         return [
@@ -98,7 +98,7 @@ private static function parseToken(string $string): array
     private static function parseBoolean(string $string): array
     {
         if (1 !== preg_match('/^\?[01]/', $string)) {
-            throw new SyntaxError('The boolean item `'.$string.'` contains invalid characters.');
+            throw new SyntaxError("The HTTP textual representation `$string` for a boolean contains invalid characters.");
         }
 
         return [$string[1] === '1', substr($string, 2)];
@@ -110,7 +110,7 @@ private static function parseBoolean(string $string): array
     private static function parseBytesSequence(string $string): array
     {
         if (1 !== preg_match('/^:(?<bytes>[a-z0-9+\/=]*):/i', $string, $matches)) {
-            throw new SyntaxError('The byte sequence item `'.$string.'` contains invalid characters.');
+            throw new SyntaxError("The HTTP textual representation `$string` for a byte sequence contains invalid characters.");
         }
 
         return [ByteSequence::fromEncoded($matches['bytes']), substr($string, strlen($matches[0]))];
@@ -122,13 +122,13 @@ private static function parseBytesSequence(string $string): array
     private static function parseNumber(string $string): array
     {
         if (1 !== preg_match('/^(?<number>-?\d+(?:\.\d+)?)(?:[^\d.]|$)/', $string, $found)) {
-            throw new SyntaxError('The number item `'.$string.'` contains invalid format.');
+            throw new SyntaxError("The HTTP textual representation `$string` for a number contains invalid characters.");
         }
 
         $number = match (true) {
             1 === preg_match('/^-?\d{1,12}\.\d{1,3}$/', $found['number']) => (float) $found['number'],
             1 === preg_match('/^-?\d{1,15}$/', $found['number']) => (int) $found['number'],
-            default => throw new SyntaxError('The number item `'.$string.'` contains too many digits'),
+            default => throw new SyntaxError("The HTTP textual representation `$string` for a number contain too many digits."),
         };
 
         return [$number, substr($string, strlen($found['number']))];
@@ -157,19 +157,19 @@ private static function parseString(string $string): array
             }
 
             if ($string === '') {
-                throw new SyntaxError('Invalid end of string');
+                throw new SyntaxError("The HTTP textual representation `$originalString` for a string contains an invalid end string.");
             }
 
             $char = $string[0];
             $string = substr($string, 1);
             if (!in_array($char, ['"', '\\'], true)) {
-                throw new SyntaxError('Invalid escaped character in string `'.$originalString.'`');
+                throw new SyntaxError("The HTTP textual representation `$originalString` for a string contains invalid characters.");
             }
 
             $returnValue .= $char;
         }
 
-        throw new SyntaxError('Invalid end of string');
+        throw new SyntaxError("The HTTP textual representation `$originalString` for a string contains an invalid end string.");
     }
 
     public function value(): Token|ByteSequence|int|float|string|bool