feat: update Eloquent Builder stubs to be more specific

[canvural]

• Added or updated tests
• Documented user facing changes
• Updated CHANGELOG.md

Resolves #1173

Changes

This PR updates Eloquent builder method stubs to be more specific. So the correct builder will be inferred inside the callbacks.

Breaking changes
none

[fragkp]

Hey @canvural!
Thanks for your work on this 👍

I've tested your branch in our project and here are the results:

UserChallenge::whereHas('challenge', fn (ChallengeBuilder) ...);

PHPStan Error:

expects (Closure(App\Models\Builders\UserChallengeBuilder): void)|(Closure(App\Models\Builders\UserChallengeBuilder): App\Models\Builders\UserChallengeBuilder)|null, 
Closure(App\Models\Builders\ChallengeBuilder): App\Models\Builders\ChallengeBuilder given.

Problem:
whereHas expects a custom eloquent builder of the given relation.

---

$this->hasOne(CompanyGoal::class)->where(fn (CompanyGoalBuilder $query) => ...);

PHPStan Error:

Parameter #1 $column of method Illuminate\Database\Eloquent\Relations\HasOne<App\Models\CompanyGoal>::where() expects
  array<int|string, mixed>|(Closure(Illuminate\Database\Eloquent\Relations\HasOne<App\Models\CompanyGoal>): void)|(Closure(Illuminate\Database\Eloquent\Relations\HasOne<App\Models\CompanyGoal>):    Illuminate\Database\Eloquent\Relations\HasOne<App\Models\CompanyGoal>)|Illuminate\Database\Query\Expression|string,
  Closure(App\Models\Builders\CompanyGoalBuilder): App\Models\Builders\CompanyGoalBuilder given.

Problem:
relation methods aren't allowed to use custom eloquent builders.

[canvural]

@fragkp Yes I know about that problem. That's why the PR is still in draft. And look like that problem will not be solved. PHPStan does not have a way to support it currently. So I'll revert the changes to relation existence methods.

[mabdullahsari]

@canvural Looks like this did the trick. Eyvallah.

[szepeviktor]

Eyvallah.

The Turkish "OK".