[TypeDeclaration] Remove and disable breaking ReturnTypeDeclarationRe…

…ctor, use split rules instead (#3120)

build/target-repository/docs/rector_rules_overview.md

@@ -1,4 +1,4 @@
-# 405 Rules Overview
+# 406 Rules Overview
 
 <br>
 
@@ -64,7 +64,7 @@
 
 - [Transform](#transform) (34)
 
-- [TypeDeclaration](#typedeclaration) (33)
+- [TypeDeclaration](#typedeclaration) (34)
 
 - [Visibility](#visibility) (3)
 
@@ -8971,6 +8971,28 @@ Add missing return type declaration based on parent class method
 
 <br>
 
+### AddReturnTypeDeclarationFromYieldsRector
+
+Add return type declarations from yields
+
+- class: [`Rector\TypeDeclaration\Rector\FunctionLike\AddReturnTypeDeclarationFromYieldsRector`](../rules/TypeDeclaration/Rector/FunctionLike/AddReturnTypeDeclarationFromYieldsRector.php)
+
+```diff
+ class SomeClass
+ {
+-    public function provide()
++    /**
++     * @return Iterator<int>
++     */
++    public function provide(): Iterator
+     {
+         yield 1;
+     }
+ }
+```
+
+<br>
+
 ### AddReturnTypeDeclarationRector
 
 Changes defined return typehint of method and class.

composer.json

@@ -105,7 +105,6 @@
             "stubs/Doctrine/Persistence/ObjectManager.php",
             "stubs/Doctrine/Common/Persistence/ObjectManager.php",
             "rules-tests/Transform/Rector/FuncCall/FuncCallToMethodCallRector/Source/some_view_function.php",
-            "rules-tests/TypeDeclaration/Rector/FunctionLike/ReturnTypeDeclarationRector/Source/MyBar.php",
             "rules-tests/TypeDeclaration/Rector/ClassMethod/ParamTypeByMethodCallTypeRector/Source/FunctionTyped.php"
         ]
     },

easy-ci.php

@@ -96,5 +96,8 @@
         NamespacedNameDecorator::class,
         NamedVariableFactory::class,
         BinaryOpTreeRootLocator::class,
+
+        // create own rule to handle this
+        \Rector\TypeDeclaration\PhpDocParser\NonInformativeReturnTagRemover::class,
     ]);
 };