typescript 5.1.0-dev.20230403 → 5.1.0-dev.20230405

package/lib/lib.webworker.iterable.d.ts

@@ -42,14 +42,17 @@ interface CSSUnparsedValue {
 }
 
 interface Cache {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/addAll) */
     addAll(requests: Iterable<RequestInfo>): Promise<void>;
 }
 
 interface CanvasPath {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/roundRect) */
     roundRect(x: number, y: number, w: number, h: number, radii?: number | DOMPointInit | Iterable<number | DOMPointInit>): void;
 }
 
 interface CanvasPathDrawingStyles {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/setLineDash) */
     setLineDash(segments: Iterable<number>): void;
 }
 
@@ -85,7 +88,11 @@ interface Headers {
 }
 
 interface IDBDatabase {
-    /** Returns a new transaction with the given mode ("readonly" or "readwrite") and scope which can be a single object store name or an array of names. */
+    /**
+     * Returns a new transaction with the given mode ("readonly" or "readwrite") and scope which can be a single object store name or an array of names.
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase/transaction)
+     */
     transaction(storeNames: string | Iterable<string>, mode?: IDBTransactionMode, options?: IDBTransactionOptions): IDBTransaction;
 }
 
@@ -94,12 +101,18 @@ interface IDBObjectStore {
      * Creates a new index in store with the given name, keyPath and options and returns a new IDBIndex. If the keyPath and options define constraints that cannot be satisfied with the data already in store the upgrade transaction will abort with a "ConstraintError" DOMException.
      *
      * Throws an "InvalidStateError" DOMException if not called within an upgrade transaction.
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/createIndex)
      */
     createIndex(name: string, keyPath: string | Iterable<string>, options?: IDBIndexParameters): IDBIndex;
 }
 
 interface MessageEvent<T = any> {
-    /** @deprecated */
+    /**
+     * @deprecated
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/initMessageEvent)
+     */
     initMessageEvent(type: string, bubbles?: boolean, cancelable?: boolean, data?: any, origin?: string, lastEventId?: string, source?: MessageEventSource | null, ports?: Iterable<MessagePort>): void;
 }
 
