PhpStorm has basic support for generics since version 2021.2 which comes
in handy as since the same version the "Dynamic Return Type" plugin is broken.
Providing the class-string annotation and a proper return generic
supersedes this and recovers the built-in autocompletion.
To have the same effect for both, 3rd party code not being under our
control or methods having complex returns based on their input, a
`.phpstorm.meta.php` file is provided extending PhpStorms code awareness
capabilities.
Tons of kudos to Alexander Schnitzler providing a boilerplate
configuration here:
https://github.com/alexanderschnitzler/phpstorm.meta.php-typo3
For more information about capability extension consult
https://www.jetbrains.com/help/phpstorm/ide-advanced-metadata.html