The generic return type on CastAttributes::castUsing is ignored

[Watercycle]

Versions:

• ide-helper Version: 3.5.5
• Laravel Version: 11.44.2
• PHP Version: 8.3.19

Description:

I'm using spatie/laravel-data and have code along the lines of...

// SettingsData.php
class SettingsData extends Data implements Castable
{
    /**
     * @param  array<string, mixed>  $arguments
     * @return CastsAttributes<static, static>
     */
    public static function castUsing(array $arguments): CastsAttributes
    {
        return new PartialDataCast(static::class, $arguments);
    }
}

// PartialDataCast.php
use Spatie\LaravelData\Support\EloquentCasts\DataEloquentCast;

class PartialDataCast extends DataEloquentCast
{
    // ...
}

php artisan ide-helper:models results in doc-blocks along the lines of: \Spatie\LaravelData\Contracts\BaseData $settings

because ModelsCommand sees

class DataEloquentCast implements CastsAttributes
{
    // ...
    public function get($model, string $key, $value, array $attributes): ?BaseData

instead of the class I'm actually casting to (i.e. AssignmentSettingsData):

// AssignmentSettings.php
class AssignmentSettingsData extends SettingsData
{
    public bool $some_property = true;
}

// Assignment.php
class Assignment extends Model
{
    protected $casts = ['settings' => AssignmentSettingsData::class];
}

All this to say, it should be possible to specialize the return type instead of just returning BaseData so that AssignmentSettingsData was used from the start. DataEloquentCast is both vendor code and presents a use-case where the get type is too broad.

#1437 is a related, slightly different, issue I saw in the backlog. Ideally we can have out-of-the-box laravel-data support to encourage strict typing in PHP projects.

Steps To Reproduce:

See #1701 - also happy to do something here upon request.