feat: allows to chain todo

src/Functions.php

@@ -87,7 +87,7 @@ if (! function_exists('test')) {
      * is the test description; the second argument is
      * a closure that contains the test expectations.
      *
-     * @return TestCall|TestCase|mixed
+     * @return HigherOrderTapProxy<TestCall|TestCase>|TestCall
      */
     function test(string $description = null, Closure $closure = null): HigherOrderTapProxy|TestCall
     {
@@ -130,10 +130,11 @@ if (! function_exists('todo')) {
      */
     function todo(string $description): TestCall
     {
-        /* @phpstan-ignore-next-line */
-        return test($description, fn () => self::markTestSkipped(
-            '__TODO__',
-        ));
+        $test = test($description);
+
+        assert($test instanceof TestCall);
+
+        return $test->skip('__TODO__');
     }
 }
 

src/PendingCalls/TestCall.php

@@ -170,6 +170,16 @@ final class TestCall
         return $this;
     }
 
+    /**
+     * Sets the test as "todo".
+     */
+    public function todo(): self
+    {
+        $this->skip('__TODO__');
+
+        return $this;
+    }
+
     /**
      * Sets the covered classes or methods.
      */

src/Support/ExceptionTrace.php

@@ -44,7 +44,7 @@ final class ExceptionTrace
      */
     public static function removePestReferences(Throwable $t): void
     {
-        if (! property_exists($t, 'serializableTrace')) { // @phpstan-ignore-line
+        if (! property_exists($t, 'serializableTrace')) {
             return;
         }
 

src/Support/HigherOrderTapProxy.php

@@ -10,6 +10,10 @@ use Throwable;
 
 /**
  * @internal
+ *
+ * @template TProxy
+ *
+ * @mixin TProxy
  */
 final class HigherOrderTapProxy
 {