Allow nodes to have custom attributes

src/Ast/ConstExpr/ConstExprArrayItemNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprArrayItemNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var ConstExprNode|null */
 	public $key;
 

src/Ast/ConstExpr/ConstExprArrayNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprArrayNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var ConstExprArrayItemNode[] */
 	public $items;
 

src/Ast/ConstExpr/ConstExprFalseNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprFalseNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	public function __toString(): string
 	{
 		return 'false';

src/Ast/ConstExpr/ConstExprFloatNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprFloatNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var string */
 	public $value;
 

src/Ast/ConstExpr/ConstExprIntegerNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprIntegerNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var string */
 	public $value;
 

src/Ast/ConstExpr/ConstExprNullNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprNullNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	public function __toString(): string
 	{
 		return 'null';

src/Ast/ConstExpr/ConstExprStringNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprStringNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var string */
 	public $value;
 

src/Ast/ConstExpr/ConstExprTrueNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstExprTrueNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	public function __toString(): string
 	{
 		return 'true';

src/Ast/ConstExpr/ConstFetchNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\ConstExpr;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class ConstFetchNode implements ConstExprNode
 {
 
+	use NodeAttributes;
+
 	/** @var string class name for class constants or empty string for non-class constants */
 	public $className;
 

src/Ast/Node.php

@@ -7,4 +7,18 @@ interface Node
 
 	public function __toString(): string;
 
+	/**
+	 * @param string $key
+	 * @param mixed $value
+	 */
+	public function setAttribute(string $key, $value): void;
+
+	public function hasAttribute(string $key): bool;
+
+	/**
+	 * @param string $key
+	 * @return mixed
+	 */
+	public function getAttribute(string $key);
+
 }

src/Ast/NodeAttributes.php

@@ -0,0 +1,38 @@
+<?php declare(strict_types = 1);
+
+namespace PHPStan\PhpDocParser\Ast;
+
+trait NodeAttributes
+{
+
+	/** @var array<string, mixed> */
+	private $attributes = [];
+
+	/**
+	 * @param string $key
+	 * @param mixed $value
+	 */
+	public function setAttribute(string $key, $value): void
+	{
+		$this->attributes[$key] = $value;
+	}
+
+	public function hasAttribute(string $key): bool
+	{
+		return array_key_exists($key, $this->attributes);
+	}
+
+	/**
+	 * @param string $key
+	 * @return mixed
+	 */
+	public function getAttribute(string $key)
+	{
+		if ($this->hasAttribute($key)) {
+			return $this->attributes[$key];
+		}
+
+		return null;
+	}
+
+}

src/Ast/PhpDoc/DeprecatedTagValueNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class DeprecatedTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var string (may be empty) */
 	public $description;
 

src/Ast/PhpDoc/ExtendsTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode;
 
 class ExtendsTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var GenericTypeNode */
 	public $type;
 

src/Ast/PhpDoc/GenericTagValueNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class GenericTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var string (may be empty) */
 	public $value;
 

src/Ast/PhpDoc/ImplementsTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\GenericTypeNode;
 
 class ImplementsTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var GenericTypeNode */
 	public $type;
 

src/Ast/PhpDoc/InvalidTagValueNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class InvalidTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var string (may be empty) */
 	public $value;
 

src/Ast/PhpDoc/MethodTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class MethodTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var bool */
 	public $isStatic;
 

src/Ast/PhpDoc/MethodTagValueParameterNode.php

@@ -4,11 +4,14 @@
 
 use PHPStan\PhpDocParser\Ast\ConstExpr\ConstExprNode;
 use PHPStan\PhpDocParser\Ast\Node;
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class MethodTagValueParameterNode implements Node
 {
 
+	use NodeAttributes;
+
 	/** @var TypeNode|null */
 	public $type;
 

src/Ast/PhpDoc/MixinTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class MixinTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var TypeNode */
 	public $type;
 

src/Ast/PhpDoc/ParamTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class ParamTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var TypeNode */
 	public $type;
 

src/Ast/PhpDoc/PhpDocNode.php

@@ -3,10 +3,13 @@
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
 use PHPStan\PhpDocParser\Ast\Node;
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 
 class PhpDocNode implements Node
 {
 
+	use NodeAttributes;
+
 	/** @var PhpDocChildNode[] */
 	public $children;
 

src/Ast/PhpDoc/PhpDocTagNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class PhpDocTagNode implements PhpDocChildNode
 {
 
+	use NodeAttributes;
+
 	/** @var string */
 	public $name;
 

src/Ast/PhpDoc/PhpDocTextNode.php

@@ -2,9 +2,13 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
+
 class PhpDocTextNode implements PhpDocChildNode
 {
 
+	use NodeAttributes;
+
 	/** @var string */
 	public $text;
 

src/Ast/PhpDoc/PropertyTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class PropertyTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var TypeNode */
 	public $type;
 

src/Ast/PhpDoc/ReturnTagValueNode.php

@@ -2,11 +2,14 @@
 
 namespace PHPStan\PhpDocParser\Ast\PhpDoc;
 
+use PHPStan\PhpDocParser\Ast\NodeAttributes;
 use PHPStan\PhpDocParser\Ast\Type\TypeNode;
 
 class ReturnTagValueNode implements PhpDocTagValueNode
 {
 
+	use NodeAttributes;
+
 	/** @var TypeNode */
 	public $type;