Syntax highlighting fails for DNF in PHP docblocks

[alexr00]

Description

The syntax highlighting in docblocks for PHP code fails when a parameter has DNF in the type declaration, for example:

/**
 * An example function.
 * @param string $a The first argument.
 * @param ClassA|(ClassB&ClassC) $b The second argument.
 * @param int $c The third argument.
 * @return void
 */
function example(string $a, ClassA|(ClassB&ClassC) $b, int $c) {
  // no-op
}

In this case, text after ClassA|(ClassB&ClassC) continues to be highlighted as if it continues as the type declaration, until the end of the docblock.

Related links:

• https://php.watch/versions/8.2/dnf-types
• https://wiki.php.net/rfc/dnf_types
• https://www.php.net/manual/en/language.types.declarations.php
• https://en.wikipedia.org/wiki/Disjunctive_normal_form

Expected behavior: [What you expect to happen]

Syntax highlighting for DNF parameters in a doc block works as well as it does in the function signature

Actual behavior: [What actually happens]

Reproduces how often: [What percentage of the time does it reproduce?]

100%

Versions

VS Code version: Code 1.88.0, which is using commit 5e8f000.

Additional Information

[Any additional information, configuration or data that might be necessary to reproduce the issue.]

Originally from @jameswatts in microsoft/vscode#209758

[RedCMD]

the closing ) must be followed by [] (atm)

[KapitanOczywisty]

#6 might help, I will try to merge soon