Since #96797, the Module object is added to the
PSR-7 Request, in case a TYPO3 backend module
is requested.

To further support autocompletion, the Module
definition is now added to the .phpstorm.meta.php file.

Resolves: #96905
Related: #96797
Releases: main
Change-Id: Id323f27dbe59a386cf38ba73ee75bd07abb11532
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/73521


Tested-by: Stefan Bürk <stefan@buerk.tech>
Tested-by: core-ci <typo3@b13.com>
Tested-by: Benni Mack <benni@typo3.org>
Reviewed-by: Stefan Bürk <stefan@buerk.tech>
Reviewed-by: Benni Mack <benni@typo3.org>

Extend PHPStorm meta file with further definitions for autocompletion
support and avoid unnecessary php docblocks in the code base.

* add request getAttribute() return types
* add return type for 'SiteMatcher->matchRequest()'
* add return type for 'PageRouter->matchRequest()'

Resolves: #96636
Related: #95064
Releases: main, 11.5
Change-Id: I7c2aafc8a0230090e267d9c4eb2f3e5284d8ee0a
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/73144


Tested-by: core-ci <typo3@b13.com>
Tested-by: Christian Kuhn <lolli@schwarzbu.ch>
Tested-by: Benni Mack <benni@typo3.org>
Reviewed-by: Christian Kuhn <lolli@schwarzbu.ch>
Reviewed-by: Benni Mack <benni@typo3.org>

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

Resolves: #95064
Releases: master, 10.4, 9.5
Change-Id: I4ea5115550ce7070de01c42c19ac3b93bf6ab4b6
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/70872


Tested-by: core-ci <typo3@b13.com>
Tested-by: Stefan Bürk <stefan@buerk.tech>
Tested-by: Andreas Fernandez <a.fernandez@scripting-base.de>
Reviewed-by: Stefan Bürk <stefan@buerk.tech>
Reviewed-by: Andreas Fernandez <a.fernandez@scripting-base.de>