formatting

Author: Jaco Labuschagne

src/Errors/XmlParserException.php

@@ -4,9 +4,12 @@
 
 namespace Zodimo\Xml\Errors;
 
-class XmlParserException extends \Exception implements \Throwable
+use Exception;
+use Throwable;
+
+class XmlParserException extends Exception implements Throwable
 {
-    public static function create(string $message, int $code = 0, ?\Throwable $previous = null): XmlParserException
+    public static function create(string $message, int $code = 0, ?Throwable $previous = null): XmlParserException
     {
         return new self($message, $code, $previous);
     }

src/Errors/XmlParsingException.php

@@ -4,9 +4,12 @@
 
 namespace Zodimo\Xml\Errors;
 
-class XmlParsingException extends \Exception implements \Throwable
+use Exception;
+use Throwable;
+
+class XmlParsingException extends Exception implements Throwable
 {
-    public static function create(string $message, int $code = 0, ?\Throwable $previous = null): XmlParsingException
+    public static function create(string $message, int $code = 0, ?Throwable $previous = null): XmlParsingException
     {
         return new self($message, $code, $previous);
     }

src/RegisterListenerInterface.php

@@ -4,6 +4,7 @@
 
 namespace Zodimo\Xml;
 
+use XMLReader;
 use Zodimo\BaseReturn\IOMonad;
 use Zodimo\Xml\Errors\XmlParserException;
 
@@ -14,5 +15,5 @@ interface RegisterListenerInterface
      *
      * @return IOMonad<XmlReaderParser,XmlParserException>
      */
-    public function registerCallback(string $xpath, callable $callback, int $nodeType = \XMLReader::ELEMENT): IOMonad;
+    public function registerCallback(string $xpath, callable $callback, int $nodeType = XMLReader::ELEMENT): IOMonad;
 }

src/SimpleXmlReaderInterface.php

@@ -4,9 +4,34 @@
 
 namespace Zodimo\Xml;
 
+use DOMDocument;
+use SimpleXMLElement;
 use XMLReader;
+use Zodimo\Xml\Errors\XmlParsingException;
 
 /**
  * @mixin XMLReader
  */
-interface SimpleXmlReaderInterface {}
+interface SimpleXmlReaderInterface
+{
+    /**
+     * Expand current node to string.
+     *
+     * @throws XmlParsingException
+     */
+    public function expandString(string $version = '1.0', string $encoding = 'UTF-8'): string;
+
+    /**
+     * Expand current node to SimpleXMLElement.
+     *
+     * @throws XmlParsingException
+     */
+    public function expandSimpleXml(string $version = '1.0', string $encoding = 'UTF-8', ?string $className = null): SimpleXMLElement;
+
+    /**
+     * Expand current node to DomDocument.
+     *
+     * @throws XmlParsingException
+     */
+    public function expandDomDocument(string $version = '1.0', string $encoding = 'UTF-8'): DOMDocument;
+}

src/XmlReaderParser.php

@@ -275,11 +275,9 @@ public function expandXpath(string $path, string $version = '1.0', string $encod
     /**
      * Expand current node to string.
      *
-     * @return string
-     *
      * @throws XmlParsingException
      */
-    public function expandString(string $version = '1.0', string $encoding = 'UTF-8')
+    public function expandString(string $version = '1.0', string $encoding = 'UTF-8'): string
     {
         $simpleXmlElement = $this->expandSimpleXml($version, $encoding);
         // https://www.php.net/manual/en/simplexmlelement.asxml.php