[config] add registerDecoratingNodeVisitor()

Author: TomasVotruba

src/Configuration/RectorConfigBuilder.php

@@ -18,11 +18,13 @@
 use Rector\Configuration\Levels\LevelRulesResolver;
 use Rector\Configuration\Parameter\SimpleParameterProvider;
 use Rector\Console\Notifier;
+use Rector\Contract\PhpParser\DecoratingNodeVisitorInterface;
 use Rector\Contract\Rector\ConfigurableRectorInterface;
 use Rector\Contract\Rector\RectorInterface;
 use Rector\Doctrine\Set\DoctrineSetList;
 use Rector\Enum\Config\Defaults;
 use Rector\Exception\Configuration\InvalidConfigurationException;
+use Rector\NodeTypeResolver\PHPStan\Scope\Contract\NodeVisitor\ScopeResolverNodeVisitorInterface;
 use Rector\Php\PhpVersionResolver\ComposerJsonPhpVersionResolver;
 use Rector\Php80\Rector\Class_\AnnotationToAttributeRector;
 use Rector\Php80\ValueObject\AnnotationToAttribute;
@@ -1217,11 +1219,31 @@ public function withTreatClassesAsFinal(bool $isTreatClassesAsFinal = true): sel
 
     public function registerService(string $className, ?string $alias = null, ?string $tag = null): self
     {
+        // BC layer since 2.2.9
+        if ($tag === ScopeResolverNodeVisitorInterface::class) {
+            $tag = DecoratingNodeVisitorInterface::class;
+        }
+
         $this->registerServices[] = new RegisteredService($className, $alias, $tag);
 
         return $this;
     }
 
+    /**
+     * DX helper
+     * @see https://getrector.com/documentation/creating-a-node-visitor
+     */
+    public function registerDecoratingNodeVisitor(string $decoratingNodeVisitorClass): self
+    {
+        Assert::isAOf($decoratingNodeVisitorClass, DecoratingNodeVisitorInterface::class);
+        $this->registerServices[] = new RegisteredService(
+            $decoratingNodeVisitorClass,
+            null,
+            DecoratingNodeVisitorInterface::class
+        );
+        return $this;
+    }
+
     public function withDowngradeSets(
         bool $php84 = false,
         bool $php83 = false,

src/NodeTypeResolver/PHPStan/Scope/Contract/NodeVisitor/ScopeResolverNodeVisitorInterface.php

@@ -4,12 +4,11 @@
 
 namespace Rector\NodeTypeResolver\PHPStan\Scope\Contract\NodeVisitor;
 
+use JetBrains\PhpStorm\Deprecated;
 use PhpParser\NodeVisitor;
-use Rector\Contract\PhpParser\DecoratingNodeVisitorInterface;
 
 /**
- * @deprecated Use
- * @see DecoratingNodeVisitorInterface instead
+ * @deprecated Since 2.2.9. Use \Rector\Contract\PhpParser\DecoratingNodeVisitorInterface instead
  */
 interface ScopeResolverNodeVisitorInterface extends NodeVisitor
 {