Add php 8.1 support to the type-lang/types package

.gitattributes

@@ -1,6 +1,7 @@
 * text=auto eol=lf
 *.pp eol=lf linguist-language=EBNF
 *.pp2 eol=lf linguist-language=EBNF
+*.pp3 eol=lf linguist-language=EBNF
 
 # GIT
 .editorconfig export-ignore

.github/workflows/tests.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php: [ '8.4', '8.5' ]
+        php: [ '8.1', '8.2', '8.3', '8.4', '8.5' ]
         os: [ ubuntu-latest, macos-latest, windows-latest ]
         stability: [ lowest, stable ]
     steps:

.php-cs-fixer.php

@@ -24,7 +24,7 @@
         strict: true,
     ));
 
-return new Config()
+return (new Config())
     ->setUnsupportedPhpVersionAllowed(true)
     ->setParallelConfig(ParallelConfigFactory::detect())
     ->setRules([
@@ -277,7 +277,7 @@
         'unary_operator_spaces' => true,
         'whitespace_after_comma_in_array' => true,
         'yoda_style' => false,
-        'new_expression_parentheses' => true,
+        'new_expression_parentheses' => ['use_parentheses' => true],
     ])
     ->setCacheFile(__DIR__ . '/vendor/.cache.php-cs-fixer')
     ->setFinder($files);

bench/Parser/StringDecoding/PHPStanStringUnescaperBench.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Bench\Parser\StringDecoding;
+
+use PhpBench\Attributes\Groups;
+use PhpBench\Attributes\Iterations;
+use PhpBench\Attributes\ParamProviders;
+use PhpBench\Attributes\RetryThreshold;
+use PhpBench\Attributes\Revs;
+use PhpBench\Attributes\Warmup;
+use PHPStan\PhpDocParser\Parser\StringUnescaper;
+
+#[Groups(['phpstan']), Revs(1000), Warmup(50), Iterations(15), RetryThreshold(2)]
+final class PHPStanStringUnescaperBench extends StringDecodingBench
+{
+    #[ParamProviders('stringsDataProvider')]
+    public function benchDecodeString(array $params): void
+    {
+        StringUnescaper::unescapeString($params['string']);
+    }
+}

bench/Parser/StringDecoding/StringDecodingBench.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Bench\Parser\StringDecoding;
+
+abstract class StringDecodingBench
+{
+    /**
+     * @var non-empty-string
+     */
+    private const LOREM = 'lorem ipsum dolor sit amet ';
+
+    /**
+     * @var int<1, max>
+     */
+    private const REPEATS = 16;
+
+    /**
+     * @return iterable<non-empty-string, array{string: non-empty-string, double: bool}>
+     */
+    public static function stringsDataProvider(): iterable
+    {
+        yield 'plain' => ['string' => '"example"', 'double' => true];
+        yield 'plain long' => ['string' => '"' . \str_repeat(self::LOREM, 8) . '"', 'double' => true];
+        yield 'quote' => ['string' => '"a\"b"', 'double' => true];
+        yield 'few specials' => ['string' => '"line\nand\ttab"', 'double' => true];
+        yield 'many specials' => ['string' => '"' . \str_repeat('a\nb\tc\r', self::REPEATS) . '"', 'double' => true];
+        yield 'many backslashes' => ['string' => '"' . \str_repeat('a\\\\b', self::REPEATS) . '"', 'double' => true];
+        yield 'one hexadecimal' => ['string' => '"a\x41b"', 'double' => true];
+        yield 'numeric mix' => ['string' => '"\x41\101\u{1F600}\x42"', 'double' => true];
+        yield 'many numeric' => ['string' => '"' . \str_repeat('\x41\101\u{48}', self::REPEATS) . '"', 'double' => true];
+        yield 'single quoted plain' => ['string' => "'" . \str_repeat(self::LOREM, 8) . "'", 'double' => false];
+        yield 'single quoted escaped' => ['string' => "'" . \str_repeat('a\\\\b\\\'c', self::REPEATS) . "'", 'double' => false];
+    }
+
+    /**
+     * @param array{string: non-empty-string, double: bool} $params
+     */
+    abstract public function benchDecodeString(array $params): void;
+}

bench/Parser/StringDecoding/TypeLangStringDecoderBench.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Bench\Parser\StringDecoding;
+
+use PhpBench\Attributes\Groups;
+use PhpBench\Attributes\Iterations;
+use PhpBench\Attributes\ParamProviders;
+use PhpBench\Attributes\RetryThreshold;
+use PhpBench\Attributes\Revs;
+use PhpBench\Attributes\Warmup;
+use TypeLang\Parser\Internal\StringDecoder;
+
+#[Groups(['typelang', 'baseline']), Revs(1000), Warmup(50), Iterations(15), RetryThreshold(2)]
+final class TypeLangStringDecoderBench extends StringDecodingBench
+{
+    #[ParamProviders('stringsDataProvider')]
+    public function benchDecodeString(array $params): void
+    {
+        StringDecoder::unpackAndDecode($params['string'], $params['double']);
+    }
+}