[WIP] feat: Property types from phpdocs

[chrisvanlier2005]

Still work in progress, need to add some tests. Bit i've opened it early to gauge interest

---

The logic is modularized using a PropertyExtractor interface, allowing for distinct strategies to handle different locations where type information might be defined.

Examples

Here are the specific class scenarios that are now supported with this extension:

Standard Properties with @var

Types are now inferred from the @var annotation above the property definition.

class UserData
{
    /** @var string */
    public $name;

    /** @var \Illuminate\Support\Collection<int, string> */
    public $tags;
}

Magic Properties (@property)

Properties defined in the class DocBlock (common in Laravel Models or fluent objects) are now recognized.

/**
 * @property string $status
 * @property-read int $count
 */
class ServerStats
{
    // ...
}

Constructor Promoted Properties

Types are inferred from the constructor's @param tags when using promoted properties.

class CreateUserRequest
{
    /**
     * @param string $email
     * @param int|null $age
     */
    public function __construct(
        public $email,
        public $age,
    ) {}
}