Add NoDiscard attributes

psalm.xml

@@ -14,4 +14,7 @@
             <directory name="vendor" />
         </ignoreFiles>
     </projectFiles>
+    <issueHandlers>
+        <UndefinedAttributeClass errorLevel="suppress" />
+    </issueHandlers>
 </psalm>

src/Document.php

@@ -36,11 +36,13 @@ private function __construct(
      *
      * @param Sequence<Node|Element|Custom>|null $children
      */
+    #[\NoDiscard]
     public static function of(Type $type, ?Sequence $children = null): self
     {
         return new self($type, $children ?? Sequence::of());
     }
 
+    #[\NoDiscard]
     public function type(): Type
     {
         return $this->type;
@@ -49,11 +51,13 @@ public function type(): Type
     /**
      * @return Sequence<Node|Element|Custom>
      */
+    #[\NoDiscard]
     public function children(): Sequence
     {
         return $this->children;
     }
 
+    #[\NoDiscard]
     public function hasChildren(): bool
     {
         return !$this->children->empty();
@@ -62,6 +66,7 @@ public function hasChildren(): bool
     /**
      * @param callable(Node|Element|Custom): bool $filter
      */
+    #[\NoDiscard]
     public function filterChild(callable $filter): self
     {
         return new self(
@@ -73,6 +78,7 @@ public function filterChild(callable $filter): self
     /**
      * @param callable(Node|Element|Custom): (Node|Element|Custom) $map
      */
+    #[\NoDiscard]
     public function mapChild(callable $map): self
     {
         return new self(
@@ -81,6 +87,7 @@ public function mapChild(callable $map): self
         );
     }
 
+    #[\NoDiscard]
     public function prependChild(Node|Element|Custom $child): self
     {
         return new self(
@@ -89,6 +96,7 @@ public function prependChild(Node|Element|Custom $child): self
         );
     }
 
+    #[\NoDiscard]
     public function appendChild(Node|Element|Custom $child): self
     {
         return new self(
@@ -97,6 +105,7 @@ public function appendChild(Node|Element|Custom $child): self
         );
     }
 
+    #[\NoDiscard]
     public function asContent(Format $format = Format::pretty): Content
     {
         /** @var Maybe<XMLDocument\Encoding> */

src/Element/A.php

@@ -30,6 +30,7 @@ private function __construct(
      * @param Sequence<Attribute>|null $attributes
      * @param Sequence<Node|Element|Custom>|null $children
      */
+    #[\NoDiscard]
     public static function of(
         Url $href,
         ?Sequence $attributes = null,
@@ -45,12 +46,14 @@ public static function of(
         );
     }
 
+    #[\NoDiscard]
     public function href(): Url
     {
         return $this->href;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function normalize(): Element
     {
         return $this->element->addAttribute(

src/Element/Base.php

@@ -28,6 +28,7 @@ private function __construct(
      *
      * @param Sequence<Attribute>|null $attributes
      */
+    #[\NoDiscard]
     public static function of(Url $href, ?Sequence $attributes = null): self
     {
         return new self($href, Element::selfClosing(
@@ -36,12 +37,14 @@ public static function of(Url $href, ?Sequence $attributes = null): self
         ));
     }
 
+    #[\NoDiscard]
     public function href(): Url
     {
         return $this->href;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function normalize(): Element
     {
         return $this->element->addAttribute(

src/Element/Img.php

@@ -28,6 +28,7 @@ private function __construct(
      *
      * @param Sequence<Attribute>|null $attributes
      */
+    #[\NoDiscard]
     public static function of(Url $src, ?Sequence $attributes = null): self
     {
         return new self($src, Element::selfClosing(
@@ -36,12 +37,14 @@ public static function of(Url $src, ?Sequence $attributes = null): self
         ));
     }
 
+    #[\NoDiscard]
     public function src(): Url
     {
         return $this->src;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function normalize(): Element
     {
         return $this->element->addAttribute(

src/Element/Link.php

@@ -33,6 +33,7 @@ private function __construct(
      * @param non-empty-string $relationship
      * @param Sequence<Attribute>|null $attributes
      */
+    #[\NoDiscard]
     public static function of(
         Url $href,
         string $relationship,
@@ -48,6 +49,7 @@ public static function of(
         );
     }
 
+    #[\NoDiscard]
     public function href(): Url
     {
         return $this->href;
@@ -56,12 +58,14 @@ public function href(): Url
     /**
      * @return non-empty-string
      */
+    #[\NoDiscard]
     public function relationship(): string
     {
         return $this->relationship;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function normalize(): Element
     {
         return $this

src/Element/Script.php

@@ -26,6 +26,7 @@ private function __construct(private Element $element)
      *
      * @param Sequence<Attribute>|null $attributes
      */
+    #[\NoDiscard]
     public static function of(Node $text, ?Sequence $attributes = null): self
     {
         return new self(Element::of(
@@ -36,6 +37,7 @@ public static function of(Node $text, ?Sequence $attributes = null): self
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function normalize(): Element
     {
         return $this->element;

src/Reader.php

@@ -23,6 +23,7 @@ private function __construct(private Translator $translate)
     /**
      * @return Attempt<Document|Node|Element|Custom>
      */
+    #[\NoDiscard]
     public function __invoke(Content $html): Attempt
     {
         $content = $html->toString();
@@ -41,6 +42,7 @@ public function __invoke(Content $html): Attempt
         }
     }
 
+    #[\NoDiscard]
     public static function new(): self
     {
         return new self(

src/Translator.php

@@ -39,6 +39,7 @@ private function __construct(
     /**
      * @return Attempt<Document|Element|Custom|Node>
      */
+    #[\NoDiscard]
     public function __invoke(\Dom\Node $node): Attempt
     {
         return $this
@@ -49,6 +50,7 @@ public function __invoke(\Dom\Node $node): Attempt
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function new(): self
     {
         return new self(XmlTranslator::of(

src/Visitor/Element.php

@@ -30,6 +30,7 @@ private function __construct(private string $name)
     /**
      * @return Maybe<Model|Custom>
      */
+    #[\NoDiscard]
     public function __invoke(Document|Node|Model|Custom $node): Maybe
     {
         return match (true) {
@@ -45,6 +46,7 @@ public function __invoke(Document|Node|Model|Custom $node): Maybe
      *
      * @param non-empty-string $name
      */
+    #[\NoDiscard]
     public static function of(string $name): self
     {
         return new self($name);
@@ -53,6 +55,7 @@ public static function of(string $name): self
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function head(): self
     {
         return new self('head');
@@ -61,6 +64,7 @@ public static function head(): self
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function body(): self
     {
         return new self('body');

src/Visitor/Elements.php

@@ -26,6 +26,7 @@ private function __construct(private string $name)
     /**
      * @return Sequence<Element|Custom>
      */
+    #[\NoDiscard]
     public function __invoke(Document|Node|Element|Custom $node): Sequence
     {
         return match (true) {
@@ -41,6 +42,7 @@ public function __invoke(Document|Node|Element|Custom $node): Sequence
      *
      * @param non-empty-string $name
      */
+    #[\NoDiscard]
     public static function of(string $name): self
     {
         return new self($name);