[TypeDeclaration] Add ReturnTypeFromStrictNewArrayRector (#2572)

Co-authored-by: GitHub Action <action@github.com>

build/target-repository/docs/rector_rules_overview.md

@@ -1,4 +1,4 @@
-# 519 Rules Overview
+# 520 Rules Overview
 
 <br>
 
@@ -94,7 +94,7 @@
 
 - [Transform](#transform) (36)
 
-- [TypeDeclaration](#typedeclaration) (28)
+- [TypeDeclaration](#typedeclaration) (29)
 
 - [Visibility](#visibility) (3)
 
@@ -11908,6 +11908,27 @@ Add strict return type based native function return
 
 <br>
 
+### ReturnTypeFromStrictNewArrayRector
+
+Add strict return array type based on created empty array and returned
+
+- class: [`Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector`](../rules/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector.php)
+
+```diff
+ final class SomeClass
+ {
+-    public function run()
++    public function run(): array
+     {
+         $values = [];
+
+         return $values;
+     }
+ }
+```
+
+<br>
+
 ### ReturnTypeFromStrictTypedCallRector
 
 Add return type from strict return type of call

config/set/type-declaration-strict.php

@@ -10,6 +10,7 @@
 use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromReturnNewRector;
 use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictBoolReturnExprRector;
 use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNativeFuncCallRector;
+use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector;
 use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictTypedCallRector;
 use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictTypedPropertyRector;
 use Rector\TypeDeclaration\Rector\Closure\AddClosureReturnTypeRector;
@@ -32,4 +33,5 @@
         ReturnTypeFromStrictBoolReturnExprRector::class,
     ]);
     $rectorConfig->rule(ReturnTypeFromStrictNativeFuncCallRector::class);
+    $rectorConfig->rule(ReturnTypeFromStrictNewArrayRector::class);
 };

rector.php

@@ -35,7 +35,7 @@
     $rectorConfig->ruleWithConfiguration(
         PreferThisOrSelfMethodCallRector::class,
         [
-            'PHPUnit\Framework\TestCase' => PreferenceSelfThis::PREFER_THIS(),
+            'PHPUnit\Framework\TestCase' => PreferenceSelfThis::PREFER_THIS,
         ]
     );
 

rules-tests/CodingStyle/Rector/MethodCall/PreferThisOrSelfMethodCallRector/config/configured_rule.php

@@ -13,8 +13,8 @@
 return static function (RectorConfig $rectorConfig): void {
     $rectorConfig
         ->ruleWithConfiguration(PreferThisOrSelfMethodCallRector::class, [
-            SomeAbstractTestCase::class => PreferenceSelfThis::PREFER_SELF(),
-            BeLocalClass::class => PreferenceSelfThis::PREFER_THIS(),
-            TestCase::class => PreferenceSelfThis::PREFER_SELF(),
+            SomeAbstractTestCase::class => PreferenceSelfThis::PREFER_SELF,
+            BeLocalClass::class => PreferenceSelfThis::PREFER_THIS,
+            TestCase::class => PreferenceSelfThis::PREFER_SELF,
         ]);
 };

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/Fixture/return_override_with_array.php.inc

@@ -0,0 +1,35 @@
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class ReturnOverrideWithArray
+{
+    public function run()
+    {
+        $values = [];
+
+        $values = [1000];
+
+        return $values;
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class ReturnOverrideWithArray
+{
+    public function run(): array
+    {
+        $values = [];
+
+        $values = [1000];
+
+        return $values;
+    }
+}
+
+?>

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/Fixture/skip_override.php.inc

@@ -0,0 +1,15 @@
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class SkipOverride
+{
+    public function run()
+    {
+        $values = [];
+
+        $values = 100;
+
+        return $values;
+    }
+}

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/Fixture/skip_two_returns.php.inc

@@ -0,0 +1,17 @@
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class SkipTwoReturns
+{
+    public function run()
+    {
+        $values = [];
+
+        if (mt_rand(1, 2)) {
+            return $values;
+        }
+
+        return null;
+    }
+}

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/Fixture/some_class.php.inc

@@ -0,0 +1,31 @@
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class SomeClass
+{
+    public function run()
+    {
+        $values = [];
+
+        return $values;
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector\Fixture;
+
+final class SomeClass
+{
+    public function run(): array
+    {
+        $values = [];
+
+        return $values;
+    }
+}
+
+?>

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/ReturnTypeFromStrictNewArrayRectorTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector;
+
+use Iterator;
+use Rector\Testing\PHPUnit\AbstractRectorTestCase;
+use Symplify\SmartFileSystem\SmartFileInfo;
+
+final class ReturnTypeFromStrictNewArrayRectorTest extends AbstractRectorTestCase
+{
+    /**
+     * @dataProvider provideData()
+     */
+    public function test(SmartFileInfo $fileInfo): void
+    {
+        $this->doTestFileInfo($fileInfo);
+    }
+
+    /**
+     * @return Iterator<SmartFileInfo>
+     */
+    public function provideData(): Iterator
+    {
+        return $this->yieldFilesFromDirectory(__DIR__ . '/Fixture');
+    }
+
+    public function provideConfigFilePath(): string
+    {
+        return __DIR__ . '/config/configured_rule.php';
+    }
+}

rules-tests/TypeDeclaration/Rector/ClassMethod/ReturnTypeFromStrictNewArrayRector/config/configured_rule.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\TypeDeclaration\Rector\ClassMethod\ReturnTypeFromStrictNewArrayRector;
+
+return static function (RectorConfig $rectorConfig): void {
+    $rectorConfig->rule(ReturnTypeFromStrictNewArrayRector::class);
+};