Add support for no-return

Author: mspirkov

src/PseudoTypes/NoReturn.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link      http://phpdoc.org
+ */
+
+namespace phpDocumentor\Reflection\PseudoTypes;
+
+use phpDocumentor\Reflection\PseudoType;
+use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\Types\Never_;
+
+/**
+ * Value Object representing the type 'no-return'.
+ *
+ * @psalm-immutable
+ */
+final class NoReturn extends Never_ implements PseudoType
+{
+    public function underlyingType(): Type
+    {
+        return new Never_();
+    }
+
+    public function __toString(): string
+    {
+        return 'no-return';
+    }
+}

src/TypeResolver.php

@@ -50,6 +50,7 @@
 use phpDocumentor\Reflection\PseudoTypes\NonNegativeInteger;
 use phpDocumentor\Reflection\PseudoTypes\NonPositiveInteger;
 use phpDocumentor\Reflection\PseudoTypes\NonZeroInteger;
+use phpDocumentor\Reflection\PseudoTypes\NoReturn;
 use phpDocumentor\Reflection\PseudoTypes\Numeric_;
 use phpDocumentor\Reflection\PseudoTypes\NumericString;
 use phpDocumentor\Reflection\PseudoTypes\ObjectShape;
@@ -186,6 +187,7 @@ final class TypeResolver
         'never' => Never_::class,
         'never-return' => NeverReturn::class,
         'never-returns' => NeverReturns::class,
+        'no-return' => NoReturn::class,
         'list' => List_::class,
         'non-empty-list' => NonEmptyList::class,
         'non-falsy-string' => NonFalsyString::class,

tests/unit/PseudoTypes/NoReturnTest.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link      http://phpdoc.org
+ */
+
+namespace phpDocumentor\Reflection\PseudoTypes;
+
+use phpDocumentor\Reflection\Types\Never_;
+use PHPUnit\Framework\TestCase;
+
+final class NoReturnTest extends TestCase
+{
+    public function testCreate(): void
+    {
+        $type = new NoReturn();
+
+        $this->assertEquals(new Never_(), $type->underlyingType());
+    }
+
+    public function testToString(): void
+    {
+        $this->assertSame('no-return', (string) (new NoReturn()));
+    }
+}

tests/unit/TypeResolverTest.php

@@ -50,6 +50,7 @@
 use phpDocumentor\Reflection\PseudoTypes\NonNegativeInteger;
 use phpDocumentor\Reflection\PseudoTypes\NonPositiveInteger;
 use phpDocumentor\Reflection\PseudoTypes\NonZeroInteger;
+use phpDocumentor\Reflection\PseudoTypes\NoReturn;
 use phpDocumentor\Reflection\PseudoTypes\Numeric_;
 use phpDocumentor\Reflection\PseudoTypes\NumericString;
 use phpDocumentor\Reflection\PseudoTypes\ObjectShape;
@@ -680,6 +681,7 @@ public function provideKeywords(): array
             ['never', Never_::class],
             ['never-return', NeverReturn::class],
             ['never-returns', NeverReturns::class],
+            ['no-return', NoReturn::class],
             ['literal-string', LiteralString::class],
             ['list', List_::class],
             ['non-empty-list', NonEmptyList::class],