feat: type a bare test() call as the bound test case

[ragulka]

The problem

$this in a test closure is typed as the bound test case. A bare test() call is not. Many suites call test()-> instead of $this->, so those calls get no checking:

uses(Tests\TestCase::class);

it('mocks a service', function (): void {
    $this->mokc(Service::class);   // error: Call to an undefined method Tests\TestCase::mokc()
    test()->mokc(Service::class);  // no error: type is TestCall|HigherOrderTapProxy
});

Projects hide the noise with a blanket ignore of Call to an undefined method Pest\PendingCalls\TestCall|Pest\Support\HigherOrderTapProxy::…. That ignore also hides real typos. Properties set through test()->name = … in a beforeEach stay mixed.

The change

Two commits.

1. TestFunctionReturnTypeExtension types a bare test() call as the bound test case. It is the same type $this gets in test closures. It uses a new PestTestCaseType::resolveIfBound(). resolve() is unchanged.
   • A file with no uses() or pest() binding keeps the declared return type of test(). Helper files outside a binding report nothing new.
   • test('description') is unchanged.
2. PestHookPropertyReader accepts a bare test() as the assignment receiver, as well as $this. test()->name = … in a beforeEach now types the property. Reads work through the existing TestCaseDynamicPropertyTypeExtension.

beforeEach(function (): void {
    test()->name = 'Ada';
});

it('reads it', function (): void {
    expect(test()->name)->toBeString(); // before: mixed
});

Tests

• tests/Fixtures/CustomTestCaseInference/Feature/test-function-custom-testcase.php: test() in a bound file, including hook properties.
• tests/Type/data/test-function.php: test() in an unbound file keeps its declared type.
• tests/Type/data/test-hook-properties.php: hook properties assigned through test().

Each new bound test fails when the matching change is disabled.

Checks

• pest: 529 passed (520 before)
• phpstan analyse at level max: 0 errors
• rector --dry-run: 0 changes
• pint --test: pass

The suite needed php -d memory_limit=2G vendor/bin/pest, run serially. At the default 128M it runs out of memory on a clean checkout too.

🤖 Generated with Claude Code

[MrPunyapal]

Should this be limited to test and hook closures?

Right now any bare test() call in a bound file gets the test case type, including calls inside normal helper functions. The new testBareTestCallInHelperFunction test makes that behavior explicit.

A file binding tells us which test case Pest will use, but it does not mean test() is always running in a test context. This seems broader than $this inference, which only exists inside the bound closures.

[ragulka]

Ah, good catch! Indeed, $this behaves a bit different, and I agree test() should follow it.

At runtime, a bare test() returns the test case only while a test is running. Inside a helper function, the type depends on the caller, so we can't know it.

Changed in 9ac88da.

Side note: $this (and also a bare test()) is typed as the test case inside a describe() body too, although that body runs before any test does (so it can't be the test case). It was like that before this PR and likely doesn't matter in practice, so I left it alone, but I'm happy to fix it if you want.