Tidy up after quality analysis (#403)

* build: upgrade dom requirement and loosen version range

* docs: update examples

* feature: trim whitespace when there are only template children
closes #363

* maintenance: phpstorm analysis improvements

src/ElementBinder.php

@@ -1,14 +1,7 @@
 <?php
 namespace Gt\DomTemplate;
 
-use Gt\Dom\DOMTokenList;
 use Gt\Dom\Element;
-use Gt\Dom\Facade\DOMTokenListFactory;
-use Gt\Dom\Node;
-use Gt\Dom\XPathResult;
-use ReflectionClass;
-use ReflectionMethod;
-use ReflectionProperty;
 
 class ElementBinder {
 	private HTMLAttributeBinder $htmlAttributeBinder;

src/ListBinder.php

@@ -10,14 +10,15 @@
 class ListBinder {
 	private BindableCache $bindableCache;
 
+	/** @noinspection PhpPropertyCanBeReadonlyInspection */
 	public function __construct(
 		private TemplateCollection $templateCollection,
 		?BindableCache $bindableCache = null
 	) {
 		$this->bindableCache = $bindableCache ?? new BindableCache();
 	}
 
-	/** @param iterable<mixed> $listData */
+	/** @param iterable<int|string,mixed> $listData */
 	public function bindListData(
 		iterable $listData,
 		Document|Element $context,
@@ -102,7 +103,7 @@ public function bindListData(
 		return $nestedCount + $i + 1;
 	}
 
-	/** @param iterable<mixed>|array<mixed> $listData */
+	/** @param iterable<int|string,mixed> $listData */
 	private function isEmpty(iterable $listData):bool {
 		if(is_array($listData)) {
 			return is_null(array_key_first($listData));

src/NodePathCalculator.php

@@ -7,7 +7,7 @@
 
 class NodePathCalculator implements Stringable {
 	public function __construct(
-		private Node|Element $element
+		private readonly Node|Element $element
 	) {
 	}
 
@@ -39,7 +39,7 @@ public function __toString():string {
 			$path = "/" . $contextPath . $path;
 			$context = $context->parentElement;
 		}
-		while($context && $context instanceof Element);
+		while($context instanceof Element);
 
 		return $path;
 	}

src/PartialContent.php

@@ -5,7 +5,7 @@
 
 class PartialContent {
 	public function __construct(
-		private string $dirPath
+		private readonly string $dirPath
 	) {
 		if(!is_dir($this->dirPath)) {
 			throw new PartialContentDirectoryNotFoundException("The partial content path does not exist: $this->dirPath");