fix docs

Author: astral-data

.openapi.php

@@ -3,21 +3,47 @@
 use Astral\Serialize\OpenApi\Storage\OpenAPI\ServersStorage;
 
 return [
+    // API Document Title
     'title' => 'API Docs',
 
+    // Description of the API document
     'description' => 'API Docs description.',
 
     /**
-     * 向全局头部参数存储中添加一个的头部参数。
-     * @param string $name
-     * @param string $example
-     * @param string $description
+     * Global headers to be added to every request.
+     * Each header should include name, example, and description.
+     *
+     * Example:
+     * [
+     *     'name'        => 'Authorization',
+     *     'example'     => 'Bearer token',
+     *     'description' => 'Authentication token'
+     * ]
      */
-    'headers' => [
-
-    ],
+    'headers' => [],
 
+    /**
+     * Service base URLs (servers).
+     * You can define multiple environments like production, staging, etc.
+     *
+     * @type ServersStorage[] $service
+     */
     'service' => [
-        new ServersStorage('http://127.0.0.1','默认环境'),
+        new ServersStorage('http://127.0.0.1', 'Default Environment'),
     ],
+
+    /**
+     * Directories to exclude from scanning.
+     * These paths are relative to the project root directory.
+     *
+     * Default excluded directories:
+     * - /vendor
+     * - /tests
+     * - /migrations
+     * Example:
+     * ['/sdk', '/app']
+     *
+     * You can override or extend this list in your config file.
+     */
+    'exclude_dirs' => [],
 ];

src/Annotations/Input/InputDateFormat.php

@@ -28,7 +28,6 @@ public function match(mixed $value, DataCollection $collection, InputValueContex
         return is_string($value) || is_numeric($value);
     }
 
-
     public function resolve(mixed $value, DataCollection $collection, InputValueContext $context): string|DateTime
     {
 

src/Annotations/Output/OutputDateFormat.php

@@ -30,7 +30,6 @@ public function match(mixed $value, DataCollection $collection, OutContext $cont
         return is_string($value) || is_numeric($value) || is_subclass_of($value, DateTimeInterface::class);
     }
 
-
     public function resolve(mixed $value, DataCollection $collection, OutContext $context): string|DateTime|null
     {
         return $this->formatValue($value);

src/Casts/InputConstructCast.php renamed to src/Casts/InputValue/InputConstructCast.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Astral\Serialize\Casts;
+namespace Astral\Serialize\Casts\InputValue;
 
 use Astral\Serialize\Support\Collections\ConstructDataCollection;
 
@@ -18,7 +18,11 @@ public function resolve(array $constructorParameters, object $object, ?array $re
     {
         $args = [];
         foreach ($constructorParameters as $param) {
-            $args[] =  array_key_exists($param->name, $readonlyVols) ? $readonlyVols[$param->name] : $object->{$param->name};
+            $value = array_key_exists($param->name, $readonlyVols) ? $readonlyVols[$param->name] : $object->{$param->name};
+            if ($param->isNull === false && $value === null && $param->defaultValue !== null) {
+                $value = $param->defaultValue;
+            }
+            $args[] =  $value;
         }
 
         $object->__construct(...$args);

src/Enums/TypeKindEnum.php

@@ -2,7 +2,6 @@
 
 namespace Astral\Serialize\Enums;
 
-
 use RuntimeException;
 
 enum TypeKindEnum

src/Faker/FakerResolver.php

@@ -2,7 +2,7 @@
 
 namespace Astral\Serialize\Faker;
 
-use Astral\Serialize\Casts\InputConstructCast;
+use Astral\Serialize\Casts\InputValue\InputConstructCast;
 use Astral\Serialize\Faker\Rule\FakerDefaultRules;
 use Astral\Serialize\Resolvers\GroupResolver;
 use Astral\Serialize\Support\Collections\DataCollection;

src/OpenApi.php

@@ -34,7 +34,7 @@ public function buildByClass(string $className): void
         $tagDoc = isset($tagDoc[0]) ? $tagDoc[0]->newInstance() : null;
 
         if ($tagDoc) {
-            self::$OpenAPI->addTag(new TagStorage($tagDoc->value, $tagDoc->description));
+            self::$openAPI->addTag(new TagStorage($tagDoc->value, $tagDoc->description));
         }
 
         foreach ($classRefection->getMethods() as $item) {
@@ -79,7 +79,7 @@ public function buildByClass(string $className): void
                 response: $instances[Response::class],
             );
 
-            self::$OpenAPI->addPath($openApiCollection);
+            self::$openAPI->addPath($openApiCollection);
         }
     }
 }

src/OpenApi/Annotations/OpenApi.php

@@ -9,7 +9,6 @@
 #[Attribute(Attribute::TARGET_PROPERTY)]
 class OpenApi
 {
-
     public function __construct(
         public string $description = '',
         public string $example = '',

src/OpenApi/Annotations/RequestBody.php

@@ -15,6 +15,6 @@ public function __construct(
         public string $className = '',
         public ContentTypeEnum $contentType = ContentTypeEnum::JSON,
         public array|null $groups = null
-    ){
+    ) {
     }
 }

src/OpenApi/Annotations/Response.php

@@ -14,6 +14,6 @@ public function __construct(
         public string   $className,
         public ?int     $code       = 200,
         public ?array   $groups     = null,
-    ){
+    ) {
     }
 }