Define type alias in phpstan configuration file

Author: nyamsprod

phpstan.neon

@@ -9,3 +9,5 @@ parameters:
         - src
     ignoreErrors:
     reportUnmatchedIgnoredErrors: true
+    typeAliases:
+        DataType: '\Bakame\Http\StructuredFields\ByteSequence|\Bakame\Http\StructuredFields\Token|bool|int|float|string'

src/Dictionary.php

@@ -13,7 +13,6 @@
 use function is_array;
 
 /**
- * @phpstan-type DataType ByteSequence|Token|bool|int|float|string
  * @implements MemberOrderedMap<string, Item|InnerList<int, Item>>
  */
 final class Dictionary implements MemberOrderedMap

src/InnerList.php

@@ -12,7 +12,6 @@
 use function count;
 
 /**
- * @phpstan-type DataType ByteSequence|Token|bool|int|float|string
  * @implements MemberList<int, Item>
  */
 final class InnerList implements MemberList, ParameterAccess

src/Item.php

@@ -20,9 +20,6 @@
 use function substr;
 use function trim;
 
-/**
- * @phpstan-type DataType ByteSequence|Token|bool|int|float|string
- */
 final class Item implements StructuredField, ParameterAccess
 {
     private function __construct(

src/OrderedList.php

@@ -14,8 +14,7 @@
 use function is_array;
 
 /**
- * @phpstan-type DataType ByteSequence|Token|bool|int|float|string
- * @implements MemberList<int, Item|MemberList<int, Item>>
+ * @implements MemberList<int, Item|InnerList<int, Item>>
  */
 final class OrderedList implements MemberList
 {
@@ -28,17 +27,17 @@ private function __construct(Item|InnerList ...$members)
     }
 
     /**
-     * @param MemberList<int, Item>|Item|DataType ...$members
+     * @param InnerList<int, Item>|Item|DataType ...$members
      *
      * @return static
      */
-    public static function from(MemberList|Item|ByteSequence|Token|bool|int|float|string ...$members): self
+    public static function from(InnerList|Item|ByteSequence|Token|bool|int|float|string ...$members): self
     {
         return self::fromList($members);
     }
 
     /**
-     * @param iterable<MemberList<int, Item>|Item|DataType> $members
+     * @param iterable<InnerList<int, Item>|Item|DataType> $members
      */
     public static function fromList(iterable $members = []): self
     {
@@ -107,7 +106,7 @@ public function hasMembers(): bool
     }
 
     /**
-     * @return Iterator<int, Item|MemberList<int, Item>>
+     * @return Iterator<int, Item|InnerList<int, Item>>
      */
     public function getIterator(): Iterator
     {
@@ -147,8 +146,10 @@ public function get(string|int $offset): Item|InnerList
 
     /**
      * Inserts members at the beginning of the list.
+     *
+     * @param InnerList<int, Item>|Item|DataType ...$members
      */
-    public function unshift(MemberList|StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
+    public function unshift(StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
     {
         $this->members = [...array_map(self::filterMember(...), array_values($members)), ...$this->members];
 
@@ -157,8 +158,10 @@ public function unshift(MemberList|StructuredField|ByteSequence|Token|bool|int|f
 
     /**
      * Inserts members at the end of the list.
+     *
+     * @param InnerList<int, Item>|Item|DataType ...$members
      */
-    public function push(MemberList|StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
+    public function push(StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
     {
         $this->members = [...$this->members, ...array_map(self::filterMember(...), array_values($members))];
 
@@ -168,9 +171,11 @@ public function push(MemberList|StructuredField|ByteSequence|Token|bool|int|floa
     /**
      * Inserts members starting at the given index.
      *
+     * @param InnerList<int, Item>|Item|DataType $members
+     *
      * @throws InvalidOffset If the index does not exist
      */
-    public function insert(int $index, MemberList|StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
+    public function insert(int $index, StructuredField|ByteSequence|Token|bool|int|float|string ...$members): self
     {
         $offset = $this->filterIndex($index);
         match (true) {
@@ -186,6 +191,8 @@ public function insert(int $index, MemberList|StructuredField|ByteSequence|Token
     /**
      * Replaces the member associated with the index.
      *
+     * @param InnerList<int, Item>|Item|DataType $member
+     *
      * @throws InvalidOffset If the index does not exist
      */
     public function replace(int $index, StructuredField|ByteSequence|Token|bool|int|float|string $member): self
@@ -248,7 +255,7 @@ public function offsetUnset($offset): void
 
     /**
      * @param int|null $offset
-     * @param MemberList<int, Item>|Item|DataType $value  the member to add
+     * @param InnerList<int, Item>|Item|DataType $value  the member to add
      *
      * @see ::push
      * @see ::replace

src/OrderedListTest.php

@@ -122,7 +122,7 @@ public function test_it_can_generate_the_same_value(): void
     public function it_implements_the_array_access_interface(): void
     {
         $sequence = OrderedList::from();
-        $sequence[] = InnerList::from(42, 69);
+        $sequence->push(InnerList::from(42, 69));
 
         self::assertTrue(isset($sequence[0]));
         self::assertInstanceOf(InnerList::class, $sequence[0]);

src/Parameters.php

@@ -16,7 +16,6 @@
 use function trim;
 
 /**
- * @phpstan-type DataType ByteSequence|Token|bool|int|float|string
  * @implements MemberOrderedMap<string, Item>
  */
 final class Parameters implements MemberOrderedMap