[stmts-aware] Deprecate the interface and replace with meta-type + groups

[TomasVotruba]

First step to solve rectorphp/rector#9416

This PR:

• deprecates Rector\Contract\PhpParser\Node\StmtsAwareInterface used in /vendor patches
• replaces its use with PhpParser\Node + PHPStan meta type
• removes need of /vendor patching and preload (to be tested first, patches will remain for now to inform about deprecation) - this has been huge pain past 4 years, time to solve it 💪

Next steps before merge:

• remove this interface from rector/rector-* packages

How to upgrade custom rules?

If you're using StmtsAwareInterface, there are 2 changes needed. First, update your Rector rule:

 public function getNodeTypes(): array
 {
-    return [StmtsAwareInterface::class];
+    return \Rector\PhpParser\Enum\NodeGroup::STMTS_AWARE;
}


     /**
-     * @param StmtsAwareInterface $node
+     * @param StmtsAware $node
      */
     public function refactor(Node $node): ?Node
     {
+           // check property stmts exists, e.g. propery_exists($node, 'stmts')
+           // or using Assert::propertyExists(...)
     }

In case you're using the interface in instanceof check, upgrade this way:

-    if (! $stmt instanceof StmtsAwareInterface) {
+    if (! NodeGroup::isStmtAwareNode($stmt)) {
             return;
         }

Second, get help from PHPStan with the union type analysis. The StmtsAware is a special global alias PHPStan type, that have to be added to phpstan.neon.

This will allow to static analysis to work as previously:

parameters:
    typeAliases:
        StmtsAware: \PhpParser\Node\Expr\Closure | \PhpParser\Node\Stmt\Case_ | \PhpParser\Node\Stmt\Catch_ | \PhpParser\Node\Stmt\ClassMethod | \PhpParser\Node\Stmt\Do_ | \PhpParser\Node\Stmt\Else_ | \PhpParser\Node\Stmt\ElseIf_ | \PhpParser\Node\Stmt\Finally_ | \PhpParser\Node\Stmt\For_ | \PhpParser\Node\Stmt\Foreach_ | \PhpParser\Node\Stmt\Function_ | \PhpParser\Node\Stmt\If_ | \PhpParser\Node\Stmt\Namespace_ | \PhpParser\Node\Stmt\TryCatch | \PhpParser\Node\Stmt\While_

[samsonasik]

For this PR, this should keep implements StmtsAwareInterface as it not yet update composer.json patch.

There should be no down in the process as possible before it actually fully migrated.

[TomasVotruba]

Good point. Will add it 👍

[TomasVotruba]

Let's go 👍

[samsonasik]

see my review comment #7679 (review)

[TomasVotruba]

Done 09bd026