Enhance Nova Resource Stubs to Support Type-Hinted Models

[nastoychev]

Hello Nova Team,

I would like to propose an enhancement to the default Nova Resource stubs to include proper type hints for associated models. This would improve IDE auto-completion, static analysis (PHPStan/Psalm), and developer experience when working with Nova resources.

🚀 Proposed Stub Enhancement

Currently, Nova’s default stubs for resources do not include generic model type annotations, making it harder to get accurate type hints in IDEs.

I suggest updating the stub to include:

<?php

namespace {{ namespace }};

use Illuminate\Http\Request;
use Laravel\Nova\Fields\ID;
use Laravel\Nova\Http\Requests\NovaRequest;

/**
 * @template TModel of \{{ namespacedModel }}
 *
 * @mixin TModel
 * @property-read TModel|null $resource
 * @method \{{ namespacedModel }}|null model()
 * @method static \{{ namespacedModel }} newModel()
 */
class {{ class }} extends Resource

✅Benefits of This Change

1. Improved IDE Auto-Completion
2. Makes $this->resource and $this->model() properly recognized as an instance of the associated model.
3. Better Static Analysis Support
4. Tools like PHPStan and Psalm can properly infer resource-related models, reducing type-related errors.
5. More Consistent Developer Experience
6. This aligns with Laravel's best practices and allows smoother integration with typed properties and generics.