Add coloration for @prop and @block Twig comments from Symfony UX

[Kocal]

Close #2544

Mainly coded through Claude Opus 4.5, let me know what you think:

I re-used the colors from PHPDoc, but maybe it would be better if we re-use more "Twig" colors.

[Haehnchen]

I did a quick run to fix the tests https://github.com/Haehnchen/idea-php-symfony2-plugin/tree/pr-2545. By this the color changed to provide more defaults. Just maybe prop/block name should have a better twig/default color. i will check what is suitable and merge the implentation then.

It's a syntax only used by the Symfony UX Toolkit AFAIK, it's not something standard, but I feel like it could be nice to implement.

it would be even nice to have this as a documented standard, its also important for agents nowadays. It could also just easily take as the source for auto completion on the consuming side.

[Kocal]

It's a syntax only used by the Symfony UX Toolkit AFAIK, it's not something standard, but I feel like it could be nice to implement.

it would be even nice to have this as a documented standard, its also important for agents nowadays. It could also just easily take as the source for auto completion on the consuming side.

Yeah totally, it must become a standard even if it's only for Symfony UX TwigComponent. It could help user by auto-completing properties or blocks when typing...

I don't know how auto-completion works, but adding the description for each prop/block could be super useful:

Note 1: the {# @prop #} syntax is not identical to /** @property */ from PHPDoc, the property name and types are inverted.

Note 2: identifying the type is super naive, it does not handle whitespaces. 😬
For the example, only array<string while be highlighted, which is not correct:

{# @prop data array<string, Collection<int, Item>> Nested data structure #}

[Kocal]

Opened twigphp/Twig#4768

[Kocal]

If twigphp/Twig#4770 gets merged, this PR will become useless and will have to be closed, since the description/docs will be parts of types and block tags (which are already correctly highlighted):