Improve type nodes and add node tests

Author: SerafimArts

libs/parser/resources/grammar.php

@@ -9,7 +9,6 @@ class FeatureNotAllowedException extends SemanticException
     /**
      * @param non-empty-string $name
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromFeature(string $name, int $offset = 0): self

libs/parser/src/Exception/FeatureNotAllowedException.php

@@ -41,7 +41,6 @@ public static function source(string $statement): string
 
     /**
      * @param int<0, max> $offset
-     *
      * @return non-empty-string
      */
     public static function suffix(string $statement, int $offset): string

libs/parser/src/Exception/Formatter.php

@@ -31,7 +31,6 @@ final public function __construct(string $message, int $code = 0, ?\Throwable $p
      * unexpected source location.
      *
      * @param int<0, max> $offset
-     *
      * @throws SourceExceptionInterface
      */
     public static function fromUnexpectedToken(string $token, string $statement, int $offset): static
@@ -49,7 +48,6 @@ public static function fromUnexpectedToken(string $token, string $statement, int
      * This error occurs when unable to recognize tokens in source code.
      *
      * @param int<0, max> $offset
-     *
      * @throws SourceExceptionInterface
      */
     public static function fromUnrecognizedToken(string $token, string $statement, int $offset): static
@@ -65,7 +63,6 @@ public static function fromUnrecognizedToken(string $token, string $statement, i
 
     /**
      * @param int<0, max> $offset
-     *
      * @throws SourceExceptionInterface
      */
     public static function fromUnrecognizedSyntaxError(string $statement, int $offset): static

libs/parser/src/Exception/ParseException.php

@@ -41,7 +41,6 @@ public function getOffset(): int
     /**
      * @param non-empty-string $key
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromShapeFieldDuplication(string $key, int $offset = 0): self
@@ -53,7 +52,6 @@ public static function fromShapeFieldDuplication(string $key, int $offset = 0):
 
     /**
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromShapeMixedKeys(int $offset = 0): self
@@ -65,7 +63,6 @@ public static function fromShapeMixedKeys(int $offset = 0): self
 
     /**
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromVariadicWithDefault(int $offset = 0): self
@@ -77,7 +74,6 @@ public static function fromVariadicWithDefault(int $offset = 0): self
 
     /**
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromVariadicRedefinition(int $offset = 0): self
@@ -90,7 +86,6 @@ public static function fromVariadicRedefinition(int $offset = 0): self
     /**
      * @param non-empty-string $operator
      * @param int<0, max> $offset
-     *
      * @return static
      */
     public static function fromInvalidConditionalOperator(string $operator, int $offset = 0): self

libs/parser/src/Exception/SemanticException.php

@@ -36,7 +36,6 @@
  *     reducers: array<int<0, max>|non-empty-string, callable(Context, mixed): mixed>,
  *     transitions?: array<array-key, mixed>
  * }
- *
  * @phpstan-type ParserConfigArrayType array<ParserConfigsInterface::CONFIG_*, mixed>
  *
  * @internal this is an internal library class, please do not use it in your code
@@ -55,6 +54,7 @@
      * In-memory string literal pool.
      *
      * @api this property is accessible inside the grammar reducers
+     *
      * @var \WeakMap<TokenInterface, StringLiteralNode>
      */
     protected \WeakMap $stringPool;
@@ -63,6 +63,7 @@
      * In-memory integer literal pool.
      *
      * @api this property is accessible inside the grammar reducers
+     *
      * @var \WeakMap<TokenInterface, IntLiteralNode>
      */
     protected \WeakMap $integerPool;
@@ -97,7 +98,6 @@ private function createBuilder(array $reducers): BuilderInterface
 
     /**
      * @param GrammarConfigArrayType $grammar
-     *
      * @return ParserRuntime<TypeNode>
      */
     private function createParser(LexerInterface $lexer, array $grammar): ParserRuntime

libs/parser/src/Internal/ExecutionContext.php

@@ -26,10 +26,8 @@ public function __construct(iterable $visitors = [])
 
     /**
      * @template TArgVisitor of VisitorInterface
-     *
      * @param TArgVisitor $visitor
      * @param iterable<array-key, Node> $nodes
-     *
      * @return TArgVisitor
      */
     public static function through(VisitorInterface $visitor, iterable $nodes): VisitorInterface

libs/parser/src/Traverser.php

@@ -29,8 +29,7 @@ interface TypeParserInterface
      * // => ParseException
      * ```
      *
-     * @param TSource $source Source code to parse.
-     *
+     * @param TSource $source source code to parse
      * @throws ParserExceptionInterface in case of parsing exception occurs
      * @throws \Throwable in case of internal error occurs
      */
@@ -68,10 +67,9 @@ public function parse(#[Language('PHP')] mixed $source): TypeNode;
      * // => "This is an example"
      * ```
      *
-     * @param TSource $source Source code to parse.
-     *
-     * @return ParsedResult Parsing result containing a partial AST, parser
-     *         state, and syntax diagnostics.
+     * @param TSource $source source code to parse
+     * @return ParsedResult parsing result containing a partial AST, parser
+     *         state, and syntax diagnostics
      * @throws ParserExceptionInterface in case of parsing exception occurs
      * @throws \Throwable in case of internal error occurs
      */

libs/parser/src/TypeParserInterface.php

@@ -16,10 +16,8 @@ interface TypeResolverInterface
      * replacement.
      *
      * @template TArgType of TypeNode
-     *
      * @param TArgType $type
      * @param callable(Name):(Name|null) $transform
-     *
      * @return TArgType
      */
     public function resolve(TypeNode $type, callable $transform): TypeNode;

libs/parser/src/TypeResolverInterface.php

@@ -12,7 +12,6 @@
  *
  * Note: the AST dump renders the attribute structure (groups and names) but
  * not the attribute argument values.
- *
  */
 #[Group('unit'), Group('type-lang/parser')]
 final class AttributeTest extends SyntaxTestCase