From 165054c78b22446a04d95d94c80ccaeeb6508dfd Mon Sep 17 00:00:00 2001
From: Mark Scherer <dereuromark@users.noreply.github.com>
Date: Thu, 6 Aug 2026 13:12:52 +0200
Subject: [PATCH] Add smoke tests for ten untested fixing sniffs

The standard ships 86 sniffs against 38 test classes, and the gap is worst
where it hurts most: sniffs that rewrite source. A fixer nobody exercises can
break without anything noticing, which is exactly how VoidCast and
PipeOperatorSpacing came to match nothing at all on PHP 8.5 from the day they
were written.

Covers the ten heaviest rewriters by fixable-error count: TernarySpacing,
DocBlockTagGrouping, DocComment, ControlStructureSpacing, ConcatenationSpacing,
Mock, MethodDeclaration, ImplicitCastSpacing, FunctionSpacing and
DocBlockStructure. Each fixture triggers the distinct error codes its sniff can
emit and also carries constructs the sniff has to leave alone, so an
over-eager matcher fails the test rather than passing it quietly.

No sniff behavior changes here. Where a fixture documents something that looks
wrong, it asserts what the sniff does today rather than what it arguably
should; those are followed up separately.

128 tests, up from 108.
---
 .../Classes/MethodDeclarationSniffTest.php    | 30 +++++++
 .../Commenting/DocBlockStructureSniffTest.php | 30 +++++++
 .../DocBlockTagGroupingSniffTest.php          | 30 +++++++
 .../Sniffs/Commenting/DocCommentSniffTest.php | 30 +++++++
 .../ControlStructureSpacingSniffTest.php      | 30 +++++++
 .../Sniffs/Testing/MockSniffTest.php          | 53 +++++++++++++
 .../ConcatenationSpacingSniffTest.php         | 30 +++++++
 .../WhiteSpace/FunctionSpacingSniffTest.php   | 30 +++++++
 .../ImplicitCastSpacingSniffTest.php          | 30 +++++++
 .../WhiteSpace/TernarySpacingSniffTest.php    | 30 +++++++
 tests/_data/ConcatenationSpacing/after.php    | 22 ++++++
 tests/_data/ConcatenationSpacing/before.php   | 22 ++++++
 tests/_data/ControlStructureSpacing/after.php | 29 +++++++
 .../_data/ControlStructureSpacing/before.php  | 32 ++++++++
 tests/_data/DocBlockStructure/after.php       | 31 ++++++++
 tests/_data/DocBlockStructure/before.php      | 30 +++++++
 tests/_data/DocBlockTagGrouping/after.php     | 78 +++++++++++++++++++
 tests/_data/DocBlockTagGrouping/before.php    | 77 ++++++++++++++++++
 tests/_data/DocComment/after.php              | 47 +++++++++++
 tests/_data/DocComment/before.php             | 47 +++++++++++
 tests/_data/FunctionSpacing/after.php         | 39 ++++++++++
 tests/_data/FunctionSpacing/before.php        | 37 +++++++++
 tests/_data/ImplicitCastSpacing/after.php     | 24 ++++++
 tests/_data/ImplicitCastSpacing/before.php    | 24 ++++++
 tests/_data/MethodDeclaration/after.php       | 26 +++++++
 tests/_data/MethodDeclaration/before.php      | 26 +++++++
 tests/_data/Mock/after.php                    | 75 ++++++++++++++++++
 tests/_data/Mock/before.php                   | 75 ++++++++++++++++++
 tests/_data/TernarySpacing/after.php          | 27 +++++++
 tests/_data/TernarySpacing/before.php         | 27 +++++++
 30 files changed, 1118 insertions(+)
 create mode 100644 tests/PhpCollective/Sniffs/Classes/MethodDeclarationSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/Commenting/DocBlockStructureSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/Commenting/DocBlockTagGroupingSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/Commenting/DocCommentSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/ControlStructures/ControlStructureSpacingSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/Testing/MockSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/WhiteSpace/ConcatenationSpacingSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/WhiteSpace/FunctionSpacingSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/WhiteSpace/ImplicitCastSpacingSniffTest.php
 create mode 100644 tests/PhpCollective/Sniffs/WhiteSpace/TernarySpacingSniffTest.php
 create mode 100644 tests/_data/ConcatenationSpacing/after.php
 create mode 100644 tests/_data/ConcatenationSpacing/before.php
 create mode 100644 tests/_data/ControlStructureSpacing/after.php
 create mode 100644 tests/_data/ControlStructureSpacing/before.php
 create mode 100644 tests/_data/DocBlockStructure/after.php
 create mode 100644 tests/_data/DocBlockStructure/before.php
 create mode 100644 tests/_data/DocBlockTagGrouping/after.php
 create mode 100644 tests/_data/DocBlockTagGrouping/before.php
 create mode 100644 tests/_data/DocComment/after.php
 create mode 100644 tests/_data/DocComment/before.php
 create mode 100644 tests/_data/FunctionSpacing/after.php
 create mode 100644 tests/_data/FunctionSpacing/before.php
 create mode 100644 tests/_data/ImplicitCastSpacing/after.php
 create mode 100644 tests/_data/ImplicitCastSpacing/before.php
 create mode 100644 tests/_data/MethodDeclaration/after.php
 create mode 100644 tests/_data/MethodDeclaration/before.php
 create mode 100644 tests/_data/Mock/after.php
 create mode 100644 tests/_data/Mock/before.php
 create mode 100644 tests/_data/TernarySpacing/after.php
 create mode 100644 tests/_data/TernarySpacing/before.php

