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/SendTaskFailureInput.php

@@ -40,8 +40,7 @@ final class SendTaskFailureInput extends Input
      *   taskToken?: string,
      *   error?: string,
      *   cause?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/SendTaskHeartbeatInput.php

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

src/Input/SendTaskSuccessInput.php

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

src/Input/StartExecutionInput.php

@@ -89,8 +89,7 @@ final class StartExecutionInput extends Input
      *   name?: string,
      *   input?: string,
      *   traceHeader?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/Input/StopExecutionInput.php

@@ -37,8 +37,7 @@ final class StopExecutionInput extends Input
      *   executionArn?: string,
      *   error?: string,
      *   cause?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * } $input
      */
     public function __construct(array $input = [])

src/StepFunctionsClient.php

@@ -46,8 +46,7 @@ class StepFunctionsClient extends AbstractApi
      *   taskToken: string,
      *   error?: string,
      *   cause?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|SendTaskFailureInput $input
      *
      * @throws TaskDoesNotExistException
@@ -87,8 +86,7 @@ public function sendTaskFailure($input): SendTaskFailureOutput
      *
      * @param array{
      *   taskToken: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|SendTaskHeartbeatInput $input
      *
      * @throws TaskDoesNotExistException
@@ -119,8 +117,7 @@ public function sendTaskHeartbeat($input): SendTaskHeartbeatOutput
      * @param array{
      *   taskToken: string,
      *   output: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|SendTaskSuccessInput $input
      *
      * @throws TaskDoesNotExistException
@@ -192,8 +189,7 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
      *   name?: string,
      *   input?: string,
      *   traceHeader?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|StartExecutionInput $input
      *
      * @throws ExecutionLimitExceededException
@@ -234,8 +230,7 @@ public function startExecution($input): StartExecutionOutput
      *   executionArn: string,
      *   error?: string,
      *   cause?: string,
-     *
-     *   @region?: string,
+     *   '@region'?: string|null,
      * }|StopExecutionInput $input
      *
      * @throws ExecutionDoesNotExistException