Merge branch 'release/2.0.5'

mikaelcom · mikaelcom · commit 48ce42fcf099 · 2022-03-24T20:35:33.000+01:00
diff --git a/.php-cs-fixer.php b/.php-cs-fixer.php
@@ -4,7 +4,7 @@
     ->exclude('vendor')
     ->in(__DIR__);
 
-return PhpCsFixer\Config::create()
+return (new PhpCsFixer\Config())
     ->setUsingCache(false)
     ->setRules(array(
         '@PhpCsFixer' => true,
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## 2.0.5 - 2022/03/24
+- Rename .php_cs to .php-cs-fixer.php
+- Add PHPStan
+- Review PHP annotations
+- Update badges
+
 ## 2.0.4 - 2021/02/03
 - Review .php_cs settings, apply PHP CS Fixer
 - Change tests classes to final classes
diff --git a/README.md b/README.md
@@ -4,12 +4,12 @@
 
 [![License](https://poser.pugx.org/wsdltophp/domhandler/license)](https://packagist.org/packages/wsdltophp/domhandler)
 [![Latest Stable Version](https://poser.pugx.org/wsdltophp/domhandler/version.png)](https://packagist.org/packages/wsdltophp/domhandler)
-[![Build Status](https://travis-ci.com/WsdlToPhp/DomHandler.svg)](https://travis-ci.com/github/WsdlToPhp/DomHandler)
+[![TeamCity build status](https://teamcity.mikael-delsol.fr/app/rest/builds/buildType:id:WsdlHandler_Build/statusIcon.svg)](https://github.com/WsdlToPhp/DomHandler)
 [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/WsdlToPhp/DomHandler/badges/quality-score.png)](https://scrutinizer-ci.com/g/WsdlToPhp/DomHandler/)
 [![Code Coverage](https://scrutinizer-ci.com/g/WsdlToPhp/DomHandler/badges/coverage.png)](https://scrutinizer-ci.com/g/WsdlToPhp/DomHandler/)
 [![Total Downloads](https://poser.pugx.org/wsdltophp/domhandler/downloads)](https://packagist.org/packages/wsdltophp/domhandler)
 [![StyleCI](https://styleci.io/repos/87977980/shield)](https://styleci.io/repos/87977980)
-[![SensioLabsInsight](https://insight.sensiolabs.com/projects/6bac01d7-5243-4682-9264-8166407c8a30/mini.png)](https://insight.sensiolabs.com/projects/6bac01d7-5243-4682-9264-8166407c8a30)
+[![SymfonyInsight](https://insight.symfony.com/projects/93e73feb-60bc-4e99-a3ce-87e537c61fed/mini.svg)](https://insight.symfony.com/projects/93e73feb-60bc-4e99-a3ce-87e537c61fed)
 
 DomHandler uses the [decorator design pattern](https://en.wikipedia.org/wiki/Decorator_pattern) in order to ease DOM handling.
 
diff --git a/composer.json b/composer.json
@@ -27,7 +27,8 @@
         "ext-dom": "*"
     },
     "require-dev": {
-        "friendsofphp/php-cs-fixer": "~2.0",
+        "friendsofphp/php-cs-fixer": "~3.0",
+        "phpstan/phpstan": "^1.4",
         "phpunit/phpunit": "^9"
     },
     "config": {
@@ -45,7 +46,8 @@
     },
     "scripts": {
         "test": "vendor/bin/phpunit",
-        "lint": "vendor/bin/php-cs-fixer fix --ansi --diff --verbose"
+        "lint": "vendor/bin/php-cs-fixer fix --ansi --diff --verbose",
+        "phpstan": "vendor/bin/phpstan analyze src --level=7"
     },
     "support": {
         "email": "contact@wsdltophp.com"
diff --git a/phpstan.neon.dist b/phpstan.neon.dist
@@ -0,0 +1,33 @@
+parameters:
+    treatPhpDocTypesAsCertain: false
+
+    ignoreErrors:
+        -
+            message: "#^Method WsdlToPhp\\\\DomHandler\\\\AbstractAttributeHandler\\:\\:getAttribute\\(\\) should return DOMAttr but returns DOMNode\\.$#"
+            count: 1
+            path: src/AbstractAttributeHandler.php
+
+        -
+            message: "#^Method WsdlToPhp\\\\DomHandler\\\\AbstractElementHandler\\:\\:getAttribute\\(\\) should return WsdlToPhp\\\\DomHandler\\\\AttributeHandler\\|null but returns WsdlToPhp\\\\DomHandler\\\\AbstractNodeHandler\\|null\\.$#"
+            count: 1
+            path: src/AbstractElementHandler.php
+
+        -
+            message: "#^Method WsdlToPhp\\\\DomHandler\\\\AbstractElementHandler\\:\\:getElement\\(\\) should return DOMElement but returns DOMNode\\.$#"
+            count: 1
+            path: src/AbstractElementHandler.php
+
+        -
+            message: "#^Method WsdlToPhp\\\\DomHandler\\\\AbstractElementHandler\\:\\:getChildByNameAndAttributes\\(\\) should return WsdlToPhp\\\\DomHandler\\\\ElementHandler\\|null but returns WsdlToPhp\\\\DomHandler\\\\AbstractNodeHandler\\|null\\.$#"
+            count: 1
+            path: src/AbstractElementHandler.php
+
+        -
+            message: "#^Strict comparison using === between 1 and mixed will always evaluate to false.$#"
+            count: 1
+            path: src/AbstractAttributeHandler.php
+
+        -
+            message: "#^Method WsdlToPhp\\\\DomHandler\\\\AbstractDomDocumentHandler\\:\\:getElementByNameAndAttributes\\(\\) should return WsdlToPhp\\\\DomHandler\\\\ElementHandler\\|null but returns WsdlToPhp\\\\DomHandler\\\\AbstractNodeHandler\\|null\\.$#"
+            count: 1
+            path: src/AbstractDomDocumentHandler.php
diff --git a/src/AbstractDomDocumentHandler.php b/src/AbstractDomDocumentHandler.php
@@ -23,6 +23,9 @@ public function __construct(DOMDocument $domDocument)
         $this->initRootElement();
     }
 
+    /**
+     * @param DOMAttr|DOMElement|DOMNode $node
+     */
     public function getHandler($node, int $index = -1): AbstractNodeHandler
     {
         if ($node instanceof DOMElement) {
@@ -53,6 +56,9 @@ public function getElementByName(string $name): ?ElementHandler
         return null;
     }
 
+    /**
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     public function getNodesByName(string $name, ?string $checkInstance = null): array
     {
         $nodes = [];
@@ -67,42 +73,64 @@ public function getNodesByName(string $name, ?string $checkInstance = null): arr
         return $nodes;
     }
 
+    /**
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     public function getElementsByName(string $name): array
     {
         return $this->getNodesByName($name, DOMElement::class);
     }
 
+    /**
+     * @param string[] $attributes
+     *
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     public function getElementsByNameAndAttributes(string $name, array $attributes, ?DOMNode $node = null): array
     {
         $matchingElements = $this->getElementsByName($name);
         if ((!empty($attributes) || $node instanceof DOMNode) && !empty($matchingElements)) {
             $nodes = $this->searchTagsByXpath($name, $attributes, $node);
 
-            if (!empty($nodes)) {
+            if ($nodes && 0 < $nodes->count()) {
                 $matchingElements = $this->getElementsHandlers($nodes);
             }
         }
 
         return $matchingElements;
     }
 
+    /**
+     * @param DOMNodeList<DOMAttr|DOMElement|DOMNode> $nodeList
+     *
+     * @return AbstractElementHandler[]
+     */
     public function getElementsHandlers(DOMNodeList $nodeList): array
     {
         $nodes = [];
-        if (!empty($nodeList)) {
-            $index = 0;
-            foreach ($nodeList as $node) {
-                if ($node instanceof DOMElement) {
-                    $nodes[] = $this->getElementHandler($node, $this, $index);
-                    ++$index;
-                }
+        if (0 === $nodeList->count()) {
+            return $nodes;
+        }
+
+        $index = 0;
+        foreach ($nodeList as $node) {
+            if (!$node instanceof DOMElement) {
+                continue;
             }
+
+            $nodes[] = $this->getElementHandler($node, $this, $index);
+            ++$index;
         }
 
         return $nodes;
     }
 
-    public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $node = null): DOMNodeList
+    /**
+     * @param string[] $attributes
+     *
+     * @return DOMNodeList<DOMAttr|DOMElement|DOMNode>|false
+     */
+    public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $node = null)
     {
         $xpath = new DOMXPath($node ? $node->ownerDocument : $this->domDocument);
         $xQuery = sprintf("%s//*[local-name()='%s']", $node instanceof DOMNode ? '.' : '', $name);
@@ -117,6 +145,9 @@ public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $nod
         return $xpath->query($xQuery, $node);
     }
 
+    /**
+     * @param string[] $attributes
+     */
     public function getElementByNameAndAttributes(string $name, array $attributes): ?ElementHandler
     {
         $elements = $this->getElementsByNameAndAttributes($name, $attributes);
@@ -129,7 +160,7 @@ public function getElementByNameAndAttributes(string $name, array $attributes):
      *
      * @throws InvalidArgumentException
      */
-    protected function initRootElement()
+    protected function initRootElement(): void
     {
         if ($this->domDocument->hasChildNodes()) {
             foreach ($this->domDocument->childNodes as $node) {
diff --git a/src/AbstractElementHandler.php b/src/AbstractElementHandler.php
@@ -25,9 +25,12 @@ public function hasAttribute(string $name): bool
 
     public function getAttribute(string $name): ?AttributeHandler
     {
-        return $this->hasAttribute($name) ? $this->getDomDocumentHandler()->getHandler($this->getNode()->getAttributeNode($name)) : null;
+        return $this->hasAttribute($name) ? $this->getDomDocumentHandler()->getHandler($this->getElement()->getAttributeNode($name)) : null;
     }
 
+    /**
+     * @return null|bool|mixed|string
+     */
     public function getAttributeValue(string $name, bool $withNamespace = false, bool $withinItsType = true, ?string $asType = AbstractAttributeHandler::DEFAULT_VALUE_TYPE)
     {
         $value = null;
@@ -39,38 +42,50 @@ public function getAttributeValue(string $name, bool $withNamespace = false, boo
         return $value;
     }
 
+    /**
+     * @return array<int, AbstractElementHandler|AbstractNodeHandler>
+     */
     public function getChildrenByName(string $name): array
     {
         $children = [];
-        if ($this->hasChildren()) {
-            foreach ($this->getElement()->getElementsByTagName($name) as $index => $node) {
-                $children[] = $this->getDomDocumentHandler()->getHandler($node, $index);
-            }
+
+        if (!$this->hasChildren()) {
+            return $children;
+        }
+
+        foreach ($this->getElement()->getElementsByTagName($name) as $index => $node) {
+            $children[] = $this->getDomDocumentHandler()->getHandler($node, $index);
         }
 
         return $children;
     }
 
+    /**
+     * @return AbstractElementHandler[]
+     */
     public function getElementChildren(): array
     {
-        $children = [];
-        if ($this->hasChildren()) {
-            $children = $this->getDomDocumentHandler()->getElementsHandlers($this->getChildNodes());
-        }
-
-        return $children;
+        return $this->hasChildren() ? $this->getDomDocumentHandler()->getElementsHandlers($this->getChildNodes()) : [];
     }
 
+    /**
+     * @param string[] $attributes
+     *
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     public function getChildrenByNameAndAttributes(string $name, array $attributes): array
     {
         return $this->getDomDocumentHandler()->getElementsByNameAndAttributes($name, $attributes, $this->getNode());
     }
 
+    /**
+     * @param string[] $attributes
+     */
     public function getChildByNameAndAttributes(string $name, array $attributes): ?ElementHandler
     {
         $children = $this->getChildrenByNameAndAttributes($name, $attributes);
 
-        return empty($children) ? null : array_shift($children);
+        return array_shift($children);
     }
 
     /**
diff --git a/src/AbstractNodeHandler.php b/src/AbstractNodeHandler.php
@@ -4,6 +4,7 @@
 
 namespace WsdlToPhp\DomHandler;
 
+use DOMElement;
 use DOMNode;
 use DOMNodeList;
 use Traversable;
@@ -28,6 +29,9 @@ public function getNode(): DOMNode
         return $this->node;
     }
 
+    /**
+     * @return DOMNodeList<DOMElement|DOMNode>
+     */
     public function getChildNodes(): DOMNodeList
     {
         return $this->getNode()->childNodes;
@@ -77,6 +81,9 @@ public function hasAttributes(): bool
         return $this->getNode()->hasAttributes();
     }
 
+    /**
+     * @return AbstractAttributeHandler[]|AbstractNodeHandler[]
+     */
     public function getAttributes(): array
     {
         return $this->getHandlers($this->getNode()->attributes);
@@ -87,6 +94,9 @@ public function hasChildren(): bool
         return $this->getNode()->hasChildNodes();
     }
 
+    /**
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     public function getChildren(): array
     {
         return $this->getHandlers($this->getNode()->childNodes);
@@ -126,6 +136,11 @@ public function getValueNamespace(): ?string
         return null;
     }
 
+    /**
+     * @param null|Traversable<DOMNode> $nodes
+     *
+     * @return AbstractAttributeHandler[]|AbstractElementHandler[]|AbstractNodeHandler[]
+     */
     private function getHandlers(?Traversable $nodes): array
     {
         if (is_null($nodes)) {

Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,9 @@ public function __construct(DOMDocument $domDocument)`
`23`	`23`	`$this->initRootElement();`
`24`	`24`	`}`
`25`	`25`
	`26`	`+ /**`
	`27`	`+ * @param DOMAttr\|DOMElement\|DOMNode $node`
	`28`	`+ */`
`26`	`29`	`public function getHandler($node, int $index = -1): AbstractNodeHandler`
`27`	`30`	`{`
`28`	`31`	`if ($node instanceof DOMElement) {`
`@@ -53,6 +56,9 @@ public function getElementByName(string $name): ?ElementHandler`
`53`	`56`	`return null;`
`54`	`57`	`}`
`55`	`58`
	`59`	`+ /**`
	`60`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`61`	`+ */`
`56`	`62`	`public function getNodesByName(string $name, ?string $checkInstance = null): array`
`57`	`63`	`{`
`58`	`64`	`$nodes = [];`
`@@ -67,42 +73,64 @@ public function getNodesByName(string $name, ?string $checkInstance = null): arr`
`67`	`73`	`return $nodes;`
`68`	`74`	`}`
`69`	`75`
	`76`	`+ /**`
	`77`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`78`	`+ */`
`70`	`79`	`public function getElementsByName(string $name): array`
`71`	`80`	`{`
`72`	`81`	`return $this->getNodesByName($name, DOMElement::class);`
`73`	`82`	`}`
`74`	`83`
	`84`	`+ /**`
	`85`	`+ * @param string[] $attributes`
	`86`	`+ *`
	`87`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`88`	`+ */`
`75`	`89`	`public function getElementsByNameAndAttributes(string $name, array $attributes, ?DOMNode $node = null): array`
`76`	`90`	`{`
`77`	`91`	`$matchingElements = $this->getElementsByName($name);`
`78`	`92`	`if ((!empty($attributes) \|\| $node instanceof DOMNode) && !empty($matchingElements)) {`
`79`	`93`	`$nodes = $this->searchTagsByXpath($name, $attributes, $node);`
`80`	`94`
`81`		`- if (!empty($nodes)) {`
	`95`	`+ if ($nodes && 0 < $nodes->count()) {`
`82`	`96`	`$matchingElements = $this->getElementsHandlers($nodes);`
`83`	`97`	`}`
`84`	`98`	`}`
`85`	`99`
`86`	`100`	`return $matchingElements;`
`87`	`101`	`}`
`88`	`102`
	`103`	`+ /**`
	`104`	`+ * @param DOMNodeList<DOMAttr\|DOMElement\|DOMNode> $nodeList`
	`105`	`+ *`
	`106`	`+ * @return AbstractElementHandler[]`
	`107`	`+ */`
`89`	`108`	`public function getElementsHandlers(DOMNodeList $nodeList): array`
`90`	`109`	`{`
`91`	`110`	`$nodes = [];`
`92`		`- if (!empty($nodeList)) {`
`93`		`- $index = 0;`
`94`		`- foreach ($nodeList as $node) {`
`95`		`- if ($node instanceof DOMElement) {`
`96`		`- $nodes[] = $this->getElementHandler($node, $this, $index);`
`97`		`- ++$index;`
`98`		`- }`
	`111`	`+ if (0 === $nodeList->count()) {`
	`112`	`+ return $nodes;`
	`113`	`+ }`
	`114`	`+`
	`115`	`+ $index = 0;`
	`116`	`+ foreach ($nodeList as $node) {`
	`117`	`+ if (!$node instanceof DOMElement) {`
	`118`	`+ continue;`
`99`	`119`	`}`
	`120`	`+`
	`121`	`+ $nodes[] = $this->getElementHandler($node, $this, $index);`
	`122`	`+ ++$index;`
`100`	`123`	`}`
`101`	`124`
`102`	`125`	`return $nodes;`
`103`	`126`	`}`
`104`	`127`
`105`		`- public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $node = null): DOMNodeList`
	`128`	`+ /**`
	`129`	`+ * @param string[] $attributes`
	`130`	`+ *`
	`131`	`+ * @return DOMNodeList<DOMAttr\|DOMElement\|DOMNode>\|false`
	`132`	`+ */`
	`133`	`+ public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $node = null)`
`106`	`134`	`{`
`107`	`135`	`$xpath = new DOMXPath($node ? $node->ownerDocument : $this->domDocument);`
`108`	`136`	`$xQuery = sprintf("%s//*[local-name()='%s']", $node instanceof DOMNode ? '.' : '', $name);`
`@@ -117,6 +145,9 @@ public function searchTagsByXpath(string $name, array $attributes, ?DOMNode $nod`
`117`	`145`	`return $xpath->query($xQuery, $node);`
`118`	`146`	`}`
`119`	`147`
	`148`	`+ /**`
	`149`	`+ * @param string[] $attributes`
	`150`	`+ */`
`120`	`151`	`public function getElementByNameAndAttributes(string $name, array $attributes): ?ElementHandler`
`121`	`152`	`{`
`122`	`153`	`$elements = $this->getElementsByNameAndAttributes($name, $attributes);`
`@@ -129,7 +160,7 @@ public function getElementByNameAndAttributes(string $name, array $attributes):`
`129`	`160`	`*`
`130`	`161`	`* @throws InvalidArgumentException`
`131`	`162`	`*/`
`132`		`- protected function initRootElement()`
	`163`	`+ protected function initRootElement(): void`
`133`	`164`	`{`
`134`	`165`	`if ($this->domDocument->hasChildNodes()) {`
`135`	`166`	`foreach ($this->domDocument->childNodes as $node) {`
Original file line number	Diff line number	Diff line change
`@@ -25,9 +25,12 @@ public function hasAttribute(string $name): bool`
`25`	`25`
`26`	`26`	`public function getAttribute(string $name): ?AttributeHandler`
`27`	`27`	`{`
`28`		`- return $this->hasAttribute($name) ? $this->getDomDocumentHandler()->getHandler($this->getNode()->getAttributeNode($name)) : null;`
	`28`	`+ return $this->hasAttribute($name) ? $this->getDomDocumentHandler()->getHandler($this->getElement()->getAttributeNode($name)) : null;`
`29`	`29`	`}`
`30`	`30`
	`31`	`+ /**`
	`32`	`+ * @return null\|bool\|mixed\|string`
	`33`	`+ */`
`31`	`34`	`public function getAttributeValue(string $name, bool $withNamespace = false, bool $withinItsType = true, ?string $asType = AbstractAttributeHandler::DEFAULT_VALUE_TYPE)`
`32`	`35`	`{`
`33`	`36`	`$value = null;`
`@@ -39,38 +42,50 @@ public function getAttributeValue(string $name, bool $withNamespace = false, boo`
`39`	`42`	`return $value;`
`40`	`43`	`}`
`41`	`44`
	`45`	`+ /**`
	`46`	`+ * @return array<int, AbstractElementHandler\|AbstractNodeHandler>`
	`47`	`+ */`
`42`	`48`	`public function getChildrenByName(string $name): array`
`43`	`49`	`{`
`44`	`50`	`$children = [];`
`45`		`- if ($this->hasChildren()) {`
`46`		`- foreach ($this->getElement()->getElementsByTagName($name) as $index => $node) {`
`47`		`- $children[] = $this->getDomDocumentHandler()->getHandler($node, $index);`
`48`		`- }`
	`51`	`+`
	`52`	`+ if (!$this->hasChildren()) {`
	`53`	`+ return $children;`
	`54`	`+ }`
	`55`	`+`
	`56`	`+ foreach ($this->getElement()->getElementsByTagName($name) as $index => $node) {`
	`57`	`+ $children[] = $this->getDomDocumentHandler()->getHandler($node, $index);`
`49`	`58`	`}`
`50`	`59`
`51`	`60`	`return $children;`
`52`	`61`	`}`
`53`	`62`
	`63`	`+ /**`
	`64`	`+ * @return AbstractElementHandler[]`
	`65`	`+ */`
`54`	`66`	`public function getElementChildren(): array`
`55`	`67`	`{`
`56`		`- $children = [];`
`57`		`- if ($this->hasChildren()) {`
`58`		`- $children = $this->getDomDocumentHandler()->getElementsHandlers($this->getChildNodes());`
`59`		`- }`
`60`		`-`
`61`		`- return $children;`
	`68`	`+ return $this->hasChildren() ? $this->getDomDocumentHandler()->getElementsHandlers($this->getChildNodes()) : [];`
`62`	`69`	`}`
`63`	`70`
	`71`	`+ /**`
	`72`	`+ * @param string[] $attributes`
	`73`	`+ *`
	`74`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`75`	`+ */`
`64`	`76`	`public function getChildrenByNameAndAttributes(string $name, array $attributes): array`
`65`	`77`	`{`
`66`	`78`	`return $this->getDomDocumentHandler()->getElementsByNameAndAttributes($name, $attributes, $this->getNode());`
`67`	`79`	`}`
`68`	`80`
	`81`	`+ /**`
	`82`	`+ * @param string[] $attributes`
	`83`	`+ */`
`69`	`84`	`public function getChildByNameAndAttributes(string $name, array $attributes): ?ElementHandler`
`70`	`85`	`{`
`71`	`86`	`$children = $this->getChildrenByNameAndAttributes($name, $attributes);`
`72`	`87`
`73`		`- return empty($children) ? null : array_shift($children);`
	`88`	`+ return array_shift($children);`
`74`	`89`	`}`
`75`	`90`
`76`	`91`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -4,6 +4,7 @@`
`4`	`4`
`5`	`5`	`namespace WsdlToPhp\DomHandler;`
`6`	`6`
	`7`	`+use DOMElement;`
`7`	`8`	`use DOMNode;`
`8`	`9`	`use DOMNodeList;`
`9`	`10`	`use Traversable;`
`@@ -28,6 +29,9 @@ public function getNode(): DOMNode`
`28`	`29`	`return $this->node;`
`29`	`30`	`}`
`30`	`31`
	`32`	`+ /**`
	`33`	`+ * @return DOMNodeList<DOMElement\|DOMNode>`
	`34`	`+ */`
`31`	`35`	`public function getChildNodes(): DOMNodeList`
`32`	`36`	`{`
`33`	`37`	`return $this->getNode()->childNodes;`
`@@ -77,6 +81,9 @@ public function hasAttributes(): bool`
`77`	`81`	`return $this->getNode()->hasAttributes();`
`78`	`82`	`}`
`79`	`83`
	`84`	`+ /**`
	`85`	`+ * @return AbstractAttributeHandler[]\|AbstractNodeHandler[]`
	`86`	`+ */`
`80`	`87`	`public function getAttributes(): array`
`81`	`88`	`{`
`82`	`89`	`return $this->getHandlers($this->getNode()->attributes);`
`@@ -87,6 +94,9 @@ public function hasChildren(): bool`
`87`	`94`	`return $this->getNode()->hasChildNodes();`
`88`	`95`	`}`
`89`	`96`
	`97`	`+ /**`
	`98`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`99`	`+ */`
`90`	`100`	`public function getChildren(): array`
`91`	`101`	`{`
`92`	`102`	`return $this->getHandlers($this->getNode()->childNodes);`
`@@ -126,6 +136,11 @@ public function getValueNamespace(): ?string`
`126`	`136`	`return null;`
`127`	`137`	`}`
`128`	`138`
	`139`	`+ /**`
	`140`	`+ * @param null\|Traversable<DOMNode> $nodes`
	`141`	`+ *`
	`142`	`+ * @return AbstractAttributeHandler[]\|AbstractElementHandler[]\|AbstractNodeHandler[]`
	`143`	`+ */`
`129`	`144`	`private function getHandlers(?Traversable $nodes): array`
`130`	`145`	`{`
`131`	`146`	`if (is_null($nodes)) {`