Unable to mark JS functions as not being constructors (TS80002)

Bug Report

TS80002 ("This constructor function may be turned to a class declaration") is a useful tool, but, it often breaks syntax coloring and classification of functions for things like out-of-line event handlers. There seems to be no way to mark a function as "not a constructor" (would the @function JSDoc hint maybe serve this purpose?)

🔎 Search Terms

jsdoc typescript constructor ts80002

🕗 Version & Regression Information

• This behavior was introduced after 3.6.2 at some point, and I reviewed the FAQ for entries about TS80002.

⏯ Playground Link

Playground link with relevant code

💻 Code

/**
 * @this {HTMLElement}
 * @param {MouseEvent} e
 */
function test(e)
{
    this.textContent = '500';
}

document.addEventListener('click', test);

🙁 Actual behavior

TypeScript marks the function test as a constructor for a type. As a consequence, too, VSCode marks it as a type, and not a function, which is confusing for navigation purposes.

🙂 Expected behavior

TypeScript should be able to detect that with a @this hint (or @function perhaps?) that this isn't a constructor.

Reproduce the behavior in the linked TypeScript Playground with JavaScript and TS80002, then investigate how the @this and @function JSDoc hints affect constructor detection. Done means a supported annotation or inference path prevents the function from being classified as a constructor and restores the expected function classification for editor navigation.