Update to enable and fix tests.

src/Asset/Attribute/Request/CsvExportAssetRequestBody.php

@@ -45,7 +45,7 @@ public function __construct()
                         new Property(property: StepConfig::SETTINGS_DELIMITER->value, type: 'string', example: ';'),
                         new Property(
                             property: StepConfig::SETTINGS_HEADER->value,
-                            type: 'enum',
+                            type: 'string',
                             enum: StepConfig::values(),
                             example: StepConfig::SETTINGS_HEADER_TITLE->value
                         ),

src/Asset/Attribute/Request/CsvExportFolderRequestBody.php

@@ -51,7 +51,7 @@ public function __construct()
                         new Property(property: StepConfig::SETTINGS_DELIMITER->value, type: 'string', example: ';'),
                         new Property(
                             property: StepConfig::SETTINGS_HEADER->value,
-                            type: 'enum',
+                            type: 'string',
                             enum: StepConfig::values(),
                             example: StepConfig::SETTINGS_HEADER_TITLE->value
                         ),

src/Asset/Controller/Image/CustomDownloadController.php

@@ -82,9 +82,9 @@ public function __construct(
     #[MimeTypeParameter]
     #[ResizeModeParameter]
     #[ImageConfigParameter('width', 140)]
-    #[ImageConfigParameter('height')]
-    #[ImageConfigParameter('quality')]
-    #[ImageConfigParameter('dpi')]
+    #[ImageConfigParameter('height', 140)]
+    #[ImageConfigParameter('quality', 80)]
+    #[ImageConfigParameter('dpi', 300)]
     #[SuccessResponse(
         description: 'asset_image_download_custom_success_response',
         content: [new MediaType('image/jpeg'), new MediaType('image/png')],

src/Asset/Controller/TreeController.php

@@ -76,7 +76,7 @@ public function __construct(
     #[PageSizeParameter]
     #[ParentIdParameter(
         description: 'Filter assets by parent id.',
-        example: null,
+        example: 83,
     )]
     #[IdSearchTermParameter]
     #[ExcludeFoldersParameter]

src/Asset/Controller/Video/ImageThumbnailStreamController.php

@@ -85,10 +85,10 @@ public function __construct(
     )]
     #[IdParameter(type: 'video')]
     #[WidthParameter('Width of the video image thumbnail', 265)]
-    #[HeightParameter('Height of the video image thumbnail')]
-    #[AspectRatioParameter]
-    #[FrameParameter]
-    #[AsyncGenerationParameter]
+    #[HeightParameter('Height of the video image thumbnail', 265)]
+    #[AspectRatioParameter('Aspect ratio of the video image thumbnail', false)]
+    #[FrameParameter('Frame of the video image thumbnail', true)]
+    #[AsyncGenerationParameter(false)]
     #[SuccessResponse(
         description: 'asset_video_image_thumbnail_stream_success_response',
         content: [new MediaType('image/*')],

src/Asset/OpenApi/Attribute/Parameter/Query/ImageConfigParameter.php

@@ -23,13 +23,13 @@
 #[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
 final class ImageConfigParameter extends QueryParameter
 {
-    public function __construct(string $name, mixed $defaultValue = null)
+    public function __construct(string $name, mixed $example = null)
     {
         parent::__construct(
             name: $name,
             description: ucfirst($name) . ' of downloaded image',
             in: 'query',
-            schema: new Schema(type: 'integer', example: $defaultValue),
+            schema: new Schema(type: 'integer', example: $example),
         );
     }
 }

src/Asset/Schema/Asset.php

