typescript 5.0.0-dev.20230215 → 5.0.0-dev.20230217

package/lib/tsserverlibrary.js

@@ -35,7 +35,7 @@ var ts = (() => {
     "src/compiler/corePublic.ts"() {
       "use strict";
       versionMajorMinor = "5.0";
-      version = `${versionMajorMinor}.0-dev.20230215`;
+      version = `${versionMajorMinor}.0-dev.20230217`;
       Comparison = /* @__PURE__ */ ((Comparison3) => {
         Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
         Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -13027,6 +13027,36 @@ ${lanes.join("\n")}
   function nodeIsPresent(node) {
     return !nodeIsMissing(node);
   }
+  function isGrammarError(parent2, child) {
+    if (isTypeParameterDeclaration(parent2))
+      return child === parent2.expression;
+    if (isClassStaticBlockDeclaration(parent2))
+      return child === parent2.modifiers;
+    if (isPropertySignature(parent2))
+      return child === parent2.initializer;
+    if (isPropertyDeclaration(parent2))
+      return child === parent2.questionToken && isAutoAccessorPropertyDeclaration(parent2);
+    if (isPropertyAssignment(parent2))
+      return child === parent2.modifiers || child === parent2.questionToken || child === parent2.exclamationToken || isGrammarErrorElement(parent2.modifiers, child, isModifierLike);
+    if (isShorthandPropertyAssignment(parent2))
+      return child === parent2.equalsToken || child === parent2.modifiers || child === parent2.questionToken || child === parent2.exclamationToken || isGrammarErrorElement(parent2.modifiers, child, isModifierLike);
+    if (isMethodDeclaration(parent2))
+      return child === parent2.exclamationToken;
+    if (isConstructorDeclaration(parent2))
+      return child === parent2.typeParameters || child === parent2.type || isGrammarErrorElement(parent2.typeParameters, child, isTypeParameterDeclaration);
+    if (isGetAccessorDeclaration(parent2))
+      return child === parent2.typeParameters || isGrammarErrorElement(parent2.typeParameters, child, isTypeParameterDeclaration);
+    if (isSetAccessorDeclaration(parent2))
+      return child === parent2.typeParameters || child === parent2.type || isGrammarErrorElement(parent2.typeParameters, child, isTypeParameterDeclaration);
+    if (isNamespaceExportDeclaration(parent2))
+      return child === parent2.modifiers || isGrammarErrorElement(parent2.modifiers, child, isModifierLike);
+    return false;
+  }
+  function isGrammarErrorElement(nodeArray, child, isElement) {
+    if (!nodeArray || isArray(child) || !isElement(child))
+      return false;
+    return contains(nodeArray, child);
+  }
   function insertStatementsAfterPrologue(to, from, isPrologueDirective2) {
     if (from === void 0 || from.length === 0)
       return to;
@@ -27168,7 +27198,7 @@ ${lanes.join("\n")}
   }
   function canHaveIllegalModifiers(node) {
     const kind = node.kind;
-    return kind === 172 /* ClassStaticBlockDeclaration */ || kind === 299 /* PropertyAssignment */ || kind === 300 /* ShorthandPropertyAssignment */ || kind === 181 /* FunctionType */ || kind === 279 /* MissingDeclaration */ || kind === 267 /* NamespaceExportDeclaration */;
+    return kind === 172 /* ClassStaticBlockDeclaration */ || kind === 299 /* PropertyAssignment */ || kind === 300 /* ShorthandPropertyAssignment */ || kind === 279 /* MissingDeclaration */ || kind === 267 /* NamespaceExportDeclaration */;
   }
   function isQuestionOrExclamationToken(node) {
     return isQuestionToken(node) || isExclamationToken(node);
@@ -29414,7 +29444,6 @@ ${lanes.join("\n")}
               return canFollowExportModifier();
             case 88 /* DefaultKeyword */:
               return nextTokenCanFollowDefaultKeyword();
-            case 127 /* AccessorKeyword */:
             case 124 /* StaticKeyword */:
             case 137 /* GetKeyword */:
             case 151 /* SetKeyword */:
@@ -30707,6 +30736,7 @@ ${lanes.join("\n")}
           const hasJSDoc = hasPrecedingJSDocComment();
           const modifiers = parseModifiersForConstructorType();
           const isConstructorType = parseOptional(103 /* NewKeyword */);
+          Debug.assert(!modifiers || isConstructorType, "Per isStartOfFunctionOrConstructorType, a function type cannot have modifiers.");
           const typeParameters = parseTypeParameters();
           const parameters = parseParameters(4 /* Type */);
           const type = parseReturnType(
@@ -30715,8 +30745,6 @@ ${lanes.join("\n")}
             false
           );
           const node = isConstructorType ? factory2.createConstructorTypeNode(modifiers, typeParameters, parameters, type) : factory2.createFunctionTypeNode(typeParameters, parameters, type);
-          if (!isConstructorType)
-            node.modifiers = modifiers;
           return withJSDoc(finishNode(node, pos), hasJSDoc);
         }
         function parseKeywordAndNoDot() {
@@ -44971,6 +44999,7 @@ ${lanes.join("\n")}
     let inlineLevel = 0;
     let currentNode;
     let varianceTypeParameter;
+    let isInferencePartiallyBlocked = false;
     const emptySymbols = createSymbolTable();
     const arrayVariances = [1 /* Covariant */];
     const compilerOptions = host.getCompilerOptions();
@@ -45402,7 +45431,9 @@ ${lanes.join("\n")}
           toMarkSkip = toMarkSkip.parent;
         } while (toMarkSkip && toMarkSkip !== containingCall);
       }
+      isInferencePartiallyBlocked = true;
       const result = runWithoutResolvedSignatureCaching(node, fn);
+      isInferencePartiallyBlocked = false;
       if (containingCall) {
         let toMarkSkip = node;
         do {
@@ -55448,6 +55479,7 @@ ${lanes.join("\n")}
       const typeParameter = getTypeParameterFromMappedType(type);
       const constraintType = getConstraintTypeFromMappedType(type);
       const nameType = getNameTypeFromMappedType(type.target || type);
+      const isFilteringMappedType = nameType && isTypeAssignableTo(nameType, typeParameter);
       const templateType = getTemplateTypeFromMappedType(type.target || type);
       const modifiersType = getApparentType(getModifiersTypeFromMappedType(type));
       const templateModifiers = getMappedTypeModifiers(type);
@@ -55485,7 +55517,7 @@ ${lanes.join("\n")}
             prop.links.keyType = keyType;
             if (modifiersProp) {
               prop.links.syntheticOrigin = modifiersProp;
-              prop.declarations = nameType ? void 0 : modifiersProp.declarations;
+              prop.declarations = !nameType || isFilteringMappedType ? modifiersProp.declarations : void 0;
             }
             members.set(propName, prop);
           }
@@ -64217,6 +64249,9 @@ ${lanes.join("\n")}
       const key = `B${getTypeId(type)}`;
       return (_a2 = getCachedType(key)) != null ? _a2 : setCachedType(key, mapType(type, getBaseTypeOfLiteralType));
     }
+    function getBaseTypeOfLiteralTypeForComparison(type) {
+      return type.flags & (128 /* StringLiteral */ | 134217728 /* TemplateLiteral */ | 268435456 /* StringMapping */) ? stringType : type.flags & (256 /* NumberLiteral */ | 32 /* Enum */) ? numberType : type.flags & 2048 /* BigIntLiteral */ ? bigintType : type.flags & 512 /* BooleanLiteral */ ? booleanType : type.flags & 1048576 /* Union */ ? mapType(type, getBaseTypeOfLiteralTypeForComparison) : type;
+    }
     function getWidenedLiteralType(type) {
       return type.flags & 1056 /* EnumLike */ && isFreshLiteralType(type) ? getBaseTypeOfEnumLikeType(type) : type.flags & 128 /* StringLiteral */ && isFreshLiteralType(type) ? stringType : type.flags & 256 /* NumberLiteral */ && isFreshLiteralType(type) ? numberType : type.flags & 2048 /* BigIntLiteral */ && isFreshLiteralType(type) ? bigintType : type.flags & 512 /* BooleanLiteral */ && isFreshLiteralType(type) ? booleanType : type.flags & 1048576 /* Union */ ? mapType(type, getWidenedLiteralType) : type;
     }
@@ -72041,7 +72076,7 @@ ${lanes.join("\n")}
       const isTaggedTemplate = node.kind === 212 /* TaggedTemplateExpression */;
       const isDecorator2 = node.kind === 167 /* Decorator */;
       const isJsxOpeningOrSelfClosingElement = isJsxOpeningLikeElement(node);
-      const reportErrors2 = !candidatesOutArray;
+      const reportErrors2 = !isInferencePartiallyBlocked && !candidatesOutArray;
       let typeArguments;
       if (!isDecorator2 && !isSuperCall(node)) {
         typeArguments = node.typeArguments;
@@ -75282,8 +75317,8 @@ ${lanes.join("\n")}
         case 32 /* LessThanEqualsToken */:
         case 33 /* GreaterThanEqualsToken */:
           if (checkForDisallowedESSymbolOperand(operator)) {
-            leftType = getBaseTypeOfLiteralType(checkNonNullType(leftType, left));
-            rightType = getBaseTypeOfLiteralType(checkNonNullType(rightType, right));
+            leftType = getBaseTypeOfLiteralTypeForComparison(checkNonNullType(leftType, left));
+            rightType = getBaseTypeOfLiteralTypeForComparison(checkNonNullType(rightType, right));
             reportOperatorErrorUnless((left2, right2) => {
               if (isTypeAny(left2) || isTypeAny(right2)) {
                 return true;
@@ -77119,6 +77154,17 @@ ${lanes.join("\n")}
               lastSeenNonAmbientDeclaration = node;
             }
           }
+          if (isInJSFile(current) && isFunctionLike(current) && current.jsDoc) {
+            for (const node2 of current.jsDoc) {
+              if (node2.tags) {
+                for (const tag of node2.tags) {
+                  if (isJSDocOverloadTag(tag)) {
+                    hasOverloads = true;
+                  }
+                }
+              }
+            }
+          }
         }
       }
       if (multipleConstructorImplementation) {
@@ -77156,8 +77202,9 @@ ${lanes.join("\n")}
           const bodySignature = getSignatureFromDeclaration(bodyDeclaration);
           for (const signature of signatures) {
             if (!isImplementationCompatibleWithOverload(bodySignature, signature)) {
+              const errorNode = signature.declaration && isJSDocSignature(signature.declaration) ? signature.declaration.parent.tagName : signature.declaration;
               addRelatedInfo(
-                error(signature.declaration, Diagnostics.This_overload_signature_is_not_compatible_with_its_implementation_signature),
+                error(errorNode, Diagnostics.This_overload_signature_is_not_compatible_with_its_implementation_signature),
                 createDiagnosticForNode(bodyDeclaration, Diagnostics.The_implementation_signature_is_declared_here)
               );
               break;
@@ -83773,7 +83820,6 @@ ${lanes.join("\n")}
         case 299 /* PropertyAssignment */:
         case 300 /* ShorthandPropertyAssignment */:
         case 267 /* NamespaceExportDeclaration */:
-        case 181 /* FunctionType */:
         case 279 /* MissingDeclaration */:
           return find(node.modifiers, isModifier);
         default:
@@ -90367,7 +90413,16 @@ ${lanes.join("\n")}
           visitNode(node.initializer, (child) => namedEvaluationVisitor(child, referencedName), isExpression)
         );
       }
-      return visitEachChild(node, visitor, context);
+      return factory2.updatePropertyDeclaration(
+        node,
+        visitNodes2(node.modifiers, modifierVisitor, isModifier),
+        visitNode(node.name, propertyNameVisitor, isPropertyName),
+        /*questionOrExclamationToken*/
+        void 0,
+        /*type*/
+        void 0,
+        visitNode(node.initializer, visitor, isExpression)
+      );
     }
     function transformPublicFieldInitializer(node) {
       if (shouldTransformInitializers && !isAutoAccessorPropertyDeclaration(node)) {
@@ -133197,7 +133252,8 @@ ${lanes.join("\n")}
         options.triggerCharacter,
         options.triggerKind,
         cancellationToken,
-        formattingSettings && ts_formatting_exports.getFormatContext(formattingSettings, host)
+        formattingSettings && ts_formatting_exports.getFormatContext(formattingSettings, host),
+        options.includeSymbol
       );
     }
     function getCompletionEntryDetails2(fileName, position, name, formattingOptions, source, preferences = emptyOptions, data) {
@@ -145829,13 +145885,7 @@ ${lanes.join("\n")}
   function getReturnTypeFromSignatures(signatures, checker, context, enclosingDeclaration) {
     if (length(signatures)) {
       const type = checker.getUnionType(map(signatures, checker.getReturnTypeOfSignature));
-      return checker.typeToTypeNode(
-        type,
-        enclosingDeclaration,
-        /*flags*/
-        void 0,
-        getNoopSymbolTrackerWithResolver(context)
-      );
+      return checker.typeToTypeNode(type, enclosingDeclaration, 1 /* NoTruncation */, getNoopSymbolTrackerWithResolver(context));
     }
   }
   function createStubbedMethod(modifiers, name, optional, typeParameters, parameters, returnType, quotePreference, body) {
@@ -146127,7 +146177,14 @@ ${lanes.join("\n")}
     changeTracker.replaceNode(file, declaration, property);
   }
   function updatePropertyAssignmentDeclaration(changeTracker, file, declaration, fieldName) {
-    const assignment = factory.updatePropertyAssignment(declaration, fieldName, declaration.initializer);
+    let assignment = factory.updatePropertyAssignment(declaration, fieldName, declaration.initializer);
+    if (assignment.modifiers || assignment.questionToken || assignment.exclamationToken) {
+      if (assignment === declaration)
+        assignment = factory.cloneNode(assignment);
+      assignment.modifiers = void 0;
+      assignment.questionToken = void 0;
+      assignment.exclamationToken = void 0;
+    }
     changeTracker.replacePropertyAssignment(file, declaration, assignment);
   }
   function updateFieldDeclaration(changeTracker, file, declaration, type, fieldName, modifiers) {
@@ -147318,7 +147375,7 @@ ${lanes.join("\n")}
       return result2 || (needsFullResolution ? "failed" : "skipped");
     }
   }
-  function getCompletionsAtPosition(host, program, log, sourceFile, position, preferences, triggerCharacter, completionKind, cancellationToken, formatContext) {
+  function getCompletionsAtPosition(host, program, log, sourceFile, position, preferences, triggerCharacter, completionKind, cancellationToken, formatContext, includeSymbol = false) {
     var _a2;
     const { previousToken } = getRelevantTokens(position, sourceFile);
     if (triggerCharacter && !isInString(sourceFile, position, previousToken) && !isValidTrigger(sourceFile, triggerCharacter, previousToken, position)) {
@@ -147340,7 +147397,7 @@ ${lanes.join("\n")}
     } else {
       incompleteCompletionsCache == null ? void 0 : incompleteCompletionsCache.clear();
     }
-    const stringCompletions = ts_Completions_StringCompletions_exports.getStringLiteralCompletions(sourceFile, position, previousToken, compilerOptions, host, program, log, preferences);
+    const stringCompletions = ts_Completions_StringCompletions_exports.getStringLiteralCompletions(sourceFile, position, previousToken, compilerOptions, host, program, log, preferences, includeSymbol);
     if (stringCompletions) {
       return stringCompletions;
     }
@@ -147365,7 +147422,7 @@ ${lanes.join("\n")}
     }
     switch (completionData.kind) {
       case 0 /* Data */:
-        const response = completionInfoFromData(sourceFile, host, program, compilerOptions, log, completionData, preferences, formatContext, position);
+        const response = completionInfoFromData(sourceFile, host, program, compilerOptions, log, completionData, preferences, formatContext, position, includeSymbol);
         if (response == null ? void 0 : response.isIncomplete) {
           incompleteCompletionsCache == null ? void 0 : incompleteCompletionsCache.set(response);
         }
@@ -147495,7 +147552,7 @@ ${lanes.join("\n")}
   function getOptionalReplacementSpan(location) {
     return (location == null ? void 0 : location.kind) === 79 /* Identifier */ ? createTextSpanFromNode(location) : void 0;
   }
-  function completionInfoFromData(sourceFile, host, program, compilerOptions, log, completionData, preferences, formatContext, position) {
+  function completionInfoFromData(sourceFile, host, program, compilerOptions, log, completionData, preferences, formatContext, position, includeSymbol) {
     const {
       symbols,
       contextToken,
@@ -147569,7 +147626,8 @@ ${lanes.join("\n")}
       symbolToOriginInfoMap,
       symbolToSortTextMap,
       isJsxIdentifierExpected,
-      isRightOfOpenTag
+      isRightOfOpenTag,
+      includeSymbol
     );
     if (keywordFilters !== 0 /* None */) {
       for (const keywordEntry of getKeywordCompletions(keywordFilters, !insideJsDocTagTypeExpression && isSourceFileJS(sourceFile))) {
@@ -147818,7 +147876,7 @@ ${lanes.join("\n")}
   function createCompletionEntryForLiteral(sourceFile, preferences, literal) {
     return { name: completionNameForLiteral(sourceFile, preferences, literal), kind: "string" /* string */, kindModifiers: "" /* none */, sortText: SortText.LocationPriority };
   }
-  function createCompletionEntry(symbol, sortText, replacementToken, contextToken, location, position, sourceFile, host, program, name, needsConvertPropertyAccess, origin, recommendedCompletion, propertyAccessToConvert, isJsxInitializer, importStatementCompletion, useSemicolons, options, preferences, completionKind, formatContext, isJsxIdentifierExpected, isRightOfOpenTag) {
+  function createCompletionEntry(symbol, sortText, replacementToken, contextToken, location, position, sourceFile, host, program, name, needsConvertPropertyAccess, origin, recommendedCompletion, propertyAccessToConvert, isJsxInitializer, importStatementCompletion, useSemicolons, options, preferences, completionKind, formatContext, isJsxIdentifierExpected, isRightOfOpenTag, includeSymbol) {
     let insertText;
     let replacementSpan = getReplacementSpanForContextToken(replacementToken);
     let data;
@@ -147862,7 +147920,9 @@ ${lanes.join("\n")}
       }
       awaitText += `(await ${propertyAccessToConvert.expression.getText()})`;
       insertText = needsConvertPropertyAccess ? `${awaitText}${insertText}` : `${awaitText}${insertQuestionDot ? "?." : "."}${insertText}`;
-      replacementSpan = createTextSpanFromBounds(propertyAccessToConvert.getStart(sourceFile), propertyAccessToConvert.end);
+      const isInAwaitExpression = tryCast(propertyAccessToConvert.parent, isAwaitExpression);
+      const wrapNode = isInAwaitExpression ? propertyAccessToConvert.parent : propertyAccessToConvert.expression;
+      replacementSpan = createTextSpanFromBounds(wrapNode.getStart(sourceFile), propertyAccessToConvert.end);
     }
     if (originIsResolvedExport(origin)) {
       sourceDisplay = [textPart(origin.moduleSpecifier)];
@@ -147930,7 +147990,8 @@ ${lanes.join("\n")}
       isSnippet,
       isPackageJsonImport: originIsPackageJsonImport(origin) || void 0,
       isImportStatementCompletion: !!importStatementCompletion || void 0,
-      data
+      data,
+      ...includeSymbol ? { symbol } : void 0
     };
   }
   function isClassLikeMemberCompletion(symbol, location, sourceFile) {
@@ -148400,7 +148461,7 @@ ${lanes.join("\n")}
       return "TypeOnlyAlias/" /* TypeOnlyAlias */;
     }
   }
-  function getCompletionEntriesFromSymbols(symbols, entries, replacementToken, contextToken, location, position, sourceFile, host, program, target, log, kind, preferences, compilerOptions, formatContext, isTypeOnlyLocation, propertyAccessToConvert, jsxIdentifierExpected, isJsxInitializer, importStatementCompletion, recommendedCompletion, symbolToOriginInfoMap, symbolToSortTextMap, isJsxIdentifierExpected, isRightOfOpenTag) {
+  function getCompletionEntriesFromSymbols(symbols, entries, replacementToken, contextToken, location, position, sourceFile, host, program, target, log, kind, preferences, compilerOptions, formatContext, isTypeOnlyLocation, propertyAccessToConvert, jsxIdentifierExpected, isJsxInitializer, importStatementCompletion, recommendedCompletion, symbolToOriginInfoMap, symbolToSortTextMap, isJsxIdentifierExpected, isRightOfOpenTag, includeSymbol = false) {
     var _a2;
     const start = timestamp();
     const variableDeclaration = getVariableDeclaration(location);
@@ -148440,7 +148501,8 @@ ${lanes.join("\n")}
         kind,
         formatContext,
         isJsxIdentifierExpected,
-        isRightOfOpenTag
+        isRightOfOpenTag,
+        includeSymbol
       );
       if (!entry) {
         continue;
@@ -150681,7 +150743,7 @@ ${lanes.join("\n")}
       values: map2.values.bind(map2)
     };
   }
-  function getStringLiteralCompletions(sourceFile, position, contextToken, options, host, program, log, preferences) {
+  function getStringLiteralCompletions(sourceFile, position, contextToken, options, host, program, log, preferences, includeSymbol) {
     if (isInReferenceComment(sourceFile, position)) {
       const entries = getTripleSlashReferenceCompletion(sourceFile, position, options, host);
       return entries && convertPathCompletions(entries);
@@ -150690,10 +150752,10 @@ ${lanes.join("\n")}
       if (!contextToken || !isStringLiteralLike(contextToken))
         return void 0;
       const entries = getStringLiteralCompletionEntries(sourceFile, contextToken, position, program.getTypeChecker(), options, host, preferences);
-      return convertStringLiteralCompletions(entries, contextToken, sourceFile, host, program, log, options, preferences, position);
+      return convertStringLiteralCompletions(entries, contextToken, sourceFile, host, program, log, options, preferences, position, includeSymbol);
     }
   }
-  function convertStringLiteralCompletions(completion, contextToken, sourceFile, host, program, log, options, preferences, position) {
+  function convertStringLiteralCompletions(completion, contextToken, sourceFile, host, program, log, options, preferences, position, includeSymbol) {
     if (completion === void 0) {
       return void 0;
     }
@@ -150719,7 +150781,28 @@ ${lanes.join("\n")}
           preferences,
           options,
           /*formatContext*/
-          void 0
+          void 0,
+          /*isTypeOnlyLocation */
+          void 0,
+          /*propertyAccessToConvert*/
+          void 0,
+          /*jsxIdentifierExpected*/
+          void 0,
+          /*isJsxInitializer*/
+          void 0,
+          /*importStatementCompletion*/
+          void 0,
+          /*recommendedCompletion*/
+          void 0,
+          /*symbolToOriginInfoMap*/
+          void 0,
+          /*symbolToSortTextMap*/
+          void 0,
+          /*isJsxIdentifierExpected*/
+          void 0,
+          /*isRightOfOpenTag*/
+          void 0,
+          includeSymbol
         );
         return { isGlobalCompletion: false, isMemberCompletion: true, isNewIdentifierLocation: completion.hasIndexSignature, optionalReplacementSpan, entries };
       }
@@ -165864,7 +165947,7 @@ ${options.prefix}` : "\n" : options.prefix
       }
       function processChildNode(child, inheritedIndentation, parent2, parentDynamicIndentation, parentStartLine, undecoratedParentStartLine, isListItem, isFirstListItem) {
         Debug.assert(!nodeIsSynthesized(child));
-        if (nodeIsMissing(child)) {
+        if (nodeIsMissing(child) || isGrammarError(parent2, child)) {
           return inheritedIndentation;
         }
         const childStartPos = child.getStart(sourceFile);
@@ -179373,6 +179456,7 @@ ${e.message}`;
     isGetOrSetAccessorDeclaration: () => isGetOrSetAccessorDeclaration,
     isGlobalDeclaration: () => isGlobalDeclaration,
     isGlobalScopeAugmentation: () => isGlobalScopeAugmentation,
+    isGrammarError: () => isGrammarError,
     isHeritageClause: () => isHeritageClause,
     isHoistedFunction: () => isHoistedFunction,
     isHoistedVariableStatement: () => isHoistedVariableStatement,
@@ -181732,6 +181816,7 @@ ${e.message}`;
     isGetOrSetAccessorDeclaration: () => isGetOrSetAccessorDeclaration,
     isGlobalDeclaration: () => isGlobalDeclaration,
     isGlobalScopeAugmentation: () => isGlobalScopeAugmentation,
+    isGrammarError: () => isGrammarError,
     isHeritageClause: () => isHeritageClause,
     isHoistedFunction: () => isHoistedFunction,
     isHoistedVariableStatement: () => isHoistedVariableStatement,

package/lib/typescript.d.ts

@@ -6171,6 +6171,13 @@ declare namespace ts {
          */
         triggerCharacter?: CompletionsTriggerCharacter;
         triggerKind?: CompletionTriggerKind;
+        /**
+         * Include a `symbol` property on each completion entry object.
+         * Symbols reference cyclic data structures and sometimes an entire TypeChecker instance,
+         * so use caution when serializing or retaining completion entries retrieved with this option.
+         * @default false
+         */
+        includeSymbol?: boolean;
         /** @deprecated Use includeCompletionsForModuleExports */
         includeExternalModuleExports?: boolean;
         /** @deprecated Use includeCompletionsWithInsertText */
@@ -6728,6 +6735,12 @@ declare namespace ts {
         isFromUncheckedFile?: true;
         isPackageJsonImport?: true;
         isImportStatementCompletion?: true;
+        /**
+         * For API purposes.
+         * Included for non-string completions only when `includeSymbol: true` option is passed to `getCompletionsAtPosition`.
+         * @example Get declaration of completion: `symbol.valueDeclaration`
+         */
+        symbol?: Symbol;
         /**
          * A property to be sent back to TS Server in the CompletionDetailsRequest, along with `name`,
          * that allows TS Server to look up the symbol represented by the completion item, disambiguating