Add Mixin attribute

Author: carlos-granados

README.md

@@ -116,6 +116,7 @@ These are the available attributes and their corresponding PHPDoc annotations:
 | [Internal](https://github.com/php-static-analysis/attributes/blob/main/doc/Internal.md)                           | `@internal`               |
 | [IsReadOnly](https://github.com/php-static-analysis/attributes/blob/main/doc/IsReadOnly.md)       | `@readonly`        |
 | [Method](https://github.com/php-static-analysis/attributes/blob/main/doc/Method.md)                               | `@method`                 |
+| [Mixin](https://github.com/php-static-analysis/attributes/blob/main/doc/Mixin.md)                                 | `@mixin`                  |
 | [Param](https://github.com/php-static-analysis/attributes/blob/main/doc/Param.md)                 | `@param`           |
 | [Property](https://github.com/php-static-analysis/attributes/blob/main/doc/Property.md)           | `@property` `@var` |
 | [PropertyRead](https://github.com/php-static-analysis/attributes/blob/main/doc/PropertyRead.md)   | `@property-read`   |

composer.json

@@ -28,7 +28,7 @@
     "require": {
         "php": ">=8.0",
         "cweagans/composer-patches": "^1.7",
-        "php-static-analysis/attributes": "^0.1.9 || dev-main",
+        "php-static-analysis/attributes": "^0.1.10 || dev-main",
         "rector/rector": "^0.19 || ^1.0"
     },
     "require-dev": {

config/sets/php-static-analysis-annotations-to-attributes.php

@@ -5,6 +5,7 @@
 use PhpStaticAnalysis\Attributes\Deprecated;
 use PhpStaticAnalysis\Attributes\Internal;
 use PhpStaticAnalysis\Attributes\Method;
+use PhpStaticAnalysis\Attributes\Mixin;
 use PhpStaticAnalysis\Attributes\PropertyRead;
 use PhpStaticAnalysis\Attributes\PropertyWrite;
 use PhpStaticAnalysis\Attributes\TemplateContravariant;
@@ -26,6 +27,7 @@
             new AnnotationToAttribute('deprecated', Deprecated::class),
             new AnnotationToAttribute('internal', Internal::class),
             new AnnotationToAttribute('method', Method::class),
+            new AnnotationToAttribute('mixin', Mixin::class),
             new AnnotationToAttribute('param', Param::class),
             new AnnotationToAttribute('property', Property::class),
             new AnnotationToAttribute('property_read', PropertyRead::class),

src/AnnotationsToAttributesRector.php

@@ -14,6 +14,7 @@
 use PHPStan\PhpDocParser\Ast\PhpDoc\DeprecatedTagValueNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\GenericTagValueNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\MethodTagValueNode;
+use PHPStan\PhpDocParser\Ast\PhpDoc\MixinTagValueNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\ParamTagValueNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocTagNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\PropertyTagValueNode;
@@ -257,6 +258,7 @@ private function processAnnotations(PhpDocInfo $phpDocInfo): array
                     ];
                     $attributeComment = $tagValueNode->description;
                     break;
+                case $tagValueNode instanceof MixinTagValueNode:
                 case $tagValueNode instanceof ReturnTagValueNode:
                 case $tagValueNode instanceof VarTagValueNode:
                     $args = [

tests/Fixture/MixinAttributeTest.php.inc

@@ -0,0 +1,35 @@
+<?php
+
+namespace test\PhpStaticAnalysis\RectorRule\Fixture;
+
+use PhpStaticAnalysis\Attributes\Template;
+
+/**
+ * @codeCoverageIgnore
+ * @mixin A
+ * @mixin B the proxied class
+ */
+#[Template('T')]
+class MixinAttributeTest
+{
+}
+
+?>
+-----
+<?php
+
+namespace test\PhpStaticAnalysis\RectorRule\Fixture;
+
+use PhpStaticAnalysis\Attributes\Template;
+
+/**
+ * @codeCoverageIgnore
+ */
+#[Template('T')]
+#[\PhpStaticAnalysis\Attributes\Mixin('A')]
+#[\PhpStaticAnalysis\Attributes\Mixin('B')] // the proxied class
+class MixinAttributeTest
+{
+}
+
+?>