🎨

Author: tymondesigns

src/Concerns/BuildsArray.php

@@ -15,6 +15,7 @@ trait BuildsArray
      * any vendor extensions registered via HasExtensions.
      *
      * @param array<string, mixed> $fields
+     *
      * @return array<string, mixed>
      */
     protected function buildArray(array $fields): array

src/Objects/Example.php

@@ -83,7 +83,9 @@ public function toArray(): array
 
         if ($this->hasValue) {
             // Inserted after buildArray so null literal values can be emitted.
-            $output = ['value' => $this->value] + $output;
+            $output = [
+                'value' => $this->value,
+            ] + $output;
             // Restore conventional key order: summary, description, value, externalValue.
             $ordered = [];
 

src/Objects/MediaType.php

@@ -14,11 +14,6 @@ final class MediaType implements Serializable
     use BuildsArray;
     use HasExtensions;
 
-    /**
-     * @var JsonSchema|array<string, mixed>|Reference|null
-     */
-    private JsonSchema|array|Reference|null $schema = null;
-
     private bool $hasExample = false;
 
     private mixed $example = null;
@@ -38,10 +33,8 @@ final class MediaType implements Serializable
      */
     private function __construct(
         private readonly string $contentType,
-        JsonSchema|array|Reference|null $schema = null,
-    ) {
-        $this->schema = $schema;
-    }
+        private JsonSchema|array|Reference|null $schema = null,
+    ) {}
 
     public static function of(string $contentType): self
     {

src/Objects/OAuthFlows.php

@@ -26,30 +26,30 @@ public static function create(): self
         return new self();
     }
 
-    public function implicit(?OAuthFlow $flow): self
+    public function implicit(?OAuthFlow $oAuthFlow): self
     {
-        $this->implicit = $flow;
+        $this->implicit = $oAuthFlow;
 
         return $this;
     }
 
-    public function password(?OAuthFlow $flow): self
+    public function password(?OAuthFlow $oAuthFlow): self
     {
-        $this->password = $flow;
+        $this->password = $oAuthFlow;
 
         return $this;
     }
 
-    public function clientCredentials(?OAuthFlow $flow): self
+    public function clientCredentials(?OAuthFlow $oAuthFlow): self
     {
-        $this->clientCredentials = $flow;
+        $this->clientCredentials = $oAuthFlow;
 
         return $this;
     }
 
-    public function authorizationCode(?OAuthFlow $flow): self
+    public function authorizationCode(?OAuthFlow $oAuthFlow): self
     {
-        $this->authorizationCode = $flow;
+        $this->authorizationCode = $oAuthFlow;
 
         return $this;
     }

src/Objects/Operation.php

@@ -57,7 +57,7 @@ final class Operation implements Serializable
     private array $servers = [];
 
     private function __construct(
-        private readonly HttpMethod $method,
+        private readonly HttpMethod $httpMethod,
     ) {}
 
     public static function get(): self
@@ -102,7 +102,7 @@ public static function trace(): self
 
     public function getMethod(): HttpMethod
     {
-        return $this->method;
+        return $this->httpMethod;
     }
 
     public function tags(string ...$tags): self

src/Objects/Parameter.php

@@ -29,11 +29,6 @@ final class Parameter implements Serializable
 
     private ?bool $allowReserved = null;
 
-    /**
-     * @var JsonSchema|array<string, mixed>|Reference|null
-     */
-    private JsonSchema|array|Reference|null $schema = null;
-
     private bool $hasExample = false;
 
     private mixed $example = null;
@@ -54,10 +49,8 @@ final class Parameter implements Serializable
     private function __construct(
         private readonly string $name,
         private readonly In $in,
-        JsonSchema|array|Reference|null $schema = null,
+        private JsonSchema|array|Reference|null $schema = null,
     ) {
-        $this->schema = $schema;
-
         if ($in === In::Path) {
             $this->required = true;
         }

src/Objects/PathItem.php

@@ -111,14 +111,14 @@ public function toArray(): array
 
         if ($this->parameters !== []) {
             $output['parameters'] = array_map(
-                fn (Parameter|Reference $parameter): array => $parameter->toArray(),
+                fn(Parameter|Reference $parameter): array => $parameter->toArray(),
                 $this->parameters,
             );
         }
 
         if ($this->servers !== []) {
             $output['servers'] = array_map(
-                fn (Server $server): array => $server->toArray(),
+                fn(Server $server): array => $server->toArray(),
                 $this->servers,
             );
         }

src/Objects/Reference.php

@@ -7,12 +7,12 @@
 use InvalidArgumentException;
 use Cortex\OpenApi\Contracts\Serializable;
 
-final class Reference implements Serializable
+final readonly class Reference implements Serializable
 {
     private function __construct(
-        private readonly string $pointer,
-        private readonly ?string $summary,
-        private readonly ?string $description,
+        private string $pointer,
+        private ?string $summary,
+        private ?string $description,
     ) {}
 
     public static function to(string $pointer, ?string $summary = null, ?string $description = null): self
@@ -29,7 +29,9 @@ public static function to(string $pointer, ?string $summary = null, ?string $des
      */
     public function toArray(): array
     {
-        $output = ['$ref' => $this->pointer];
+        $output = [
+            '$ref' => $this->pointer,
+        ];
 
         if ($this->summary !== null) {
             $output['summary'] = $this->summary;

src/Objects/Response.php

@@ -16,7 +16,7 @@ final class Response implements Serializable
     /**
      * Default description used by the named constructors when the user does not override it.
      */
-    private const DEFAULT_DESCRIPTIONS = [
+    private const array DEFAULT_DESCRIPTIONS = [
         '200' => 'OK',
         '201' => 'Created',
         '202' => 'Accepted',

src/Objects/SecurityRequirement.php

@@ -6,14 +6,14 @@
 
 use Cortex\OpenApi\Contracts\Serializable;
 
-final class SecurityRequirement implements Serializable
+final readonly class SecurityRequirement implements Serializable
 {
     /**
      * @param array<int, string> $scopes
      */
     private function __construct(
-        private readonly ?string $scheme,
-        private readonly array $scopes,
+        private ?string $scheme,
+        private array $scopes,
     ) {}
 
     /**
@@ -41,6 +41,8 @@ public function toArray(): array
             return [];
         }
 
-        return [$this->scheme => $this->scopes];
+        return [
+            $this->scheme => $this->scopes,
+        ];
     }
 }