Add option to generate objects as schemas instead of x-objects

config/swagger-generator.php

@@ -77,6 +77,12 @@
     'ignoredAnnotationNames' => ['mixin'],
     /*
     |---------------------------------------------------------
+    | Generate objects inside 'components.schemas' instead of 'components.x-objects'
+    |---------------------------------------------------------
+    */
+    'generateObjectsAsSchemas' => false,
+    /*
+    |---------------------------------------------------------
     | List of classes to additionally generate definitions
     |---------------------------------------------------------
     |

src/Describer/CollectsClassReferences.php

@@ -122,7 +122,8 @@ private static function getCollectedClassReferenceName(string $className, array
             return static::$collectedClassReferencesKeys[$classNameWithAttributes];
         }
         $classNameSafe = str_replace(['\\', '.'], '_', $classNameWithAttributes);
-        $keys = ['components', RoutesParser::COMPONENT_OBJECTS, $classNameSafe];
+        $componentsKey = config('swagger-generator.generateObjectsAsSchemas', false) ? RoutesParser::COMPONENT_SCHEMAS : RoutesParser::COMPONENT_OBJECTS;
+        $keys = ['components', $componentsKey, $classNameSafe];
 
         return static::$collectedClassReferencesKeys[$classNameWithAttributes] = '#/' . implode('/', $keys);
     }

src/RoutesParser.php

@@ -34,6 +34,7 @@ class RoutesParser
     const COMPONENT_REQUESTS = 'requestBodies';
     const COMPONENT_PARAMETER = 'parameters';
     const COMPONENT_OBJECTS = 'x-objects';
+    const COMPONENT_SCHEMAS = 'schemas';
 
     const PROBLEM_NO_RESPONSE = 'no_response';
     const PROBLEM_ROUTE_CLOSURE = 'route_closure';