PhpdocTypesOrderFixer: fix for array shapes

[kubawerlos]

fixes #5798
closes #5833

As an extra it will "work" for broken types such as array<string} or array{string>.

[coveralls]

Coverage remained the same at 92.185% when pulling 5669a31 on kubawerlos:fix_PhpdocTypesOrderFixer_array_shapes into 7c1dff0 on FriendsOfPHP:3.0.

[keradus]

Thank you @kubawerlos.

[ruudk]

Thanks for fixing this 👏

[drupol]

I think there's still an issue with 3.0.2:

-                 * @var Closure(Iterator<TKey, T>): Generator<TKey, T> $callback
+                 * @var Closure(Iterator<TKey, <|T>): Generator|TKey, T> $callback

[ruudk]

Related but slightly different syntax also causes issues:

-     * @param null|callable(array<string>): array<string, T> $computeCallback
+     * @param null|callable(array<string>): array|<|string, T> $computeCallback

[SpacePossum]

Thanks for reporting! Can you guys check there is a new open bug issue for these cases? it is kinda hard keep track with closed issues/PR's

[ruudk]

I think it's #5850 ... Will post there too.