feat: improve return types for Collection::first, last, get and pull when default value is given.

[bastien-phi]

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

Changes

This PR improves return type resolution for Collection::first, last, get and pull when default value is given.

Today,

User::all()->first(default: new User);

is typed as User|null, even if it actually never returns null.

With this PR, it will be typed as User.

Strange calls are also supported

User::all()->first(default: 42); // User|int

(I really don't know why someone would write this but why not ?)

This PR does not add support for callable as default

User::all()->first(default: fn() => new User);

My guess is it will be a little bit more complicated than just a stub update.

Breaking changes

I hope there won't be any

[szepeviktor]

Thank you.

[canvural]

Hi,

Thank you. It looks good. Just left two tiny comments.

[canvural]

If you can rebase and fix the conflicts we can merge! 👍🏽

[bastien-phi]

Should be good !

[canvural]

Thank you!

[bastien-phi]

Glad to contribute !