Improving phpstan

Author: spekulatius

src/Client.php

@@ -68,13 +68,17 @@ public function search(
                 ]
             );
 
+            /** @var array<string, mixed> $result */
             $result = json_decode($response->getBody()->getContents(), true);
 
             if (! isset($result['data']['defaultDatasetId'])) {
                 throw new ApiException('Invalid API response: missing dataset ID');
             }
 
-            return $this->fetchDataset($result['data']['defaultDatasetId']);
+            /** @var string $datasetId */
+            $datasetId = $result['data']['defaultDatasetId'];
+
+            return $this->fetchDataset($datasetId);
         } catch (GuzzleException $e) {
             $this->handleGuzzleException($e);
         }
@@ -89,10 +93,11 @@ private function fetchDataset(string $datasetId): array
     {
         try {
             $response = $this->http->get("/datasets/{$datasetId}/items");
+            /** @var array<int, array<string, mixed>> $items */
             $items = json_decode($response->getBody()->getContents(), true);
 
             return array_map(
-                static fn (array $item) => Supplier::fromArray($item),
+                static fn (array $item): Supplier => Supplier::fromArray($item),
                 $items
             );
         } catch (GuzzleException $e) {

src/DTO/Address.php

@@ -18,6 +18,9 @@ public function __construct(
         public ?float $longitude,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/Brand.php

@@ -10,6 +10,9 @@ public function __construct(
         public string $name,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/Certification.php

@@ -21,6 +21,9 @@ public function __construct(
         public bool $isActive,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/CertificationTotal.php

@@ -11,6 +11,9 @@ public function __construct(
         public int $count,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/Heading.php

@@ -14,6 +14,9 @@ public function __construct(
         public ?string $url,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/NewsArticle.php

@@ -15,6 +15,9 @@ public function __construct(
         public ?string $type,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/Person.php

@@ -11,6 +11,9 @@ public function __construct(
         public ?string $title,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/Product.php

@@ -12,6 +12,9 @@ public function __construct(
         public ?string $imageUrl,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(

src/DTO/SocialLink.php

@@ -11,6 +11,9 @@ public function __construct(
         public string $url,
     ) {}
 
+    /**
+     * @param  array<string, mixed>  $data
+     */
     public static function fromArray(array $data): self
     {
         return new self(