From d3868dbff9b6d80e37abba40d6b277c908e80bce Mon Sep 17 00:00:00 2001
From: David Grudl <david@grudl.com>
Date: Tue, 2 Nov 2021 00:36:43 +0100
Subject: [PATCH] improved phpdoc

---
 src/Neon/Encoder.php            | 1 +
 src/Neon/Entity.php             | 3 ++-
 src/Neon/Node/ArrayItemNode.php | 5 ++++-
 src/Neon/Node/ArrayNode.php     | 1 +
 src/Neon/Parser.php             | 1 +
 5 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/Neon/Encoder.php b/src/Neon/Encoder.php
index 3ac14135..18f3a95d 100644
--- a/src/Neon/Encoder.php
+++ b/src/Neon/Encoder.php
@@ -75,6 +75,7 @@ public function valueToNode($val, bool $blockMode = false): Node
 	}
 
 
+	/** @return Node\ArrayItemNode[] */
 	private function arrayToNodes($val, bool $blockMode = false): array
 	{
 		$res = [];
diff --git a/src/Neon/Entity.php b/src/Neon/Entity.php
index 8cb1afb1..4e60cb14 100644
--- a/src/Neon/Entity.php
+++ b/src/Neon/Entity.php
@@ -18,7 +18,7 @@ final class Entity extends \stdClass
 	/** @var mixed */
 	public $value;
 
-	/** @var array */
+	/** @var mixed[] */
 	public $attributes;
 
 
@@ -29,6 +29,7 @@ public function __construct($value, array $attrs = [])
 	}
 
 
+	/** @param  mixed[]  $properties */
 	public static function __set_state(array $properties)
 	{
 		return new self($properties['value'], $properties['attributes']);
diff --git a/src/Neon/Node/ArrayItemNode.php b/src/Neon/Node/ArrayItemNode.php
index 322219dd..0a42537b 100644
--- a/src/Neon/Node/ArrayItemNode.php
+++ b/src/Neon/Node/ArrayItemNode.php
@@ -22,7 +22,10 @@ final class ArrayItemNode extends Node
 	public $value;
 
 
-	/** @param  self[]  $items */
+	/**
+	 * @param  self[]  $items
+	 * @return mixed[]
+	 */
 	public static function itemsToArray(array $items): array
 	{
 		$res = [];
diff --git a/src/Neon/Node/ArrayNode.php b/src/Neon/Node/ArrayNode.php
index c46cdfea..26f97696 100644
--- a/src/Neon/Node/ArrayNode.php
+++ b/src/Neon/Node/ArrayNode.php
@@ -19,6 +19,7 @@ abstract class ArrayNode extends Node
 	public $items = [];
 
 
+	/** @return mixed[] */
 	public function toValue(): array
 	{
 		return ArrayItemNode::itemsToArray($this->items);
diff --git a/src/Neon/Parser.php b/src/Neon/Parser.php
index 25557b9b..bc87742e 100644
--- a/src/Neon/Parser.php
+++ b/src/Neon/Parser.php
@@ -220,6 +220,7 @@ private function parseBraces(): Node\InlineArrayNode
 	}
 
 
+	/** @param  true[]  $arr */
 	private function checkArrayKey(Node $key, array &$arr): void
 	{
 		if ((!$key instanceof Node\StringNode && !$key instanceof Node\LiteralNode) || !is_scalar($key->value)) {