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

package/lib/typescript.js

@@ -42,7 +42,7 @@ var ts = (() => {
     "src/compiler/corePublic.ts"() {
       "use strict";
       versionMajorMinor = "5.0";
-      version = `${versionMajorMinor}.0-dev.20221212`;
+      version = `${versionMajorMinor}.0-dev.20221213`;
       Comparison = /* @__PURE__ */ ((Comparison3) => {
         Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
         Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -3881,14 +3881,15 @@ ${lanes.join("\n")}
         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";
@@ -3917,9 +3918,9 @@ ${lanes.join("\n")}
         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;
@@ -11875,8 +11876,8 @@ ${lanes.join("\n")}
       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:
@@ -11953,7 +11954,7 @@ ${lanes.join("\n")}
     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 */) {
@@ -12014,13 +12015,13 @@ ${lanes.join("\n")}
     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 */;
@@ -12434,7 +12435,7 @@ ${lanes.join("\n")}
     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(
@@ -13596,7 +13597,7 @@ ${lanes.join("\n")}
       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;
@@ -14648,7 +14649,7 @@ ${lanes.join("\n")}
   }
   function getOperatorPrecedence(nodeKind, operatorKind, hasArguments) {
     switch (nodeKind) {
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return 0 /* Comma */;
       case 227 /* SpreadElement */:
         return 1 /* Spread */;
@@ -15604,7 +15605,18 @@ ${lanes.join("\n")}
     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);
@@ -16178,7 +16190,7 @@ ${lanes.join("\n")}
         case 209 /* ElementAccessExpression */:
         case 208 /* PropertyAccessExpression */:
         case 232 /* NonNullExpression */:
-        case 353 /* PartiallyEmittedExpression */:
+        case 354 /* PartiallyEmittedExpression */:
         case 235 /* SatisfiesExpression */:
           node = node.expression;
           continue;
@@ -17283,7 +17295,7 @@ ${lanes.join("\n")}
         return parent2.types;
       case 186 /* TupleType */:
       case 206 /* ArrayLiteralExpression */:
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
       case 272 /* NamedImports */:
       case 276 /* NamedExports */:
         return parent2.elements;
@@ -17446,6 +17458,23 @@ ${lanes.join("\n")}
     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;
+    }
+  }
   var resolvingEmptyArray, externalHelpersModuleNameText, defaultMaximumTruncationLength, noTruncationMaximumTruncationLength, stringWriter, GetLiteralTextFlags, fullTripleSlashReferencePathRegEx, fullTripleSlashReferenceTypeReferenceDirectiveRegEx, fullTripleSlashAMDReferencePathRegEx, defaultLibReferenceRegEx, AssignmentKind, FunctionFlags, Associativity, OperatorPrecedence, templateSubstitutionRegExp, doubleQuoteEscapedCharsRegExp, singleQuoteEscapedCharsRegExp, backtickQuoteEscapedCharsRegExp, escapedCharsMap, nonAsciiCharacters, jsxDoubleQuoteEscapedCharsRegExp, jsxSingleQuoteEscapedCharsRegExp, jsxEscapedCharsMap, indentStrings, base64Digits, carriageReturnLineFeed, lineFeed, AccessKind, objectAllocator, localizedDiagnosticMessages, reservedCharacterPattern, wildcardCharCodes, commonPackageFolders, implicitExcludePathRegexPattern, filesMatcher, directoriesMatcher, excludeMatcher, wildcardMatchers, supportedTSExtensions, supportedTSExtensionsFlat, supportedTSExtensionsWithJson, supportedTSExtensionsForExtractExtension, supportedJSExtensions, supportedJSExtensionsFlat, allSupportedExtensions, allSupportedExtensionsWithJson, supportedDeclarationExtensions, supportedTSImplementationExtensions, extensionsToRemove, emptyFileSystemEntries;
   var init_utilities = __esm({
     "src/compiler/utilities.ts"() {
@@ -18569,6 +18598,12 @@ ${lanes.join("\n")}
       get updateJSDocDeprecatedTag() {
         return getJSDocSimpleTagUpdateFunction(334 /* JSDocDeprecatedTag */);
       },
+      get createJSDocThrowsTag() {
+        return getJSDocTypeLikeTagCreateFunction(351 /* JSDocThrowsTag */);
+      },
+      get updateJSDocThrowsTag() {
+        return getJSDocTypeLikeTagUpdateFunction(351 /* JSDocThrowsTag */);
+      },
       createJSDocUnknownTag,
       updateJSDocUnknownTag,
       createJSDocText,
@@ -21518,18 +21553,18 @@ ${lanes.join("\n")}
       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 */;
@@ -21551,7 +21586,7 @@ ${lanes.join("\n")}
       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;
@@ -21560,19 +21595,19 @@ ${lanes.join("\n")}
       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);
@@ -21720,7 +21755,7 @@ ${lanes.join("\n")}
           return updateSatisfiesExpression(outerExpression, expression, outerExpression.type);
         case 232 /* NonNullExpression */:
           return updateNonNullExpression2(outerExpression, expression);
-        case 353 /* PartiallyEmittedExpression */:
+        case 354 /* PartiallyEmittedExpression */:
           return updatePartiallyEmittedExpression2(outerExpression, expression);
       }
     }
@@ -22209,7 +22244,7 @@ ${lanes.join("\n")}
       case 213 /* TypeAssertionExpression */:
       case 235 /* SatisfiesExpression */:
       case 231 /* AsExpression */:
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
       case 214 /* ParenthesizedExpression */:
       case 106 /* SuperKeyword */:
         return -2147483648 /* OuterExpressionExcludes */;
@@ -23776,10 +23811,10 @@ ${lanes.join("\n")}
     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 */;
@@ -23923,16 +23958,16 @@ ${lanes.join("\n")}
     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 */;
@@ -24120,8 +24155,11 @@ ${lanes.join("\n")}
   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 */;
   }
   var init_nodeTests = __esm({
     "src/compiler/factory/nodeTests.ts"() {
@@ -24431,7 +24469,7 @@ ${lanes.join("\n")}
     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);
@@ -24454,7 +24492,7 @@ ${lanes.join("\n")}
         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;
@@ -25103,7 +25141,7 @@ ${lanes.join("\n")}
   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) {
@@ -25773,7 +25811,7 @@ ${lanes.join("\n")}
         [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) {
@@ -25841,10 +25879,11 @@ ${lanes.join("\n")}
         [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);
         },
@@ -25862,7 +25901,7 @@ ${lanes.join("\n")}
         [339 /* JSDocReadonlyTag */]: forEachChildInJSDocTag,
         [334 /* JSDocDeprecatedTag */]: forEachChildInJSDocTag,
         [340 /* JSDocOverrideTag */]: forEachChildInJSDocTag,
-        [353 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
+        [354 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
       };
       ((Parser2) => {
         const scanner2 = createScanner(99 /* Latest */, true);
@@ -31043,6 +31082,10 @@ ${lanes.join("\n")}
                 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;
@@ -31295,6 +31338,11 @@ ${lanes.join("\n")}
               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();
@@ -47419,8 +47467,8 @@ ${lanes.join("\n")}
       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);
@@ -50328,9 +50376,6 @@ ${lanes.join("\n")}
       });
       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;
@@ -76699,13 +76744,13 @@ ${lanes.join("\n")}
             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)
@@ -82827,7 +82872,7 @@ ${lanes.join("\n")}
           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);
@@ -85066,7 +85111,7 @@ ${lanes.join("\n")}
           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 */:
@@ -87773,7 +87818,7 @@ ${lanes.join("\n")}
       switch (node.kind) {
         case 223 /* BinaryExpression */:
           return visitBinaryExpression(node);
-        case 354 /* CommaListExpression */:
+        case 355 /* CommaListExpression */:
           return visitCommaListExpression(node);
         case 224 /* ConditionalExpression */:
           return visitConditionalExpression(node);
@@ -89864,9 +89909,9 @@ ${lanes.join("\n")}
           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);
@@ -89883,7 +89928,7 @@ ${lanes.join("\n")}
           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) {
@@ -91665,9 +91710,9 @@ ${lanes.join("\n")}
           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);
@@ -91815,7 +91860,7 @@ ${lanes.join("\n")}
           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)) {
@@ -94247,7 +94292,7 @@ ${lanes.join("\n")}
   }
   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;
