Improve Loading test files

Author: nyamsprod

src/TestRecord.php

@@ -4,6 +4,16 @@
 
 namespace Bakame\Http\StructuredFields;
 
+/**
+ * @phpstan-type RecordData array{
+ *     name:string,
+ *     header_type:string,
+ *     raw:array<string>,
+ *     canonical?: array<string>,
+ *     must_fail?: bool,
+ *     can_fail?: bool
+ * }
+ */
 final class TestRecord
 {
     private function __construct(
@@ -19,14 +29,7 @@ private function __construct(
     }
 
     /**
-     * @param array{
-     *     name:string,
-     *     header_type:string,
-     *     raw:array<string>,
-     *     canonical?: array<string>,
-     *     must_fail?: bool,
-     *     can_fail?: bool
-     * } $data
+     * @param RecordData $data
      */
     public static function fromDecoded(array $data): self
     {

src/TestRecordCollection.php

@@ -17,6 +17,7 @@
 
 /**
  * @implements IteratorAggregate<string, TestRecord>
+ * @phpstan-import-type RecordData from TestRecord
  */
 final class TestRecordCollection implements IteratorAggregate
 {
@@ -39,7 +40,7 @@ public function add(TestRecord $test): void
     /**
      * @param resource|null $context
      *
-     * @throws JsonException
+     * @throws JsonException|RuntimeException
      */
     public static function fromPath(string $path, $context = null): self
     {
@@ -58,14 +59,7 @@ public static function fromPath(string $path, $context = null): self
         $content = stream_get_contents($resource);
         fclose($resource);
 
-        /** @var array<array{
-         *     name: string,
-         *     header_type: string,
-         *     raw: array<string>,
-         *     canonical?: array<string>,
-         *     must_fail?: bool,
-         *     can_fail?: bool
-         * }> $records */
+        /** @var array<RecordData> $records */
         $records = json_decode($content, true, 512, JSON_THROW_ON_ERROR);
         $suite = new self();
         foreach ($records as $offset => $record) {