feat: deprecate annotation namespace in favor of attribute

src/Annotation/Areas.php

@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Annotation;
+
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 4.0. Use the \Nelmio\ApiDocBundle\Attribute\Areas attribute instead.', Areas::class);
+
+/**
+ * @Annotation
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
+final class Areas extends \Nelmio\ApiDocBundle\Attribute\Areas
+{
+}

src/Annotation/Model.php

@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Annotation;
+
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 4.0. Use the \Nelmio\ApiDocBundle\Attribute\Model attribute instead.', Model::class);
+
+/**
+ * @Annotation
+ */
+#[\Attribute(\Attribute::TARGET_METHOD)]
+final class Model extends \Nelmio\ApiDocBundle\Attribute\Model
+{
+}

src/Annotation/Operation.php

@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Annotation;
+
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 4.0. Use the \Nelmio\ApiDocBundle\Attribute\Operation attribute instead.', Operation::class);
+
+/**
+ * @Annotation
+ */
+#[\Attribute(\Attribute::TARGET_METHOD)]
+class Operation extends \Nelmio\ApiDocBundle\Attribute\Operation
+{
+}

src/Annotation/Security.php

@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Annotation;
+
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 4.0. Use the \Nelmio\ApiDocBundle\Attribute\Security attribute instead.', Security::class);
+
+/**
+ * @Annotation
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
+class Security extends \Nelmio\ApiDocBundle\Attribute\Security
+{
+}

src/Attribute/Areas.php

@@ -12,10 +12,10 @@
 namespace Nelmio\ApiDocBundle\Attribute;
 
 /**
- * @Annotation
+ * @final
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
-final class Areas
+class Areas
 {
     /** @var string[] */
     private array $areas;

src/Attribute/Model.php

@@ -16,10 +16,10 @@
 use OpenApi\Generator;
 
 /**
- * @Annotation
+ * @final
  */
 #[\Attribute(\Attribute::TARGET_METHOD)]
-final class Model extends Attachable
+class Model extends Attachable
 {
     public static $_types = [
         'type' => 'string',

src/Attribute/Operation.php

@@ -14,7 +14,7 @@
 use OpenApi\Annotations\Operation as BaseOperation;
 
 /**
- * @Annotation
+ * @final
  */
 #[\Attribute(\Attribute::TARGET_METHOD)]
 class Operation extends BaseOperation

src/Attribute/Security.php

@@ -14,7 +14,7 @@
 use OpenApi\Annotations\AbstractAnnotation;
 
 /**
- * @Annotation
+ * @final
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
 class Security extends AbstractAnnotation

src/Routing/FilteredRouteCollectionBuilder.php

@@ -181,6 +181,7 @@ private function defaultRouteDisabled(Route $route): bool
 
         foreach ($annotations as $annotation) {
             if (false !== strpos(get_class($annotation), 'Nelmio\\ApiDocBundle\\Annotation')
+                || false !== strpos(get_class($annotation), 'Nelmio\\ApiDocBundle\\Attribute')
                 || false !== strpos(get_class($annotation), 'OpenApi\\Annotations')
                 || false !== strpos(get_class($annotation), 'OpenApi\\Attributes')
             ) {