@@ -95931,6 +95976,7 @@ ${lanes.join("\n")}
           case 344 /* JSDocReturnTag */:
           case 345 /* JSDocThisTag */:
           case 346 /* JSDocTypeTag */:
+          case 351 /* JSDocThrowsTag */:
             return emitJSDocSimpleTypedTag(node);
           case 347 /* JSDocTemplateTag */:
             return emitJSDocTemplateTag(node);
@@ -95938,9 +95984,9 @@ ${lanes.join("\n")}
             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)) {
@@ -96035,18 +96081,18 @@ ${lanes.join("\n")}
             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");
         }
       }
@@ -98961,7 +99007,7 @@ ${lanes.join("\n")}
       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;
@@ -98984,7 +99030,7 @@ ${lanes.join("\n")}
         containerPos = savedContainerPos;
         containerEnd = savedContainerEnd;
         declarationListContainerEnd = savedDeclarationListContainerEnd;
-        if (!skipTrailingComments && node.kind !== 352 /* NotEmittedStatement */) {
+        if (!skipTrailingComments && node.kind !== 353 /* NotEmittedStatement */) {
           emitTrailingComments(end);
         }
       }
@@ -99236,7 +99282,7 @@ ${lanes.join("\n")}
         }
       } 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 */) {
@@ -99251,7 +99297,7 @@ ${lanes.join("\n")}
         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);
         }
       }
