Detect data from collection

[clementbirkle]

This PR introduces a new feature that allows the use of well-annotated collections without the need for annotations inside the Data class. By ensuring that collections are well-annotated, we can achieve strong typing and better static analysis, eliminating the need to redundantly annotate properties in classes that utilize these collections.

For example:

// before
use App\Data\SongData;
use Illuminate\Support\Collection;

class AlbumData extends Data
{    
    /** @var Collection<int, SongData> */
    public Collection $songs;
}

// after
use App\Collection\SongDataCollection;

class AlbumData extends Data
{    
    public SongDataCollection $songs;
}

[rubenvanassche]

Cool PR!

Two remarks about caching + could you also add a more integration like test in DataTest where you create a data object with such a special DataCollection property? Then we know for sure everything is working.

Thanks!

[clementbirkle]

@rubenvanassche Thank you for your remarks. I have created an integration test and added some caching.
Please let me know if I need to change anything else.

PS: I noticed a new error with PHPStan, but I don't think it's linked to this PR:

------ ---------------------------------------------------------------------------------------------------------------------------------------------------------- 
  Line   src/Support/Validation/RuleDenormalizer.php                                                                                                               
 ------ ---------------------------------------------------------------------------------------------------------------------------------------------------------- 
         Ignored error pattern #^Call to method Illuminate\\Support\\Collection<\(int\|string\),string\|null>\:\:isEmpty\(\) will always evaluate to false\.$# in  
         path /Users/clementbirkle/www/tests/laravel-data/src/Support/Validation/RuleDenormalizer.php was not matched in reported errors.                          
 ------ ---------------------------------------------------------------------------------------------------------------------------------------------------------- 

[rubenvanassche]

Thanks!