Recognize @phpstan-pure-unless-callable-is-impure as a known tag

InvalidPHPStanDocTagRule matches @phpstan-* tags by name against a
hardcoded list, so native phpdoc-parser recognition does not exempt
them. @phpstan-pure-unless-callable-is-impure was never added to that
list and is currently reported as an unknown tag; add it alongside
@phpstan-pure-unless-parameter-passed and drop the stale TODO.

Author: zonuexe

src/Rules/PhpDoc/InvalidPHPStanDocTagRule.php

@@ -64,8 +64,7 @@ final class InvalidPHPStanDocTagRule implements Rule
 		'@phpstan-param-immediately-invoked-callable',
 		'@phpstan-param-later-invoked-callable',
 		'@phpstan-param-closure-this',
-		// TODO: drop this once phpstan/phpdoc-parser#259 is merged and the parser
-		// recognizes the tag natively (like @phpstan-pure-unless-callable-is-impure).
+		'@phpstan-pure-unless-callable-is-impure',
 		'@phpstan-pure-unless-parameter-passed',
 		'@phpstan-all-methods-pure',
 		'@phpstan-all-methods-impure',

tests/PHPStan/Rules/PhpDoc/data/invalid-phpstan-doc.php

@@ -58,3 +58,12 @@ public function doFoo(): string
 	}
 
 }
+
+/**
+ * @param-out int $count
+ * @phpstan-pure-unless-callable-is-impure $callback
+ * @phpstan-pure-unless-parameter-passed $count
+ */
+function withPurityTags(callable $callback, int &$count = 0): void
+{
+}