Inaccurate error or buggy behavior for JSDoc @typedef tags

[DanielRosenwasser]

// @ts-check

/**
 * @typedef Foo
 * @member foo {() => string}
 */

JSDoc '@typedef' tag should either have a type annotation or be followed by '@property' or '@member' tags.ts(8021)

We need to figure out what this message should actually be or make it work.

P.S. I can never figure out how to declare a typedef on the first try.

[danvk]

I ran into this error today and got thoroughly confused. In the end, the problem was that I was using a Closure-style @typedef, with a var at the end:

/**
 * @typedef {{
 *   x: number;
 *   y: number;
 * }}
 */
var Point2D;

whereas TypeScript wants the Point2D inside the jsdoc comment:

/**
 * @typedef {{
 *   x: number;
 *   y: number;
 * }} Point2D
 */

There was no explicit error for the first form, TypeScript just didn't know about the type.