Add NoDiscard attributes

psalm.xml

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

src/CallFrame.php

@@ -13,6 +13,9 @@ interface CallFrame
     /**
      * @return Sequence<mixed>
      */
+    #[\NoDiscard]
     public function arguments(): Sequence;
+
+    #[\NoDiscard]
     public function toString(): string;
 }

src/CallFrame/FunctionCall.php

@@ -39,6 +39,7 @@ private function __construct(
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(
         FunctionName $functionName,
         Url $file,
@@ -48,30 +49,35 @@ public static function of(
         return new self($functionName, $file, $line, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function functionName(): FunctionName
     {
         return $this->functionName;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function file(): Url
     {
         return $this->file;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function line(): Line
     {
         return $this->line;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->functionName->toString()}()";

src/CallFrame/InternalFunctionCall.php

@@ -31,23 +31,27 @@ private function __construct(FunctionName $functionName, mixed ...$arguments)
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(FunctionName $functionName, mixed ...$arguments): self
     {
         return new self($functionName, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function functionName(): FunctionName
     {
         return $this->functionName;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->functionName->toString()}()";

src/CallFrame/InternalMethodCall.php

@@ -37,6 +37,7 @@ private function __construct(
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(
         ClassName $class,
         Method $method,
@@ -45,23 +46,27 @@ public static function of(
         return new self($class, $method, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function class(): ClassName
     {
         return $this->class;
     }
 
+    #[\NoDiscard]
     public function method(): Method
     {
         return $this->method;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->class->toString()}->{$this->method->toString()}()";

src/CallFrame/InternalStaticMethodCall.php

@@ -37,6 +37,7 @@ private function __construct(
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(
         ClassName $class,
         Method $method,
@@ -45,23 +46,27 @@ public static function of(
         return new self($class, $method, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function class(): ClassName
     {
         return $this->class;
     }
 
+    #[\NoDiscard]
     public function method(): Method
     {
         return $this->method;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->class->toString()}::{$this->method->toString()}()";

src/CallFrame/MethodCall.php

@@ -43,6 +43,7 @@ private function __construct(
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(
         ClassName $class,
         Method $method,
@@ -53,35 +54,41 @@ public static function of(
         return new self($class, $method, $file, $line, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function class(): ClassName
     {
         return $this->class;
     }
 
+    #[\NoDiscard]
     public function method(): Method
     {
         return $this->method;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function file(): Url
     {
         return $this->file;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function line(): Line
     {
         return $this->line;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->class->toString()}->{$this->method->toString()}()";

src/CallFrame/StaticMethodCall.php

@@ -43,6 +43,7 @@ private function __construct(
      * @no-named-arguments
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(
         ClassName $class,
         Method $method,
@@ -53,35 +54,41 @@ public static function of(
         return new self($class, $method, $file, $line, ...$arguments);
     }
 
+    #[\NoDiscard]
     public function class(): ClassName
     {
         return $this->class;
     }
 
+    #[\NoDiscard]
     public function method(): Method
     {
         return $this->method;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function file(): Url
     {
         return $this->file;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function line(): Line
     {
         return $this->line;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function arguments(): Sequence
     {
         return $this->arguments;
     }
 
     #[\Override]
+    #[\NoDiscard]
     public function toString(): string
     {
         return "{$this->class->toString()}::{$this->method->toString()}()";

src/CallFrame/UserLand.php

@@ -14,6 +14,9 @@
  */
 interface UserLand extends CallFrame
 {
+    #[\NoDiscard]
     public function file(): Url;
+
+    #[\NoDiscard]
     public function line(): Line;
 }

src/CallFrames.php

@@ -13,6 +13,7 @@ final class CallFrames
      *
      * @return Sequence<CallFrame>
      */
+    #[\NoDiscard]
     public static function of(\Throwable $throwable): Sequence
     {
         $frames = [];

src/ClassName.php

@@ -25,11 +25,13 @@ private function __construct(string $value)
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(string $value): self
     {
         return new self($value);
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return $this->value;

src/FormatPath.php

@@ -13,5 +13,6 @@ interface FormatPath
     /**
      * @return non-empty-string
      */
+    #[\NoDiscard]
     public function __invoke(Url $url, Line $line): string;
 }

src/FormatPath/Truncate.php

@@ -37,6 +37,7 @@ public function __invoke(Url $url, Line $line): string
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(Url $workingDirectory): self
     {
         return new self($workingDirectory);

src/FunctionName.php

@@ -25,11 +25,13 @@ private function __construct(string $value)
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(string $value): self
     {
         return new self($value);
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return $this->value;

src/Line.php

@@ -24,16 +24,19 @@ private function __construct(int $value)
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(int $value): self
     {
         return new self($value);
     }
 
+    #[\NoDiscard]
     public function toInt(): int
     {
         return $this->value;
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return (string) $this->value;

src/Link.php

@@ -10,5 +10,6 @@
  */
 interface Link
 {
+    #[\NoDiscard]
     public function __invoke(Url $file, Line $line): Url;
 }

src/Method.php

@@ -25,11 +25,13 @@ private function __construct(string $value)
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(string $value): self
     {
         return new self($value);
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return $this->value;

src/Render.php

@@ -33,6 +33,7 @@ private function __construct(?Link $link = null, ?FormatPath $formatPath = null)
         $this->formatPath = $formatPath ?? new FormatPath\FullPath;
     }
 
+    #[\NoDiscard]
     public function __invoke(StackTrace $stack): Content
     {
         $thrown = $this->thrown(
@@ -63,6 +64,7 @@ public function __invoke(StackTrace $stack): Content
     /**
      * @psalm-pure
      */
+    #[\NoDiscard]
     public static function of(?Link $link = null, ?FormatPath $formatPath = null): self
     {
         return new self($link, $formatPath);