typescript 5.0.0-dev.20221212 → 5.0.0-dev.20221213

package/lib/tsc.js

@@ -23,7 +23,7 @@ var __export = (target, all) => {
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.0";
-var version = `${versionMajorMinor}.0-dev.20221212`;
+var version = `${versionMajorMinor}.0-dev.20221213`;
 
 // src/compiler/core.ts
 var emptyArray = [];
@@ -3340,14 +3340,15 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind4) => {
   SyntaxKind4[SyntaxKind4["JSDocTypedefTag"] = 348] = "JSDocTypedefTag";
   SyntaxKind4[SyntaxKind4["JSDocSeeTag"] = 349] = "JSDocSeeTag";
   SyntaxKind4[SyntaxKind4["JSDocPropertyTag"] = 350] = "JSDocPropertyTag";
-  SyntaxKind4[SyntaxKind4["SyntaxList"] = 351] = "SyntaxList";
-  SyntaxKind4[SyntaxKind4["NotEmittedStatement"] = 352] = "NotEmittedStatement";
-  SyntaxKind4[SyntaxKind4["PartiallyEmittedExpression"] = 353] = "PartiallyEmittedExpression";
-  SyntaxKind4[SyntaxKind4["CommaListExpression"] = 354] = "CommaListExpression";
-  SyntaxKind4[SyntaxKind4["MergeDeclarationMarker"] = 355] = "MergeDeclarationMarker";
-  SyntaxKind4[SyntaxKind4["EndOfDeclarationMarker"] = 356] = "EndOfDeclarationMarker";
-  SyntaxKind4[SyntaxKind4["SyntheticReferenceExpression"] = 357] = "SyntheticReferenceExpression";
-  SyntaxKind4[SyntaxKind4["Count"] = 358] = "Count";
+  SyntaxKind4[SyntaxKind4["JSDocThrowsTag"] = 351] = "JSDocThrowsTag";
+  SyntaxKind4[SyntaxKind4["SyntaxList"] = 352] = "SyntaxList";
+  SyntaxKind4[SyntaxKind4["NotEmittedStatement"] = 353] = "NotEmittedStatement";
+  SyntaxKind4[SyntaxKind4["PartiallyEmittedExpression"] = 354] = "PartiallyEmittedExpression";
+  SyntaxKind4[SyntaxKind4["CommaListExpression"] = 355] = "CommaListExpression";
+  SyntaxKind4[SyntaxKind4["MergeDeclarationMarker"] = 356] = "MergeDeclarationMarker";
+  SyntaxKind4[SyntaxKind4["EndOfDeclarationMarker"] = 357] = "EndOfDeclarationMarker";
+  SyntaxKind4[SyntaxKind4["SyntheticReferenceExpression"] = 358] = "SyntheticReferenceExpression";
+  SyntaxKind4[SyntaxKind4["Count"] = 359] = "Count";
   SyntaxKind4[SyntaxKind4["FirstAssignment"] = 63 /* EqualsToken */] = "FirstAssignment";
   SyntaxKind4[SyntaxKind4["LastAssignment"] = 78 /* CaretEqualsToken */] = "LastAssignment";
   SyntaxKind4[SyntaxKind4["FirstCompoundAssignment"] = 64 /* PlusEqualsToken */] = "FirstCompoundAssignment";
@@ -3376,9 +3377,9 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind4) => {
   SyntaxKind4[SyntaxKind4["LastStatement"] = 256 /* DebuggerStatement */] = "LastStatement";
   SyntaxKind4[SyntaxKind4["FirstNode"] = 163 /* QualifiedName */] = "FirstNode";
   SyntaxKind4[SyntaxKind4["FirstJSDocNode"] = 312 /* JSDocTypeExpression */] = "FirstJSDocNode";
-  SyntaxKind4[SyntaxKind4["LastJSDocNode"] = 350 /* JSDocPropertyTag */] = "LastJSDocNode";
+  SyntaxKind4[SyntaxKind4["LastJSDocNode"] = 351 /* JSDocThrowsTag */] = "LastJSDocNode";
   SyntaxKind4[SyntaxKind4["FirstJSDocTagNode"] = 330 /* JSDocTag */] = "FirstJSDocTagNode";
-  SyntaxKind4[SyntaxKind4["LastJSDocTagNode"] = 350 /* JSDocPropertyTag */] = "LastJSDocTagNode";
+  SyntaxKind4[SyntaxKind4["LastJSDocTagNode"] = 351 /* JSDocThrowsTag */] = "LastJSDocTagNode";
   SyntaxKind4[SyntaxKind4["FirstContextualKeyword"] = 126 /* AbstractKeyword */] = "FirstContextualKeyword";
   SyntaxKind4[SyntaxKind4["LastContextualKeyword"] = 162 /* OfKeyword */] = "LastContextualKeyword";
   return SyntaxKind4;
@@ -10365,8 +10366,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:
@@ -10429,7 +10430,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 */) {
@@ -10490,10 +10491,10 @@ 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 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 */;
@@ -10875,7 +10876,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(
@@ -11970,7 +11971,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;
@@ -12936,7 +12937,7 @@ function getOperator(expression) {
 }
 function getOperatorPrecedence(nodeKind, operatorKind, hasArguments) {
   switch (nodeKind) {
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
       return 0 /* Comma */;
     case 227 /* SpreadElement */:
       return 1 /* Spread */;
@@ -13910,7 +13911,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);
@@ -14358,7 +14370,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;
@@ -15484,7 +15496,7 @@ function getContainingNodeArray(node) {
       return parent.types;
     case 186 /* TupleType */:
     case 206 /* ArrayLiteralExpression */:
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
     case 272 /* NamedImports */:
     case 276 /* NamedExports */:
       return parent.elements;
@@ -15636,6 +15648,23 @@ function canUsePropertyAccess(name, languageVersion) {
   const firstChar = name.charCodeAt(0);
   return firstChar === 35 /* hash */ ? name.length > 1 && isIdentifierStart(name.charCodeAt(1), languageVersion) : isIdentifierStart(firstChar, languageVersion);
 }
+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() {
@@ -16580,6 +16609,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,
@@ -19529,18 +19564,18 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createSyntaxList(children) {
-    const node = createBaseNode(351 /* SyntaxList */);
+    const node = createBaseNode(352 /* SyntaxList */);
     node._children = children;
     return node;
   }
   function createNotEmittedStatement(original) {
-    const node = createBaseNode(352 /* NotEmittedStatement */);
+    const node = createBaseNode(353 /* NotEmittedStatement */);
     node.original = original;
     setTextRange(node, original);
     return node;
   }
   function createPartiallyEmittedExpression(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 */;
@@ -19562,7 +19597,7 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createCommaListExpression(elements) {
-    const node = createBaseNode(354 /* CommaListExpression */);
+    const node = createBaseNode(355 /* CommaListExpression */);
     node.elements = createNodeArray(sameFlatMap(elements, flattenCommaElements));
     node.transformFlags |= propagateChildrenFlags(node.elements);
     return node;
@@ -19571,19 +19606,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);
@@ -19731,7 +19766,7 @@ function createNodeFactory(flags, baseFactory2) {
         return updateSatisfiesExpression(outerExpression, expression, outerExpression.type);
       case 232 /* NonNullExpression */:
         return updateNonNullExpression(outerExpression, expression);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return updatePartiallyEmittedExpression(outerExpression, expression);
     }
   }
@@ -20222,7 +20257,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 */;
@@ -21674,10 +21709,10 @@ function isMetaProperty(node) {
   return node.kind === 233 /* MetaProperty */;
 }
 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 */;
@@ -21800,10 +21835,10 @@ function isExportSpecifier(node) {
   return node.kind === 278 /* ExportSpecifier */;
 }
 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 isExternalModuleReference(node) {
   return node.kind === 280 /* ExternalModuleReference */;
@@ -21961,6 +21996,9 @@ function isJSDocTemplateTag(node) {
 function isJSDocTypedefTag(node) {
   return node.kind === 348 /* JSDocTypedefTag */;
 }
+function isJSDocPropertyTag(node) {
+  return node.kind === 350 /* JSDocPropertyTag */;
+}
 function isJSDocImplementsTag(node) {
   return node.kind === 332 /* JSDocImplementsTag */;
 }
@@ -22259,7 +22297,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);
@@ -22282,7 +22320,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;
@@ -23209,7 +23247,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) {
@@ -23277,10 +23315,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);
   },
@@ -23298,7 +23337,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);
@@ -23339,7 +23378,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) {
@@ -28622,6 +28661,10 @@ var Parser;
           case "see":
             tag = parseSeeTag(start2, tagName, margin, indentText);
             break;
+          case "exception":
+          case "throws":
+            tag = parseThrowsTag(start2, tagName, margin, indentText);
+            break;
           default:
             tag = parseUnknownTag(start2, tagName, margin, indentText);
             break;
@@ -28874,6 +28917,11 @@ var Parser;
         const comments2 = indent2 !== void 0 && indentText !== void 0 ? parseTrailingTagComments(start2, getNodePos(), indent2, indentText) : void 0;
         return finishNode(factory2.createJSDocSeeTag(tagName, nameExpression, comments2), start2);
       }
+      function parseThrowsTag(start2, tagName, indent2, indentText) {
+        const typeExpression = tryParseTypeExpression();
+        const comment = parseTrailingTagComments(start2, getNodePos(), indent2, indentText);
+        return finishNode(factory2.createJSDocThrowsTag(tagName, typeExpression, comment), start2);
+      }
       function parseAuthorTag(start2, tagName, indent2, indentText) {
         const commentStart = getNodePos();
         const textOnly = parseAuthorNameAndEmail();
@@ -45099,8 +45147,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);
@@ -48008,9 +48056,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;
@@ -74239,13 +74284,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)
@@ -80144,7 +80189,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);
@@ -82340,7 +82385,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 */:
@@ -85035,7 +85080,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);
@@ -87120,9 +87165,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);
@@ -87139,7 +87184,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) {
@@ -88914,9 +88959,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);
@@ -89064,7 +89109,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)) {
@@ -91465,7 +91510,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;
@@ -93172,6 +93217,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);
@@ -93179,9 +93225,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)) {
@@ -93276,18 +93322,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");
       }
     }
@@ -96202,7 +96248,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;
@@ -96225,7 +96271,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);
       }
     }
@@ -96477,7 +96523,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 */) {
@@ -96492,7 +96538,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);
       }
     }