Fix false positive in DocBlockVarSniff for array property types.

Resolves issue where the sniff incorrectly reported errors for array properties using alternative syntax like string[], int[], or array<K,V> in doc blocks when the property was typed as array.

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

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

Author: dereuromark

PhpCollective/Sniffs/Commenting/DocBlockVarSniff.php

@@ -406,6 +406,11 @@ protected function typesMatch(File $phpCsFile, string $docBlockType, string $pro
             return true;
         }
 
+        // Check if property type is 'array' and doc block contains array syntax
+        if ($propertyType === 'array' && $this->containsTypeArray([$docBlockType])) {
+            return true;
+        }
+
         // Get use statements
         $useStatements = $this->getUseStatements($phpCsFile);
 

tests/_data/DocBlockVar/after.php

@@ -32,7 +32,7 @@ class FixMe
      *
      * @var list<string|null>
      */
-    protected $left = [];
+    protected array $left = [];
 
     /**
      * @var \Tools\Mailer\Message
@@ -48,4 +48,26 @@ class FixMe
      * @var \Yet\Another\Thing
      */
     protected AnotherAlias $another;
+
+    /**
+     * @var string[]
+     */
+    protected array $fixtures = [
+        'plugin.QueueScheduler.SchedulerRows',
+    ];
+
+    /**
+     * @var int[]
+     */
+    protected array $numbers = [1, 2, 3];
+
+    /**
+     * @var array<string, mixed>
+     */
+    protected array $config = [];
+
+    /**
+     * @var MyClass[]
+     */
+    protected array $objects;
 }

tests/_data/DocBlockVar/before.php

@@ -32,7 +32,7 @@ class FixMe
      *
      * @var list<string|null>
      */
-    protected $left = [];
+    protected array $left = [];
 
     /**
      * @var \Tools\Mailer\Message
@@ -48,4 +48,26 @@ class FixMe
      * @var \Yet\Another\Thing
      */
     protected AnotherAlias $another;
+
+    /**
+     * @var string[]
+     */
+    protected array $fixtures = [
+        'plugin.QueueScheduler.SchedulerRows',
+    ];
+
+    /**
+     * @var int[]
+     */
+    protected array $numbers = [1, 2, 3];
+
+    /**
+     * @var array<string, mixed>
+     */
+    protected array $config = [];
+
+    /**
+     * @var MyClass[]
+     */
+    protected array $objects;
 }