[AutoImport] Handle FQCN in/not in use on auto import + remove unused import

Author: samsonasik

rules/TypeDeclaration/PHPStan/ObjectTypeSpecifier.php

@@ -51,14 +51,16 @@ public function narrowToFullyQualifiedOrAliasedObjectType(
 
         $uses = $this->useImportsResolver->resolve();
 
-        $aliasedObjectType = $this->matchAliasedObjectType($objectType, $uses);
-        if ($aliasedObjectType instanceof AliasedObjectType) {
-            return $aliasedObjectType;
-        }
+        if (! $withPreslash) {
+            $aliasedObjectType = $this->matchAliasedObjectType($objectType, $uses);
+            if ($aliasedObjectType instanceof AliasedObjectType) {
+                return $aliasedObjectType;
+            }
 
-        $shortenedObjectType = $this->matchShortenedObjectType($objectType, $uses);
-        if ($shortenedObjectType !== null) {
-            return $shortenedObjectType;
+            $shortenedObjectType = $this->matchShortenedObjectType($objectType, $uses);
+            if ($shortenedObjectType !== null) {
+                return $shortenedObjectType;
+            }
         }
 
         if ($this->reflectionProvider->hasClass($className)) {

stubs/Carbon/CarbonInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Carbon;
+
+if (interface_exists('Carbon\CarbonInterface')) {
+    return;
+}
+
+interface CarbonInterface
+{
+
+}

tests/Issues/NamespacedUseAutoImport/Fixture/in_use_fqcn_docblock.php.inc

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\Issues\NamespacedUseAutoImport\Fixture;
+
+use Carbon\Carbon;
+use Carbon\CarbonInterface;
+
+/**
+ * @property \Carbon\CarbonInterface|null $deleted_at
+ */
+class InUseFqcnDocblock
+{
+    /**
+     * @return CarbonInterface[]
+     */
+    public function demoFunction(): array
+    {
+        return [Carbon::parse('2026-01-01 11:16:01')];
+    }
+}
+
+?>
+-----
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\Issues\NamespacedUseAutoImport\Fixture;
+
+use Carbon\Carbon;
+use Carbon\CarbonInterface;
+
+/**
+ * @property CarbonInterface|null $deleted_at
+ */
+class InUseFqcnDocblock
+{
+    /**
+     * @return CarbonInterface[]
+     */
+    public function demoFunction(): array
+    {
+        return [Carbon::parse('2026-01-01 11:16:01')];
+    }
+}
+
+?>

…ged_import_property_annotation_2.php.inc …Fixture/not_in_use_fqcn_docblock.php.inctests/Issues/NamespacedUseAutoImport/Fixture/merged_import_property_annotation_2.php.inc renamed to tests/Issues/NamespacedUseAutoImport/Fixture/not_in_use_fqcn_docblock.php.inc tests/Issues/NamespacedUseAutoImport/Fixture/merged_import_property_annotation_2.php.inc renamed to tests/Issues/NamespacedUseAutoImport/Fixture/not_in_use_fqcn_docblock.php.inc

@@ -10,7 +10,7 @@ use Carbon\CarbonInterface;
 /**
  * @property \Carbon\CarbonInterface|null $deleted_at
  */
-class MergedImportErrorOtherVariety
+class NotInUseFqcnDocblock
 {
     public function demoFunction(): array
     {
@@ -32,7 +32,7 @@ use Carbon\CarbonInterface;
 /**
  * @property CarbonInterface|null $deleted_at
  */
-class MergedImportErrorOtherVariety
+class NotInUseFqcnDocblock
 {
     public function demoFunction(): array
     {

…erged_import_property_annotation.php.inc …t/Fixture/not_in_use_fqcn_docblock_2.inctests/Issues/NamespacedUseAutoImport/Fixture/merged_import_property_annotation.php.inc renamed to tests/Issues/NamespacedUseAutoImport/Fixture/not_in_use_fqcn_docblock_2.inc tests/Issues/NamespacedUseAutoImport/Fixture/merged_import_property_annotation.php.inc renamed to tests/Issues/NamespacedUseAutoImport/Fixture/not_in_use_fqcn_docblock_2.inc

@@ -10,7 +10,7 @@ use Carbon\CarbonInterface;
 /**
  * @property \Carbon\CarbonInterface|null $deleted_at
  */
-class MergedImportError
+class NotInUseFqcnDocblock2
 {
     public function demoFunction(): array
     {
@@ -27,12 +27,11 @@ declare(strict_types=1);
 namespace Rector\Tests\Issues\NamespacedUseAutoImport\Fixture;
 
 use Carbon\Carbon;
-use Carbon\CarbonInterface;
 
 /**
  * @property CarbonInterface|null $deleted_at
  */
-class MergedImportError
+class NotInUseFqcnDocblock2
 {
     public function demoFunction(): array
     {