Type hinting arrays with multipe types

When hinting an array that can contain multiple types, FunctionCommentSniff gives a warning

class MyClass {

  /**
   *  @return (A|B)[]
   */
  public function foo() {}

}

Expected A|B[] but found (A|B)[] for function return type

This can be avoided by using the type hint A[]|B[] instead, but implies a slightly different meaning (an array containing only items of one of the types, versus containing items of either type).

PhpDocumentor: https://www.phpdoc.org/docs/latest/references/phpdoc/types.html#arrays