feat: create PhpStan type resolvers

[nikophil]

Here is a draft suggestion to add PHPStan type resolvers for factories' methods.

This would override the @phpstan-method stuff in the factories, and it has the big advantage to give us back the control over the type system, we could then update these as long as we're updating the code.

It has the drawback that we may need to support two versions of this: one for PHPStan, and another one for Psalm (and I'll have to learn how to make this for Psalm 😅) For now we can only drop the @phpstan-method generation with maker, and keep the @psalm-method annotation.

Some stuff still needs to be done:

• I would like to merge refactor: split Factory class #452 before we will merge it in the branch feat/split-factories
• We will be able to fix all type problems in refactor: split Factory class #452 (see here and here)
• add tests
• provide a foundry-phpstan.neon file
• update doc: remove references to @phpstan-method and show how it should be configured
• update make:factory
• create a CHANGELOG.md to explain existing @phpstan-method can be dropped in userland

we can even imagine that once we've made the subtree split, we'd create a zenstruck/foundry-phpstan package which will be a phpstan extension and be auto installed with phpstan/extension-installer

WDYT of this?

[kbond]

Neat! Yeah, I agree to wait for #452

[nikophil]

I couldn't get rid of all these phpstan errors 🤷

[nikophil]

I'm more and more thinking to analyse ./tests folder with phpstan... this will be useful to battle test the phpstan extension

[kbond]

I'm good to merge this into feat/split-factories

What about the todos though?