Fix PHP 8.4 compatibility

src/Builder/OpenApiBuilder.php

@@ -36,7 +36,7 @@
  */
 class OpenApiBuilder implements OpenApiBuilderInterface
 {
-    public function schema(SchemaConfigurator|ReferenceConfigurator|string $definition = null): SchemaConfigurator|ReferenceConfigurator
+    public function schema(SchemaConfigurator|ReferenceConfigurator|string|null $definition = null): SchemaConfigurator|ReferenceConfigurator
     {
         return SchemaConfigurator::createFromDefinition($definition);
     }

src/Builder/OpenApiBuilderInterface.php

@@ -36,7 +36,7 @@
  */
 interface OpenApiBuilderInterface
 {
-    public function schema(SchemaConfigurator|ReferenceConfigurator|string $definition = null): SchemaConfigurator|ReferenceConfigurator;
+    public function schema(SchemaConfigurator|ReferenceConfigurator|string|null $definition = null): SchemaConfigurator|ReferenceConfigurator;
 
     public function callbackRequest(): CallbackRequestConfigurator;
 

src/Configurator/ComponentsConfigurator.php

@@ -29,7 +29,7 @@ class ComponentsConfigurator
     private array $callbacks = [];
     private array $pathItems = [];
 
-    public function build(Components $toMergeWith = null): Components
+    public function build(?Components $toMergeWith = null): Components
     {
         if (!$toMergeWith) {
             $toMergeWith = new Components();

src/Configurator/InfoConfigurator.php

@@ -64,14 +64,14 @@ public function termsOfService(string $termsOfService): static
         return $this;
     }
 
-    public function contact(string $name = null, string $url = null, string $email = null, array $specificationExtensions = []): static
+    public function contact(?string $name = null, ?string $url = null, ?string $email = null, array $specificationExtensions = []): static
     {
         $this->contact = new Contact($name, $url, $email, $specificationExtensions);
 
         return $this;
     }
 
-    public function license(string $name, string $identifier = null, string $url = null, array $specificationExtensions = []): static
+    public function license(string $name, ?string $identifier = null, ?string $url = null, array $specificationExtensions = []): static
     {
         $this->license = new License($name, $identifier, $url, $specificationExtensions);
 

src/Configurator/PathItemConfigurator.php

@@ -41,7 +41,7 @@ public function __construct(OpenApiBuilderInterface $openApiBuilder)
         $this->openApiBuilder = $openApiBuilder;
     }
 
-    public function build(PathItem $toMergeWith = null): PathItem
+    public function build(?PathItem $toMergeWith = null): PathItem
     {
         return new PathItem(
             ref: $this->ref ?: $toMergeWith?->getRef(),

src/Configurator/SchemaConfigurator.php

@@ -87,7 +87,7 @@ class SchemaConfigurator
      */
     private ?array $anyOf = null;
 
-    public static function createFromDefinition(self|ReferenceConfigurator|string|array $definition = null): self|ReferenceConfigurator
+    public static function createFromDefinition(self|ReferenceConfigurator|string|array|null $definition = null): self|ReferenceConfigurator
     {
         // Empty schema
         if (!$definition) {
@@ -418,19 +418,19 @@ public function example(mixed $example): static
         return $this;
     }
 
-    public function discriminator(string $propertyName, array $mapping = null, array $specificationExtensions = []): static
+    public function discriminator(string $propertyName, ?array $mapping = null, array $specificationExtensions = []): static
     {
         $this->discriminator = new Discriminator($propertyName, $mapping, $specificationExtensions);
 
         return $this;
     }
 
     public function xml(
-        string $name = null,
-        string $namespace = null,
-        string $prefix = null,
-        bool $attribute = null,
-        bool $wrapped = null,
+        ?string $name = null,
+        ?string $namespace = null,
+        ?string $prefix = null,
+        ?bool $attribute = null,
+        ?bool $wrapped = null,
         array $specificationExtensions = [],
     ): static {
         $this->xml = new Xml($name, $namespace, $prefix, $attribute, $wrapped, $specificationExtensions);

src/Configurator/Traits/ExamplesTrait.php

@@ -27,7 +27,7 @@ trait ExamplesTrait
      */
     private ?array $examples = null;
 
-    public function example(mixed $name, ExampleConfigurator|ReferenceConfigurator $example = null): static
+    public function example(mixed $name, ExampleConfigurator|ReferenceConfigurator|null $example = null): static
     {
         if ($example) {
             $this->examples[$name] = $example->build();

src/Configurator/Traits/ExternalDocsTrait.php

@@ -19,7 +19,7 @@ trait ExternalDocsTrait
 {
     private ?ExternalDocumentation $externalDocs = null;
 
-    public function externalDocs(string $url, string $description = null, array $specificationExtensions = []): static
+    public function externalDocs(string $url, ?string $description = null, array $specificationExtensions = []): static
     {
         $this->externalDocs = new ExternalDocumentation($url, $description, $specificationExtensions);
 

src/Configurator/Traits/ServerVariablesTrait.php

@@ -22,7 +22,7 @@ trait ServerVariablesTrait
      */
     private array $variables = [];
 
-    public function variable(string $name, string $default, string $description = null, array $enum = null, array $specificationExtensions = []): static
+    public function variable(string $name, string $default, ?string $description = null, ?array $enum = null, array $specificationExtensions = []): static
     {
         $this->variables[$name] = new ServerVariable($default, $description, $enum, $specificationExtensions);