CallableNodeVisitor.php

<?php

declare(strict_types=1);

namespace Rector\PhpDocParser\NodeVisitor;

use PhpParser\Node;
use PhpParser\Node\Expr;
use PhpParser\Node\Stmt;
use PhpParser\Node\Stmt\Expression;
use PhpParser\NodeVisitor;
use PhpParser\NodeVisitorAbstract;

final class CallableNodeVisitor extends NodeVisitorAbstract
{
    /**
     * @var callable(Node): (int|Node|null|Node[])
     */
    private $callable;

    /**
     * @param callable(Node $node): (int|Node|null|Node[]) $callable
     */
    public function __construct(callable $callable)
    {
        $this->callable = $callable;
    }

    /**
     * @return NodeVisitor::*|Node|null|Node[]
     */
    public function enterNode(Node $node): int|Node|null|array
    {
        $originalNode = $node;

        $callable = $this->callable;

        /** @var NodeVisitor::*|Node|null|Node[] $newNode */
        $newNode = $callable($node);

        if ($originalNode instanceof Stmt && $newNode instanceof Expr) {
            return new Expression($newNode);
        }

        return $newNode;
    }
}