Provide snippet completions for `@param` in JSDoc

[DanielRosenwasser]

/**
 * @para$
 */
function printValue(value, maximumFractionDigits) {
}

Today, we provide the expected @param JSDoc tag completion.

However, if we're going by the book with JSDoc, the name of the parameter is already known. Can we provide snippet completions that contain the name of the parameter?

Thoughts:

1. This should work in both JS and TS.
2. In TS it should have a placeholder by the comment
3. In JS it should have a placeholder that starts on the type, followed by a placeholder at the comment
4. I don't know (/remember) how this should work with destructuring.

[ufukbakan]

snippet completors related to IDEs, not directly to typescript. However I guess you use VSCode and it already does what you want.
Write your function, go to the line just before your function, type /** then hit enter, it should autocomplete params and names

[DanielRosenwasser]

snippet completors related to IDEs, not directly to typescript.

TypeScript provides certain snippet completions for IDEs, such as object and class member completions and switch/case completions.

However I guess you use VSCode and it already does what you want.

It doesn't work if you have a preceding JSDoc comment declared using a @typedef or an @overload tag.

/** @typedef {string} Id */

/**<- No comment scaffolding here
function foo(x, y, z) {
}

[DanielRosenwasser]

Actually, that is itself TypeScript bug on the docCommentTemplate command - I likely wouldn't have filed this issue if TypeScript actually provided that.

[DanielRosenwasser]

I still think things like the @type tag and @typedef tag would be good as snippets, because I can never remember the names of these things.