@@ -111,12 +124,16 @@ interface StylePropertyMapReadOnly {
 }
 
 interface SubtleCrypto {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey) */
     deriveKey(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, derivedKeyType: AlgorithmIdentifier | AesDerivedKeyParams | HmacImportParams | HkdfParams | Pbkdf2Params, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey) */
     generateKey(algorithm: RsaHashedKeyGenParams | EcKeyGenParams, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKeyPair>;
     generateKey(algorithm: AesKeyGenParams | HmacKeyGenParams | Pbkdf2Params, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKey>;
     generateKey(algorithm: AlgorithmIdentifier, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKeyPair | CryptoKey>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey) */
     importKey(format: "jwk", keyData: JsonWebKey, algorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKey>;
     importKey(format: Exclude<KeyFormat, "jwk">, keyData: BufferSource, algorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey) */
     unwrapKey(format: KeyFormat, wrappedKey: BufferSource, unwrappingKey: CryptoKey, unwrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, unwrappedKeyAlgorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
 }
 
@@ -131,71 +148,123 @@ interface URLSearchParams {
 }
 
 interface WEBGL_draw_buffers {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_draw_buffers/drawBuffersWEBGL) */
     drawBuffersWEBGL(buffers: Iterable<GLenum>): void;
 }
 
 interface WEBGL_multi_draw {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysInstancedWEBGL) */
     multiDrawArraysInstancedWEBGL(mode: GLenum, firstsList: Int32Array | Iterable<GLint>, firstsOffset: GLuint, countsList: Int32Array | Iterable<GLsizei>, countsOffset: GLuint, instanceCountsList: Int32Array | Iterable<GLsizei>, instanceCountsOffset: GLuint, drawcount: GLsizei): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysWEBGL) */
     multiDrawArraysWEBGL(mode: GLenum, firstsList: Int32Array | Iterable<GLint>, firstsOffset: GLuint, countsList: Int32Array | Iterable<GLsizei>, countsOffset: GLuint, drawcount: GLsizei): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsInstancedWEBGL) */
     multiDrawElementsInstancedWEBGL(mode: GLenum, countsList: Int32Array | Iterable<GLsizei>, countsOffset: GLuint, type: GLenum, offsetsList: Int32Array | Iterable<GLsizei>, offsetsOffset: GLuint, instanceCountsList: Int32Array | Iterable<GLsizei>, instanceCountsOffset: GLuint, drawcount: GLsizei): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsWEBGL) */
     multiDrawElementsWEBGL(mode: GLenum, countsList: Int32Array | Iterable<GLsizei>, countsOffset: GLuint, type: GLenum, offsetsList: Int32Array | Iterable<GLsizei>, offsetsOffset: GLuint, drawcount: GLsizei): void;
 }
 
 interface WebGL2RenderingContextBase {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/clearBuffer) */
     clearBufferfv(buffer: GLenum, drawbuffer: GLint, values: Iterable<GLfloat>, srcOffset?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/clearBuffer) */
     clearBufferiv(buffer: GLenum, drawbuffer: GLint, values: Iterable<GLint>, srcOffset?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/clearBuffer) */
     clearBufferuiv(buffer: GLenum, drawbuffer: GLint, values: Iterable<GLuint>, srcOffset?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/drawBuffers) */
     drawBuffers(buffers: Iterable<GLenum>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/getActiveUniforms) */
     getActiveUniforms(program: WebGLProgram, uniformIndices: Iterable<GLuint>, pname: GLenum): any;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/getUniformIndices) */
     getUniformIndices(program: WebGLProgram, uniformNames: Iterable<string>): Iterable<GLuint> | null;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/invalidateFramebuffer) */
     invalidateFramebuffer(target: GLenum, attachments: Iterable<GLenum>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/invalidateSubFramebuffer) */
     invalidateSubFramebuffer(target: GLenum, attachments: Iterable<GLenum>, x: GLint, y: GLint, width: GLsizei, height: GLsizei): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/transformFeedbackVaryings) */
     transformFeedbackVaryings(program: WebGLProgram, varyings: Iterable<string>, bufferMode: GLenum): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniform) */
     uniform1uiv(location: WebGLUniformLocation | null, data: Iterable<GLuint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniform) */
     uniform2uiv(location: WebGLUniformLocation | null, data: Iterable<GLuint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniform) */
     uniform3uiv(location: WebGLUniformLocation | null, data: Iterable<GLuint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniform) */
     uniform4uiv(location: WebGLUniformLocation | null, data: Iterable<GLuint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix2x3fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix2x4fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix3x2fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix3x4fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix4x2fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
     uniformMatrix4x3fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/vertexAttribI) */
     vertexAttribI4iv(index: GLuint, values: Iterable<GLint>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/vertexAttribI) */
     vertexAttribI4uiv(index: GLuint, values: Iterable<GLuint>): void;
 }
 
 interface WebGL2RenderingContextOverloads {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform1fv(location: WebGLUniformLocation | null, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform1iv(location: WebGLUniformLocation | null, data: Iterable<GLint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform2fv(location: WebGLUniformLocation | null, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform2iv(location: WebGLUniformLocation | null, data: Iterable<GLint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform3fv(location: WebGLUniformLocation | null, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform3iv(location: WebGLUniformLocation | null, data: Iterable<GLint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform4fv(location: WebGLUniformLocation | null, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform4iv(location: WebGLUniformLocation | null, data: Iterable<GLint>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix2fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix3fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix4fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: GLuint, srcLength?: GLuint): void;
 }
 
 interface WebGLRenderingContextBase {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/vertexAttrib) */
     vertexAttrib1fv(index: GLuint, values: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/vertexAttrib) */
     vertexAttrib2fv(index: GLuint, values: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/vertexAttrib) */
     vertexAttrib3fv(index: GLuint, values: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/vertexAttrib) */
     vertexAttrib4fv(index: GLuint, values: Iterable<GLfloat>): void;
 }
 
 interface WebGLRenderingContextOverloads {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform1fv(location: WebGLUniformLocation | null, v: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform1iv(location: WebGLUniformLocation | null, v: Iterable<GLint>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform2fv(location: WebGLUniformLocation | null, v: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform2iv(location: WebGLUniformLocation | null, v: Iterable<GLint>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform3fv(location: WebGLUniformLocation | null, v: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform3iv(location: WebGLUniformLocation | null, v: Iterable<GLint>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform4fv(location: WebGLUniformLocation | null, v: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
     uniform4iv(location: WebGLUniformLocation | null, v: Iterable<GLint>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix2fv(location: WebGLUniformLocation | null, transpose: GLboolean, value: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix3fv(location: WebGLUniformLocation | null, transpose: GLboolean, value: Iterable<GLfloat>): void;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
     uniformMatrix4fv(location: WebGLUniformLocation | null, transpose: GLboolean, value: Iterable<GLfloat>): void;
 }

package/lib/tsc.js

@@ -18,7 +18,7 @@ and limitations under the License.
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.1";
-var version = `${versionMajorMinor}.0-dev.20230403`;
+var version = `${versionMajorMinor}.0-dev.20230405`;
 
 // src/compiler/core.ts
 var emptyArray = [];
@@ -80351,6 +80351,14 @@ function createTypeChecker(host) {
       const symbol = getSymbolAtLocation(node);
       return symbol ? getDeclaredTypeOfSymbol(symbol) : errorType;
     }
+    if (isBindingElement(node)) {
+      return getTypeForVariableLikeDeclaration(
+        node,
+        /*includeOptionality*/
+        true,
+        0 /* Normal */
+      ) || errorType;
+    }
     if (isDeclaration(node)) {
       const symbol = getSymbolOfDeclaration(node);
       return symbol ? getTypeOfSymbol(symbol) : errorType;

package/lib/tsserver.js

@@ -2292,7 +2292,7 @@ module.exports = __toCommonJS(server_exports);
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.1";
-var version = `${versionMajorMinor}.0-dev.20230403`;
+var version = `${versionMajorMinor}.0-dev.20230405`;
 var Comparison = /* @__PURE__ */ ((Comparison3) => {
   Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
   Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -84999,6 +84999,14 @@ function createTypeChecker(host) {
       const symbol = getSymbolAtLocation(node);
       return symbol ? getDeclaredTypeOfSymbol(symbol) : errorType;
     }
+    if (isBindingElement(node)) {
+      return getTypeForVariableLikeDeclaration(
+        node,
+        /*includeOptionality*/
+        true,
+        0 /* Normal */
+      ) || errorType;
+    }
     if (isDeclaration(node)) {
       const symbol = getSymbolOfDeclaration(node);
       return symbol ? getTypeOfSymbol(symbol) : errorType;
@@ -149063,6 +149071,7 @@ function getCompletionsAtPosition(host, program, log, sourceFile, position, pref
     return void 0;
   }
   const compilerOptions = program.getCompilerOptions();
+  const checker = program.getTypeChecker();
   const incompleteCompletionsCache = preferences.allowIncompleteCompletions ? (_a2 = host.getIncompleteCompletionsCache) == null ? void 0 : _a2.call(host) : void 0;
   if (incompleteCompletionsCache && completionKind === 3 /* TriggerForIncompleteCompletions */ && previousToken && isIdentifier(previousToken)) {
     const incompleteContinuation = continuePreviousIncompleteResponse(incompleteCompletionsCache, sourceFile, previousToken, program, host, preferences, cancellationToken, position);
@@ -149103,9 +149112,31 @@ function getCompletionsAtPosition(host, program, log, sourceFile, position, pref
       }
       return response;
     case 1 /* JsDocTagName */:
-      return jsdocCompletionInfo(ts_JsDoc_exports.getJSDocTagNameCompletions());
+      return jsdocCompletionInfo([
+        ...ts_JsDoc_exports.getJSDocTagNameCompletions(),
+        ...getJSDocParameterCompletions(
+          sourceFile,
+          position,
+          checker,
+          compilerOptions,
+          preferences,
+          /*tagNameOnly*/
+          true
+        )
+      ]);
     case 2 /* JsDocTag */:
-      return jsdocCompletionInfo(ts_JsDoc_exports.getJSDocTagCompletions());
+      return jsdocCompletionInfo([
+        ...ts_JsDoc_exports.getJSDocTagCompletions(),
+        ...getJSDocParameterCompletions(
+          sourceFile,
+          position,
+          checker,
+          compilerOptions,
+          preferences,
+          /*tagNameOnly*/
+          false
+        )
+      ]);
     case 3 /* JsDocParameterName */:
       return jsdocCompletionInfo(ts_JsDoc_exports.getJSDocParameterNameCompletions(completionData.tag));
     case 4 /* Keywords */:
@@ -149193,6 +149224,264 @@ function continuePreviousIncompleteResponse(cache, file, location, program, host
 function jsdocCompletionInfo(entries) {
   return { isGlobalCompletion: false, isMemberCompletion: false, isNewIdentifierLocation: false, entries };
 }
+function getJSDocParameterCompletions(sourceFile, position, checker, options, preferences, tagNameOnly) {
+  const currentToken = getTokenAtPosition(sourceFile, position);
+  if (!isJSDocTag(currentToken) && !isJSDoc(currentToken)) {
+    return [];
+  }
+  const jsDoc = isJSDoc(currentToken) ? currentToken : currentToken.parent;
+  if (!isJSDoc(jsDoc)) {
+    return [];
+  }
+  const func = jsDoc.parent;
+  if (!isFunctionLike(func)) {
+    return [];
+  }
+  const isJs = isSourceFileJS(sourceFile);
+  const isSnippet = preferences.includeCompletionsWithSnippetText || void 0;
+  const paramTagCount = countWhere(jsDoc.tags, (tag) => isJSDocParameterTag(tag) && tag.getEnd() <= position);
+  return mapDefined(func.parameters, (param) => {
+    if (getJSDocParameterTags(param).length) {
+      return void 0;
+    }
+    if (isIdentifier(param.name)) {
+      const tabstopCounter = { tabstop: 1 };
+      const paramName = param.name.text;
+      let displayText = getJSDocParamAnnotation(
+        paramName,
+        param.initializer,
+        param.dotDotDotToken,
+        isJs,
+        /*isObject*/
+        false,
+        /*isSnippet*/
+        false,
+        checker,
+        options,
+        preferences
+      );
+      let snippetText = isSnippet ? getJSDocParamAnnotation(
+        paramName,
+        param.initializer,
+        param.dotDotDotToken,
+        isJs,
+        /*isObject*/
+        false,
+        /*isSnippet*/
+        true,
+        checker,
+        options,
+        preferences,
+        tabstopCounter
+      ) : void 0;
+      if (tagNameOnly) {
+        displayText = displayText.slice(1);
+        if (snippetText)
+          snippetText = snippetText.slice(1);
+      }
+      return {
+        name: displayText,
+        kind: "parameter" /* parameterElement */,
+        sortText: SortText.LocationPriority,
+        insertText: isSnippet ? snippetText : void 0,
+        isSnippet
+      };
+    } else if (param.parent.parameters.indexOf(param) === paramTagCount) {
+      const paramPath = `param${paramTagCount}`;
+      const displayTextResult = generateJSDocParamTagsForDestructuring(
+        paramPath,
+        param.name,
+        param.initializer,
+        param.dotDotDotToken,
+        isJs,
+        /*isSnippet*/
+        false,
+        checker,
+        options,
+        preferences
+      );
+      const snippetTextResult = isSnippet ? generateJSDocParamTagsForDestructuring(
+        paramPath,
+        param.name,
+        param.initializer,
+        param.dotDotDotToken,
+        isJs,
+        /*isSnippet*/
+        true,
+        checker,
+        options,
+        preferences
+      ) : void 0;
+      let displayText = displayTextResult.join(getNewLineCharacter(options) + "* ");
+      let snippetText = snippetTextResult == null ? void 0 : snippetTextResult.join(getNewLineCharacter(options) + "* ");
+      if (tagNameOnly) {
+        displayText = displayText.slice(1);
+        if (snippetText)
+          snippetText = snippetText.slice(1);
+      }
+      return {
+        name: displayText,
+        kind: "parameter" /* parameterElement */,
+        sortText: SortText.LocationPriority,
+        insertText: isSnippet ? snippetText : void 0,
+        isSnippet
+      };
+    }
+  });
+}
+function generateJSDocParamTagsForDestructuring(path, pattern, initializer, dotDotDotToken, isJs, isSnippet, checker, options, preferences) {
+  if (!isJs) {
+    return [
+      getJSDocParamAnnotation(
+        path,
+        initializer,
+        dotDotDotToken,
+        isJs,
+        /*isObject*/
+        false,
+        isSnippet,
+        checker,
+        options,
+        preferences,
+        { tabstop: 1 }
+      )
+    ];
+  }
+  return patternWorker(path, pattern, initializer, dotDotDotToken, { tabstop: 1 });
+  function patternWorker(path2, pattern2, initializer2, dotDotDotToken2, counter) {
+    if (isObjectBindingPattern(pattern2) && !dotDotDotToken2) {
+      const oldTabstop = counter.tabstop;
+      const childCounter = { tabstop: oldTabstop };
+      const rootParam = getJSDocParamAnnotation(
+        path2,
+        initializer2,
+        dotDotDotToken2,
+        isJs,
+        /*isObject*/
+        true,
+        isSnippet,
+        checker,
+        options,
+        preferences,
+        childCounter
+      );
+      let childTags = [];
+      for (const element of pattern2.elements) {
+        const elementTags = elementWorker(path2, element, childCounter);
+        if (!elementTags) {
+          childTags = void 0;
+          break;
+        } else {
+          childTags.push(...elementTags);
+        }
+      }
+      if (childTags) {
+        counter.tabstop = childCounter.tabstop;
+        return [rootParam, ...childTags];
+      }
+    }
+    return [
+      getJSDocParamAnnotation(
+        path2,
+        initializer2,
+        dotDotDotToken2,
+        isJs,
+        /*isObject*/
+        false,
+        isSnippet,
+        checker,
+        options,
+        preferences,
+        counter
+      )
+    ];
+  }
+  function elementWorker(path2, element, counter) {
+    if (!element.propertyName && isIdentifier(element.name) || isIdentifier(element.name)) {
+      const propertyName = element.propertyName ? tryGetTextOfPropertyName(element.propertyName) : element.name.text;
+      if (!propertyName) {
+        return void 0;
+      }
+      const paramName = `${path2}.${propertyName}`;
+      return [
+        getJSDocParamAnnotation(
+          paramName,
+          element.initializer,
+          element.dotDotDotToken,
+          isJs,
+          /*isObject*/
+          false,
+          isSnippet,
+          checker,
+          options,
+          preferences,
+          counter
+        )
+      ];
+    } else if (element.propertyName) {
+      const propertyName = tryGetTextOfPropertyName(element.propertyName);
+      return propertyName && patternWorker(`${path2}.${propertyName}`, element.name, element.initializer, element.dotDotDotToken, counter);
+    }
+    return void 0;
+  }
+}
+function getJSDocParamAnnotation(paramName, initializer, dotDotDotToken, isJs, isObject, isSnippet, checker, options, preferences, tabstopCounter) {
+  if (isSnippet) {
+    Debug.assertIsDefined(tabstopCounter);
+  }
+  if (initializer) {
+    paramName = getJSDocParamNameWithInitializer(paramName, initializer);
+  }
+  if (isSnippet) {
+    paramName = escapeSnippetText(paramName);
+  }
+  if (isJs) {
+    let type = "*";
+    if (isObject) {
+      Debug.assert(!dotDotDotToken, `Cannot annotate a rest parameter with type 'Object'.`);
+      type = "Object";
+    } else {
+      if (initializer) {
+        const inferredType = checker.getTypeAtLocation(initializer.parent);
+        if (!(inferredType.flags & (1 /* Any */ | 16384 /* Void */))) {
+          const sourceFile = initializer.getSourceFile();
+          const quotePreference = getQuotePreference(sourceFile, preferences);
+          const builderFlags = quotePreference === 0 /* Single */ ? 268435456 /* UseSingleQuotesForStringLiteralType */ : 0 /* None */;
+          const typeNode = checker.typeToTypeNode(inferredType, findAncestor(initializer, isFunctionLike), builderFlags);
+          if (typeNode) {
+            const printer = isSnippet ? createSnippetPrinter({
+              removeComments: true,
+              module: options.module,
+              target: options.target
+            }) : createPrinter({
+              removeComments: true,
+              module: options.module,
+              target: options.target
+            });
+            setEmitFlags(typeNode, 1 /* SingleLine */);
+            type = printer.printNode(4 /* Unspecified */, typeNode, sourceFile);
+          }
+        }
+      }
+      if (isSnippet && type === "*") {
+        type = `\${${tabstopCounter.tabstop++}:${type}}`;
+      }
+    }
+    const dotDotDot = !isObject && dotDotDotToken ? "..." : "";
+    const description2 = isSnippet ? `\${${tabstopCounter.tabstop++}}` : "";
+    return `@param {${dotDotDot}${type}} ${paramName} ${description2}`;
+  } else {
+    const description2 = isSnippet ? `\${${tabstopCounter.tabstop++}}` : "";
+    return `@param ${paramName} ${description2}`;
+  }
+}
+function getJSDocParamNameWithInitializer(paramName, initializer) {
+  const initializerText = initializer.getText().trim();
+  if (initializerText.includes("\n") || initializerText.length > 80) {
+    return `[${paramName}]`;
+  }
+  return `[${paramName}=${initializerText}]`;
+}
 function keywordToCompletionEntry(keyword) {
   return {
     name: tokenToString(keyword),
@@ -154260,7 +154549,7 @@ var Core;
 ((Core2) => {
   function getReferencedSymbolsForNode(position, node, program, sourceFiles, cancellationToken, options = {}, sourceFilesSet = new Set(sourceFiles.map((f) => f.fileName))) {
     var _a2, _b, _c;
-    node = getAdjustedNode(node, options);
+    node = getAdjustedNode2(node, options);
     if (isSourceFile(node)) {
       const resolvedRef = ts_GoToDefinition_exports.getReferenceAtPosition(node, position, program);
       if (!(resolvedRef == null ? void 0 : resolvedRef.file)) {
@@ -154328,7 +154617,7 @@ var Core;
     return mergeReferences(program, moduleReferences, references, moduleReferencesOfExportTarget);
   }
   Core2.getReferencedSymbolsForNode = getReferencedSymbolsForNode;
-  function getAdjustedNode(node, options) {
+  function getAdjustedNode2(node, options) {
     if (options.use === 1 /* References */) {
       node = getAdjustedReferenceLocation(node);
     } else if (options.use === 2 /* Rename */) {
@@ -154336,7 +154625,7 @@ var Core;
     }
     return node;
   }
-  Core2.getAdjustedNode = getAdjustedNode;
+  Core2.getAdjustedNode = getAdjustedNode2;
   function getReferencesForFileName(fileName, program, sourceFiles, sourceFilesSet = new Set(sourceFiles.map((f) => f.fileName))) {
     var _a2, _b;
     const moduleSymbol = (_a2 = program.getSourceFile(fileName)) == null ? void 0 : _a2.symbol;
@@ -163150,8 +163439,11 @@ function countBinaryExpressionParameters(b) {
   return isBinaryExpression(b.left) ? countBinaryExpressionParameters(b.left) + 1 : 2;
 }
 function tryGetParameterInfo(startingToken, position, sourceFile, checker) {
-  const info = getContextualSignatureLocationInfo(startingToken, sourceFile, position, checker);
-  if (!info)
+  const node = getAdjustedNode(startingToken);
+  if (node === void 0)
+    return void 0;
+  const info = getContextualSignatureLocationInfo(node, sourceFile, position, checker);
+  if (info === void 0)
     return void 0;
   const { contextualType, argumentIndex, argumentCount, argumentsSpan } = info;
   const nonNullableContextualType = contextualType.getNonNullableType();
@@ -163164,16 +163456,23 @@ function tryGetParameterInfo(startingToken, position, sourceFile, checker) {
   const invocation = { kind: 2 /* Contextual */, signature, node: startingToken, symbol: chooseBetterSymbol(symbol) };
   return { isTypeParameterList: false, invocation, argumentsSpan, argumentIndex, argumentCount };
 }
-function getContextualSignatureLocationInfo(startingToken, sourceFile, position, checker) {
-  if (startingToken.kind !== 20 /* OpenParenToken */ && startingToken.kind !== 27 /* CommaToken */)
-    return void 0;
-  const { parent: parent2 } = startingToken;
+function getAdjustedNode(node) {
+  switch (node.kind) {
+    case 20 /* OpenParenToken */:
+    case 27 /* CommaToken */:
+      return node;
+    default:
+      return findAncestor(node.parent, (n) => isParameter(n) ? true : isBindingElement(n) || isObjectBindingPattern(n) || isArrayBindingPattern(n) ? false : "quit");
+  }
+}
+function getContextualSignatureLocationInfo(node, sourceFile, position, checker) {
+  const { parent: parent2 } = node;
   switch (parent2.kind) {
     case 215 /* ParenthesizedExpression */:
     case 172 /* MethodDeclaration */:
     case 216 /* FunctionExpression */:
     case 217 /* ArrowFunction */:
-      const info = getArgumentOrParameterListInfo(startingToken, position, sourceFile);
+      const info = getArgumentOrParameterListInfo(node, position, sourceFile);
       if (!info)
         return void 0;
       const { argumentIndex, argumentCount, argumentsSpan } = info;
@@ -163182,7 +163481,7 @@ function getContextualSignatureLocationInfo(startingToken, sourceFile, position,
     case 224 /* BinaryExpression */: {
       const highestBinary = getHighestBinary(parent2);
       const contextualType2 = checker.getContextualType(highestBinary);
-      const argumentIndex2 = startingToken.kind === 20 /* OpenParenToken */ ? 0 : countBinaryExpressionParameters(parent2) - 1;
+      const argumentIndex2 = node.kind === 20 /* OpenParenToken */ ? 0 : countBinaryExpressionParameters(parent2) - 1;
       const argumentCount2 = countBinaryExpressionParameters(highestBinary);
       return contextualType2 && { contextualType: contextualType2, argumentIndex: argumentIndex2, argumentCount: argumentCount2, argumentsSpan: createTextSpanFromNode(parent2) };
     }