DocCommentSpacingSniff: Fixed fixer

Author: kukulich

SlevomatCodingStandard/Sniffs/Commenting/DocCommentSpacingSniff.php

@@ -567,13 +567,20 @@ private function checkAnnotationsGroupsOrder(
 			}
 		}
 
-		$endOfLineBeforeFirstAnnotation = TokenHelper::findPreviousContent($phpcsFile, T_DOC_COMMENT_WHITESPACE, $phpcsFile->eolChar, $firstAnnotation->getStartPointer() - 1);
+		$endOfLineBeforeFirstAnnotation = TokenHelper::findPreviousContent($phpcsFile, T_DOC_COMMENT_WHITESPACE, $phpcsFile->eolChar, $firstAnnotation->getStartPointer() - 1, $docCommentOpenerPointer);
 		$endOfLineAfterLastAnnotation = TokenHelper::findNextContent($phpcsFile, T_DOC_COMMENT_WHITESPACE, $phpcsFile->eolChar, $lastAnnotation->getEndPointer() + 1);
 
 		$phpcsFile->fixer->beginChangeset();
-		$phpcsFile->fixer->replaceToken($endOfLineBeforeFirstAnnotation + 1, $fixedAnnotations);
-		for ($i = $endOfLineBeforeFirstAnnotation + 2; $i <= $endOfLineAfterLastAnnotation; $i++) {
-			$phpcsFile->fixer->replaceToken($i, '');
+		if ($endOfLineBeforeFirstAnnotation === null) {
+			$phpcsFile->fixer->replaceToken($docCommentOpenerPointer, '/**' . $phpcsFile->eolChar . $fixedAnnotations);
+			for ($i = $docCommentOpenerPointer + 1; $i <= $endOfLineAfterLastAnnotation; $i++) {
+				$phpcsFile->fixer->replaceToken($i, '');
+			}
+		} else {
+			$phpcsFile->fixer->replaceToken($endOfLineBeforeFirstAnnotation + 1, $fixedAnnotations);
+			for ($i = $endOfLineBeforeFirstAnnotation + 2; $i <= $endOfLineAfterLastAnnotation; $i++) {
+				$phpcsFile->fixer->replaceToken($i, '');
+			}
 		}
 		$phpcsFile->fixer->endChangeset();
 	}

tests/Sniffs/Commenting/DocCommentSpacingSniffTest.php

@@ -134,13 +134,14 @@ public function testAnnotationsGroupsErrors(): void
 			DocCommentSpacingSniff::CODE_INCORRECT_ORDER_OF_ANNOTATIONS_IN_GROUP,
 		]);
 
-		self::assertSame(5, $report->getErrorCount());
+		self::assertSame(6, $report->getErrorCount());
 
 		self::assertSniffError($report, 20, DocCommentSpacingSniff::CODE_INCORRECT_ANNOTATIONS_GROUP);
 		self::assertSniffError($report, 34, DocCommentSpacingSniff::CODE_INCORRECT_LINES_COUNT_BETWEEN_ANNOTATIONS_GROUPS);
 		self::assertSniffError($report, 46, DocCommentSpacingSniff::CODE_INCORRECT_ORDER_OF_ANNOTATIONS_GROUPS);
 		self::assertSniffError($report, 49, DocCommentSpacingSniff::CODE_INCORRECT_ORDER_OF_ANNOTATIONS_IN_GROUP);
 		self::assertSniffError($report, 62, DocCommentSpacingSniff::CODE_INCORRECT_ORDER_OF_ANNOTATIONS_GROUPS);
+		self::assertSniffError($report, 83, DocCommentSpacingSniff::CODE_INCORRECT_ANNOTATIONS_GROUP);
 
 		self::assertAllFixedInFile($report);
 	}

tests/Sniffs/Commenting/data/docCommentSpacingAnnotationsGroupsErrors.fixed.php

@@ -69,4 +69,24 @@ public function oneMoreMethod($a, $b, $c)
 
 	}
 
+	/**
+	 * @return bool
+	 *
+	 * @param int $a
+	 */
+	public function methodBeforeInvalidDocComment($a): bool
+	{
+
+	}
+
+	/**
+	 * @param int $a
+	 *
+	 * @return bool
+	 */
+	public function methodWithInvalidDocComment($a): bool
+	{
+
+	}
+
 }

tests/Sniffs/Commenting/data/docCommentSpacingAnnotationsGroupsErrors.php

@@ -70,4 +70,22 @@ public function oneMoreMethod($a, $b, $c)
 
 	}
 
+	/**
+	 * @return bool
+	 *
+	 * @param int $a
+	 */
+	public function methodBeforeInvalidDocComment($a): bool
+	{
+
+	}
+
+	/** @return bool
+	 * @param int $a
+	 */
+	public function methodWithInvalidDocComment($a): bool
+	{
+
+	}
+
 }