Remove private functions

accessTag.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace PhpStubs\WordPress\Reflection\DocBlock\Tag;
+
+require_once(__DIR__ . '/vendor/autoload.php');
+
+use phpDocumentor\Reflection\DocBlockFactory;
+use phpDocumentor\Reflection\DocBlock\Description;
+use phpDocumentor\Reflection\DocBlock\DescriptionFactory;
+use phpDocumentor\Reflection\DocBlock\Tags\BaseTag;
+use phpDocumentor\Reflection\Types\Context;
+use Webmozart\Assert\Assert;
+
+final class Access extends BaseTag
+{
+    protected $name = 'access';
+
+    public function __construct(Description $description = null)
+    {
+        $this->description = $description;
+    }
+
+    public static function create(string $body, DescriptionFactory $descriptionFactory = null, ?Context $context = null): self
+    {
+        Assert::notNull($descriptionFactory);
+        return new static($descriptionFactory->create($body, $context));
+    }
+
+    public function __toString(): string
+    {
+        return (string)$this->description;
+    }
+}
+
+$factory = DocBlockFactory::createInstance(['access' => Access::class]);

composer.json

@@ -14,7 +14,8 @@
         "php-stubs/generator": "^0.8.3",
         "phpdocumentor/reflection-docblock": "^5.3",
         "phpstan/phpstan": "^1.9",
-        "phpunit/phpunit": "^9.5"
+        "phpunit/phpunit": "^9.5",
+        "webmozart/assert": "^1.11.0"
     },
     "suggest": {
         "paragonie/sodium_compat": "Pure PHP implementation of libsodium",
@@ -23,7 +24,8 @@
     },
     "autoload-dev": {
         "classmap": [
-            "tests/"
+            "tests/",
+            "accessTag.php"
         ]
     },
     "minimum-stability": "stable",

phpstan.neon

@@ -1,6 +1,7 @@
 parameters:
     level: 8
     paths:
+        - accessTag.php
         - finder.php
         - visitor.php
         - tests/

visitor.php

@@ -4,6 +4,7 @@
 
 use phpDocumentor\Reflection\DocBlock;
 use phpDocumentor\Reflection\DocBlock\Description;
+use phpDocumentor\Reflection\DocBlock\Tag;
 use phpDocumentor\Reflection\DocBlock\Tags\Param;
 use phpDocumentor\Reflection\DocBlock\Tags\Return_;
 use phpDocumentor\Reflection\DocBlock\Tags\Var_;
@@ -15,6 +16,7 @@
 use PhpParser\Node\Stmt\ClassMethod;
 use PhpParser\Node\Stmt\Function_;
 use PhpParser\Node\Stmt\Property;
+use PhpParser\NodeTraverser;
 use StubsGenerator\NodeVisitor;
 
 abstract class WithChildren
@@ -296,6 +298,11 @@ public function enterNode(Node $node)
             $this->additionalTags[ $symbolName ] = $additions;
         }
 
+        if ($this->isPrivateFunction($node) === true) {
+            $node->setAttribute('isPrivateFunction', true);
+            return null;
+        }
+
         $additions = $this->getAdditionalTagsFromMap($symbolName);
 
         if (count($additions) > 0) {
@@ -305,6 +312,17 @@ public function enterNode(Node $node)
         return null;
     }
 
+    public function leaveNode(Node $node, bool $preserveStack = false)
+    {
+        if ($node->getAttribute('isPrivateFunction') === true) {
+            if (!$preserveStack) {
+                array_pop($this->stack);
+            }
+            return NodeTraverser::REMOVE_NODE;
+        }
+        return parent::leaveNode($node, $preserveStack);
+    }
+
     private static function getNodeName(Node $node): string
     {
         if ((($node instanceof Function_) || ($node instanceof ClassMethod) || ($node instanceof Class_)) && $node->name instanceof Identifier) {
@@ -889,4 +907,26 @@ private static function isOptional(string $description): bool
             || (stripos($description, 'Defaults to ') !== false)
         ;
     }
+
+    private function isPrivateFunction(Node $node): bool
+    {
+        if (!($node instanceof Function_)) {
+            return false;
+        }
+
+        $docComment = $node->getDocComment();
+        if (!($docComment instanceof Doc)) {
+            return false;
+        }
+
+        $docblock = $this->docBlockFactory->create($docComment->getText());
+        $access = array_map(
+            static function (Tag $tag): string {
+                return $tag->__toString();
+            },
+            $docblock->getTagsByName('access')
+        );
+
+        return in_array('private', $access, true);
+    }
 };