Add generics PHPDoc tags to ParseNode methods

[Ndiritu]

PHP doesn't support generics. The return type of our ParseNode object methods is a Parsable and Enum for enum-related methods yet model setters expect a concrete type. This causes static analysis failures like:

Error: Parameter #1 $value of method Integration\Test\Client\Models\AppPermissions::setPages() expects Integration\Test\Client\Models\AppPermissions_pages|null, Microsoft\Kiota\Abstractions\Enum|null given.
Error: Parameter #1 $value of method Integration\Test\Client\Models\TestList::setItems() expects array<Integration\Test\Client\Models\TestList_items>|null, array<Microsoft\Kiota\Abstractions\Serialization\Parsable>|null given.
Error: Parameter #1 $value of method Integration\Test\Client\Models\TestList_items::setAdditional() expects Integration\Test\Client\Models\TestList_items_additional|null, Microsoft\Kiota\Abstractions\Serialization\Parsable|null given.

This change tells PHPStan that a generic type will be passed and returned.

Impact of this change can be viewed at https://github.com/microsoft/kiota-samples/actions/runs/4383543674/jobs/7673923173 where PHPStan is run using abstractions changes from this branch. The only existing issue is around arrays of primitive types. Arrays of Parsable implementations/Arrays of Enums are handled.

Still need to figure out a fix for the PHPDoc for getCollectionOfPrimitiveValues. The generic PHPDoc format doesn't match primitive types.

part of microsoft/kiota#2378

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication