Add a return type using phpdoc to fix IDE autocomplete (#292)

The make function can't define a return type, because the result could be a Decorator, or the actual action.
However, without docblocks or type-hinting, PHPStorm ends up providing incorrect autocomplete information.
The solution is to instead add back a phpdoc comment for this specific use case.

See #285 and #287 for more details.

Author: TaylorWilton

src/Concerns/AsObject.php

@@ -6,6 +6,9 @@
 
 trait AsObject
 {
+    /**
+     * @return static
+     */
     public static function make()
     {
         return app(static::class);

tests/AsActionTest.php

@@ -85,11 +85,15 @@ public function asCommand(Command $command): void
     expect(AsActionTest::$latestResult)->toBe(42);
 });
 
-it('returns void when calling make()', function () {
-    // Make sure that the static function ::make() returns not a type.
-    $result = (new \ReflectionMethod(AsActionTest::class, 'make'))->getReturnType();
+it('uses a comment instead of a return type on make()', function () {
+    // Make sure that the static function ::make() does not have a return type.
+    $reflectionMethod = new \ReflectionMethod(AsActionTest::class, 'make');
 
-    expect($result)->toBeEmpty();
+    $returnType = $reflectionMethod->getReturnType();
+    $docComment = $reflectionMethod->getDocComment();
+
+    expect($returnType)->toBeEmpty();
+    expect($docComment)->toContain('@return static');
 });
 
 it('runs as a controller', function () {