typescript 5.5.0-dev.20240505 → 5.5.0-dev.20240507

package/lib/typescript.js

@@ -2364,7 +2364,7 @@ module.exports = __toCommonJS(typescript_exports);
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.5";
-var version = `${versionMajorMinor}.0-dev.20240505`;
+var version = `${versionMajorMinor}.0-dev.20240507`;
 var Comparison = /* @__PURE__ */ ((Comparison3) => {
   Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
   Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -6355,7 +6355,7 @@ var FileIncludeKind = /* @__PURE__ */ ((FileIncludeKind2) => {
   return FileIncludeKind2;
 })(FileIncludeKind || {});
 var FilePreprocessingDiagnosticsKind = /* @__PURE__ */ ((FilePreprocessingDiagnosticsKind2) => {
-  FilePreprocessingDiagnosticsKind2[FilePreprocessingDiagnosticsKind2["FilePreprocessingReferencedDiagnostic"] = 0] = "FilePreprocessingReferencedDiagnostic";
+  FilePreprocessingDiagnosticsKind2[FilePreprocessingDiagnosticsKind2["FilePreprocessingLibReferenceDiagnostic"] = 0] = "FilePreprocessingLibReferenceDiagnostic";
   FilePreprocessingDiagnosticsKind2[FilePreprocessingDiagnosticsKind2["FilePreprocessingFileExplainingDiagnostic"] = 1] = "FilePreprocessingFileExplainingDiagnostic";
   FilePreprocessingDiagnosticsKind2[FilePreprocessingDiagnosticsKind2["ResolutionDiagnostics"] = 2] = "ResolutionDiagnostics";
   return FilePreprocessingDiagnosticsKind2;
@@ -67311,7 +67311,7 @@ function createTypeChecker(host) {
     for (let i = 0; i < paramCount; i++) {
       const sourceType = i === restIndex ? getRestOrAnyTypeAtPosition(source, i) : tryGetTypeAtPosition(source, i);
       const targetType = i === restIndex ? getRestOrAnyTypeAtPosition(target, i) : tryGetTypeAtPosition(target, i);
-      if (sourceType && targetType) {
+      if (sourceType && targetType && (sourceType !== targetType || checkMode & 8 /* StrictArity */)) {
         const sourceSig = checkMode & 3 /* Callback */ || isInstantiatedGenericParameter(source, i) ? void 0 : getSingleCallSignature(getNonNullableType(sourceType));
         const targetSig = checkMode & 3 /* Callback */ || isInstantiatedGenericParameter(target, i) ? void 0 : getSingleCallSignature(getNonNullableType(targetType));
         const callbacks = sourceSig && targetSig && !getTypePredicateOfSignature(sourceSig) && !getTypePredicateOfSignature(targetSig) && getTypeFacts(sourceType, 50331648 /* IsUndefinedOrNull */) === getTypeFacts(targetType, 50331648 /* IsUndefinedOrNull */);
@@ -119249,13 +119249,9 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     }
   }
   function emitComputedPropertyName(node) {
-    const savedPrivateNameTempFlags = privateNameTempFlags;
-    const savedReservedMemberNames = reservedPrivateNames;
-    popPrivateNameGenerationScope();
     writePunctuation("[");
     emitExpression(node.expression, parenthesizer.parenthesizeExpressionOfComputedPropertyName);
     writePunctuation("]");
-    pushPrivateNameGenerationScope(savedPrivateNameTempFlags, savedReservedMemberNames);
   }
   function emitTypeParameter(node) {
     emitModifierList(node, node.modifiers);
@@ -119316,15 +119312,10 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     writeTrailingSemicolon();
   }
   function emitMethodSignature(node) {
-    pushNameGenerationScope(node);
     emitModifierList(node, node.modifiers);
     emit(node.name);
     emit(node.questionToken);
-    emitTypeParameters(node, node.typeParameters);
-    emitParameters(node, node.parameters);
-    emitTypeAnnotation(node.type);
-    writeTrailingSemicolon();
-    popNameGenerationScope(node);
+    emitSignatureAndBody(node, emitSignatureHead, emitEmptyFunctionBody);
   }
   function emitMethodDeclaration(node) {
     emitDecoratorsAndModifiers(
@@ -119336,11 +119327,13 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emit(node.asteriskToken);
     emit(node.name);
     emit(node.questionToken);
-    emitSignatureAndBody(node, emitSignatureHead);
+    emitSignatureAndBody(node, emitSignatureHead, emitFunctionBody);
   }
   function emitClassStaticBlockDeclaration(node) {
     writeKeyword("static");
+    pushNameGenerationScope(node);
     emitBlockFunctionBody(node.body);
+    popNameGenerationScope(node);
   }
   function emitConstructor(node) {
     emitDecoratorsAndModifiers(
@@ -119350,7 +119343,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       false
     );
     writeKeyword("constructor");
-    emitSignatureAndBody(node, emitSignatureHead);
+    emitSignatureAndBody(node, emitSignatureHead, emitFunctionBody);
   }
   function emitAccessorDeclaration(node) {
     const pos = emitDecoratorsAndModifiers(
@@ -119363,25 +119356,15 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitTokenWithComment(token, pos, writeKeyword, node);
     writeSpace();
     emit(node.name);
-    emitSignatureAndBody(node, emitSignatureHead);
+    emitSignatureAndBody(node, emitSignatureHead, emitFunctionBody);
   }
   function emitCallSignature(node) {
-    pushNameGenerationScope(node);
-    emitTypeParameters(node, node.typeParameters);
-    emitParameters(node, node.parameters);
-    emitTypeAnnotation(node.type);
-    writeTrailingSemicolon();
-    popNameGenerationScope(node);
+    emitSignatureAndBody(node, emitSignatureHead, emitEmptyFunctionBody);
   }
   function emitConstructSignature(node) {
-    pushNameGenerationScope(node);
     writeKeyword("new");
     writeSpace();
-    emitTypeParameters(node, node.typeParameters);
-    emitParameters(node, node.parameters);
-    emitTypeAnnotation(node.type);
-    writeTrailingSemicolon();
-    popNameGenerationScope(node);
+    emitSignatureAndBody(node, emitSignatureHead, emitEmptyFunctionBody);
   }
   function emitIndexSignature(node) {
     emitDecoratorsAndModifiers(
@@ -119419,14 +119402,17 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitTypeArguments(node, node.typeArguments);
   }
   function emitFunctionType(node) {
-    pushNameGenerationScope(node);
+    emitSignatureAndBody(node, emitFunctionTypeHead, emitFunctionTypeBody);
+  }
+  function emitFunctionTypeHead(node) {
     emitTypeParameters(node, node.typeParameters);
     emitParametersForArrow(node, node.parameters);
     writeSpace();
     writePunctuation("=>");
+  }
+  function emitFunctionTypeBody(node) {
     writeSpace();
     emit(node.type);
-    popNameGenerationScope(node);
   }
   function emitJSDocFunctionType(node) {
     writeKeyword("function");
@@ -119447,17 +119433,10 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     writePunctuation("=");
   }
   function emitConstructorType(node) {
-    pushNameGenerationScope(node);
     emitModifierList(node, node.modifiers);
     writeKeyword("new");
     writeSpace();
-    emitTypeParameters(node, node.typeParameters);
-    emitParameters(node, node.parameters);
-    writeSpace();
-    writePunctuation("=>");
-    writeSpace();
-    emit(node.type);
-    popNameGenerationScope(node);
+    emitSignatureAndBody(node, emitFunctionTypeHead, emitFunctionTypeBody);
   }
   function emitTypeQuery(node) {
     writeKeyword("typeof");
@@ -119466,16 +119445,13 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitTypeArguments(node, node.typeArguments);
   }
   function emitTypeLiteral(node) {
-    pushPrivateNameGenerationScope(
-      0 /* Auto */,
-      /*newReservedMemberNames*/
-      void 0
-    );
+    pushNameGenerationScope(node);
+    forEach(node.members, generateMemberNames);
     writePunctuation("{");
     const flags = getEmitFlags(node) & 1 /* SingleLine */ ? 768 /* SingleLineTypeLiteralMembers */ : 32897 /* MultiLineTypeLiteralMembers */;
     emitList(node, node.members, flags | 524288 /* NoSpaceIfEmpty */);
     writePunctuation("}");
-    popPrivateNameGenerationScope();
+    popNameGenerationScope(node);
   }
   function emitArrayType(node) {
     emit(node.elementType, parenthesizer.parenthesizeNonArrayTypeOfPostfixType);
@@ -119647,11 +119623,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitExpressionList(node, elements, 8914 /* ArrayLiteralExpressionElements */ | preferNewLine, parenthesizer.parenthesizeExpressionForDisallowedComma);
   }
   function emitObjectLiteralExpression(node) {
-    pushPrivateNameGenerationScope(
-      0 /* Auto */,
-      /*newReservedMemberNames*/
-      void 0
-    );
+    pushNameGenerationScope(node);
     forEach(node.properties, generateMemberNames);
     const indentedFlag = getEmitFlags(node) & 131072 /* Indented */;
     if (indentedFlag) {
@@ -119663,7 +119635,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     if (indentedFlag) {
       decreaseIndent();
     }
-    popPrivateNameGenerationScope();
+    popNameGenerationScope(node);
   }
   function emitPropertyAccessExpression(node) {
     emitExpression(node.expression, parenthesizer.parenthesizeLeftSideOfAccess);
@@ -119778,7 +119750,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
   }
   function emitArrowFunction(node) {
     emitModifierList(node, node.modifiers);
-    emitSignatureAndBody(node, emitArrowFunctionHead);
+    emitSignatureAndBody(node, emitArrowFunctionHead, emitArrowFunctionBody);
   }
   function emitArrowFunctionHead(node) {
     emitTypeParameters(node, node.typeParameters);
@@ -119787,6 +119759,14 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     writeSpace();
     emit(node.equalsGreaterThanToken);
   }
+  function emitArrowFunctionBody(node) {
+    if (isBlock(node.body)) {
+      emitBlockFunctionBody(node.body);
+    } else {
+      writeSpace();
+      emitExpression(node.body, parenthesizer.parenthesizeConciseBodyOfArrowFunction);
+    }
+  }
   function emitDeleteExpression(node) {
     emitTokenWithComment(91 /* DeleteKeyword */, node.pos, writeKeyword, node);
     writeSpace();
@@ -120334,35 +120314,33 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emit(node.asteriskToken);
     writeSpace();
     emitIdentifierName(node.name);
-    emitSignatureAndBody(node, emitSignatureHead);
+    emitSignatureAndBody(node, emitSignatureHead, emitFunctionBody);
   }
-  function emitSignatureAndBody(node, emitSignatureHead2) {
+  function emitSignatureAndBody(node, emitSignatureHead2, emitBody) {
+    const indentedFlag = getEmitFlags(node) & 131072 /* Indented */;
+    if (indentedFlag) {
+      increaseIndent();
+    }
+    pushNameGenerationScope(node);
+    forEach(node.parameters, generateNames);
+    emitSignatureHead2(node);
+    emitBody(node);
+    popNameGenerationScope(node);
+    if (indentedFlag) {
+      decreaseIndent();
+    }
+  }
+  function emitFunctionBody(node) {
     const body = node.body;
     if (body) {
-      if (isBlock(body)) {
-        const indentedFlag = getEmitFlags(node) & 131072 /* Indented */;
-        if (indentedFlag) {
-          increaseIndent();
-        }
-        pushNameGenerationScope(node);
-        forEach(node.parameters, generateNames);
-        generateNames(node.body);
-        emitSignatureHead2(node);
-        emitBlockFunctionBody(body);
-        popNameGenerationScope(node);
-        if (indentedFlag) {
-          decreaseIndent();
-        }
-      } else {
-        emitSignatureHead2(node);
-        writeSpace();
-        emitExpression(body, parenthesizer.parenthesizeConciseBodyOfArrowFunction);
-      }
+      emitBlockFunctionBody(body);
     } else {
-      emitSignatureHead2(node);
       writeTrailingSemicolon();
     }
   }
+  function emitEmptyFunctionBody(_node) {
+    writeTrailingSemicolon();
+  }
   function emitSignatureHead(node) {
     emitTypeParameters(node, node.typeParameters);
     emitParameters(node, node.parameters);
@@ -120391,6 +120369,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     return true;
   }
   function emitBlockFunctionBody(body) {
+    generateNames(body);
     onBeforeEmitNode == null ? void 0 : onBeforeEmitNode(body);
     writeSpace();
     writePunctuation("{");
@@ -120431,12 +120410,6 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitClassDeclarationOrExpression(node);
   }
   function emitClassDeclarationOrExpression(node) {
-    pushPrivateNameGenerationScope(
-      0 /* Auto */,
-      /*newReservedMemberNames*/
-      void 0
-    );
-    forEach(node.members, generateMemberNames);
     emitDecoratorsAndModifiers(
       node,
       node.modifiers,
@@ -120456,19 +120429,16 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitList(node, node.heritageClauses, 0 /* ClassHeritageClauses */);
     writeSpace();
     writePunctuation("{");
+    pushNameGenerationScope(node);
+    forEach(node.members, generateMemberNames);
     emitList(node, node.members, 129 /* ClassMembers */);
+    popNameGenerationScope(node);
     writePunctuation("}");
     if (indentedFlag) {
       decreaseIndent();
     }
-    popPrivateNameGenerationScope();
   }
   function emitInterfaceDeclaration(node) {
-    pushPrivateNameGenerationScope(
-      0 /* Auto */,
-      /*newReservedMemberNames*/
-      void 0
-    );
     emitDecoratorsAndModifiers(
       node,
       node.modifiers,
@@ -120482,9 +120452,11 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emitList(node, node.heritageClauses, 512 /* HeritageClauses */);
     writeSpace();
     writePunctuation("{");
+    pushNameGenerationScope(node);
+    forEach(node.members, generateMemberNames);
     emitList(node, node.members, 129 /* InterfaceMembers */);
+    popNameGenerationScope(node);
     writePunctuation("}");
-    popPrivateNameGenerationScope();
   }
   function emitTypeAliasDeclaration(node) {
     emitDecoratorsAndModifiers(
@@ -121865,6 +121837,9 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     return getLiteralText(node, currentSourceFile, flags);
   }
   function pushNameGenerationScope(node) {
+    privateNameTempFlagsStack.push(privateNameTempFlags);
+    privateNameTempFlags = 0 /* Auto */;
+    reservedPrivateNamesStack.push(reservedPrivateNames);
     if (node && getEmitFlags(node) & 1048576 /* ReuseTempVariableScope */) {
       return;
     }
@@ -121875,6 +121850,8 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     reservedNamesStack.push(reservedNames);
   }
   function popNameGenerationScope(node) {
+    privateNameTempFlags = privateNameTempFlagsStack.pop();
+    reservedPrivateNames = reservedPrivateNamesStack.pop();
     if (node && getEmitFlags(node) & 1048576 /* ReuseTempVariableScope */) {
       return;
     }
@@ -121888,16 +121865,6 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     }
     reservedNames.add(name);
   }
-  function pushPrivateNameGenerationScope(newPrivateNameTempFlags, newReservedMemberNames) {
-    privateNameTempFlagsStack.push(privateNameTempFlags);
-    privateNameTempFlags = newPrivateNameTempFlags;
-    reservedPrivateNamesStack.push(reservedNames);
-    reservedPrivateNames = newReservedMemberNames;
-  }
-  function popPrivateNameGenerationScope() {
-    privateNameTempFlags = privateNameTempFlagsStack.pop();
-    reservedPrivateNames = reservedPrivateNamesStack.pop();
-  }
   function reservePrivateNameInNestedScopes(name) {
     if (!reservedPrivateNames || reservedPrivateNames === lastOrUndefined(reservedPrivateNamesStack)) {
       reservedPrivateNames = /* @__PURE__ */ new Set();
@@ -121997,7 +121964,9 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       case 303 /* PropertyAssignment */:
       case 304 /* ShorthandPropertyAssignment */:
       case 172 /* PropertyDeclaration */:
+      case 171 /* PropertySignature */:
       case 174 /* MethodDeclaration */:
+      case 173 /* MethodSignature */:
       case 177 /* GetAccessor */:
       case 178 /* SetAccessor */:
         generateNameIfNeeded(node.name);
@@ -122031,7 +122000,28 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     return isFileLevelUniqueNameInCurrentFile(name, privateName) && !isReservedName(name, privateName) && !generatedNames.has(name);
   }
   function isReservedName(name, privateName) {
-    return privateName ? !!(reservedPrivateNames == null ? void 0 : reservedPrivateNames.has(name)) : !!(reservedNames == null ? void 0 : reservedNames.has(name));
+    let set;
+    let stack;
+    if (privateName) {
+      set = reservedPrivateNames;
+      stack = reservedPrivateNamesStack;
+    } else {
+      set = reservedNames;
+      stack = reservedNamesStack;
+    }
+    if (set == null ? void 0 : set.has(name)) {
+      return true;
+    }
+    for (let i = stack.length - 1; i >= 0; i--) {
+      if (set === stack[i]) {
+        continue;
+      }
+      set = stack[i];
+      if (set == null ? void 0 : set.has(name)) {
+        return true;
+      }
+    }
+    return false;
   }
   function isFileLevelUniqueNameInCurrentFile(name, _isPrivate) {
     return currentSourceFile ? isFileLevelUniqueName(currentSourceFile, name, hasGlobalName) : true;
@@ -123876,10 +123866,12 @@ function getLibraryNameFromLibFileName(libFileName) {
   }
   return "@typescript/lib-" + path;
 }
+function getLibNameFromLibReference(libReference) {
+  return toFileNameLowerCase(libReference.fileName);
+}
 function getLibFileNameFromLibReference(libReference) {
-  const libName = toFileNameLowerCase(libReference.fileName);
-  const libFileName = libMap.get(libName);
-  return { libName, libFileName };
+  const libName = getLibNameFromLibReference(libReference);
+  return libMap.get(libName);
 }
 function isReferencedFile(reason) {
   switch (reason == null ? void 0 : reason.kind) {
@@ -124126,6 +124118,9 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   let classifiableNames;
   const ambientModuleNameToUnmodifiedFileName = /* @__PURE__ */ new Map();
   let fileReasons = createMultiMap();
+  let filesWithReferencesProcessed;
+  let fileReasonsToChain;
+  let reasonToRelatedInfo;
   const cachedBindAndCheckDiagnosticsForFile = {};
   const cachedDeclarationDiagnosticsForFile = {};
   let resolvedTypeReferenceDirectives = createModeAwareCache();
@@ -124157,6 +124152,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   const getDefaultLibraryFileName = memoize(() => host.getDefaultLibFileName(options));
   const defaultLibraryPath = host.getDefaultLibLocation ? host.getDefaultLibLocation() : getDirectoryPath(getDefaultLibraryFileName());
   const programDiagnostics = createDiagnosticCollection();
+  let lazyProgramDiagnosticExplainingFile = [];
   const currentDirectory = host.getCurrentDirectory();
   const supportedExtensions = getSupportedExtensions(options);
   const supportedExtensionsWithJsonIfResolveJsonModule = getSupportedExtensionsWithJsonIfResolveJsonModule(options, supportedExtensions);
@@ -124363,6 +124359,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     files = stableSort(processingDefaultLibFiles, compareDefaultLibFiles).concat(processingOtherFiles);
     processingDefaultLibFiles = void 0;
     processingOtherFiles = void 0;
+    filesWithReferencesProcessed = void 0;
   }
   if (oldProgram && host.onReleaseOldSourceFile) {
     const oldSourceFiles = oldProgram.getSourceFiles();
@@ -124485,24 +124482,64 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     writeFile: writeFile2
   };
   onProgramCreateComplete();
-  fileProcessingDiagnostics == null ? void 0 : fileProcessingDiagnostics.forEach((diagnostic) => {
-    switch (diagnostic.kind) {
-      case 1 /* FilePreprocessingFileExplainingDiagnostic */:
-        return programDiagnostics.add(createDiagnosticExplainingFile(diagnostic.file && getSourceFileByPath(diagnostic.file), diagnostic.fileProcessingReason, diagnostic.diagnostic, diagnostic.args || emptyArray));
-      case 0 /* FilePreprocessingReferencedDiagnostic */:
-        const { file, pos, end } = getReferencedFileLocation(program, diagnostic.reason);
-        return programDiagnostics.add(createFileDiagnostic(file, Debug.checkDefined(pos), Debug.checkDefined(end) - pos, diagnostic.diagnostic, ...diagnostic.args || emptyArray));
-      case 2 /* ResolutionDiagnostics */:
-        return diagnostic.diagnostics.forEach((d) => programDiagnostics.add(d));
-      default:
-        Debug.assertNever(diagnostic);
-    }
-  });
   verifyCompilerOptions();
   mark("afterProgram");
   measure("Program", "beforeProgram", "afterProgram");
   (_p = tracing) == null ? void 0 : _p.pop();
   return program;
+  function updateAndGetProgramDiagnostics() {
+    if (lazyProgramDiagnosticExplainingFile) {
+      fileProcessingDiagnostics == null ? void 0 : fileProcessingDiagnostics.forEach((diagnostic) => {
+        switch (diagnostic.kind) {
+          case 1 /* FilePreprocessingFileExplainingDiagnostic */:
+            return programDiagnostics.add(
+              createDiagnosticExplainingFile(
+                diagnostic.file && getSourceFileByPath(diagnostic.file),
+                diagnostic.fileProcessingReason,
+                diagnostic.diagnostic,
+                diagnostic.args || emptyArray
+              )
+            );
+          case 0 /* FilePreprocessingLibReferenceDiagnostic */:
+            return programDiagnostics.add(filePreprocessingLibreferenceDiagnostic(diagnostic));
+          case 2 /* ResolutionDiagnostics */:
+            return diagnostic.diagnostics.forEach((d) => programDiagnostics.add(d));
+          default:
+            Debug.assertNever(diagnostic);
+        }
+      });
+      lazyProgramDiagnosticExplainingFile.forEach(
+        ({ file, diagnostic, args }) => programDiagnostics.add(
+          createDiagnosticExplainingFile(
+            file,
+            /*fileProcessingReason*/
+            void 0,
+            diagnostic,
+            args
+          )
+        )
+      );
+      lazyProgramDiagnosticExplainingFile = void 0;
+      fileReasonsToChain = void 0;
+      reasonToRelatedInfo = void 0;
+    }
+    return programDiagnostics;
+  }
+  function filePreprocessingLibreferenceDiagnostic({ reason }) {
+    const { file, pos, end } = getReferencedFileLocation(program, reason);
+    const libReference = file.libReferenceDirectives[reason.index];
+    const libName = getLibNameFromLibReference(libReference);
+    const unqualifiedLibName = removeSuffix(removePrefix(libName, "lib."), ".d.ts");
+    const suggestion = getSpellingSuggestion(unqualifiedLibName, libs, identity);
+    return createFileDiagnostic(
+      file,
+      Debug.checkDefined(pos),
+      Debug.checkDefined(end) - pos,
+      suggestion ? Diagnostics.Cannot_find_lib_definition_for_0_Did_you_mean_1 : Diagnostics.Cannot_find_lib_definition_for_0,
+      libName,
+      suggestion
+    );
+  }
   function getResolvedModule(file, moduleName, mode) {
     var _a2;
     return (_a2 = resolvedModules == null ? void 0 : resolvedModules.get(file.path)) == null ? void 0 : _a2.get(moduleName, mode);
@@ -125195,7 +125232,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     if (skipTypeChecking(sourceFile, options, program)) {
       return emptyArray;
     }
-    const programDiagnosticsInFile = programDiagnostics.getDiagnostics(sourceFile.fileName);
+    const programDiagnosticsInFile = updateAndGetProgramDiagnostics().getDiagnostics(sourceFile.fileName);
     if (!((_a2 = sourceFile.commentDirectives) == null ? void 0 : _a2.length)) {
       return programDiagnosticsInFile;
     }
@@ -125542,16 +125579,16 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function getOptionsDiagnostics() {
     return sortAndDeduplicateDiagnostics(concatenate(
-      programDiagnostics.getGlobalDiagnostics(),
+      updateAndGetProgramDiagnostics().getGlobalDiagnostics(),
       getOptionsDiagnosticsOfConfigFile()
     ));
   }
   function getOptionsDiagnosticsOfConfigFile() {
     if (!options.configFile)
       return emptyArray;
-    let diagnostics = programDiagnostics.getDiagnostics(options.configFile.fileName);
+    let diagnostics = updateAndGetProgramDiagnostics().getDiagnostics(options.configFile.fileName);
     forEachResolvedProjectReference2((resolvedRef) => {
-      diagnostics = concatenate(diagnostics, programDiagnostics.getDiagnostics(resolvedRef.sourceFile.fileName));
+      diagnostics = concatenate(diagnostics, updateAndGetProgramDiagnostics().getDiagnostics(resolvedRef.sourceFile.fileName));
     });
     return diagnostics;
   }
@@ -125725,7 +125762,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function getLibFileFromReference(ref) {
     var _a2;
-    const { libFileName } = getLibFileNameFromLibReference(ref);
+    const libFileName = getLibFileNameFromLibReference(ref);
     const actualFileName = libFileName && ((_a2 = resolvedLibReferences == null ? void 0 : resolvedLibReferences.get(libFileName)) == null ? void 0 : _a2.actual);
     return actualFileName !== void 0 ? getSourceFile(actualFileName) : void 0;
   }
@@ -125863,8 +125900,13 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     const originalFileName = fileName;
     if (filesByName.has(path)) {
       const file2 = filesByName.get(path);
-      addFileIncludeReason(file2 || void 0, reason);
-      if (file2 && !(options.forceConsistentCasingInFileNames === false)) {
+      const addedReason = addFileIncludeReason(
+        file2 || void 0,
+        reason,
+        /*checkExisting*/
+        true
+      );
+      if (file2 && addedReason && !(options.forceConsistentCasingInFileNames === false)) {
         const checkedName = file2.fileName;
         const isRedirect = toPath3(checkedName) !== toPath3(fileName);
         if (isRedirect) {
@@ -125927,7 +125969,12 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
         const dupFile = createRedirectedSourceFile(fileFromPackageId, file, fileName, path, toPath3(fileName), originalFileName, sourceFileOptions);
         redirectTargetsMap.add(fileFromPackageId.path, fileName);
         addFileToFilesByName(dupFile, path, fileName, redirectedPath);
-        addFileIncludeReason(dupFile, reason);
+        addFileIncludeReason(
+          dupFile,
+          reason,
+          /*checkExisting*/
+          false
+        );
         sourceFileToPackageName.set(path, packageIdToPackageName(packageId));
         processingOtherFiles.push(dupFile);
         return dupFile;
@@ -125945,7 +125992,12 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       file.originalFileName = originalFileName;
       file.packageJsonLocations = ((_a2 = sourceFileOptions.packageJsonLocations) == null ? void 0 : _a2.length) ? sourceFileOptions.packageJsonLocations : void 0;
       file.packageJsonScope = sourceFileOptions.packageJsonScope;
-      addFileIncludeReason(file, reason);
+      addFileIncludeReason(
+        file,
+        reason,
+        /*checkExisting*/
+        false
+      );
       if (host.useCaseSensitiveFileNames()) {
         const pathLowerCase = toFileNameLowerCase(path);
         const existingFile = filesByNameIgnoreCase.get(pathLowerCase);
@@ -125969,12 +126021,16 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       } else {
         processingOtherFiles.push(file);
       }
+      (filesWithReferencesProcessed ?? (filesWithReferencesProcessed = /* @__PURE__ */ new Set())).add(file.path);
     }
     return file;
   }
-  function addFileIncludeReason(file, reason) {
-    if (file)
+  function addFileIncludeReason(file, reason, checkExisting) {
+    if (file && (!checkExisting || !isReferencedFile(reason) || !(filesWithReferencesProcessed == null ? void 0 : filesWithReferencesProcessed.has(reason.file)))) {
       fileReasons.add(file.path, reason);
+      return true;
+    }
+    return false;
   }
   function addFileToFilesByName(file, path, fileName, redirectedPath) {
     if (redirectedPath) {
@@ -126204,7 +126260,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function processLibReferenceDirectives(file) {
     forEach(file.libReferenceDirectives, (libReference, index) => {
-      const { libName, libFileName } = getLibFileNameFromLibReference(libReference);
+      const libFileName = getLibFileNameFromLibReference(libReference);
       if (libFileName) {
         processRootFile(
           pathForLibFile(libFileName),
@@ -126215,15 +126271,9 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
           { kind: 7 /* LibReferenceDirective */, file: file.path, index }
         );
       } else {
-        const unqualifiedLibName = removeSuffix(removePrefix(libName, "lib."), ".d.ts");
-        const suggestion = getSpellingSuggestion(unqualifiedLibName, libs, identity);
-        const diagnostic = suggestion ? Diagnostics.Cannot_find_lib_definition_for_0_Did_you_mean_1 : Diagnostics.Cannot_find_lib_definition_for_0;
-        const args = suggestion ? [libName, suggestion] : [libName];
         (fileProcessingDiagnostics || (fileProcessingDiagnostics = [])).push({
-          kind: 0 /* FilePreprocessingReferencedDiagnostic */,
-          reason: { kind: 7 /* LibReferenceDirective */, file: file.path, index },
-          diagnostic,
-          args
+          kind: 0 /* FilePreprocessingLibReferenceDiagnostic */,
+          reason: { kind: 7 /* LibReferenceDirective */, file: file.path, index }
         });
       }
     });
@@ -126284,7 +126334,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       if (!sourceFile.isDeclarationFile) {
         const absoluteSourceFilePath = host.getCanonicalFileName(getNormalizedAbsolutePath(sourceFile.fileName, currentDirectory));
         if (absoluteSourceFilePath.indexOf(absoluteRootDirectoryPath) !== 0) {
-          addProgramDiagnosticExplainingFile(
+          addLazyProgramDiagnosticExplainingFile(
             sourceFile,
             Diagnostics.File_0_is_not_under_rootDir_1_rootDir_is_expected_to_contain_all_source_files,
             [sourceFile.fileName, rootDirectory]
@@ -126414,7 +126464,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       const rootPaths = new Set(rootNames.map(toPath3));
       for (const file of files) {
         if (sourceFileMayBeEmitted(file, program) && !rootPaths.has(file.path)) {
-          addProgramDiagnosticExplainingFile(
+          addLazyProgramDiagnosticExplainingFile(
             file,
             Diagnostics.File_0_is_not_listed_within_the_file_list_of_project_1_Projects_must_list_all_files_or_use_an_include_pattern,
             [file.fileName, options.configFilePath || ""]
@@ -126777,31 +126827,90 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     });
   }
   function createDiagnosticExplainingFile(file, fileProcessingReason, diagnostic, args) {
-    var _a2;
+    let seenReasons;
+    const reasons = file && fileReasons.get(file.path);
     let fileIncludeReasons;
     let relatedInfo;
     let locationReason = isReferencedFile(fileProcessingReason) ? fileProcessingReason : void 0;
-    if (file)
-      (_a2 = fileReasons.get(file.path)) == null ? void 0 : _a2.forEach(processReason);
+    let fileIncludeReasonDetails;
+    let redirectInfo;
+    let cachedChain = file && (fileReasonsToChain == null ? void 0 : fileReasonsToChain.get(file.path));
+    let chain;
+    if (cachedChain) {
+      if (cachedChain.fileIncludeReasonDetails) {
+        seenReasons = new Set(reasons);
+        reasons == null ? void 0 : reasons.forEach(populateRelatedInfo);
+      } else {
+        reasons == null ? void 0 : reasons.forEach(processReason);
+      }
+      redirectInfo = cachedChain.redirectInfo;
+    } else {
+      reasons == null ? void 0 : reasons.forEach(processReason);
+      redirectInfo = file && explainIfFileIsRedirectAndImpliedFormat(file, getCompilerOptionsForFile(file));
+    }
     if (fileProcessingReason)
       processReason(fileProcessingReason);
-    if (locationReason && (fileIncludeReasons == null ? void 0 : fileIncludeReasons.length) === 1)
-      fileIncludeReasons = void 0;
+    const processedExtraReason = (seenReasons == null ? void 0 : seenReasons.size) !== (reasons == null ? void 0 : reasons.length);
+    if (locationReason && (seenReasons == null ? void 0 : seenReasons.size) === 1)
+      seenReasons = void 0;
+    if (seenReasons && cachedChain) {
+      if (cachedChain.details && !processedExtraReason) {
+        chain = chainDiagnosticMessages(cachedChain.details, diagnostic, ...args || emptyArray);
+      } else if (cachedChain.fileIncludeReasonDetails) {
+        if (!processedExtraReason) {
+          if (!cachedFileIncludeDetailsHasProcessedExtraReason()) {
+            fileIncludeReasonDetails = cachedChain.fileIncludeReasonDetails;
+          } else {
+            fileIncludeReasons = cachedChain.fileIncludeReasonDetails.next.slice(0, reasons.length);
+          }
+        } else {
+          if (!cachedFileIncludeDetailsHasProcessedExtraReason()) {
+            fileIncludeReasons = [...cachedChain.fileIncludeReasonDetails.next, fileIncludeReasons[0]];
+          } else {
+            fileIncludeReasons = append(cachedChain.fileIncludeReasonDetails.next.slice(0, reasons.length), fileIncludeReasons[0]);
+          }
+        }
+      }
+    }
+    if (!chain) {
+      if (!fileIncludeReasonDetails)
+        fileIncludeReasonDetails = seenReasons && chainDiagnosticMessages(fileIncludeReasons, Diagnostics.The_file_is_in_the_program_because_Colon);
+      chain = chainDiagnosticMessages(
+        redirectInfo ? fileIncludeReasonDetails ? [fileIncludeReasonDetails, ...redirectInfo] : redirectInfo : fileIncludeReasonDetails,
+        diagnostic,
+        ...args || emptyArray
+      );
+    }
+    if (file) {
+      if (cachedChain) {
+        if (!cachedChain.fileIncludeReasonDetails || !processedExtraReason && fileIncludeReasonDetails) {
+          cachedChain.fileIncludeReasonDetails = fileIncludeReasonDetails;
+        }
+      } else {
+        (fileReasonsToChain ?? (fileReasonsToChain = /* @__PURE__ */ new Map())).set(file.path, cachedChain = { fileIncludeReasonDetails, redirectInfo });
+      }
+      if (!cachedChain.details && !processedExtraReason)
+        cachedChain.details = chain.next;
+    }
     const location = locationReason && getReferencedFileLocation(program, locationReason);
-    const fileIncludeReasonDetails = fileIncludeReasons && chainDiagnosticMessages(fileIncludeReasons, Diagnostics.The_file_is_in_the_program_because_Colon);
-    const optionsForFile = file && getCompilerOptionsForFile(file) || options;
-    const redirectInfo = file && explainIfFileIsRedirectAndImpliedFormat(file, optionsForFile);
-    const chain = chainDiagnosticMessages(redirectInfo ? fileIncludeReasonDetails ? [fileIncludeReasonDetails, ...redirectInfo] : redirectInfo : fileIncludeReasonDetails, diagnostic, ...args || emptyArray);
     return location && isReferenceFileLocation(location) ? createFileDiagnosticFromMessageChain(location.file, location.pos, location.end - location.pos, chain, relatedInfo) : createCompilerDiagnosticFromMessageChain(chain, relatedInfo);
     function processReason(reason) {
-      (fileIncludeReasons || (fileIncludeReasons = [])).push(fileIncludeReasonToDiagnostics(program, reason));
+      if (seenReasons == null ? void 0 : seenReasons.has(reason))
+        return;
+      (seenReasons ?? (seenReasons = /* @__PURE__ */ new Set())).add(reason);
+      (fileIncludeReasons ?? (fileIncludeReasons = [])).push(fileIncludeReasonToDiagnostics(program, reason));
+      populateRelatedInfo(reason);
+    }
+    function populateRelatedInfo(reason) {
       if (!locationReason && isReferencedFile(reason)) {
         locationReason = reason;
       } else if (locationReason !== reason) {
-        relatedInfo = append(relatedInfo, fileIncludeReasonToRelatedInformation(reason));
+        relatedInfo = append(relatedInfo, getFileIncludeReasonToRelatedInformation(reason));
       }
-      if (reason === fileProcessingReason)
-        fileProcessingReason = void 0;
+    }
+    function cachedFileIncludeDetailsHasProcessedExtraReason() {
+      var _a2;
+      return ((_a2 = cachedChain.fileIncludeReasonDetails.next) == null ? void 0 : _a2.length) !== (reasons == null ? void 0 : reasons.length);
     }
   }
   function addFilePreprocessingFileExplainingDiagnostic(file, fileProcessingReason, diagnostic, args) {
@@ -126813,14 +126922,14 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       args
     });
   }
-  function addProgramDiagnosticExplainingFile(file, diagnostic, args) {
-    programDiagnostics.add(createDiagnosticExplainingFile(
-      file,
-      /*fileProcessingReason*/
-      void 0,
-      diagnostic,
-      args
-    ));
+  function addLazyProgramDiagnosticExplainingFile(file, diagnostic, args) {
+    lazyProgramDiagnosticExplainingFile.push({ file, diagnostic, args });
+  }
+  function getFileIncludeReasonToRelatedInformation(reason) {
+    let relatedInfo = reasonToRelatedInfo == null ? void 0 : reasonToRelatedInfo.get(reason);
+    if (relatedInfo === void 0)
+      (reasonToRelatedInfo ?? (reasonToRelatedInfo = /* @__PURE__ */ new Map())).set(reason, relatedInfo = fileIncludeReasonToRelatedInformation(reason) ?? false);
+    return relatedInfo || void 0;
   }
   function fileIncludeReasonToRelatedInformation(reason) {
     if (isReferencedFile(reason)) {
@@ -131121,6 +131230,7 @@ function createWatchProgram(host) {
       });
       parsedConfigs = void 0;
     }
+    builderProgram = void 0;
   }
   function getResolutionCache() {
     return resolutionCache;
@@ -149274,7 +149384,7 @@ var invalidOperationsInSyntacticMode = [
   "findRenameLocations",
   "getApplicableRefactors"
 ];
-function createLanguageService(host, documentRegistry = createDocumentRegistry(host.useCaseSensitiveFileNames && host.useCaseSensitiveFileNames(), host.getCurrentDirectory()), syntaxOnlyOrLanguageServiceMode) {
+function createLanguageService(host, documentRegistry = createDocumentRegistry(host.useCaseSensitiveFileNames && host.useCaseSensitiveFileNames(), host.getCurrentDirectory(), host.jsDocParsingMode), syntaxOnlyOrLanguageServiceMode) {
   var _a;
   let languageServiceMode;
   if (syntaxOnlyOrLanguageServiceMode === void 0) {