Broken nestled jsdoc comments for overloaded functions

Prettier 1.19.1 Playground link

--parser babel

Input:

const foo = "Bar";

/**
 * @template T
 * @param {Type} type
 * @param {T} value
 * @return {Value}
 *//**
 * @param {Type} type
 * @return {Value}
 */
function value(type, value) {
  if (arguments.length === 2) {
    return new ConcreteValue(type, value);
  } else {
    return new Value(type);
  }
}

Output:

const foo = "Bar";
/**
 * @param {Type} type
 * @return {Value}
 */

/**
 * @template T
 * @param {Type} type
 * @param {T} value
 * @return {Value}
 */ function value(type, value) {
  if (arguments.length === 2) {
    return new ConcreteValue(type, value);
  } else {
    return new Value(type);
  }
}

Expected behavior: Output identical to input.

[thw0rted]

TS does not support it but tsd-jsdoc does, so this is breaking a live process today. JSDoc does parse it correctly as demonstrated in their issue, linked above.

[thorn0]

Yes, TS doesn’t support this syntax. Related: https://github.com/microsoft/TypeScript/issues/25590