@@ -29,7 +29,6 @@
 #[Schema(
     title: 'Asset',
     required: [
-        'iconName',
         'hasChildren',
         'type',
         'filename',
@@ -50,7 +49,7 @@ class Asset extends Element implements AdditionalAttributesInterface
     use WorkflowAvailableTrait;
 
     public function __construct(
-        #[Property(description: 'Has children', type: 'bool', example: false)]
+        #[Property(description: 'Has children', required: ['hasChildren'], type: 'bool', example: false)]
         private readonly bool $hasChildren,
         #[Property(description: 'Type', type: 'string', example: 'image')]
         private readonly string $type,

src/Asset/Schema/CustomSetting/FixedCustomSettings.php

@@ -34,7 +34,7 @@ public function __construct(
         #[Property(
             description: 'embedded meta data of the asset - array of any key-value pairs',
             type: 'array',
-            items: new Items(),
+            items: new Items(type: 'object'),
             example: '{ FileSize: "265 KiB", MIMEType: "image/jpeg" }'
         )]
         private array $embeddedMetadata = [],

src/Asset/Schema/CustomSettings.php

@@ -41,8 +41,8 @@ public function __construct(
         #[Property(
             description: 'dynamic custom settings - can be any key-value pair',
             type: 'array',
-            items: new Items(),
-            example: '{ imageWidth: 1280, imageHeight: 720 }')
+            items: new Items(type: 'object'),
+            example: '[{ imageWidth: 1280 }, { imageHeight: 720 }]')
         ]
         private readonly array $dynamicCustomSettings = [],
     ) {

src/Asset/Schema/Type/Document.php

@@ -23,7 +23,7 @@
 use Pimcore\Bundle\StudioBackendBundle\Response\ElementIcon;
 
 #[Schema(
-    schema: 'Asset Document',
+    schema: 'AssetDocument',
     title: 'Asset Document',
     required: [
         'pageCount',

src/DataObject/Attribute/Parameter/Query/ClassNameParameter.php

@@ -37,7 +37,7 @@ public function __construct()
             schema: new Schema(
                 type: 'string',
                 enum:  array_map(static fn (ClassDefinition $def) => $def->getName(), $classDefinitions->load()),
-                example: null
+                example: 'string'
             ),
         );
     }

src/DataObject/Controller/Grid/GetAvailableColumnsController.php

@@ -59,7 +59,7 @@ public function __construct(
     )]
     #[IsGranted(UserPermissions::DATA_OBJECTS->value)]
     #[Get(
-        path: self::PREFIX . '/data-object/grid/available-columns/{classId}/folderId',
+        path: self::PREFIX . '/data-object/grid/available-columns/{classId}/{folderId}',
         operationId: 'data_object_get_available_grid_columns',
         description: 'data_object_get_available_grid_columns_description',
         summary: 'data_object_get_available_grid_columns_summary',

src/DataObject/Controller/TreeController.php

@@ -78,7 +78,7 @@ public function __construct(
     #[PageSizeParameter]
     #[ParentIdParameter(
         description: 'Filter data objects by parent id.',
-        example: null
+        example: 12
     )]
     #[IdSearchTermParameter]
     #[ExcludeFoldersParameter]

src/DataObject/Schema/DataObjectAddParameters.php

@@ -34,7 +34,7 @@ public function __construct(
         private string $classId,
         #[Property(
             description: 'Type',
-            type: 'enum',
+            type: 'string',
             enum: [AbstractObject::OBJECT_TYPE_OBJECT, AbstractObject::OBJECT_TYPE_VARIANT],
             example: AbstractObject::OBJECT_TYPE_OBJECT
         )]

src/DataObject/Schema/Layout.php

@@ -78,7 +78,7 @@ public function __construct(
         private readonly ?string $bodyStyle = null,
         #[Property(description: 'Locked', type: 'bool', example: false)]
         private readonly bool $locked = false,
-        #[Property(description: 'Children', type: 'array', items: new Items(), example: '[]')]
+        #[Property(description: 'Children', type: 'array', items: new Items(type: 'object'), example: '[{id: 1}]')]
         private readonly array $children = [],
         #[Property(description: 'Icon', type: ElementIcon::class)]
         private readonly ?ElementIcon $icon = null,

src/Document/Schema/Document.php

@@ -28,8 +28,7 @@
 #[Schema(
     schema: 'Document',
     title: 'Document',
-    required: [
-    ],
+    required: ['id'],
     type: 'object'
 )]
 final class Document extends Element implements AdditionalAttributesInterface

