Fix false positive in DocBlockVarSniff for class aliases.

Resolves issue where properties using class aliases from use statements
incorrectly triggered doc block type errors. Added typesMatch() method
to properly compare doc block types with typed properties by resolving
aliases through use statements.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: dereuromark

PhpCollective/Sniffs/Commenting/DocBlockVarSniff.php

@@ -11,6 +11,7 @@
 use PHP_CodeSniffer\Util\Tokens;
 use PhpCollective\Sniffs\AbstractSniffs\AbstractSniff;
 use PhpCollective\Traits\CommentingTrait;
+use PhpCollective\Traits\UseStatementsTrait;
 
 /**
  * Ensures Doc Blocks for variables exist and are correct.
@@ -21,6 +22,7 @@
 class DocBlockVarSniff extends AbstractSniff
 {
     use CommentingTrait;
+    use UseStatementsTrait;
 
     /**
      * @inheritDoc
@@ -377,7 +379,7 @@ protected function handleDefaultValue(
     protected function handleTypes(File $phpCsFile, int $stackPointer, array $types, mixed $content, string $appendix, int $classNameIndex): void
     {
         foreach ($types as $type) {
-            if (str_contains($content, $type)) {
+            if ($this->typesMatch($phpCsFile, $content, $type)) {
                 continue;
             }
 
@@ -387,4 +389,35 @@ protected function handleTypes(File $phpCsFile, int $stackPointer, array $types,
             }
         }
     }
+
+    /**
+     * Check if two types match, considering use statement aliases.
+     *
+     * @param \PHP_CodeSniffer\Files\File $phpCsFile
+     * @param string $docBlockType
+     * @param string $propertyType
+     *
+     * @return bool
+     */
+    protected function typesMatch(File $phpCsFile, string $docBlockType, string $propertyType): bool
+    {
+        // Direct match
+        if (str_contains($docBlockType, $propertyType)) {
+            return true;
+        }
+
+        // Get use statements
+        $useStatements = $this->getUseStatements($phpCsFile);
+
+        // Check if the property type is an alias
+        if (isset($useStatements[$propertyType])) {
+            $fullClassName = $useStatements[$propertyType]['fullName'];
+            // Check if doc block contains the full class name (with or without leading backslash)
+            if (str_contains($docBlockType, '\\' . $fullClassName) || str_contains($docBlockType, $fullClassName)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
 }

tests/_data/DocBlockVar/after.php

@@ -2,6 +2,10 @@
 
 namespace PhpCollective;
 
+use Tools\Mailer\Message as MailerMessage;
+use Some\Other\Class;
+use Yet\Another\Thing as AnotherAlias;
+
 class FixMe
 {
     protected $x = [];
@@ -29,4 +33,19 @@ class FixMe
      * @var list<string|null>
      */
     protected $left = [];
+
+    /**
+     * @var \Tools\Mailer\Message
+     */
+    protected MailerMessage $message;
+
+    /**
+     * @var \Some\Other\Class
+     */
+    protected Class $class;
+
+    /**
+     * @var \Yet\Another\Thing
+     */
+    protected AnotherAlias $another;
 }

tests/_data/DocBlockVar/before.php

@@ -2,6 +2,10 @@
 
 namespace PhpCollective;
 
+use Tools\Mailer\Message as MailerMessage;
+use Some\Other\Class;
+use Yet\Another\Thing as AnotherAlias;
+
 class FixMe
 {
     protected $x = [];
@@ -29,4 +33,19 @@ class FixMe
      * @var list<string|null>
      */
     protected $left = [];
+
+    /**
+     * @var \Tools\Mailer\Message
+     */
+    protected MailerMessage $message;
+
+    /**
+     * @var \Some\Other\Class
+     */
+    protected Class $class;
+
+    /**
+     * @var \Yet\Another\Thing
+     */
+    protected AnotherAlias $another;
 }