Add PHPStan stub for ResponseFactory::image() macro

[k1rana]

Summary

Resolves #24

Larastan reports Call to an undefined method Illuminate\Contracts\Routing\ResponseFactory::image() because the image() macro is registered at runtime via ServiceProvider::boot(), which static analysis tools cannot detect.

This PR adds a PHPStan stub and extension config so PHPStan/Larastan recognizes the image() method on ResponseFactory

Changes

• stubs/ResponseFactory.stub — Declares image() via @method PHPDoc on Illuminate\Contracts\Routing\ResponseFactory, matching the macro signature in ServiceProvider.php
• extension.neon— Registers the stub with PHPStan
• composer.json — Added extra.phpstan.includes for auto-discovery (zero user config needed)

Verification

vendor/bin/phpstan analyse fixture.php -c extension.neon --level=max

// fixture.php
<?php

use Illuminate\Contracts\Routing\ResponseFactory;
use Intervention\Image\Image;

function test(ResponseFactory $factory, Image $image): void
{
    $factory->image($image);
    $factory->image($image, 'webp');
    $factory->image($image, null, quality: 80);
}

Expected Result

[olivervogel]

Thank you. I wonder if this could be solved more easily with a hint in a comment without having to go through phpstan. I also have a few questions.

[olivervogel]

The name of this file is very ambiguous. Could you make it more clear, that this file belongs to phpstan?

[olivervogel]

I wonder if this will cause problems, since phpstan is part of the dependencies. Also: Where is phpstan defined in the composer.json schema? I can't find anything about it. It's included in extra, I missed that.