Improve documentation layout

Author: nyamsprod

.github/workflows/build.yml

@@ -12,6 +12,10 @@ jobs:
             matrix:
                 php: ['8.1', '8.2', '8.3', '8.4']
                 stability: [prefer-lowest, prefer-stable]
+                include:
+                    -   php: '8.5'
+                        flags: "--ignore-platform-req=php"
+                        stability: prefer-stable
         steps:
             - name: Checkout code
               uses: actions/checkout@v4
@@ -45,11 +49,16 @@ jobs:
 
             - name: Run Unit tests with coverage
               run: composer phpunit -- ${{ matrix.phpunit-flags }}
+              if: ${{ matrix.php != '8.5' }}
+
+            - name: Run Unit tests without coverage
+              run: vendor/bin/phpunit --no-coverage
+              if: ${{ matrix.php == '8.5' }}
 
             - name: Run static analysis
-              run: composer phpstan
-              if: ${{ matrix.php == '8.3' && matrix.stability == 'prefer-stable'}}
+              run: composer phpstan-build
+              if: ${{ matrix.php == '8.4' && matrix.stability == 'prefer-stable'}}
 
             - name: Run Coding style rules
               run: composer phpcs:fix
-              if: ${{ matrix.php == '8.3' && matrix.stability == 'prefer-stable'}}
+              if: ${{ matrix.php == '8.4' && matrix.stability == 'prefer-stable'}}

composer.json

@@ -42,16 +42,16 @@
         "php" : "^8.1"
     },
     "require-dev": {
-        "friendsofphp/php-cs-fixer": "^3.65.0",
+        "friendsofphp/php-cs-fixer": "^3.89.2",
         "httpwg/structured-field-tests": "*@dev",
-        "phpstan/phpstan": "^2.0.3",
-        "phpstan/phpstan-strict-rules": "^2.0",
-        "phpstan/phpstan-phpunit": "^2.0.1",
-        "phpstan/phpstan-deprecation-rules": "^2.0.1",
-        "phpunit/phpunit": "^10.5.38 || ^11.5.0",
-        "symfony/var-dumper": "^6.4.15 || ^v7.2.0",
+        "phpstan/phpstan": "^2.1.32",
+        "phpstan/phpstan-strict-rules": "^2.0.7",
+        "phpstan/phpstan-phpunit": "^2.0.8",
+        "phpstan/phpstan-deprecation-rules": "^2.0.3",
+        "phpunit/phpunit": "^10.5.38 || ^11.5.43",
+        "symfony/var-dumper": "^6.4.15 || ^7.3.5",
         "bakame/aide-base32": "dev-main",
-        "phpbench/phpbench": "^1.3.1"
+        "phpbench/phpbench": "^1.4.3"
     },
     "autoload": {
         "psr-4": {

src/Dictionary.php

@@ -105,7 +105,7 @@ public static function fromPairs(StructuredFieldProvider|Dictionary|Parameters|i
         return match (true) {
             $pairs instanceof Dictionary,
             $pairs instanceof Parameters => new self($pairs->toAssociative()),
-            default => new self((function (iterable $pairs) {
+            default => new self((function (iterable $pairs) { /* @phpstan-ignore-line */
                 foreach ($pairs as [$key, $member]) {
                     yield $key => Member::innerListOrItemFromPair($member);
                 }
@@ -671,12 +671,13 @@ public function mergeAssociative(StructuredFieldProvider|iterable ...$others): s
                 $other = $other->toAssociative();
             }
 
+            /** @var string $key */
             foreach ($other as $key => $value) {
                 $members[$key] = $value;
             }
         }
 
-        return new self($members);
+        return new self($members); /* @phpstan-ignore-line */
     }
 
     /**

src/Parameters.php

@@ -106,7 +106,7 @@ public static function fromPairs(StructuredFieldProvider|iterable $pairs): self
         return match (true) {
             $pairs instanceof Parameters,
             $pairs instanceof Dictionary => new self($pairs->toAssociative()),
-            default => new self((function (iterable $pairs) {
+            default => new self((function (iterable $pairs) { /* @phpstan-ignore-line */
                 foreach ($pairs as [$key, $member]) {
                     yield $key => $member;
                 }