@@ -111474,7 +111520,7 @@ ${lanes.join("\n")}
         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("}"));
@@ -111490,20 +111536,26 @@ ${lanes.join("\n")}
     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;
   }
@@ -113186,7 +113238,7 @@ ${lanes.join("\n")}
       pushClassification(start, 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) {
@@ -113240,6 +113292,11 @@ ${lanes.join("\n")}
             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);
@@ -116305,7 +116362,7 @@ ${lanes.join("\n")}
     }
   }
   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) {
@@ -117728,7 +117785,7 @@ ${lanes.join("\n")}
           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) {
@@ -127834,6 +127891,9 @@ ${lanes.join("\n")}
         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) {
@@ -131125,6 +131185,7 @@ ${lanes.join("\n")}
         case 344 /* JSDocReturnTag */:
         case 346 /* JSDocTypeTag */:
         case 348 /* JSDocTypedefTag */:
+        case 351 /* JSDocThrowsTag */:
           return true;
         case 347 /* JSDocTemplateTag */:
           return !!tag.constraint;
@@ -132313,7 +132374,7 @@ ${lanes.join("\n")}
   }
   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);
@@ -136420,6 +136481,9 @@ ${lanes.join("\n")}
     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 */:
@@ -150286,6 +150350,7 @@ ${options.prefix}` : "\n" : options.prefix
     isJSDocNode: () => isJSDocNode,
     isJSDocNonNullableType: () => isJSDocNonNullableType,
     isJSDocNullableType: () => isJSDocNullableType,
+    isJSDocOptionalParameter: () => isJSDocOptionalParameter,
     isJSDocOptionalType: () => isJSDocOptionalType,
     isJSDocOverrideTag: () => isJSDocOverrideTag,
     isJSDocParameterTag: () => isJSDocParameterTag,
@@ -150301,6 +150366,7 @@ ${options.prefix}` : "\n" : options.prefix
     isJSDocTag: () => isJSDocTag,
     isJSDocTemplateTag: () => isJSDocTemplateTag,
     isJSDocThisTag: () => isJSDocThisTag,
+    isJSDocThrowsTag: () => isJSDocThrowsTag,
     isJSDocTypeAlias: () => isJSDocTypeAlias,
     isJSDocTypeAssertion: () => isJSDocTypeAssertion,
     isJSDocTypeExpression: () => isJSDocTypeExpression,
@@ -150431,6 +150497,7 @@ ${options.prefix}` : "\n" : options.prefix
     isOmittedExpression: () => isOmittedExpression,
     isOptionalChain: () => isOptionalChain,
     isOptionalChainRoot: () => isOptionalChainRoot,
+    isOptionalDeclaration: () => isOptionalDeclaration,
     isOptionalJSDocPropertyLikeTag: () => isOptionalJSDocPropertyLikeTag,
     isOptionalTypeNode: () => isOptionalTypeNode,
     isOuterExpression: () => isOuterExpression,