src/Email/Controller/Blocklist/CollectionController.php

@@ -71,7 +71,8 @@ public function __construct(
     #[TextFieldParameter(
         name: 'email',
         description: 'Email address to be filtered by',
-        required: false
+        required: false,
+        example: '[email protected]'
     )]
     #[SuccessResponse(
         description: 'email_blocklist_get_collection_success_response',

src/Email/Controller/Blocklist/DeleteController.php

@@ -63,7 +63,8 @@ public function __construct(
     #[TextFieldParameter(
         name: 'email',
         description: ' Email address to be deleted from blocklist',
-        required: false
+        required: false,
+        example: '[email protected]'
     )]
     #[SuccessResponse(
         description: 'email_blocklist_delete_success_response',

src/Email/Schema/EmailDocumentParameters.php

@@ -29,7 +29,12 @@
     public function __construct(
         #[Property(description: 'parameter key', type: 'string', example: 'some_parameter_key')]
         private string $key,
-        #[Property(description: 'parameter value', type: 'value', example: 'some_parameter_value')]
+        #[Property(description: 'parameter value', example: 'some_parameter_value', anyOf: [
+            new Schema(type: 'string'),
+            new Schema(type: 'number'),
+            new Schema(type: 'boolean'),
+            new Schema(type: 'object'),
+        ])]
         private mixed $value,
     ) {
     }

src/Email/Schema/SendEmailParameters.php

@@ -39,7 +39,7 @@ public function __construct(
         private string $subject,
         #[Property(
             description: 'email content type',
-            type: 'enum',
+            type: 'string',
             enum: [
                 EmailContentType::DOCUMENT->value,
                 EmailContentType::HTML->value,

src/ExecutionEngine/Controller/AbortController.php

@@ -51,7 +51,7 @@ public function __construct(
     #[Route('/execution-engine/abort/{jobRunId}', name: 'pimcore_studio_api_execution_engine_abort', methods: ['POST'])]
     #[IsGranted(UserPermissions::ASSETS->value)]
     #[Post(
-        path: self::PREFIX . '/execution-engine/abort/{JobRunId}',
+        path: self::PREFIX . '/execution-engine/abort/{jobRunId}',
         operationId: 'execution_engine_abort_job_run_by_id',
         description: 'execution_engine_abort_job_run_by_id_description',
         summary: 'execution_engine_abort_job_run_by_id_summary',

src/Mercure/Schema/ExecutionEngine/Finished.php

@@ -16,6 +16,7 @@
 
 namespace Pimcore\Bundle\StudioBackendBundle\Mercure\Schema\ExecutionEngine;
 
+use OpenApi\Attributes\Items;
 use OpenApi\Attributes\Property;
 use OpenApi\Attributes\Schema;
 use Pimcore\Bundle\GenericExecutionEngineBundle\Model\JobRunStates;
@@ -46,7 +47,12 @@ public function __construct(
         private int $ownerId,
         #[Property(description: 'status', type: 'string', example: JobRunStates::FINISHED->value)]
         private string $status,
-        #[Property(description: 'messages', type: 'list', example: ['Something went wrong'])]
+        #[Property(
+            description: 'messages',
+            type: 'array',
+            items: new Items(type: 'string'),
+            example: ['Something went wrong']
+        )]
         private array $messages = [],
         #[Property(description: 'notifyAll', type: 'boolean', example: false)]
         private bool $notifyAll = false,

src/Note/Attribute/Parameter/Query/NoteSortByParameter.php

@@ -43,7 +43,7 @@ enum: [
                     'description',
                     'locked',
                 ],
-                example: null,
+                example: 'id',
             ),
         );
     }

