[docs] add specific example how to iterate stmts of namespaced and non-namespaced file

Author: TomasVotruba

UPGRADING.md

@@ -1,7 +1,7 @@
 # Upgrading from Rector 2.2.14 to 2.3
 
 * `FileWithoutNamespace` is deprecated, and replaced by `FileNode` that represents both namespaced and non-namespaced files and allow changes inside
-* `beforeTraverse()` is now soft marked as `@final`, use `getNodeTypes()` with `FileNode::class` instead
+* `beforeTraverse()` is now marked as `@final`, use `getNodeTypes()` with `FileNode::class` instead
 
 **Before**
 
@@ -67,10 +67,40 @@ final class SomeRector extends AbstractRector
 }
 ```
 
-The `FileNode` handles both namespaced and non-namespaced files. To check if the file is namespaced, use:
+<br>
+
+The `FileNode` handles both namespaced and non-namespaced files. To handle the first stmts inside the file, you hook into 2 nodes:
 
 ```php
-$fileNode->isNamespaced();
+use Rector\PhpParser\Node\FileNode;
+use Rector\Rector\AbstractRector;
+use PhpParser\Node\Stmt\Namespace_;
+
+final class SomeRector extends AbstractRector
+{
+    public function getNodeTypes(): array
+    {
+        return [FileNode::class, Namespace_::class];
+    }
+
+    /**
+     * @param FileNode|Namespace_ $node
+     */
+    public function refactor(Node $node): ?Node
+    {
+        if ($node instanceof FileNode && $node->isNamespaced()) {
+            // handled in the Namespace_ node
+            return null;
+        }
+
+        foreach ($node->stmts as $stmt) {
+            // modify stmts in desired way here
+        }
+
+        return $node;
+    }
+
+}
 ```
 
 <br>

composer-dependency-analyser.php

@@ -17,8 +17,6 @@
     // ensure use version ^3.2.0
     ->ignoreErrorsOnPackage('composer/pcre', [ErrorType::UNUSED_DEPENDENCY])
 
-    ->ignoreErrorsOnPath(__DIR__ . '/src/Reporting/DeprecatedRulesReporter.php', [ErrorType::UNKNOWN_CLASS])
-
     ->ignoreErrorsOnPaths([
         __DIR__ . '/stubs',
         __DIR__ . '/tests',

src/PhpParser/Node/CustomNode/FileWithoutNamespace.php

@@ -4,7 +4,6 @@
 
 namespace Rector\PhpParser\Node\CustomNode;
 
-use PhpParser\Node\Stmt;
 use Rector\Contract\PhpParser\Node\StmtsAwareInterface;
 use Rector\PhpParser\Node\FileNode;
 
@@ -16,14 +15,6 @@
  */
 final class FileWithoutNamespace extends FileNode implements StmtsAwareInterface
 {
-    /**
-     * @param Stmt[] $stmts
-     */
-    public function __construct(array $stmts)
-    {
-        parent::__construct($stmts);
-    }
-
     public function getType(): string
     {
         return 'FileWithoutNamespace';

src/Reporting/DeprecatedRulesReporter.php

@@ -10,16 +10,6 @@
 use Rector\Contract\PhpParser\Node\StmtsAwareInterface;
 use Rector\Contract\Rector\RectorInterface;
 use Rector\PhpParser\Enum\NodeGroup;
-<<<<<<< HEAD
-<<<<<<< HEAD
-use Rector\PhpParserNode\FileNode;
-=======
-<<<<<<< HEAD
->>>>>>> 6bcee47e76 (warn about deprecated type)
-use ReflectionMethod;
-=======
-=======
->>>>>>> 00c8276150 (print stmts with false)
 use Rector\PhpParser\Node\CustomNode\FileWithoutNamespace;
 use Rector\PhpParser\Node\FileNode;
 use ReflectionMethod;