Refactor encoding to use EncoderInterface

Replaces usage of the concrete Encoder class with EncoderInterface throughout the codebase for improved abstraction and flexibility. Updates type hints, exception handling, and relevant docblocks to reflect the new interface usage.

https: //github.com/paquettg/pull/321
Co-Authored-By: dakur <[email protected]>

Author: mr-chetan

src/PHPHtmlParser/DTO/Tag/AttributeDTO.php

@@ -4,8 +4,8 @@
 
 namespace PHPHtmlParser\DTO\Tag;
 
-use stringEncode\Exception;
-use StringEncoder\Encoder;
+use StringEncoder\Contracts\EncoderInterface;
+use StringEncoder\Exceptions\InvalidEncodingException;
 
 use function htmlspecialchars_decode;
 use function is_null;
@@ -54,9 +54,9 @@ public function htmlspecialcharsDecode(): void
     }
 
     /**
-     * @throws Exception
+     * @throws InvalidEncodingException
      */
-    public function encodeValue(Encoder $encode)
+    public function encodeValue(EncoderInterface $encode)
     {
         if ($this->value !== null) {
             $this->value = $encode->convert()->fromString($this->value)->toString();

src/PHPHtmlParser/Dom/Node/AbstractNode.php

@@ -12,7 +12,7 @@
 use PHPHtmlParser\Exceptions\Tag\AttributeNotFoundException;
 use PHPHtmlParser\Finder;
 use PHPHtmlParser\Selector\Selector;
-use StringEncoder\Encoder;
+use StringEncoder\Contracts\EncoderInterface;
 
 use function is_null;
 use function is_string;
@@ -61,7 +61,7 @@ abstract class AbstractNode
     /**
      * The encoding class used to encode strings.
      *
-     * @var mixed
+     * @var EncoderInterface|null
      */
     protected $encode;
 
@@ -230,7 +230,7 @@ public function delete()
      *
      * @return void
      */
-    public function propagateEncoding(Encoder $encode)
+    public function propagateEncoding(EncoderInterface $encode)
     {
         $this->encode = $encode;
         $this->tag->setEncoding($encode);

src/PHPHtmlParser/Dom/Node/InnerNode.php

@@ -8,7 +8,7 @@
 use PHPHtmlParser\Exceptions\ChildNotFoundException;
 use PHPHtmlParser\Exceptions\CircularException;
 use PHPHtmlParser\Exceptions\LogicalException;
-use StringEncoder\Encoder;
+use StringEncoder\Contracts\EncoderInterface;
 
 use function array_combine;
 use function array_keys;
@@ -46,7 +46,7 @@ abstract class InnerNode extends ArrayNode
      * Sets the encoding class to this node and propagates it
      * to all its children.
      */
-    public function propagateEncoding(Encoder $encode): void
+    public function propagateEncoding(EncoderInterface $encode): void
     {
         $this->encode = $encode;
         $this->tag->setEncoding($encode);

src/PHPHtmlParser/Dom/Parser.php

@@ -18,6 +18,7 @@
 use PHPHtmlParser\Exceptions\StrictException;
 use PHPHtmlParser\Options;
 use StringEncoder\Encoder;
+use StringEncoder\Contracts\EncoderInterface;
 
 use function in_array;
 use function is_null;
@@ -251,7 +252,7 @@ private function parseTag(Options $options, Content $content, int $size): TagDTO
     /**
      * @throws ChildNotFoundException
      */
-    private function detectHTML5Charset(Encoder $encode, AbstractNode $root): bool
+    private function detectHTML5Charset(EncoderInterface $encode, AbstractNode $root): bool
     {
         /** @var AbstractNode|null $meta */
         $meta = $root->find('meta[charset]', 0);

src/PHPHtmlParser/Dom/Tag.php

@@ -6,7 +6,8 @@
 
 use PHPHtmlParser\DTO\Tag\AttributeDTO;
 use PHPHtmlParser\Exceptions\Tag\AttributeNotFoundException;
-use StringEncoder\Encoder;
+use StringEncoder\Contracts\EncoderInterface;
+use StringEncoder\Exceptions\InvalidEncodingException;
 use TypeError;
 
 use function array_keys;
@@ -58,7 +59,7 @@ class Tag
     /**
      * The encoding class to... encode the tags.
      *
-     * @var Encoder|null
+     * @var EncoderInterface|null
      */
     protected $encode;
 
@@ -152,7 +153,7 @@ public function isSelfClosing(): bool
     /**
      * Sets the encoding type to be used.
      */
-    public function setEncoding(Encoder $encode): void
+    public function setEncoding(EncoderInterface $encode): void
     {
         $this->encode = $encode;
     }
@@ -282,7 +283,7 @@ public function setAttributes(array $attr)
      *
      * @return AttributeDTO[]
      *
-     * @throws \stringEncode\Exception
+     * @throws InvalidEncodingException
      */
     public function getAttributes(): array
     {
@@ -303,7 +304,7 @@ public function getAttributes(): array
      * Returns an attribute by the key.
      *
      * @throws AttributeNotFoundException
-     * @throws \stringEncode\Exception
+     * @throws InvalidEncodingException
      */
     public function getAttribute(string $key): AttributeDTO
     {
@@ -358,6 +359,7 @@ public function makeOpeningTag()
             }
 
             $val = $attributeDTO->getValue();
+
             if (is_null($val)) {
                 $return .= ' ' . $key;
             } elseif ($attributeDTO->isDoubleQuote()) {