src/Note/Schema/Note.php

@@ -53,7 +53,14 @@ public function __construct(
         #[Property(
             description: 'Data of note',
             type: 'array',
-            items: new Items(),
+            items: new Items(
+                anyOf: [
+                    new Schema(type: 'string'),
+                    new Schema(type: 'number'),
+                    new Schema(type: 'boolean'),
+                    new Schema(type: 'object'),
+                ]
+            ),
             example: 'Can be pretty much anything',
         )]
         private readonly array $data,

src/Notification/Schema/SendNotificationParameters.php

@@ -38,7 +38,7 @@ public function __construct(
         private string $message,
         #[Property(
             description: 'type of the attachment',
-            type: 'enum',
+            type: 'string',
             enum: [
                 ElementTypes::TYPE_ASSET,
                 ElementTypes::TYPE_DOCUMENT,

src/OpenApi/Attribute/Parameter/Query/ExcludeFoldersParameter.php

@@ -30,7 +30,7 @@ public function __construct()
             description: 'Filter folders from result.',
             in: 'query',
             required: false,
-            schema: new Schema(type: 'boolean', example: null),
+            schema: new Schema(type: 'boolean', example: false),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/FieldFilterParameter.php

@@ -18,6 +18,7 @@
 
 use Attribute;
 use OpenApi\Attributes\QueryParameter as OpenApiQueryParameter;
+use OpenApi\Attributes\Schema;
 
 #[Attribute(Attribute::TARGET_METHOD)]
 final class FieldFilterParameter extends OpenApiQueryParameter
@@ -30,7 +31,7 @@ public function __construct()
             [{"operator":"like","value":"John","field":"name","type":"string"}]',
             in: 'query',
             required: false,
-            example: ''
+            schema: new Schema(type: 'string', example: '[{"operator":"like","value":"John","field":"name"}]'),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/FilterParameter.php

@@ -30,7 +30,7 @@ public function __construct(string $filterFor = 'properties')
             description: 'Filter for ' . $filterFor,
             in: 'query',
             required: false,
-            schema: new Schema(type: 'string', example: null),
+            schema: new Schema(type: 'string', example: $filterFor),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/IdParameter.php

@@ -33,7 +33,7 @@ public function __construct(
             description: $description,
             in: 'query',
             required: $required,
-            schema: new Schema(type: 'integer', example: null),
+            schema: new Schema(type: 'integer', example: 83),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/IdSearchTermParameter.php

@@ -30,7 +30,7 @@ public function __construct()
             description: 'Filter assets/data-objects by matching ids. As a wildcard * can be used',
             in: 'query',
             required: false,
-            schema: new Schema(type: 'string', example: null),
+            schema: new Schema(type: 'string', example: 83),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/PathIncludeDescendantsParameter.php

@@ -30,7 +30,7 @@ public function __construct()
             description: 'Include all descendants in the result.',
             in: 'query',
             required: false,
-            schema: new Schema(type: 'boolean', example: null),
+            schema: new Schema(type: 'boolean', example: true),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/PathIncludeParentParameter.php

@@ -30,7 +30,7 @@ public function __construct()
             description: 'Include the parent item in the result.',
             in: 'query',
             required: false,
-            schema: new Schema(type: 'boolean', example: null),
+            schema: new Schema(type: 'boolean', example: true),
         );
     }
 }

src/OpenApi/Attribute/Parameter/Query/PathParameter.php

@@ -30,7 +30,7 @@ public function __construct()
             description: 'Filter by path.',
             in: 'query',
             required: false,
-            schema: new Schema(type: 'string', example: null),
+            schema: new Schema(type: 'string', example: '/path/to/folder'),
 
         );
     }

src/OpenApi/Attribute/Parameter/Query/SortOrderParameter.php

@@ -36,7 +36,7 @@ enum: [
                     'ASC',
                     'DESC',
                 ],
-                example: null,
+                example: 'ASC',
             ),
         );
     }