no-undefined-types does not consider @template definitions with type constraints

[Elberet]

When running in typescript mode (settings.jsdoc.mode = "typescript"), template types with type constraints are ignored by the no-undefined-types rule:

/**
 * Run callback when hooked method is called.
 *
 * @template {BaseObject} T
 * @param {T} obj - object whose method should be hooked.
 * @param {string} method - method which should be hooked.
 * @param {(sender: T) => void} callback - callback which should
 * be called when the hooked method was invoked.
 */
function registerEvent(obj, method, callback) { ... }

In the example above, the type constraint on T results in jsdoc/no-undefined-types emitting a warning "The type 'T' is undefined". See the Typescript handbook for more examples on typed templates.

[brettz9]

Fixed by 5f48821

[brettz9]

And released with https://github.com/gajus/eslint-plugin-jsdoc/releases/tag/v17.1.2 .

[Elberet]

😱

Now that's what I call response time. 👍

[snowteamer]

There is still a false positive when the type parameter is used inside the function:

/**
 * @template T
 * @param {T} arg
 * @returns {[T]}
 */
function example(arg) {
	const result =  /** @type {[T]} */ (new Array());
	result[0] = arg;
	return result;
}

The type 'T' is undefined. (eslint(jsdoc/no-undefined-types) [7, 1]

[brettz9]

@snowteamer : Thank you. Could you please file a new issue? Also if know of docs showing the scope of where the template name can be used?

[wycats]

I hit the same issue today!

[Elberet]

See also #559 for the template type scope issue.