Javascript function parameter annotation

What IDEA version do you work with? Your first solution should be fine, and it works for me - I don't see any errors reported in 2019.2.1:

/**
 @param {HTMLElement} target
 */
function foo(target) { }

/** @type {HTMLInputElement} */
const myInput = document.createElement('input');

foo(myInput)

Hello Elena,

Thank you for the quick answer.

My current IDEA version is 2019.2.2

Considering your reply, I did a double check and the noticed that this indeed wasn't the entire scenario that's leading to the type mismatch.

My variable isn't actually typed statically, its type is inferred from a dynamic type cast, a minimal case which leads to the type mismatch is like the following:

/**
 @template T
 @param {*} target
 @param {{prototype: T, new(): T}} type
 @return {T}
 */
export function cast(target, type) {
    return /** @type {T} */(target);
}

const myInput = cast(document.createElement('input'), HTMLInputElement);

This isn't the actual code I'm using, nor I use it in such a simplistic way, it's really a minimal scenario to illustrate how I get the type mismatch. But after myInput is assigned through this cast, IDEA says that it is of type HTMLInputElement, but then gives a type mismatch.

No type mismatch errors are reported for me when using your example:

Could it be some setting that I'm using then?

Here's the inspection message I get:

Can you recreate it in a new project?

No, but I get a validation error on the cast:

I can see it too; why do you need it, BTW? Return type is taken from @return {T}, the is no need in additional casting

Oh, yes... That's right. Maybe it was reminiscent from some previous iteration of my code. I dropped this explicit cast.

Since the validation error doesn't happen on a clean project, I tried moving the .idea folder to another location and reopen the project folder to create a clean project, yet the same message appeared after IDEA indexed the files.

>yet the same message appeared after IDEA indexed the files

Must be smth specific to your project code/dependencies...

I'm gonna dig through the project and run some tests to see if I can find the cause then...

Thanks for the help for now.

I'd like to point out that I discovered the source of my struggle, although I don't understand why IDEA was reacting this way.
At another point in my project's directory structure, I had a cloned copy of immutable-js's source direct from its github directory. As soon as I deleted the "type-definitions" folder, the type mismatch message went away.