Generate valid phpdoc param tags (#1457)

* Fix the phpdoc of the RequestContext

* Generate valid phpdoc param tags

When an array shape key starts with a `@` like `@region`, it must be
quoted in the phpdoc as the unquoted one would be interpreted as the
next phpdoc tag.

* Use an unsealed shape for the type in Input

This avoids reports about passing extra keys from child classes in
Psalm.

* Allow passing null as the region in the input

The base input class already accept null values in addition to omitted
values for the region.

* Update the psalm baseline

* Disallow invalid docblocks in Psalm as well

Author: stof

src/Input/AddLayerVersionPermissionRequest.php

@@ -80,8 +80,7 @@ final class AddLayerVersionPermissionRequest extends Input
      *   Principal?: string,
      *   OrganizationId?: string,
      *   RevisionId?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/DeleteFunctionRequest.php

@@ -38,8 +38,7 @@ final class DeleteFunctionRequest extends Input
      * @param array{
      *   FunctionName?: string,
      *   Qualifier?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/InvocationRequest.php

@@ -81,8 +81,7 @@ final class InvocationRequest extends Input
      *   ClientContext?: string,
      *   Payload?: string,
      *   Qualifier?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/ListFunctionsRequest.php

@@ -47,8 +47,7 @@ final class ListFunctionsRequest extends Input
      *   FunctionVersion?: FunctionVersion::*,
      *   Marker?: string,
      *   MaxItems?: int,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/ListLayerVersionsRequest.php

@@ -61,8 +61,7 @@ final class ListLayerVersionsRequest extends Input
      *   Marker?: string,
      *   MaxItems?: int,
      *   CompatibleArchitecture?: Architecture::*,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/ListVersionsByFunctionRequest.php

@@ -47,8 +47,7 @@ final class ListVersionsByFunctionRequest extends Input
      *   FunctionName?: string,
      *   Marker?: string,
      *   MaxItems?: int,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/PublishLayerVersionRequest.php

@@ -79,8 +79,7 @@ final class PublishLayerVersionRequest extends Input
      *   CompatibleRuntimes?: list<Runtime::*>,
      *   LicenseInfo?: string,
      *   CompatibleArchitectures?: list<Architecture::*>,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/LambdaClient.php

@@ -84,8 +84,7 @@ class LambdaClient extends AbstractApi
      *   Principal: string,
      *   OrganizationId?: string,
      *   RevisionId?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|AddLayerVersionPermissionRequest $input
      *
      * @throws ServiceException
@@ -126,8 +125,7 @@ public function addLayerVersionPermission($input): AddLayerVersionPermissionResp
      * @param array{
      *   FunctionName: string,
      *   Qualifier?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|DeleteFunctionRequest $input
      *
      * @throws ServiceException
@@ -200,8 +198,7 @@ public function deleteFunction($input): Result
      *   ClientContext?: string,
      *   Payload?: string,
      *   Qualifier?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|InvocationRequest $input
      *
      * @throws ServiceException
@@ -293,8 +290,7 @@ public function invoke($input): InvocationResponse
      *   FunctionVersion?: FunctionVersion::*,
      *   Marker?: string,
      *   MaxItems?: int,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|ListFunctionsRequest $input
      *
      * @throws ServiceException
@@ -330,8 +326,7 @@ public function listFunctions($input = []): ListFunctionsResponse
      *   Marker?: string,
      *   MaxItems?: int,
      *   CompatibleArchitecture?: Architecture::*,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|ListLayerVersionsRequest $input
      *
      * @throws ServiceException
@@ -365,8 +360,7 @@ public function listLayerVersions($input): ListLayerVersionsResponse
      *   FunctionName: string,
      *   Marker?: string,
      *   MaxItems?: int,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|ListVersionsByFunctionRequest $input
      *
      * @throws ServiceException
@@ -405,8 +399,7 @@ public function listVersionsByFunction($input): ListVersionsByFunctionResponse
      *   CompatibleRuntimes?: list<Runtime::*>,
      *   LicenseInfo?: string,
      *   CompatibleArchitectures?: list<Architecture::*>,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|PublishLayerVersionRequest $input
      *
      * @throws ServiceException