[StructuredOutput] Support description from @param

[OskarStark]

Before, only @var was supported

[OskarStark]

@chr-hertel this shows the problem, but I have no clue how to extract the description from @param 🤔

cc @DZunke

[chr-hertel]

had a look and failed as well, and i guess that's because

a) the param tag belongs to methods

meaning it should look like

final class UserWithAtParamAnnotation
{
    /**
     * @param string $name The name of the user in lowercase
     */
    public function __construct(
        public int $id,
        public string $name,
        public \DateTimeInterface $createdAt,
        public bool $isActive,
        public ?int $age = null,
    ) {
    }
}

which leads to b) the property component doesn't care about method params from constructor, is that possible?

meaning those param infos are not extracted by Symfony's PropertyType component

[OskarStark]

That is possible

[chr-hertel]

so, after further investigation it doesn't even work with symfony/symfony#57632

so decouple from property-info and doing it ourselves would be the answer 😬
but i'm also not an expert when it comes to that component ofc

[OskarStark]

Needs

• [PropertyInfo] Get short description from promoted properties in PhpDocExtractor symfony/symfony#59540

[chr-hertel]

would work with #212

[OskarStark]

Superseded by #212

Thanks @chr-hertel