[Php80] Handle value as argument with keep description as comment on …

…AttributeValueResolver (#6589)

* [Php80] Handle behat @when with values as argument and description as comment

* debugging

* handle comment as value

* [Php80] Handle value as argument with keep description as comment on AttributeValueResolver

* new lines

* new lines

* deetail

rules-tests/Php80/Rector/Class_/AnnotationToAttributeRector/Fixture/with_value_as_argument_and_description.php.inc

@@ -0,0 +1,44 @@
+<?php
+
+namespace Rector\Tests\Php80\Rector\Class_\AnnotationToAttributeRector\Fixture;
+
+final class WithValueAsArgumentAndDescription
+{
+    /**
+     * original comment
+     * some other new lines
+     *
+     * @When(key="value") some description
+     *
+     * other comment
+     * other new line comment
+     */
+    public function someStep(): void
+    {
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\Php80\Rector\Class_\AnnotationToAttributeRector\Fixture;
+
+final class WithValueAsArgumentAndDescription
+{
+    /**
+     * original comment
+     * some other new lines
+     *
+     * some description
+     *
+     * other comment
+     * other new line comment
+     */
+    #[\Behat\Step\When('(key="value")')]
+    public function someStep(): void
+    {
+    }
+}
+
+?>

rules/Php80/Rector/Class_/AttributeValueResolver.php

@@ -7,6 +7,7 @@
 use Nette\Utils\Strings;
 use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocTagNode;
 use Rector\BetterPhpDocParser\PhpDoc\DoctrineAnnotationTagValueNode;
+use Rector\NodeTypeResolver\Node\AttributeKey;
 use Rector\Php80\ValueObject\AnnotationToAttribute;
 use Rector\Php80\ValueObject\AttributeValueAndDocComment;
 use Rector\Util\NewLineSplitter;
@@ -27,10 +28,23 @@ public function resolve(
             return null;
         }
 
+        $docValue = (string) $phpDocTagNode->value;
+
         if ($phpDocTagNode->value instanceof DoctrineAnnotationTagValueNode) {
-            $docValue = (string) $phpDocTagNode->value->getOriginalContent();
-        } else {
-            $docValue = (string) $phpDocTagNode->value;
+            $originalContent = (string) $phpDocTagNode->value->getOriginalContent();
+
+            if ($docValue === '') {
+                $attributeComment = (string) $phpDocTagNode->value->getAttribute(AttributeKey::ATTRIBUTE_COMMENT);
+
+                if ($originalContent === $attributeComment) {
+                    $docValue = $originalContent;
+                }
+            } else {
+                $attributeComment = ltrim($originalContent, $docValue);
+                if ($attributeComment !== '') {
+                    $docValue .= "\n" . $attributeComment;
+                }
+            }
         }
 
         $docComment = '';