PHP 8 Attributes

use Geni\Laravel\Attributes\Endpoint;
use Geni\Laravel\Attributes\Group;
use Geni\Laravel\Attributes\Hidden;

#[Group('Articles', 'Endpoints for managing blog articles')]
class ArticleController
{
    #[Endpoint(
        title: 'Publish an article',
        description: 'Changes article status to published and notifies subscribers.',
        operationId: 'articles.publish',
        deprecated: false
    )]
    public function publish(Article $article) {}

    #[Hidden]
    public function internalWebhook() {}
}

use Geni\Laravel\Attributes\PathParameter;
use Geni\Laravel\Attributes\QueryParameter;
use Geni\Laravel\Attributes\HeaderParameter;

class ArticleController
{
    #[QueryParameter(
        name: 'include_drafts',
        description: 'Whether to include unpublished draft articles.',
        type: 'boolean',
        default: false
    )]
    #[HeaderParameter(
        name: 'X-Client-Version',
        description: 'Client application version identifier.',
        type: 'string'
    )]
    public function index() {}
}

use Geni\Laravel\Attributes\Response;
use Geni\Laravel\Attributes\Example;

class ArticleController
{
    #[Response(
        status: 201,
        description: 'Article successfully created.',
        type: ArticleResource::class
    )]
    #[Response(
        status: 422,
        description: 'Validation failed.'
    )]
    public function store() {}
}

use Geni\Laravel\Attributes\BodyParameter;

class StoreArticleRequest extends FormRequest
{
    #[BodyParameter(
        name: 'title',
        description: 'The unique title for the article.',
        example: 'Getting Started with Geni'
    )]
    public function rules(): array
    {
        return [
            'title' => 'required|string',
        ];
    }
}