chore(deps-dev): bump larastan/larastan from 2.9.8 to 3.0.2

[dependabot]

Bumps larastan/larastan from 2.9.8 to 3.0.2.

Release notes

Sourced from larastan/larastan's releases.

v3.0.1

What's Changed

Fixed

• Fix typo in address #2125 by @​spoyntersmith in larastan/larastan#2130
• fix: relation forwarding by @​calebdw in larastan/larastan#2119

Internal

• Update README.md by @​Tamas-hi in larastan/larastan#2117

Also changes from 2.9.12

New Contributors

• @​Tamas-hi made their first contribution in larastan/larastan#2117
• @​spoyntersmith made their first contribution in larastan/larastan#2130

Full Changelog: larastan/larastan@v3.0.0...v3.0.1

3.0.0

Larastan 3.0 🥳

This release adds compability with PHPStan 2 and drops support for Laravel versions < 11

Please make sure you read the both PHPStan's and Larastan's upgrade guides!

Notable changes:

• Added support for PHPStan 2
• Dropped support for Laravel versions <11
• Dropped support for automatically adding generic return types for relations. Read the upgrade guide for more info.
• Removed some PHPStan config options. If you want the same behavior as before, you can add them back yourselves.
• Made some rules enabled by default.

v2.9.12

What's Changed

Added

• Dynamically determine return type for Collection::reject by @​spawnia in larastan/larastan#2107

Fixed

• fix: relation forwarding by @​calebdw in larastan/larastan#2119

Full Changelog: larastan/larastan@v2.9.11...v2.9.12

2.9.11

What's Changed

Fixed

• fix: improve PHPDoc for find method of QueryBuilder to support FETCH_ASSOC by @​kayw-geek in larastan/larastan#2081
• fix: don't report error when using Builder<*> by @​calebdw in larastan/larastan#2099
• fix: fix declaring class for forwarded relation methods f476d8f0fdf4b22f8b14d85f48c289549202f411

... (truncated)

Upgrade guide

Sourced from larastan/larastan's upgrade guide.

Upgrade Guide

Upgrading to 3.0 from 2.x

This is a new major release with lots of breaking changes.

Please first read PHPStan's 2.0 upgrade guide here carefully.

Correct return types for model relation methods

Likelihood Of Impact: High

Normally PHPStan warns the users when a return type of method does not provide its generic types. For example, the following code will produce a PHPStan error:

class User extends Model
{
    public function posts(): HasMany
    {
        return $this->hasMany(Post::class);
    }
}
// Method User::posts() return type with generic class HasMany does not specify its types: TRelatedModel, TDeclaringModel

In the previous versions of Larastan, in this case Larastan would parse the model file and read the method body to understand the generic types of the relation. But this approach is slow (because it requires parsing the file) and the maintenance of this feature is hard. So in this version, Larastan will not parse the method body to understand the generic types of the relation. Instead, you need to provide the correct generic types in the return type of the relation method. Here is how you can fix the above example:

class User extends Model
{
    /**
     * @return HasMany<Post, $this>
     */
    public function posts(): HasMany
    {
        return $this->hasMany(Post::class);
    }
}

Manually adding these annotations can be tedious. To help with this, we've created a Rector rule that can automatically add them for you! You can use this rule to automatically add the correct generic annotations. It detects your Laravel version and adds the appropriate generic types accordingly.

If you're not currently using Rector, or can't use it due to dependency conflicts, don't worry! We've also prepared a simple script that can run Rector for you without requiring a full installation.

First install cpx:

composer global require cpx/cpx

Then download this script from the gist and run with:

... (truncated)

Commits

• b2e24e1 chore: update minimum PHPStan version
• 86abf11 fix: relation forwarding (#2119)
• 7a2819a fix tests
• ef598cc feat: dynamically determine return type for Collection::reject (#2107)
• a677364 chore: update stubs
• 4f97683 fix: a typo (#2130)
• 60d434e fix tests
• 4935474 chore: update README (#2117)
• 02f35d2 fix: reorganize tests
• 88f46e3 chore: update README
• Additional commits viewable in compare view

You can trigger a rebase of this PR by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

Note
Automatic rebases have been disabled on this pull request as it has been open for over 30 days.

[dependabot]

Superseded by #46.