Merge pull request #14 from Kambarov/feat/additional-changes

additional changes for the documentation

Author: jkbennemann

src/Attributes/Parameter.php

@@ -17,5 +17,6 @@ public function __construct(
         public string $description = '',
         public bool $deprecated = false,
         public mixed $example = null,
+        public mixed $parameters = null,
     ) {}
 }

src/Services/EnhancedResponseAnalyzer.php

@@ -6,9 +6,6 @@
 
 use Illuminate\Contracts\Config\Repository;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Resources\Json\JsonResource;
-use Illuminate\Http\Response;
 use Illuminate\Validation\ValidationException;
 use JkBennemann\LaravelApiDocumentation\Attributes\DataResponse;
 use JkBennemann\LaravelApiDocumentation\Attributes\Parameter;
@@ -1092,9 +1089,21 @@ private function applyParameterAttributesToSchema(?array $schema, string $contro
                     if ($enhancement->deprecated) {
                         $property['deprecated'] = true;
                     }
+
+                    unset($parameterEnhancements[$propertyName]);
                 }
             }
 
+            foreach ($parameterEnhancements as $parameterEnhancement) {
+                $schema['properties'][$parameterEnhancement->name] = [
+                    'type' => $parameterEnhancement->type ? $this->mapParameterTypeToOpenApi($parameterEnhancement->type) : 'string',
+                    'format' => $parameterEnhancement->format,
+                    'description' => $parameterEnhancement->description,
+                    'example' => $parameterEnhancement->example,
+                    'deprecated' => $parameterEnhancement->deprecated,
+                ];
+            }
+
             return $schema;
 
         } catch (\Throwable $e) {

src/Services/RequestAnalyzer.php

@@ -324,6 +324,10 @@ private function extractParameterAttributes(ReflectionClass $reflection): array
             if ($parameter->example !== null) {
                 $parameters[$parameter->name]['example'] = $parameter->example;
             }
+
+            if ($parameter->parameters !== null) {
+                $parameters[$parameter->name]['parameters'] = $parameter->parameters;
+            }
         }
 
         // Then check for attributes on the rules() method if it exists

src/Services/ResponseAnalyzer.php

@@ -738,7 +738,7 @@ private function getPaginatedResponse(string $collectionClass): array
      * Rule: Keep the code modular and easy to understand
      * Rule: Write concise, technical PHP code with accurate examples
      */
-    private function analyzeJsonResourceResponse(string $resourceClass): array
+    public function analyzeJsonResourceResponse(string $resourceClass): array
     {
         try {
             // Rule: Project Context - Laravel API Documentation is a PHP package that provides the ability to automatically generate API documentation