[TypeDeclaration] Adds AddParamTypeForFunctionLikeWithinCallLikeArgDeclarationRector rule

[peterfox]

Changes

• Adds the new AddParamTypeForFunctionLikeWithinCallLikeArgDeclarationRector in the TypeDeclaration category
• Adds a new value object for configuring the rule
• Adds tests for the rule
• Updates the rule list

Why

The benefits are hopefully obvious. In PHP frameworks like Laravel, methods etc. are often used with FunctionLike parameters but it can be difficult to know the correct type for Parameters. This rule would allow for enforcing types on method and static calls.

-(new SomeClass)->process(function ($parameter) {});
+(new SomeClass)->process(function (string $parameter) {});

Using example parameters:

new AddParamTypeForFunctionLikeWithinCallLikeArgDeclaration(
    'SomeClass',
    'process',
    0, // position of the FunctionLike in the CallLike object, can also be a string of the args name.
    0, // position of the Param in the FunctionLike
    new StringType()
),

Notes

Both numeric position and named args for a CallLike are supported but positional args are ignored if they have a name. For example if you wanted to cover both scenarios in a code base you could reference the position and the named arg successfully and not worry about declaring the type on the wrong param.

[TomasVotruba]

Thank you 👍