typescript 5.0.0-dev.20221211 → 5.0.0-dev.20221213

package/lib/tsserver.js

@@ -1598,6 +1598,7 @@ __export(server_exports, {
   isJSDocNode: () => isJSDocNode,
   isJSDocNonNullableType: () => isJSDocNonNullableType,
   isJSDocNullableType: () => isJSDocNullableType,
+  isJSDocOptionalParameter: () => isJSDocOptionalParameter,
   isJSDocOptionalType: () => isJSDocOptionalType,
   isJSDocOverrideTag: () => isJSDocOverrideTag,
   isJSDocParameterTag: () => isJSDocParameterTag,
@@ -1613,6 +1614,7 @@ __export(server_exports, {
   isJSDocTag: () => isJSDocTag,
   isJSDocTemplateTag: () => isJSDocTemplateTag,
   isJSDocThisTag: () => isJSDocThisTag,
+  isJSDocThrowsTag: () => isJSDocThrowsTag,
   isJSDocTypeAlias: () => isJSDocTypeAlias,
   isJSDocTypeAssertion: () => isJSDocTypeAssertion,
   isJSDocTypeExpression: () => isJSDocTypeExpression,
@@ -1743,6 +1745,7 @@ __export(server_exports, {
   isOmittedExpression: () => isOmittedExpression,
   isOptionalChain: () => isOptionalChain,
   isOptionalChainRoot: () => isOptionalChainRoot,
+  isOptionalDeclaration: () => isOptionalDeclaration,
   isOptionalJSDocPropertyLikeTag: () => isOptionalJSDocPropertyLikeTag,
   isOptionalTypeNode: () => isOptionalTypeNode,
   isOuterExpression: () => isOuterExpression,
@@ -2645,7 +2648,7 @@ __export(ts_server_exports3, {
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.0";
-var version = `${versionMajorMinor}.0-dev.20221211`;
+var version = `${versionMajorMinor}.0-dev.20221213`;
 var Comparison = /* @__PURE__ */ ((Comparison3) => {
   Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
   Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -6426,14 +6429,15 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind5) => {
   SyntaxKind5[SyntaxKind5["JSDocTypedefTag"] = 348] = "JSDocTypedefTag";
   SyntaxKind5[SyntaxKind5["JSDocSeeTag"] = 349] = "JSDocSeeTag";
   SyntaxKind5[SyntaxKind5["JSDocPropertyTag"] = 350] = "JSDocPropertyTag";
-  SyntaxKind5[SyntaxKind5["SyntaxList"] = 351] = "SyntaxList";
-  SyntaxKind5[SyntaxKind5["NotEmittedStatement"] = 352] = "NotEmittedStatement";
-  SyntaxKind5[SyntaxKind5["PartiallyEmittedExpression"] = 353] = "PartiallyEmittedExpression";
-  SyntaxKind5[SyntaxKind5["CommaListExpression"] = 354] = "CommaListExpression";
-  SyntaxKind5[SyntaxKind5["MergeDeclarationMarker"] = 355] = "MergeDeclarationMarker";
-  SyntaxKind5[SyntaxKind5["EndOfDeclarationMarker"] = 356] = "EndOfDeclarationMarker";
-  SyntaxKind5[SyntaxKind5["SyntheticReferenceExpression"] = 357] = "SyntheticReferenceExpression";
-  SyntaxKind5[SyntaxKind5["Count"] = 358] = "Count";
+  SyntaxKind5[SyntaxKind5["JSDocThrowsTag"] = 351] = "JSDocThrowsTag";
+  SyntaxKind5[SyntaxKind5["SyntaxList"] = 352] = "SyntaxList";
+  SyntaxKind5[SyntaxKind5["NotEmittedStatement"] = 353] = "NotEmittedStatement";
+  SyntaxKind5[SyntaxKind5["PartiallyEmittedExpression"] = 354] = "PartiallyEmittedExpression";
+  SyntaxKind5[SyntaxKind5["CommaListExpression"] = 355] = "CommaListExpression";
+  SyntaxKind5[SyntaxKind5["MergeDeclarationMarker"] = 356] = "MergeDeclarationMarker";
+  SyntaxKind5[SyntaxKind5["EndOfDeclarationMarker"] = 357] = "EndOfDeclarationMarker";
+  SyntaxKind5[SyntaxKind5["SyntheticReferenceExpression"] = 358] = "SyntheticReferenceExpression";
+  SyntaxKind5[SyntaxKind5["Count"] = 359] = "Count";
   SyntaxKind5[SyntaxKind5["FirstAssignment"] = 63 /* EqualsToken */] = "FirstAssignment";
   SyntaxKind5[SyntaxKind5["LastAssignment"] = 78 /* CaretEqualsToken */] = "LastAssignment";
   SyntaxKind5[SyntaxKind5["FirstCompoundAssignment"] = 64 /* PlusEqualsToken */] = "FirstCompoundAssignment";
@@ -6462,9 +6466,9 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind5) => {
   SyntaxKind5[SyntaxKind5["LastStatement"] = 256 /* DebuggerStatement */] = "LastStatement";
   SyntaxKind5[SyntaxKind5["FirstNode"] = 163 /* QualifiedName */] = "FirstNode";
   SyntaxKind5[SyntaxKind5["FirstJSDocNode"] = 312 /* JSDocTypeExpression */] = "FirstJSDocNode";
-  SyntaxKind5[SyntaxKind5["LastJSDocNode"] = 350 /* JSDocPropertyTag */] = "LastJSDocNode";
+  SyntaxKind5[SyntaxKind5["LastJSDocNode"] = 351 /* JSDocThrowsTag */] = "LastJSDocNode";
   SyntaxKind5[SyntaxKind5["FirstJSDocTagNode"] = 330 /* JSDocTag */] = "FirstJSDocTagNode";
-  SyntaxKind5[SyntaxKind5["LastJSDocTagNode"] = 350 /* JSDocPropertyTag */] = "LastJSDocTagNode";
+  SyntaxKind5[SyntaxKind5["LastJSDocTagNode"] = 351 /* JSDocThrowsTag */] = "LastJSDocTagNode";
   SyntaxKind5[SyntaxKind5["FirstContextualKeyword"] = 126 /* AbstractKeyword */] = "FirstContextualKeyword";
   SyntaxKind5[SyntaxKind5["LastContextualKeyword"] = 162 /* OfKeyword */] = "LastContextualKeyword";
   return SyntaxKind5;
@@ -14396,8 +14400,8 @@ function isExpressionKind(kind) {
     case 227 /* SpreadElement */:
     case 231 /* AsExpression */:
     case 229 /* OmittedExpression */:
-    case 354 /* CommaListExpression */:
-    case 353 /* PartiallyEmittedExpression */:
+    case 355 /* CommaListExpression */:
+    case 354 /* PartiallyEmittedExpression */:
     case 235 /* SatisfiesExpression */:
       return true;
     default:
@@ -14474,7 +14478,7 @@ function isDeclarationStatementKind(kind) {
   return kind === 259 /* FunctionDeclaration */ || kind === 279 /* MissingDeclaration */ || kind === 260 /* ClassDeclaration */ || kind === 261 /* InterfaceDeclaration */ || kind === 262 /* TypeAliasDeclaration */ || kind === 263 /* EnumDeclaration */ || kind === 264 /* ModuleDeclaration */ || kind === 269 /* ImportDeclaration */ || kind === 268 /* ImportEqualsDeclaration */ || kind === 275 /* ExportDeclaration */ || kind === 274 /* ExportAssignment */ || kind === 267 /* NamespaceExportDeclaration */;
 }
 function isStatementKindButNotDeclarationKind(kind) {
-  return kind === 249 /* BreakStatement */ || kind === 248 /* ContinueStatement */ || kind === 256 /* DebuggerStatement */ || kind === 243 /* DoStatement */ || kind === 241 /* ExpressionStatement */ || kind === 239 /* EmptyStatement */ || kind === 246 /* ForInStatement */ || kind === 247 /* ForOfStatement */ || kind === 245 /* ForStatement */ || kind === 242 /* IfStatement */ || kind === 253 /* LabeledStatement */ || kind === 250 /* ReturnStatement */ || kind === 252 /* SwitchStatement */ || kind === 254 /* ThrowStatement */ || kind === 255 /* TryStatement */ || kind === 240 /* VariableStatement */ || kind === 244 /* WhileStatement */ || kind === 251 /* WithStatement */ || kind === 352 /* NotEmittedStatement */ || kind === 356 /* EndOfDeclarationMarker */ || kind === 355 /* MergeDeclarationMarker */;
+  return kind === 249 /* BreakStatement */ || kind === 248 /* ContinueStatement */ || kind === 256 /* DebuggerStatement */ || kind === 243 /* DoStatement */ || kind === 241 /* ExpressionStatement */ || kind === 239 /* EmptyStatement */ || kind === 246 /* ForInStatement */ || kind === 247 /* ForOfStatement */ || kind === 245 /* ForStatement */ || kind === 242 /* IfStatement */ || kind === 253 /* LabeledStatement */ || kind === 250 /* ReturnStatement */ || kind === 252 /* SwitchStatement */ || kind === 254 /* ThrowStatement */ || kind === 255 /* TryStatement */ || kind === 240 /* VariableStatement */ || kind === 244 /* WhileStatement */ || kind === 251 /* WithStatement */ || kind === 353 /* NotEmittedStatement */ || kind === 357 /* EndOfDeclarationMarker */ || kind === 356 /* MergeDeclarationMarker */;
 }
 function isDeclaration(node) {
   if (node.kind === 165 /* TypeParameter */) {
@@ -14535,13 +14539,13 @@ function isCaseOrDefaultClause(node) {
   return kind === 292 /* CaseClause */ || kind === 293 /* DefaultClause */;
 }
 function isJSDocNode(node) {
-  return node.kind >= 312 /* FirstJSDocNode */ && node.kind <= 350 /* LastJSDocNode */;
+  return node.kind >= 312 /* FirstJSDocNode */ && node.kind <= 351 /* LastJSDocNode */;
 }
 function isJSDocCommentContainingNode(node) {
   return node.kind === 323 /* JSDoc */ || node.kind === 322 /* JSDocNamepathType */ || node.kind === 324 /* JSDocText */ || isJSDocLinkLike(node) || isJSDocTag(node) || isJSDocTypeLiteral(node) || isJSDocSignature(node);
 }
 function isJSDocTag(node) {
-  return node.kind >= 330 /* FirstJSDocTagNode */ && node.kind <= 350 /* LastJSDocTagNode */;
+  return node.kind >= 330 /* FirstJSDocTagNode */ && node.kind <= 351 /* LastJSDocTagNode */;
 }
 function isSetAccessor(node) {
   return node.kind === 175 /* SetAccessor */;
@@ -14951,7 +14955,7 @@ function getTokenPosOfNode(node, sourceFile, includeJsDoc) {
   if (includeJsDoc && hasJSDocNodes(node)) {
     return getTokenPosOfNode(node.jsDoc[0], sourceFile);
   }
-  if (node.kind === 351 /* SyntaxList */ && node._children.length > 0) {
+  if (node.kind === 352 /* SyntaxList */ && node._children.length > 0) {
     return getTokenPosOfNode(node._children[0], sourceFile, includeJsDoc);
   }
   return skipTrivia(
@@ -16125,7 +16129,7 @@ function isExpressionNode(node) {
     case 233 /* MetaProperty */:
       return true;
     case 230 /* ExpressionWithTypeArguments */:
-      return !isHeritageClause(node.parent);
+      return !isHeritageClause(node.parent) && !isJSDocAugmentsTag(node.parent);
     case 163 /* QualifiedName */:
       while (node.parent.kind === 163 /* QualifiedName */) {
         node = node.parent;
@@ -17224,7 +17228,7 @@ var OperatorPrecedence = /* @__PURE__ */ ((OperatorPrecedence2) => {
 })(OperatorPrecedence || {});
 function getOperatorPrecedence(nodeKind, operatorKind, hasArguments) {
   switch (nodeKind) {
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
       return 0 /* Comma */;
     case 227 /* SpreadElement */:
       return 1 /* Spread */;
@@ -18208,7 +18212,18 @@ function tryGetClassExtendingExpressionWithTypeArguments(node) {
   return cls && !cls.isImplements ? cls.class : void 0;
 }
 function tryGetClassImplementingOrExtendingExpressionWithTypeArguments(node) {
-  return isExpressionWithTypeArguments(node) && isHeritageClause(node.parent) && isClassLike(node.parent.parent) ? { class: node.parent.parent, isImplements: node.parent.token === 117 /* ImplementsKeyword */ } : void 0;
+  if (isExpressionWithTypeArguments(node)) {
+    if (isHeritageClause(node.parent) && isClassLike(node.parent.parent)) {
+      return { class: node.parent.parent, isImplements: node.parent.token === 117 /* ImplementsKeyword */ };
+    }
+    if (isJSDocAugmentsTag(node.parent)) {
+      const host = getEffectiveJSDocHost(node.parent);
+      if (host && isClassLike(host)) {
+        return { class: host, isImplements: false };
+      }
+    }
+  }
+  return void 0;
 }
 function isAssignmentExpression(node, excludeCompoundAssignment) {
   return isBinaryExpression(node) && (excludeCompoundAssignment ? node.operatorToken.kind === 63 /* EqualsToken */ : isAssignmentOperator(node.operatorToken.kind)) && isLeftHandSideExpression(node.left);
@@ -18791,7 +18806,7 @@ function getLeftmostExpression(node, stopAtCallExpressions) {
       case 209 /* ElementAccessExpression */:
       case 208 /* PropertyAccessExpression */:
       case 232 /* NonNullExpression */:
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
       case 235 /* SatisfiesExpression */:
         node = node.expression;
         continue;
@@ -19947,7 +19962,7 @@ function getContainingNodeArray(node) {
       return parent2.types;
     case 186 /* TupleType */:
     case 206 /* ArrayLiteralExpression */:
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
     case 272 /* NamedImports */:
     case 276 /* NamedExports */:
       return parent2.elements;
@@ -20110,6 +20125,23 @@ function hasTabstop(node) {
   var _a2;
   return ((_a2 = getSnippetElement(node)) == null ? void 0 : _a2.kind) === 0 /* TabStop */;
 }
+function isJSDocOptionalParameter(node) {
+  return isInJSFile(node) && (node.type && node.type.kind === 319 /* JSDocOptionalType */ || getJSDocParameterTags(node).some(({ isBracketed, typeExpression }) => isBracketed || !!typeExpression && typeExpression.type.kind === 319 /* JSDocOptionalType */));
+}
+function isOptionalDeclaration(declaration) {
+  switch (declaration.kind) {
+    case 169 /* PropertyDeclaration */:
+    case 168 /* PropertySignature */:
+      return !!declaration.questionToken;
+    case 166 /* Parameter */:
+      return !!declaration.questionToken || isJSDocOptionalParameter(declaration);
+    case 350 /* JSDocPropertyTag */:
+    case 343 /* JSDocParameterTag */:
+      return isOptionalJSDocPropertyLikeTag(declaration);
+    default:
+      return false;
+  }
+}
 
 // src/compiler/factory/baseNodeFactory.ts
 function createBaseNodeFactory() {
@@ -21065,6 +21097,12 @@ function createNodeFactory(flags, baseFactory2) {
     get updateJSDocDeprecatedTag() {
       return getJSDocSimpleTagUpdateFunction(334 /* JSDocDeprecatedTag */);
     },
+    get createJSDocThrowsTag() {
+      return getJSDocTypeLikeTagCreateFunction(351 /* JSDocThrowsTag */);
+    },
+    get updateJSDocThrowsTag() {
+      return getJSDocTypeLikeTagUpdateFunction(351 /* JSDocThrowsTag */);
+    },
     createJSDocUnknownTag,
     updateJSDocUnknownTag,
     createJSDocText,
@@ -24014,18 +24052,18 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createSyntaxList3(children) {
-    const node = createBaseNode(351 /* SyntaxList */);
+    const node = createBaseNode(352 /* SyntaxList */);
     node._children = children;
     return node;
   }
   function createNotEmittedStatement2(original) {
-    const node = createBaseNode(352 /* NotEmittedStatement */);
+    const node = createBaseNode(353 /* NotEmittedStatement */);
     node.original = original;
     setTextRange(node, original);
     return node;
   }
   function createPartiallyEmittedExpression2(expression, original) {
-    const node = createBaseNode(353 /* PartiallyEmittedExpression */);
+    const node = createBaseNode(354 /* PartiallyEmittedExpression */);
     node.expression = expression;
     node.original = original;
     node.transformFlags |= propagateChildFlags(node.expression) | 1 /* ContainsTypeScript */;
@@ -24047,7 +24085,7 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createCommaListExpression(elements) {
-    const node = createBaseNode(354 /* CommaListExpression */);
+    const node = createBaseNode(355 /* CommaListExpression */);
     node.elements = createNodeArray2(sameFlatMap(elements, flattenCommaElements));
     node.transformFlags |= propagateChildrenFlags(node.elements);
     return node;
@@ -24056,19 +24094,19 @@ function createNodeFactory(flags, baseFactory2) {
     return node.elements !== elements ? update(createCommaListExpression(elements), node) : node;
   }
   function createEndOfDeclarationMarker(original) {
-    const node = createBaseNode(356 /* EndOfDeclarationMarker */);
+    const node = createBaseNode(357 /* EndOfDeclarationMarker */);
     node.emitNode = {};
     node.original = original;
     return node;
   }
   function createMergeDeclarationMarker(original) {
-    const node = createBaseNode(355 /* MergeDeclarationMarker */);
+    const node = createBaseNode(356 /* MergeDeclarationMarker */);
     node.emitNode = {};
     node.original = original;
     return node;
   }
   function createSyntheticReferenceExpression(expression, thisArg) {
-    const node = createBaseNode(357 /* SyntheticReferenceExpression */);
+    const node = createBaseNode(358 /* SyntheticReferenceExpression */);
     node.expression = expression;
     node.thisArg = thisArg;
     node.transformFlags |= propagateChildFlags(node.expression) | propagateChildFlags(node.thisArg);
@@ -24216,7 +24254,7 @@ function createNodeFactory(flags, baseFactory2) {
         return updateSatisfiesExpression(outerExpression, expression, outerExpression.type);
       case 232 /* NonNullExpression */:
         return updateNonNullExpression2(outerExpression, expression);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return updatePartiallyEmittedExpression2(outerExpression, expression);
     }
   }
@@ -24707,7 +24745,7 @@ function getTransformFlagsSubtreeExclusions(kind) {
     case 213 /* TypeAssertionExpression */:
     case 235 /* SatisfiesExpression */:
     case 231 /* AsExpression */:
-    case 353 /* PartiallyEmittedExpression */:
+    case 354 /* PartiallyEmittedExpression */:
     case 214 /* ParenthesizedExpression */:
     case 106 /* SuperKeyword */:
       return -2147483648 /* OuterExpressionExcludes */;
@@ -26245,10 +26283,10 @@ function isSyntheticExpression(node) {
   return node.kind === 234 /* SyntheticExpression */;
 }
 function isPartiallyEmittedExpression(node) {
-  return node.kind === 353 /* PartiallyEmittedExpression */;
+  return node.kind === 354 /* PartiallyEmittedExpression */;
 }
 function isCommaListExpression(node) {
-  return node.kind === 354 /* CommaListExpression */;
+  return node.kind === 355 /* CommaListExpression */;
 }
 function isTemplateSpan(node) {
   return node.kind === 236 /* TemplateSpan */;
@@ -26392,16 +26430,16 @@ function isMissingDeclaration(node) {
   return node.kind === 279 /* MissingDeclaration */;
 }
 function isNotEmittedStatement(node) {
-  return node.kind === 352 /* NotEmittedStatement */;
+  return node.kind === 353 /* NotEmittedStatement */;
 }
 function isSyntheticReference(node) {
-  return node.kind === 357 /* SyntheticReferenceExpression */;
+  return node.kind === 358 /* SyntheticReferenceExpression */;
 }
 function isMergeDeclarationMarker(node) {
-  return node.kind === 355 /* MergeDeclarationMarker */;
+  return node.kind === 356 /* MergeDeclarationMarker */;
 }
 function isEndOfDeclarationMarker(node) {
-  return node.kind === 356 /* EndOfDeclarationMarker */;
+  return node.kind === 357 /* EndOfDeclarationMarker */;
 }
 function isExternalModuleReference(node) {
   return node.kind === 280 /* ExternalModuleReference */;
@@ -26589,8 +26627,11 @@ function isJSDocPropertyTag(node) {
 function isJSDocImplementsTag(node) {
   return node.kind === 332 /* JSDocImplementsTag */;
 }
+function isJSDocThrowsTag(node) {
+  return node.kind === 351 /* JSDocThrowsTag */;
+}
 function isSyntaxList(n) {
-  return n.kind === 351 /* SyntaxList */;
+  return n.kind === 352 /* SyntaxList */;
 }
 
 // src/compiler/factory/utilities.ts
@@ -26894,7 +26935,7 @@ function startsWithUseStrict(statements) {
   return firstStatement !== void 0 && isPrologueDirective(firstStatement) && isUseStrictPrologue(firstStatement);
 }
 function isCommaSequence(node) {
-  return node.kind === 223 /* BinaryExpression */ && node.operatorToken.kind === 27 /* CommaToken */ || node.kind === 354 /* CommaListExpression */;
+  return node.kind === 223 /* BinaryExpression */ && node.operatorToken.kind === 27 /* CommaToken */ || node.kind === 355 /* CommaListExpression */;
 }
 function isJSDocTypeAssertion(node) {
   return isParenthesizedExpression(node) && isInJSFile(node) && !!getJSDocTypeTag(node);
@@ -26917,7 +26958,7 @@ function isOuterExpression(node, kinds = 15 /* All */) {
       return (kinds & 2 /* TypeAssertions */) !== 0;
     case 232 /* NonNullExpression */:
       return (kinds & 4 /* NonNullAssertions */) !== 0;
-    case 353 /* PartiallyEmittedExpression */:
+    case 354 /* PartiallyEmittedExpression */:
       return (kinds & 8 /* PartiallyEmittedExpressions */) !== 0;
   }
   return false;
@@ -27855,7 +27896,7 @@ var forEachChildTable = {
   [279 /* MissingDeclaration */]: function forEachChildInMissingDeclaration(node, cbNode, cbNodes) {
     return visitNodes(cbNode, cbNodes, node.illegalDecorators) || visitNodes(cbNode, cbNodes, node.modifiers);
   },
-  [354 /* CommaListExpression */]: function forEachChildInCommaListExpression(node, cbNode, cbNodes) {
+  [355 /* CommaListExpression */]: function forEachChildInCommaListExpression(node, cbNode, cbNodes) {
     return visitNodes(cbNode, cbNodes, node.elements);
   },
   [281 /* JsxElement */]: function forEachChildInJsxElement(node, cbNode, cbNodes) {
@@ -27923,10 +27964,11 @@ var forEachChildTable = {
   [341 /* JSDocCallbackTag */]: function forEachChildInJSDocCallbackTag(node, cbNode, cbNodes) {
     return visitNode2(cbNode, node.tagName) || visitNode2(cbNode, node.fullName) || visitNode2(cbNode, node.typeExpression) || (typeof node.comment === "string" ? void 0 : visitNodes(cbNode, cbNodes, node.comment));
   },
-  [344 /* JSDocReturnTag */]: forEachChildInJSDocReturnTag,
-  [346 /* JSDocTypeTag */]: forEachChildInJSDocReturnTag,
-  [345 /* JSDocThisTag */]: forEachChildInJSDocReturnTag,
-  [342 /* JSDocEnumTag */]: forEachChildInJSDocReturnTag,
+  [344 /* JSDocReturnTag */]: forEachChildInJSDocTypeLikeTag,
+  [346 /* JSDocTypeTag */]: forEachChildInJSDocTypeLikeTag,
+  [345 /* JSDocThisTag */]: forEachChildInJSDocTypeLikeTag,
+  [342 /* JSDocEnumTag */]: forEachChildInJSDocTypeLikeTag,
+  [351 /* JSDocThrowsTag */]: forEachChildInJSDocTypeLikeTag,
   [326 /* JSDocSignature */]: function forEachChildInJSDocSignature(node, cbNode, _cbNodes) {
     return forEach(node.typeParameters, cbNode) || forEach(node.parameters, cbNode) || visitNode2(cbNode, node.type);
   },
@@ -27944,7 +27986,7 @@ var forEachChildTable = {
   [339 /* JSDocReadonlyTag */]: forEachChildInJSDocTag,
   [334 /* JSDocDeprecatedTag */]: forEachChildInJSDocTag,
   [340 /* JSDocOverrideTag */]: forEachChildInJSDocTag,
-  [353 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
+  [354 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
 };
 function forEachChildInCallOrConstructSignature(node, cbNode, cbNodes) {
   return visitNodes(cbNode, cbNodes, node.typeParameters) || visitNodes(cbNode, cbNodes, node.parameters) || visitNode2(cbNode, node.type);
@@ -27985,7 +28027,7 @@ function forEachChildInOptionalRestOrJSDocParameterModifier(node, cbNode, _cbNod
 function forEachChildInJSDocParameterOrPropertyTag(node, cbNode, cbNodes) {
   return visitNode2(cbNode, node.tagName) || (node.isNameFirst ? visitNode2(cbNode, node.name) || visitNode2(cbNode, node.typeExpression) : visitNode2(cbNode, node.typeExpression) || visitNode2(cbNode, node.name)) || (typeof node.comment === "string" ? void 0 : visitNodes(cbNode, cbNodes, node.comment));
 }
-function forEachChildInJSDocReturnTag(node, cbNode, cbNodes) {
+function forEachChildInJSDocTypeLikeTag(node, cbNode, cbNodes) {
   return visitNode2(cbNode, node.tagName) || visitNode2(cbNode, node.typeExpression) || (typeof node.comment === "string" ? void 0 : visitNodes(cbNode, cbNodes, node.comment));
 }
 function forEachChildInJSDocLinkCodeOrPlain(node, cbNode, _cbNodes) {
@@ -33283,6 +33325,10 @@ var Parser;
           case "see":
             tag = parseSeeTag(start3, tagName, margin, indentText);
             break;
+          case "exception":
+          case "throws":
+            tag = parseThrowsTag(start3, tagName, margin, indentText);
+            break;
           default:
             tag = parseUnknownTag(start3, tagName, margin, indentText);
             break;
@@ -33535,6 +33581,11 @@ var Parser;
         const comments2 = indent3 !== void 0 && indentText !== void 0 ? parseTrailingTagComments(start3, getNodePos(), indent3, indentText) : void 0;
         return finishNode(factory2.createJSDocSeeTag(tagName, nameExpression, comments2), start3);
       }
+      function parseThrowsTag(start3, tagName, indent3, indentText) {
+        const typeExpression = tryParseTypeExpression();
+        const comment = parseTrailingTagComments(start3, getNodePos(), indent3, indentText);
+        return finishNode(factory2.createJSDocThrowsTag(tagName, typeExpression, comment), start3);
+      }
       function parseAuthorTag(start3, tagName, indent3, indentText) {
         const commentStart = getNodePos();
         const textOnly = parseAuthorNameAndEmail();
@@ -49958,8 +50009,8 @@ function createTypeChecker(host) {
     if (isBindingPattern(declaration.parent)) {
       return getTypeForBindingElement(declaration);
     }
-    const isProperty = isPropertyDeclaration(declaration) && !hasAccessorModifier(declaration) || isPropertySignature(declaration);
-    const isOptional = includeOptionality && (isProperty && !!declaration.questionToken || isParameter(declaration) && (!!declaration.questionToken || isJSDocOptionalParameter(declaration)) || isOptionalJSDocPropertyLikeTag(declaration));
+    const isProperty = isPropertyDeclaration(declaration) && !hasAccessorModifier(declaration) || isPropertySignature(declaration) || isJSDocPropertyTag(declaration);
+    const isOptional = includeOptionality && isOptionalDeclaration(declaration);
     const declaredType = tryGetTypeFromEffectiveTypeNode(declaration);
     if (declaredType) {
       return addOptionality(declaredType, isProperty, isOptional);
@@ -52867,9 +52918,6 @@ function createTypeChecker(host) {
     });
     return result;
   }
-  function isJSDocOptionalParameter(node) {
-    return isInJSFile(node) && (node.type && node.type.kind === 319 /* JSDocOptionalType */ || getJSDocParameterTags(node).some(({ isBracketed, typeExpression }) => isBracketed || !!typeExpression && typeExpression.type.kind === 319 /* JSDocOptionalType */));
-  }
   function tryFindAmbientModule(moduleName, withAugmentations) {
     if (isExternalModuleNameRelative(moduleName)) {
       return void 0;
@@ -79098,13 +79146,13 @@ var visitEachChildTable = {
       visitLexicalEnvironment(node.statements, visitor, context)
     );
   },
-  [353 /* PartiallyEmittedExpression */]: function visitEachChildOfPartiallyEmittedExpression(node, visitor, context, _nodesVisitor, nodeVisitor, _tokenVisitor) {
+  [354 /* PartiallyEmittedExpression */]: function visitEachChildOfPartiallyEmittedExpression(node, visitor, context, _nodesVisitor, nodeVisitor, _tokenVisitor) {
     return context.factory.updatePartiallyEmittedExpression(
       node,
       nodeVisitor(node.expression, visitor, isExpression)
     );
   },
-  [354 /* CommaListExpression */]: function visitEachChildOfCommaListExpression(node, visitor, context, nodesVisitor, _nodeVisitor, _tokenVisitor) {
+  [355 /* CommaListExpression */]: function visitEachChildOfCommaListExpression(node, visitor, context, nodesVisitor, _nodeVisitor, _tokenVisitor) {
     return context.factory.updateCommaListExpression(
       node,
       nodesVisitor(node.elements, visitor, isExpression)
@@ -85168,7 +85216,7 @@ function transformES2018(context) {
         return visitObjectLiteralExpression(node);
       case 223 /* BinaryExpression */:
         return visitBinaryExpression(node, expressionResultIsUnused2);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node, expressionResultIsUnused2);
       case 295 /* CatchClause */:
         return visitCatchClause(node);
@@ -87364,7 +87412,7 @@ function transformES2015(context) {
         return visitParenthesizedExpression(node, expressionResultIsUnused2);
       case 223 /* BinaryExpression */:
         return visitBinaryExpression(node, expressionResultIsUnused2);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node, expressionResultIsUnused2);
       case 14 /* NoSubstitutionTemplateLiteral */:
       case 15 /* TemplateHead */:
@@ -90059,7 +90107,7 @@ function transformGenerators(context) {
     switch (node.kind) {
       case 223 /* BinaryExpression */:
         return visitBinaryExpression(node);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node);
       case 224 /* ConditionalExpression */:
         return visitConditionalExpression(node);
@@ -92144,9 +92192,9 @@ function transformModule(context) {
         return visitFunctionDeclaration(node);
       case 260 /* ClassDeclaration */:
         return visitClassDeclaration(node);
-      case 355 /* MergeDeclarationMarker */:
+      case 356 /* MergeDeclarationMarker */:
         return visitMergeDeclarationMarker(node);
-      case 356 /* EndOfDeclarationMarker */:
+      case 357 /* EndOfDeclarationMarker */:
         return visitEndOfDeclarationMarker(node);
       default:
         return visitor(node);
@@ -92163,7 +92211,7 @@ function transformModule(context) {
         return visitExpressionStatement(node);
       case 214 /* ParenthesizedExpression */:
         return visitParenthesizedExpression(node, valueIsDiscarded);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return visitPartiallyEmittedExpression(node, valueIsDiscarded);
       case 210 /* CallExpression */:
         if (isImportCall(node) && currentSourceFile.impliedNodeFormat === void 0) {
@@ -93938,9 +93986,9 @@ function transformSystemModule(context) {
         return visitCatchClause(node);
       case 238 /* Block */:
         return visitBlock(node);
-      case 355 /* MergeDeclarationMarker */:
+      case 356 /* MergeDeclarationMarker */:
         return visitMergeDeclarationMarker(node);
-      case 356 /* EndOfDeclarationMarker */:
+      case 357 /* EndOfDeclarationMarker */:
         return visitEndOfDeclarationMarker(node);
       default:
         return visitor(node);
@@ -94088,7 +94136,7 @@ function transformSystemModule(context) {
         return visitExpressionStatement(node);
       case 214 /* ParenthesizedExpression */:
         return visitParenthesizedExpression(node, valueIsDiscarded);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return visitPartiallyEmittedExpression(node, valueIsDiscarded);
       case 223 /* BinaryExpression */:
         if (isDestructuringAssignment(node)) {
@@ -96489,7 +96537,7 @@ function noEmitNotification(hint, node, callback) {
 }
 function transformNodes(resolver, host, factory2, options, nodes, transformers, allowDtsFiles) {
   var _a2, _b;
-  const enabledSyntaxKindFeatures = new Array(358 /* Count */);
+  const enabledSyntaxKindFeatures = new Array(359 /* Count */);
   let lexicalEnvironmentVariableDeclarations;
   let lexicalEnvironmentFunctionDeclarations;
   let lexicalEnvironmentStatements;
@@ -98207,6 +98255,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
         case 344 /* JSDocReturnTag */:
         case 345 /* JSDocThisTag */:
         case 346 /* JSDocTypeTag */:
+        case 351 /* JSDocThrowsTag */:
           return emitJSDocSimpleTypedTag(node);
         case 347 /* JSDocTemplateTag */:
           return emitJSDocTemplateTag(node);
@@ -98214,9 +98263,9 @@ function createPrinter(printerOptions = {}, handlers = {}) {
           return emitJSDocTypedefTag(node);
         case 349 /* JSDocSeeTag */:
           return emitJSDocSeeTag(node);
-        case 352 /* NotEmittedStatement */:
-        case 356 /* EndOfDeclarationMarker */:
-        case 355 /* MergeDeclarationMarker */:
+        case 353 /* NotEmittedStatement */:
+        case 357 /* EndOfDeclarationMarker */:
+        case 356 /* MergeDeclarationMarker */:
           return;
       }
       if (isExpression(node)) {
@@ -98311,18 +98360,18 @@ function createPrinter(printerOptions = {}, handlers = {}) {
           return emitJsxSelfClosingElement(node);
         case 285 /* JsxFragment */:
           return emitJsxFragment(node);
-        case 351 /* SyntaxList */:
+        case 352 /* SyntaxList */:
           return Debug.fail("SyntaxList should not be printed");
-        case 352 /* NotEmittedStatement */:
+        case 353 /* NotEmittedStatement */:
           return;
-        case 353 /* PartiallyEmittedExpression */:
+        case 354 /* PartiallyEmittedExpression */:
           return emitPartiallyEmittedExpression(node);
-        case 354 /* CommaListExpression */:
+        case 355 /* CommaListExpression */:
           return emitCommaList(node);
-        case 355 /* MergeDeclarationMarker */:
-        case 356 /* EndOfDeclarationMarker */:
+        case 356 /* MergeDeclarationMarker */:
+        case 357 /* EndOfDeclarationMarker */:
           return;
-        case 357 /* SyntheticReferenceExpression */:
+        case 358 /* SyntheticReferenceExpression */:
           return Debug.fail("SyntheticReferenceExpression should not be printed");
       }
     }
@@ -101237,7 +101286,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     const skipTrailingComments = end < 0 || (emitFlags & 2048 /* NoTrailingComments */) !== 0 || node.kind === 11 /* JsxText */;
     if ((pos > 0 || end > 0) && pos !== end) {
       if (!skipLeadingComments) {
-        emitLeadingComments(pos, node.kind !== 352 /* NotEmittedStatement */);
+        emitLeadingComments(pos, node.kind !== 353 /* NotEmittedStatement */);
       }
       if (!skipLeadingComments || pos >= 0 && (emitFlags & 1024 /* NoLeadingComments */) !== 0) {
         containerPos = pos;
@@ -101260,7 +101309,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       containerPos = savedContainerPos;
       containerEnd = savedContainerEnd;
       declarationListContainerEnd = savedDeclarationListContainerEnd;
-      if (!skipTrailingComments && node.kind !== 352 /* NotEmittedStatement */) {
+      if (!skipTrailingComments && node.kind !== 353 /* NotEmittedStatement */) {
         emitTrailingComments(end);
       }
     }
@@ -101512,7 +101561,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       }
     } else {
       const source = sourceMapRange.source || sourceMapSource;
-      if (node.kind !== 352 /* NotEmittedStatement */ && (emitFlags & 32 /* NoLeadingSourceMap */) === 0 && sourceMapRange.pos >= 0) {
+      if (node.kind !== 353 /* NotEmittedStatement */ && (emitFlags & 32 /* NoLeadingSourceMap */) === 0 && sourceMapRange.pos >= 0) {
         emitSourcePos(sourceMapRange.source || sourceMapSource, skipSourceTrivia(source, sourceMapRange.pos));
       }
       if (emitFlags & 128 /* NoNestedSourceMaps */) {
@@ -101527,7 +101576,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       if (emitFlags & 128 /* NoNestedSourceMaps */) {
         sourceMapsDisabled = false;
       }
-      if (node.kind !== 352 /* NotEmittedStatement */ && (emitFlags & 64 /* NoTrailingSourceMap */) === 0 && sourceMapRange.end >= 0) {
+      if (node.kind !== 353 /* NotEmittedStatement */ && (emitFlags & 64 /* NoTrailingSourceMap */) === 0 && sourceMapRange.end >= 0) {
         emitSourcePos(sourceMapRange.source || sourceMapSource, sourceMapRange.end);
       }
     }
@@ -113105,6 +113154,7 @@ __export(ts_exports3, {
   isJSDocNode: () => isJSDocNode,
   isJSDocNonNullableType: () => isJSDocNonNullableType,
   isJSDocNullableType: () => isJSDocNullableType,
+  isJSDocOptionalParameter: () => isJSDocOptionalParameter,
   isJSDocOptionalType: () => isJSDocOptionalType,
   isJSDocOverrideTag: () => isJSDocOverrideTag,
   isJSDocParameterTag: () => isJSDocParameterTag,
@@ -113120,6 +113170,7 @@ __export(ts_exports3, {
   isJSDocTag: () => isJSDocTag,
   isJSDocTemplateTag: () => isJSDocTemplateTag,
   isJSDocThisTag: () => isJSDocThisTag,
+  isJSDocThrowsTag: () => isJSDocThrowsTag,
   isJSDocTypeAlias: () => isJSDocTypeAlias,
   isJSDocTypeAssertion: () => isJSDocTypeAssertion,
   isJSDocTypeExpression: () => isJSDocTypeExpression,
@@ -113250,6 +113301,7 @@ __export(ts_exports3, {
   isOmittedExpression: () => isOmittedExpression,
   isOptionalChain: () => isOptionalChain,
   isOptionalChainRoot: () => isOptionalChainRoot,
+  isOptionalDeclaration: () => isOptionalDeclaration,
   isOptionalJSDocPropertyLikeTag: () => isOptionalJSDocPropertyLikeTag,
   isOptionalTypeNode: () => isOptionalTypeNode,
   isOuterExpression: () => isOuterExpression,
@@ -116120,7 +116172,7 @@ function buildLinkParts(link, checker) {
       if (text)
         parts.push(linkTextPart(text));
     } else {
-      parts.push(linkTextPart(name + (suffix || text.indexOf("://") === 0 ? "" : " ") + text));
+      parts.push(linkTextPart(name + (suffix ? "" : " ") + text));
     }
   }
   parts.push(linkPart("}"));
@@ -116136,20 +116188,26 @@ function skipSeparatorFromLinkText(text) {
   return text;
 }
 function findLinkNameEnd(text) {
+  let pos = text.indexOf("://");
+  if (pos === 0) {
+    while (pos < text.length && text.charCodeAt(pos) !== 124 /* bar */)
+      pos++;
+    return pos;
+  }
   if (text.indexOf("()") === 0)
     return 2;
-  if (text[0] !== "<")
-    return 0;
-  let brackets2 = 0;
-  let i = 0;
-  while (i < text.length) {
-    if (text[i] === "<")
-      brackets2++;
-    if (text[i] === ">")
-      brackets2--;
-    i++;
-    if (!brackets2)
-      return i;
+  if (text.charAt(0) === "<") {
+    let brackets2 = 0;
+    let i = 0;
+    while (i < text.length) {
+      if (text[i] === "<")
+        brackets2++;
+      if (text[i] === ">")
+        brackets2--;
+      i++;
+      if (!brackets2)
+        return i;
+    }
   }
   return 0;
 }
@@ -117796,7 +117854,7 @@ function getEncodedSyntacticClassifications(cancellationToken, sourceFile, span)
     pushClassification(start2, width, 1 /* comment */);
   }
   function classifyJSDocComment(docComment) {
-    var _a2, _b, _c, _d, _e, _f, _g;
+    var _a2, _b, _c, _d, _e, _f, _g, _h;
     let pos = docComment.pos;
     if (docComment.tags) {
       for (const tag of docComment.tags) {
@@ -117850,6 +117908,11 @@ function getEncodedSyntacticClassifications(cancellationToken, sourceFile, span)
           case 332 /* JSDocImplementsTag */:
             commentStart = tag.class.end;
             break;
+          case 351 /* JSDocThrowsTag */:
+            processElement(tag.typeExpression);
+            pos = tag.end;
+            commentStart = ((_h = tag.typeExpression) == null ? void 0 : _h.end) || commentStart;
+            break;
         }
         if (typeof tag.comment === "object") {
           pushCommentRange(tag.comment.pos, tag.comment.end - tag.comment.pos);
@@ -120837,7 +120900,7 @@ var NodeObject = class {
     if (!children.length) {
       return void 0;
     }
-    const child = find(children, (kid) => kid.kind < 312 /* FirstJSDocNode */ || kid.kind > 350 /* LastJSDocNode */);
+    const child = find(children, (kid) => kid.kind < 312 /* FirstJSDocNode */ || kid.kind > 351 /* LastJSDocNode */);
     return child.kind < 163 /* FirstNode */ ? child : child.getFirstToken(sourceFile);
   }
   getLastToken(sourceFile) {
@@ -120904,7 +120967,7 @@ function addSyntheticNodes(nodes, pos, end, parent2) {
   }
 }
 function createSyntaxList(nodes, parent2) {
-  const list = createNode(351 /* SyntaxList */, nodes.pos, nodes.end, parent2);
+  const list = createNode(352 /* SyntaxList */, nodes.pos, nodes.end, parent2);
   list._children = [];
   let pos = nodes.pos;
   for (const node of nodes) {
@@ -131905,6 +131968,9 @@ function addNewNodeForMemberSymbol(symbol, enclosingDeclaration, sourceFile, con
       addClassElement(method);
   }
   function createName(node) {
+    if (isIdentifier(node) && node.escapedText === "constructor") {
+      return factory.createComputedPropertyName(factory.createStringLiteral(idText(node), quotePreference === 0 /* Single */));
+    }
     return getSynthesizedDeepClone(node, false);
   }
   function createBody(block, quotePreference2, ambient2) {
@@ -135025,6 +135091,7 @@ function getCompletionData(program, log, sourceFile, compilerOptions, position,
       case 344 /* JSDocReturnTag */:
       case 346 /* JSDocTypeTag */:
       case 348 /* JSDocTypedefTag */:
+      case 351 /* JSDocThrowsTag */:
         return true;
       case 347 /* JSDocTemplateTag */:
         return !!tag.constraint;
@@ -136226,7 +136293,7 @@ function getPropertiesForCompletion(type, checker) {
 }
 function tryGetObjectTypeDeclarationCompletionContainer(sourceFile, contextToken, location, position) {
   switch (location.kind) {
-    case 351 /* SyntaxList */:
+    case 352 /* SyntaxList */:
       return tryCast(location.parent, isObjectTypeDeclaration);
     case 1 /* EndOfFileToken */:
       const cls = tryCast(lastOrUndefined(cast(location.parent, isSourceFile).statements), isObjectTypeDeclaration);
@@ -140262,6 +140329,9 @@ function getCommentDisplayParts(tag, checker) {
   const { comment, kind } = tag;
   const namePart = getTagNameDisplayPart(kind);
   switch (kind) {
+    case 351 /* JSDocThrowsTag */:
+      const typeExpression = tag.typeExpression;
+      return typeExpression ? withNode(typeExpression) : comment === void 0 ? void 0 : getDisplayPartsFromComment(comment, checker);
     case 332 /* JSDocImplementsTag */:
       return withNode(tag.class);
     case 331 /* JSDocAugmentsTag */:
@@ -163730,6 +163800,7 @@ start(initializeNodeSystem(), require("os").platform());
   isJSDocNode,
   isJSDocNonNullableType,
   isJSDocNullableType,
+  isJSDocOptionalParameter,
   isJSDocOptionalType,
   isJSDocOverrideTag,
   isJSDocParameterTag,
@@ -163745,6 +163816,7 @@ start(initializeNodeSystem(), require("os").platform());
   isJSDocTag,
   isJSDocTemplateTag,
   isJSDocThisTag,
+  isJSDocThrowsTag,
   isJSDocTypeAlias,
   isJSDocTypeAssertion,
   isJSDocTypeExpression,
@@ -163875,6 +163947,7 @@ start(initializeNodeSystem(), require("os").platform());
   isOmittedExpression,
   isOptionalChain,
   isOptionalChainRoot,
+  isOptionalDeclaration,
   isOptionalJSDocPropertyLikeTag,
   isOptionalTypeNode,
   isOuterExpression,