diff --git a/tests/PhpCollective/Sniffs/Classes/MethodDeclarationSniffTest.php b/tests/PhpCollective/Sniffs/Classes/MethodDeclarationSniffTest.php
new file mode 100644
index 0000000..e21e882
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/Classes/MethodDeclarationSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\Classes;
+
+use PhpCollective\Sniffs\Classes\MethodDeclarationSniff;
+use PhpCollective\Test\TestCase;
+
+class MethodDeclarationSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testMethodDeclarationSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new MethodDeclarationSniff(), 5, 4);
+    }
+
+    /**
+     * @return void
+     */
+    public function testMethodDeclarationFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new MethodDeclarationSniff(), 4);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/Commenting/DocBlockStructureSniffTest.php b/tests/PhpCollective/Sniffs/Commenting/DocBlockStructureSniffTest.php
new file mode 100644
index 0000000..35ec887
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/Commenting/DocBlockStructureSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\Commenting;
+
+use PhpCollective\Sniffs\Commenting\DocBlockStructureSniff;
+use PhpCollective\Test\TestCase;
+
+class DocBlockStructureSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testDocBlockStructureSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new DocBlockStructureSniff(), 3, 3);
+    }
+
+    /**
+     * @return void
+     */
+    public function testDocBlockStructureFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new DocBlockStructureSniff(), 3);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/Commenting/DocBlockTagGroupingSniffTest.php b/tests/PhpCollective/Sniffs/Commenting/DocBlockTagGroupingSniffTest.php
new file mode 100644
index 0000000..b194fe7
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/Commenting/DocBlockTagGroupingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\Commenting;
+
+use PhpCollective\Sniffs\Commenting\DocBlockTagGroupingSniff;
+use PhpCollective\Test\TestCase;
+
+class DocBlockTagGroupingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testDocBlockTagGroupingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new DocBlockTagGroupingSniff(), 6, 6);
+    }
+
+    /**
+     * @return void
+     */
+    public function testDocBlockTagGroupingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new DocBlockTagGroupingSniff(), 6);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/Commenting/DocCommentSniffTest.php b/tests/PhpCollective/Sniffs/Commenting/DocCommentSniffTest.php
new file mode 100644
index 0000000..0e4f159
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/Commenting/DocCommentSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\Commenting;
+
+use PhpCollective\Sniffs\Commenting\DocCommentSniff;
+use PhpCollective\Test\TestCase;
+
+class DocCommentSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testDocCommentSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new DocCommentSniff(), 4, 4);
+    }
+
+    /**
+     * @return void
+     */
+    public function testDocCommentFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new DocCommentSniff(), 4);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/ControlStructures/ControlStructureSpacingSniffTest.php b/tests/PhpCollective/Sniffs/ControlStructures/ControlStructureSpacingSniffTest.php
new file mode 100644
index 0000000..9e68192
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/ControlStructures/ControlStructureSpacingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\ControlStructures;
+
+use PhpCollective\Sniffs\ControlStructures\ControlStructureSpacingSniff;
+use PhpCollective\Test\TestCase;
+
+class ControlStructureSpacingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testControlStructureSpacingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new ControlStructureSpacingSniff(), 6, 6);
+    }
+
+    /**
+     * @return void
+     */
+    public function testControlStructureSpacingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new ControlStructureSpacingSniff(), 6);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/Testing/MockSniffTest.php b/tests/PhpCollective/Sniffs/Testing/MockSniffTest.php
new file mode 100644
index 0000000..4eb9ecc
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/Testing/MockSniffTest.php
@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\Testing;
+
+use PHP_CodeSniffer\Sniffs\Sniff;
+use PhpCollective\Sniffs\Testing\MockSniff;
+use PhpCollective\Test\TestCase;
+
+class MockSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testMockSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new MockSniff(), 6, 4);
+    }
+
+    /**
+     * @return void
+     */
+    public function testMockFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new MockSniff(), 4);
+    }
+
+    /**
+     * @param \PHP_CodeSniffer\Sniffs\Sniff $sniffer
+     *
+     * @return string
+     */
+    protected function getDummyFileBefore(Sniff $sniffer): string
+    {
+        $fixture = parent::getDummyFileBefore($sniffer);
+        $target = TMP . 'MockSniffFixtureTest.php';
+
+        if (!is_dir(TMP)) {
+            mkdir(TMP, 0770, true);
+        }
+
+        $contents = file_get_contents($fixture);
+        $this->assertIsString($contents);
+        $result = file_put_contents($target, $contents);
+        $this->assertIsInt($result);
+
+        return $target;
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/WhiteSpace/ConcatenationSpacingSniffTest.php b/tests/PhpCollective/Sniffs/WhiteSpace/ConcatenationSpacingSniffTest.php
new file mode 100644
index 0000000..4a9229e
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/WhiteSpace/ConcatenationSpacingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\WhiteSpace;
+
+use PhpCollective\Sniffs\WhiteSpace\ConcatenationSpacingSniff;
+use PhpCollective\Test\TestCase;
+
+class ConcatenationSpacingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testConcatenationSpacingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new ConcatenationSpacingSniff(), 4, 4);
+    }
+
+    /**
+     * @return void
+     */
+    public function testConcatenationSpacingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new ConcatenationSpacingSniff(), 4);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/WhiteSpace/FunctionSpacingSniffTest.php b/tests/PhpCollective/Sniffs/WhiteSpace/FunctionSpacingSniffTest.php
new file mode 100644
index 0000000..ff4a0a4
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/WhiteSpace/FunctionSpacingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\WhiteSpace;
+
+use PhpCollective\Sniffs\WhiteSpace\FunctionSpacingSniff;
+use PhpCollective\Test\TestCase;
+
+class FunctionSpacingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testFunctionSpacingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new FunctionSpacingSniff(), 2, 2);
+    }
+
+    /**
+     * @return void
+     */
+    public function testFunctionSpacingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new FunctionSpacingSniff(), 2);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/WhiteSpace/ImplicitCastSpacingSniffTest.php b/tests/PhpCollective/Sniffs/WhiteSpace/ImplicitCastSpacingSniffTest.php
new file mode 100644
index 0000000..0923db9
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/WhiteSpace/ImplicitCastSpacingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\WhiteSpace;
+
+use PhpCollective\Sniffs\WhiteSpace\ImplicitCastSpacingSniff;
+use PhpCollective\Test\TestCase;
+
+class ImplicitCastSpacingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testImplicitCastSpacingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new ImplicitCastSpacingSniff(), 4, 4);
+    }
+
+    /**
+     * @return void
+     */
+    public function testImplicitCastSpacingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new ImplicitCastSpacingSniff(), 4);
+    }
+}
diff --git a/tests/PhpCollective/Sniffs/WhiteSpace/TernarySpacingSniffTest.php b/tests/PhpCollective/Sniffs/WhiteSpace/TernarySpacingSniffTest.php
new file mode 100644
index 0000000..35a872e
--- /dev/null
+++ b/tests/PhpCollective/Sniffs/WhiteSpace/TernarySpacingSniffTest.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * MIT License
+ * For full license information, please view the LICENSE file that was distributed with this source code.
+ */
+
+namespace PhpCollective\Test\PhpCollective\Sniffs\WhiteSpace;
+
+use PhpCollective\Sniffs\WhiteSpace\TernarySpacingSniff;
+use PhpCollective\Test\TestCase;
+
+class TernarySpacingSniffTest extends TestCase
+{
+    /**
+     * @return void
+     */
+    public function testTernarySpacingSniffer(): void
+    {
+        $this->assertSnifferFindsFixableErrors(new TernarySpacingSniff(), 7, 7);
+    }
+
+    /**
+     * @return void
+     */
+    public function testTernarySpacingFixer(): void
+    {
+        $this->assertSnifferCanFixErrors(new TernarySpacingSniff(), 7);
+    }
+}
diff --git a/tests/_data/ConcatenationSpacing/after.php b/tests/_data/ConcatenationSpacing/after.php
new file mode 100644
index 0000000..fe97e9b
--- /dev/null
+++ b/tests/_data/ConcatenationSpacing/after.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class ConcatenationSpacingExample
+{
+    public function render(string $first, string $second): string
+    {
+        $missingBefore = $first . 'b';
+        $missingAfter = $first . 'b';
+        $tooManyBefore = $first . 'b';
+        $tooManyAfter = $first . 'b';
+
+        $valid = $first . 'b';
+        $multiline = $first
+            . $second;
+
+        return $missingBefore . $missingAfter . $tooManyBefore . $tooManyAfter . $valid . $multiline;
+    }
+}
diff --git a/tests/_data/ConcatenationSpacing/before.php b/tests/_data/ConcatenationSpacing/before.php
new file mode 100644
index 0000000..5611b10
--- /dev/null
+++ b/tests/_data/ConcatenationSpacing/before.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class ConcatenationSpacingExample
+{
+    public function render(string $first, string $second): string
+    {
+        $missingBefore = $first. 'b';
+        $missingAfter = $first .'b';
+        $tooManyBefore = $first  . 'b';
+        $tooManyAfter = $first .  'b';
+
+        $valid = $first . 'b';
+        $multiline = $first
+            . $second;
+
+        return $missingBefore . $missingAfter . $tooManyBefore . $tooManyAfter . $valid . $multiline;
+    }
+}
diff --git a/tests/_data/ControlStructureSpacing/after.php b/tests/_data/ControlStructureSpacing/after.php
new file mode 100644
index 0000000..1cabc10
--- /dev/null
+++ b/tests/_data/ControlStructureSpacing/after.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+use RuntimeException;
+use Throwable;
+
+class ControlStructureSpacingExample
+{
+    public function run(): void
+    {
+        try {
+            throw new RuntimeException('first');
+        } catch (RuntimeException $exception) {
+        }
+
+        try {
+            throw new RuntimeException('second');
+        } catch (Throwable $exception) {
+        }
+
+        try {
+            throw new RuntimeException('valid');
+        } catch (Throwable $exception) {
+        }
+    }
+}
diff --git a/tests/_data/ControlStructureSpacing/before.php b/tests/_data/ControlStructureSpacing/before.php
new file mode 100644
index 0000000..285a3c7
--- /dev/null
+++ b/tests/_data/ControlStructureSpacing/before.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+use RuntimeException;
+use Throwable;
+
+class ControlStructureSpacingExample
+{
+    public function run(): void
+    {
+        try{
+            throw new RuntimeException('first');
+        }catch(RuntimeException $exception) {
+        }
+
+        try
+        {
+            throw new RuntimeException('second');
+        }
+        catch
+        (Throwable $exception) {
+        }
+
+        try {
+            throw new RuntimeException('valid');
+        } catch (Throwable $exception) {
+        }
+    }
+}
diff --git a/tests/_data/DocBlockStructure/after.php b/tests/_data/DocBlockStructure/after.php
new file mode 100644
index 0000000..12cfba9
--- /dev/null
+++ b/tests/_data/DocBlockStructure/after.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocBlockStructureExample
+{
+    /**
+     * Opening marker has too many stars.
+     */
+    public const OPENING = 'opening';
+
+    /**
+     * Closing marker has too many stars.
+     */
+    public const CLOSING = 'closing';
+
+    /**
+     * Summary starts on the opening line.
+     */
+    public const BEGINNING = 'beginning';
+
+    /** Single-line comments are left alone. */
+    public const VALID_SINGLE_LINE = 'valid';
+
+    /**
+     * Valid multi-line comments are left alone.
+     */
+    public const VALID_MULTI_LINE = 'valid';
+}
diff --git a/tests/_data/DocBlockStructure/before.php b/tests/_data/DocBlockStructure/before.php
new file mode 100644
index 0000000..ee7d9de
--- /dev/null
+++ b/tests/_data/DocBlockStructure/before.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocBlockStructureExample
+{
+    /***
+     * Opening marker has too many stars.
+     */
+    public const OPENING = 'opening';
+
+    /**
+     * Closing marker has too many stars.
+     **/
+    public const CLOSING = 'closing';
+
+    /** Summary starts on the opening line.
+     */
+    public const BEGINNING = 'beginning';
+
+    /** Single-line comments are left alone. */
+    public const VALID_SINGLE_LINE = 'valid';
+
+    /**
+     * Valid multi-line comments are left alone.
+     */
+    public const VALID_MULTI_LINE = 'valid';
+}
diff --git a/tests/_data/DocBlockTagGrouping/after.php b/tests/_data/DocBlockTagGrouping/after.php
new file mode 100644
index 0000000..2f53ae4
--- /dev/null
+++ b/tests/_data/DocBlockTagGrouping/after.php
@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocBlockTagGroupingExample
+{
+    /**
+     *
+     * @var string
+     */
+    public const TAGS_START_TOO_LATE = 'start';
+
+    /**
+     * Tags need one separating line.
+     *
+     * @param string $name
+     *
+     * @return void
+     */
+    public function missingDescriptionTagSeparator(string $name): void
+    {
+    }
+
+    /**
+     * Same tags must stay together.
+     *
+     * @param string $first
+     * @param string $second
+     *
+     * @return void
+     */
+    public function sameTagsHaveExtraSpacing(string $first, string $second): void
+    {
+    }
+
+    /**
+     * Different tags need one separator.
+     *
+     * @param string $value
+     *
+     * @throws \RuntimeException
+     */
+    public function differentTagsNeedSpacing(string $value): void
+    {
+    }
+
+    /**
+     * Extra spacing after tags.
+     *
+     * @return void
+     */
+    public function tagsHaveTrailingSpacing(): void
+    {
+    }
+
+    /**
+     * Valid grouping.
+     *
+     * @param string $value
+     *
+     * @return void
+     */
+    public function validGrouping(string $value): void
+    {
+    }
+
+    public function closureIsLeftAlone(): void
+    {
+        /**
+         * Closure doc block is ignored.
+         * @return void
+         */
+        $closure = function (): void {
+        };
+    }
+}
diff --git a/tests/_data/DocBlockTagGrouping/before.php b/tests/_data/DocBlockTagGrouping/before.php
new file mode 100644
index 0000000..687330c
--- /dev/null
+++ b/tests/_data/DocBlockTagGrouping/before.php
@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocBlockTagGroupingExample
+{
+    /**
+     *
+     * @var string
+     */
+    public const TAGS_START_TOO_LATE = 'start';
+
+    /**
+     * Tags need one separating line.
+     * @param string $name
+     * @return void
+     */
+    public function missingDescriptionTagSeparator(string $name): void
+    {
+    }
+
+    /**
+     * Same tags must stay together.
+     *
+     * @param string $first
+     *
+     * @param string $second
+     *
+     * @return void
+     */
+    public function sameTagsHaveExtraSpacing(string $first, string $second): void
+    {
+    }
+
+    /**
+     * Different tags need one separator.
+     *
+     * @param string $value
+     * @throws \RuntimeException
+     */
+    public function differentTagsNeedSpacing(string $value): void
+    {
+    }
+
+    /**
+     * Extra spacing after tags.
+     *
+     * @return void
+     *
+     */
+    public function tagsHaveTrailingSpacing(): void
+    {
+    }
+
+    /**
+     * Valid grouping.
+     *
+     * @param string $value
+     *
+     * @return void
+     */
+    public function validGrouping(string $value): void
+    {
+    }
+
+    public function closureIsLeftAlone(): void
+    {
+        /**
+         * Closure doc block is ignored.
+         * @return void
+         */
+        $closure = function (): void {
+        };
+    }
+}
diff --git a/tests/_data/DocComment/after.php b/tests/_data/DocComment/after.php
new file mode 100644
index 0000000..4867b1c
--- /dev/null
+++ b/tests/_data/DocComment/after.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocCommentExample
+{
+    /**
+     * Close tag shares a line. 
+				 */
+    public function closeTagSharesLine(): void
+    {
+    }
+
+    /**
+     * Short description starts too late.
+     */
+    public function shortDescriptionStartsTooLate(): void
+    {
+    }
+
+    /**
+     * Extra blank line before the close tag.
+     */
+    public function extraBlankLineAtEnd(): void
+    {
+    }
+
+    /**
+     * Tags are too close.
+				 *
+     * @return void
+     */
+    public function tagsNeedSpacing(): void
+    {
+    }
+
+    /**
+     * Valid comment.
+     *
+     * @return void
+     */
+    public function validComment(): void
+    {
+    }
+}
diff --git a/tests/_data/DocComment/before.php b/tests/_data/DocComment/before.php
new file mode 100644
index 0000000..c09979c
--- /dev/null
+++ b/tests/_data/DocComment/before.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class DocCommentExample
+{
+    /**
+     * Close tag shares a line. */
+    public function closeTagSharesLine(): void
+    {
+    }
+
+    /**
+     *
+     * Short description starts too late.
+     */
+    public function shortDescriptionStartsTooLate(): void
+    {
+    }
+
+    /**
+     * Extra blank line before the close tag.
+     *
+     */
+    public function extraBlankLineAtEnd(): void
+    {
+    }
+
+    /**
+     * Tags are too close.
+     * @return void
+     */
+    public function tagsNeedSpacing(): void
+    {
+    }
+
+    /**
+     * Valid comment.
+     *
+     * @return void
+     */
+    public function validComment(): void
+    {
+    }
+}
diff --git a/tests/_data/FunctionSpacing/after.php b/tests/_data/FunctionSpacing/after.php
new file mode 100644
index 0000000..aaad89f
--- /dev/null
+++ b/tests/_data/FunctionSpacing/after.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+interface FunctionSpacingContract
+{
+    public function first(): void;
+    public function second(): void;
+
+    public function last(): void;
+}
+
+class FunctionSpacingExample
+{
+    private string $name = 'x';
+
+    public function needsBlankBefore(): void
+    {
+    }
+
+    public function needsBlankAfter(): void
+    {
+    }
+
+    private string $other = 'y';
+
+    #[\Override]
+    public function attributeIsLeftAlone(): void
+    {
+    }
+
+    public function closureIsLeftAlone(): void
+    {
+        $closure = function (): void {
+        };
+    }
+}
diff --git a/tests/_data/FunctionSpacing/before.php b/tests/_data/FunctionSpacing/before.php
new file mode 100644
index 0000000..48be288
--- /dev/null
+++ b/tests/_data/FunctionSpacing/before.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+interface FunctionSpacingContract
+{
+    public function first(): void;
+    public function second(): void;
+
+    public function last(): void;
+}
+
+class FunctionSpacingExample
+{
+    private string $name = 'x';
+    public function needsBlankBefore(): void
+    {
+    }
+
+    public function needsBlankAfter(): void
+    {
+    }
+    private string $other = 'y';
+
+    #[\Override]
+    public function attributeIsLeftAlone(): void
+    {
+    }
+
+    public function closureIsLeftAlone(): void
+    {
+        $closure = function (): void {
+        };
+    }
+}
diff --git a/tests/_data/ImplicitCastSpacing/after.php b/tests/_data/ImplicitCastSpacing/after.php
new file mode 100644
index 0000000..c7448d6
--- /dev/null
+++ b/tests/_data/ImplicitCastSpacing/after.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class ImplicitCastSpacingExample
+{
+    public function run(bool $ready, int $count, int $mask, callable $callable): int
+    {
+        $not = !$ready;
+        $silenced = @$callable();
+        $flipped = ~ $mask;
+        ++$count;
+        $count--;
+
+        $validNot = !$ready;
+        $validSilenced = @$callable();
+        ++$count;
+        $count++;
+
+        return (int)$not + (int)$silenced + $flipped + $count + (int)$validNot + (int)$validSilenced;
+    }
+}
diff --git a/tests/_data/ImplicitCastSpacing/before.php b/tests/_data/ImplicitCastSpacing/before.php
new file mode 100644
index 0000000..d2f31d9
--- /dev/null
+++ b/tests/_data/ImplicitCastSpacing/before.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class ImplicitCastSpacingExample
+{
+    public function run(bool $ready, int $count, int $mask, callable $callable): int
+    {
+        $not = ! $ready;
+        $silenced = @ $callable();
+        $flipped = ~ $mask;
+        ++ $count;
+        $count --;
+
+        $validNot = !$ready;
+        $validSilenced = @$callable();
+        ++$count;
+        $count++;
+
+        return (int)$not + (int)$silenced + $flipped + $count + (int)$validNot + (int)$validSilenced;
+    }
+}
diff --git a/tests/_data/MethodDeclaration/after.php b/tests/_data/MethodDeclaration/after.php
new file mode 100644
index 0000000..b8da889
--- /dev/null
+++ b/tests/_data/MethodDeclaration/after.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+abstract class MethodDeclarationExample
+{
+    final public function finalAfterVisibility(): void
+    {
+    }
+
+    abstract public function abstractAfterVisibility(): void;
+
+    public static function staticBeforeVisibility(): void
+    {
+    }
+
+    final private function finalPrivate(): void
+    {
+    }
+
+    final public static function validOrder(): void
+    {
+    }
+}
diff --git a/tests/_data/MethodDeclaration/before.php b/tests/_data/MethodDeclaration/before.php
new file mode 100644
index 0000000..b1753a0
--- /dev/null
+++ b/tests/_data/MethodDeclaration/before.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+abstract class MethodDeclarationExample
+{
+    public final function finalAfterVisibility(): void
+    {
+    }
+
+    public abstract function abstractAfterVisibility(): void;
+
+    static public function staticBeforeVisibility(): void
+    {
+    }
+
+    private final function finalPrivate(): void
+    {
+    }
+
+    final public static function validOrder(): void
+    {
+    }
+}
diff --git a/tests/_data/Mock/after.php b/tests/_data/Mock/after.php
new file mode 100644
index 0000000..5ef1b05
--- /dev/null
+++ b/tests/_data/Mock/after.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+use PHPUnit\Framework\MockObject\MockObject;
+use RuntimeException;
+
+class MockExampleTest
+{
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function missingMockReturnType()
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function invalidTypehint()
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function missingTypeHint(): Service
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|Repository|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function complexMockMustNotHaveTypeHint(): Service
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return \PHPUnit\Framework\MockObject\MockObject
+     */
+    public function missingMockedClass()
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function validMock(): Service
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return RuntimeException
+     */
+    public function nonMockReturnType(): RuntimeException
+    {
+        return new RuntimeException('valid');
+    }
+}
+
+class Service
+{
+}
+
+class Repository
+{
+}
diff --git a/tests/_data/Mock/before.php b/tests/_data/Mock/before.php
new file mode 100644
index 0000000..5d39eb7
--- /dev/null
+++ b/tests/_data/Mock/before.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+use PHPUnit\Framework\MockObject\MockObject;
+use RuntimeException;
+
+class MockExampleTest
+{
+    /**
+     * @return Service
+     */
+    public function missingMockReturnType(): MockObject
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function invalidTypehint(): MockObject
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function missingTypeHint()
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|Repository|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function complexMockMustNotHaveTypeHint(): Service
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return \PHPUnit\Framework\MockObject\MockObject
+     */
+    public function missingMockedClass()
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return Service|\PHPUnit\Framework\MockObject\MockObject
+     */
+    public function validMock(): Service
+    {
+        return $this->createMock(Service::class);
+    }
+
+    /**
+     * @return RuntimeException
+     */
+    public function nonMockReturnType(): RuntimeException
+    {
+        return new RuntimeException('valid');
+    }
+}
+
+class Service
+{
+}
+
+class Repository
+{
+}
diff --git a/tests/_data/TernarySpacing/after.php b/tests/_data/TernarySpacing/after.php
new file mode 100644
index 0000000..ce75cef
--- /dev/null
+++ b/tests/_data/TernarySpacing/after.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class TernarySpacingExample
+{
+    public function format(bool $first, bool $second, string $value): string
+    {
+        $missingBefore = $first ? 'yes' : 'no';
+        $missingAfter = $first ? 'yes' : 'no';
+        $missingElseBefore = $first ? 'yes' : 'no';
+        $missingElseAfter = $first ? 'yes' : 'no';
+        $tooManyBefore = $first ? 'yes' : 'no';
+        $tooManyAfter = $first ? 'yes' : 'no';
+        $short = $value ?: 'fallback';
+
+        $valid = $second ? 'left' : 'right';
+        $validShort = $value ?: 'fallback';
+        $multiline = $first
+            ? 'yes'
+            : 'no';
+
+        return $missingBefore . $missingAfter . $missingElseBefore . $missingElseAfter . $tooManyBefore . $tooManyAfter . $short . $valid . $validShort . $multiline;
+    }
+}
diff --git a/tests/_data/TernarySpacing/before.php b/tests/_data/TernarySpacing/before.php
new file mode 100644
index 0000000..58d3248
--- /dev/null
+++ b/tests/_data/TernarySpacing/before.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpCollective;
+
+class TernarySpacingExample
+{
+    public function format(bool $first, bool $second, string $value): string
+    {
+        $missingBefore = $first? 'yes' : 'no';
+        $missingAfter = $first ?'yes' : 'no';
+        $missingElseBefore = $first ? 'yes': 'no';
+        $missingElseAfter = $first ? 'yes' :'no';
+        $tooManyBefore = $first  ? 'yes' : 'no';
+        $tooManyAfter = $first ?  'yes' : 'no';
+        $short = $value ? : 'fallback';
+
+        $valid = $second ? 'left' : 'right';
+        $validShort = $value ?: 'fallback';
+        $multiline = $first
+            ? 'yes'
+            : 'no';
+
+        return $missingBefore . $missingAfter . $missingElseBefore . $missingElseAfter . $tooManyBefore . $tooManyAfter . $short . $valid . $validShort . $multiline;
+    }
+}