typescript 5.8.0-dev.20250109 → 5.8.0-dev.20250110

package/lib/typescript.js

@@ -436,6 +436,7 @@ __export(typescript_exports, {
   createPrinterWithRemoveCommentsNeverAsciiEscape: () => createPrinterWithRemoveCommentsNeverAsciiEscape,
   createPrinterWithRemoveCommentsOmitTrailingSemicolon: () => createPrinterWithRemoveCommentsOmitTrailingSemicolon,
   createProgram: () => createProgram,
+  createProgramDiagnostics: () => createProgramDiagnostics,
   createProgramHost: () => createProgramHost,
   createPropertyNameNodeForIdentifierOrLiteral: () => createPropertyNameNodeForIdentifierOrLiteral,
   createQueue: () => createQueue,
@@ -605,6 +606,8 @@ __export(typescript_exports, {
   forEachLeadingCommentRange: () => forEachLeadingCommentRange,
   forEachNameInAccessChainWalkingLeft: () => forEachNameInAccessChainWalkingLeft,
   forEachNameOfDefaultExport: () => forEachNameOfDefaultExport,
+  forEachOptionsSyntaxByName: () => forEachOptionsSyntaxByName,
+  forEachProjectReference: () => forEachProjectReference,
   forEachPropertyAssignment: () => forEachPropertyAssignment,
   forEachResolvedProjectReference: () => forEachResolvedProjectReference,
   forEachReturnStatement: () => forEachReturnStatement,
@@ -844,6 +847,8 @@ __export(typescript_exports, {
   getLeadingCommentRangesOfNode: () => getLeadingCommentRangesOfNode,
   getLeftmostAccessExpression: () => getLeftmostAccessExpression,
   getLeftmostExpression: () => getLeftmostExpression,
+  getLibFileNameFromLibReference: () => getLibFileNameFromLibReference,
+  getLibNameFromLibReference: () => getLibNameFromLibReference,
   getLibraryNameFromLibFileName: () => getLibraryNameFromLibFileName,
   getLineAndCharacterOfPosition: () => getLineAndCharacterOfPosition,
   getLineInfo: () => getLineInfo,
@@ -916,6 +921,8 @@ __export(typescript_exports, {
   getOptionFromName: () => getOptionFromName,
   getOptionsForLibraryResolution: () => getOptionsForLibraryResolution,
   getOptionsNameMap: () => getOptionsNameMap,
+  getOptionsSyntaxByArrayElementValue: () => getOptionsSyntaxByArrayElementValue,
+  getOptionsSyntaxByValue: () => getOptionsSyntaxByValue,
   getOrCreateEmitNode: () => getOrCreateEmitNode,
   getOrUpdate: () => getOrUpdate,
   getOriginalNode: () => getOriginalNode,
@@ -952,7 +959,6 @@ __export(typescript_exports, {
   getPrivateIdentifier: () => getPrivateIdentifier,
   getProperties: () => getProperties,
   getProperty: () => getProperty,
-  getPropertyArrayElementValue: () => getPropertyArrayElementValue,
   getPropertyAssignmentAliasLikeExpression: () => getPropertyAssignmentAliasLikeExpression,
   getPropertyNameForPropertyNameNode: () => getPropertyNameForPropertyNameNode,
   getPropertyNameFromType: () => getPropertyNameFromType,
@@ -2279,7 +2285,7 @@ module.exports = __toCommonJS(typescript_exports);
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.8";
-var version = `${versionMajorMinor}.0-dev.20250109`;
+var version = `${versionMajorMinor}.0-dev.20250110`;
 var Comparison = /* @__PURE__ */ ((Comparison3) => {
   Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
   Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -8875,23 +8881,105 @@ function resolvePath(path, ...paths) {
 function getNormalizedPathComponents(path, currentDirectory) {
   return reducePathComponents(getPathComponents(path, currentDirectory));
 }
-function getNormalizedAbsolutePath(fileName, currentDirectory) {
-  return getPathFromPathComponents(getNormalizedPathComponents(fileName, currentDirectory));
+function getNormalizedAbsolutePath(path, currentDirectory) {
+  let rootLength = getRootLength(path);
+  if (rootLength === 0 && currentDirectory) {
+    path = combinePaths(currentDirectory, path);
+    rootLength = getRootLength(path);
+  } else {
+    path = normalizeSlashes(path);
+  }
+  const simpleNormalized = simpleNormalizePath(path);
+  if (simpleNormalized !== void 0) {
+    return simpleNormalized.length > rootLength ? removeTrailingDirectorySeparator(simpleNormalized) : simpleNormalized;
+  }
+  const length2 = path.length;
+  const root = path.substring(0, rootLength);
+  let normalized;
+  let index = rootLength;
+  let segmentStart = index;
+  let normalizedUpTo = index;
+  let seenNonDotDotSegment = rootLength !== 0;
+  while (index < length2) {
+    segmentStart = index;
+    let ch = path.charCodeAt(index);
+    while (ch === 47 /* slash */ && index + 1 < length2) {
+      index++;
+      ch = path.charCodeAt(index);
+    }
+    if (index > segmentStart) {
+      normalized ?? (normalized = path.substring(0, segmentStart - 1));
+      segmentStart = index;
+    }
+    let segmentEnd = path.indexOf(directorySeparator, index + 1);
+    if (segmentEnd === -1) {
+      segmentEnd = length2;
+    }
+    const segmentLength = segmentEnd - segmentStart;
+    if (segmentLength === 1 && path.charCodeAt(index) === 46 /* dot */) {
+      normalized ?? (normalized = path.substring(0, normalizedUpTo));
+    } else if (segmentLength === 2 && path.charCodeAt(index) === 46 /* dot */ && path.charCodeAt(index + 1) === 46 /* dot */) {
+      if (!seenNonDotDotSegment) {
+        if (normalized !== void 0) {
+          normalized += normalized.length === rootLength ? ".." : "/..";
+        } else {
+          normalizedUpTo = index + 2;
+        }
+      } else if (normalized === void 0) {
+        if (normalizedUpTo - 2 >= 0) {
+          normalized = path.substring(0, Math.max(rootLength, path.lastIndexOf(directorySeparator, normalizedUpTo - 2)));
+        } else {
+          normalized = path.substring(0, normalizedUpTo);
+        }
+      } else {
+        const lastSlash = normalized.lastIndexOf(directorySeparator);
+        if (lastSlash !== -1) {
+          normalized = normalized.substring(0, Math.max(rootLength, lastSlash));
+        } else {
+          normalized = root;
+        }
+        if (normalized.length === rootLength) {
+          seenNonDotDotSegment = rootLength !== 0;
+        }
+      }
+    } else if (normalized !== void 0) {
+      if (normalized.length !== rootLength) {
+        normalized += directorySeparator;
+      }
+      seenNonDotDotSegment = true;
+      normalized += path.substring(segmentStart, segmentEnd);
+    } else {
+      seenNonDotDotSegment = true;
+      normalizedUpTo = segmentEnd;
+    }
+    index = segmentEnd + 1;
+  }
+  return normalized ?? (length2 > rootLength ? removeTrailingDirectorySeparator(path) : path);
 }
 function normalizePath(path) {
   path = normalizeSlashes(path);
+  let normalized = simpleNormalizePath(path);
+  if (normalized !== void 0) {
+    return normalized;
+  }
+  normalized = getNormalizedAbsolutePath(path, "");
+  return normalized && hasTrailingDirectorySeparator(path) ? ensureTrailingDirectorySeparator(normalized) : normalized;
+}
+function simpleNormalizePath(path) {
   if (!relativePathSegmentRegExp.test(path)) {
     return path;
   }
-  const simplified = path.replace(/\/\.\//g, "/").replace(/^\.\//, "");
+  let simplified = path.replace(/\/\.\//g, "/");
+  if (simplified.startsWith("./")) {
+    simplified = simplified.slice(2);
+  }
   if (simplified !== path) {
     path = simplified;
     if (!relativePathSegmentRegExp.test(path)) {
       return path;
     }
   }
-  const normalized = getPathFromPathComponents(reducePathComponents(getPathComponents(path)));
-  return normalized && hasTrailingDirectorySeparator(path) ? ensureTrailingDirectorySeparator(normalized) : normalized;
+  return void 0;
 }
 function getPathWithoutRoot(pathComponents2) {
   if (pathComponents2.length === 0) return "";
@@ -17942,9 +18030,6 @@ function forEachPropertyAssignment(objectLiteral, key, callback, key2) {
     return key === propName || key2 && key2 === propName ? callback(property) : void 0;
   });
 }
-function getPropertyArrayElementValue(objectLiteral, propKey, elementValue) {
-  return forEachPropertyAssignment(objectLiteral, propKey, (property) => isArrayLiteralExpression(property.initializer) ? find(property.initializer.elements, (element) => isStringLiteral(element) && element.text === elementValue) : void 0);
-}
 function getTsConfigObjectLiteralExpression(tsConfigSourceFile) {
   if (tsConfigSourceFile && tsConfigSourceFile.statements.length) {
     const expression = tsConfigSourceFile.statements[0].expression;
@@ -23952,6 +24037,64 @@ function getNodeAtPosition(sourceFile, position, includeJSDoc) {
 function isNewScopeNode(node) {
   return isFunctionLike(node) || isJSDocSignature(node) || isMappedTypeNode(node);
 }
+function getLibNameFromLibReference(libReference) {
+  return toFileNameLowerCase(libReference.fileName);
+}
+function getLibFileNameFromLibReference(libReference) {
+  const libName = getLibNameFromLibReference(libReference);
+  return libMap.get(libName);
+}
+function forEachResolvedProjectReference(resolvedProjectReferences, cb) {
+  return forEachProjectReference(
+    /*projectReferences*/
+    void 0,
+    resolvedProjectReferences,
+    (resolvedRef, parent2) => resolvedRef && cb(resolvedRef, parent2)
+  );
+}
+function forEachProjectReference(projectReferences, resolvedProjectReferences, cbResolvedRef, cbRef) {
+  let seenResolvedRefs;
+  return worker(
+    projectReferences,
+    resolvedProjectReferences,
+    /*parent*/
+    void 0
+  );
+  function worker(projectReferences2, resolvedProjectReferences2, parent2) {
+    if (cbRef) {
+      const result = cbRef(projectReferences2, parent2);
+      if (result) return result;
+    }
+    let skipChildren;
+    return forEach(
+      resolvedProjectReferences2,
+      (resolvedRef, index) => {
+        if (resolvedRef && (seenResolvedRefs == null ? void 0 : seenResolvedRefs.has(resolvedRef.sourceFile.path))) {
+          (skipChildren ?? (skipChildren = /* @__PURE__ */ new Set())).add(resolvedRef);
+          return void 0;
+        }
+        const result = cbResolvedRef(resolvedRef, parent2, index);
+        if (result || !resolvedRef) return result;
+        (seenResolvedRefs || (seenResolvedRefs = /* @__PURE__ */ new Set())).add(resolvedRef.sourceFile.path);
+      }
+    ) || forEach(
+      resolvedProjectReferences2,
+      (resolvedRef) => resolvedRef && !(skipChildren == null ? void 0 : skipChildren.has(resolvedRef)) ? worker(resolvedRef.commandLine.projectReferences, resolvedRef.references, resolvedRef) : void 0
+    );
+  }
+}
+function getOptionsSyntaxByArrayElementValue(optionsObject, name, value) {
+  return optionsObject && getPropertyArrayElementValue(optionsObject, name, value);
+}
+function getPropertyArrayElementValue(objectLiteral, propKey, elementValue) {
+  return forEachPropertyAssignment(objectLiteral, propKey, (property) => isArrayLiteralExpression(property.initializer) ? find(property.initializer.elements, (element) => isStringLiteral(element) && element.text === elementValue) : void 0);
+}
+function getOptionsSyntaxByValue(optionsObject, name, value) {
+  return forEachOptionsSyntaxByName(optionsObject, name, (property) => isStringLiteral(property.initializer) && property.initializer.text === value ? property.initializer : void 0);
+}
+function forEachOptionsSyntaxByName(optionsObject, name, callback) {
+  return forEachPropertyAssignment(optionsObject, name, callback);
+}
 
 // src/compiler/factory/baseNodeFactory.ts
 function createBaseNodeFactory() {
@@ -125720,45 +125863,6 @@ function loadWithModeAwareCache(entries, containingFile, redirectedReference, op
   }
   return resolutions;
 }
-function forEachResolvedProjectReference(resolvedProjectReferences, cb) {
-  return forEachProjectReference(
-    /*projectReferences*/
-    void 0,
-    resolvedProjectReferences,
-    (resolvedRef, parent2) => resolvedRef && cb(resolvedRef, parent2)
-  );
-}
-function forEachProjectReference(projectReferences, resolvedProjectReferences, cbResolvedRef, cbRef) {
-  let seenResolvedRefs;
-  return worker(
-    projectReferences,
-    resolvedProjectReferences,
-    /*parent*/
-    void 0
-  );
-  function worker(projectReferences2, resolvedProjectReferences2, parent2) {
-    if (cbRef) {
-      const result = cbRef(projectReferences2, parent2);
-      if (result) return result;
-    }
-    let skipChildren;
-    return forEach(
-      resolvedProjectReferences2,
-      (resolvedRef, index) => {
-        if (resolvedRef && (seenResolvedRefs == null ? void 0 : seenResolvedRefs.has(resolvedRef.sourceFile.path))) {
-          (skipChildren ?? (skipChildren = /* @__PURE__ */ new Set())).add(resolvedRef);
-          return void 0;
-        }
-        const result = cbResolvedRef(resolvedRef, parent2, index);
-        if (result || !resolvedRef) return result;
-        (seenResolvedRefs || (seenResolvedRefs = /* @__PURE__ */ new Set())).add(resolvedRef.sourceFile.path);
-      }
-    ) || forEach(
-      resolvedProjectReferences2,
-      (resolvedRef) => resolvedRef && !(skipChildren == null ? void 0 : skipChildren.has(resolvedRef)) ? worker(resolvedRef.commandLine.projectReferences, resolvedRef.references, resolvedRef) : void 0
-    );
-  }
-}
 var inferredTypesContainingFile = "__inferred type names__.ts";
 function getInferredLibraryNameResolveFrom(options, currentDirectory, libFileName) {
   const containingDirectory = options.configFilePath ? getDirectoryPath(options.configFilePath) : currentDirectory;
@@ -125774,13 +125878,6 @@ function getLibraryNameFromLibFileName(libFileName) {
   }
   return "@typescript/lib-" + path;
 }
-function getLibNameFromLibReference(libReference) {
-  return toFileNameLowerCase(libReference.fileName);
-}
-function getLibFileNameFromLibReference(libReference) {
-  const libName = getLibNameFromLibReference(libReference);
-  return libMap.get(libName);
-}
 function isReferencedFile(reason) {
   switch (reason == null ? void 0 : reason.kind) {
     case 3 /* Import */:
@@ -126015,16 +126112,12 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   let processingOtherFiles;
   let files;
   let symlinks;
-  let commonSourceDirectory;
   let typeChecker;
   let classifiableNames;
-  let fileReasons = createMultiMap();
   let filesWithReferencesProcessed;
-  let fileReasonsToChain;
-  let reasonToRelatedInfo;
   let cachedBindAndCheckDiagnosticsForFile;
   let cachedDeclarationDiagnosticsForFile;
-  let fileProcessingDiagnostics;
+  const programDiagnostics = createProgramDiagnostics(getCompilerOptionsObjectLiteralSyntax);
   let automaticTypeDirectiveNames;
   let automaticTypeDirectiveResolutions;
   let resolvedLibReferences;
@@ -126051,8 +126144,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   let skipDefaultLib = options.noLib;
   const getDefaultLibraryFileName = memoize(() => host.getDefaultLibFileName(options));
   const defaultLibraryPath = host.getDefaultLibLocation ? host.getDefaultLibLocation() : getDirectoryPath(getDefaultLibraryFileName());
-  const programDiagnostics = createDiagnosticCollection();
-  let lazyProgramDiagnosticExplainingFile = [];
+  let skipVerifyCompilerOptions = false;
   const currentDirectory = host.getCurrentDirectory();
   const supportedExtensions = getSupportedExtensions(options);
   const supportedExtensionsWithJsonIfResolveJsonModule = getSupportedExtensionsWithJsonIfResolveJsonModule(options, supportedExtensions);
@@ -126330,7 +126422,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     getTypeCount: () => getTypeChecker().getTypeCount(),
     getInstantiationCount: () => getTypeChecker().getInstantiationCount(),
     getRelationCacheSizes: () => getTypeChecker().getRelationCacheSizes(),
-    getFileProcessingDiagnostics: () => fileProcessingDiagnostics,
+    getFileProcessingDiagnostics: () => programDiagnostics.getFileProcessingDiagnostics(),
     getAutomaticTypeDirectiveNames: () => automaticTypeDirectiveNames,
     getAutomaticTypeDirectiveResolutions: () => automaticTypeDirectiveResolutions,
     isSourceFileFromExternalLibrary,
@@ -126346,6 +126438,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     resolvedModules,
     resolvedTypeReferenceDirectiveNames,
     resolvedLibReferences,
+    getProgramDiagnosticsContainer: () => programDiagnostics,
     getResolvedModule,
     getResolvedModuleFromModuleSpecifier,
     getResolvedTypeReferenceDirective,
@@ -126378,70 +126471,19 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     realpath: (_o = host.realpath) == null ? void 0 : _o.bind(host),
     useCaseSensitiveFileNames: () => host.useCaseSensitiveFileNames(),
     getCanonicalFileName,
-    getFileIncludeReasons: () => fileReasons,
+    getFileIncludeReasons: () => programDiagnostics.getFileReasons(),
     structureIsReused,
     writeFile: writeFile2,
     getGlobalTypingsCacheLocation: maybeBind(host, host.getGlobalTypingsCacheLocation)
   };
   onProgramCreateComplete();
-  verifyCompilerOptions();
+  if (!skipVerifyCompilerOptions) {
+    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);
@@ -126490,7 +126532,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   function addResolutionDiagnostics(resolution) {
     var _a2;
     if (!((_a2 = resolution.resolutionDiagnostics) == null ? void 0 : _a2.length)) return;
-    (fileProcessingDiagnostics ?? (fileProcessingDiagnostics = [])).push({
+    programDiagnostics.addFileProcessingDiagnostic({
       kind: 2 /* ResolutionDiagnostics */,
       diagnostics: resolution.resolutionDiagnostics
     });
@@ -126584,16 +126626,19 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     return toPath(fileName, currentDirectory, getCanonicalFileName);
   }
   function getCommonSourceDirectory2() {
-    if (commonSourceDirectory === void 0) {
-      const emittedFiles = filter(files, (file) => sourceFileMayBeEmitted(file, program));
-      commonSourceDirectory = getCommonSourceDirectory(
-        options,
-        () => mapDefined(emittedFiles, (file) => file.isDeclarationFile ? void 0 : file.fileName),
-        currentDirectory,
-        getCanonicalFileName,
-        (commonSourceDirectory2) => checkSourceFilesBelongToPath(emittedFiles, commonSourceDirectory2)
-      );
+    let commonSourceDirectory = programDiagnostics.getCommonSourceDirectory();
+    if (commonSourceDirectory !== void 0) {
+      return commonSourceDirectory;
     }
+    const emittedFiles = filter(files, (file) => sourceFileMayBeEmitted(file, program));
+    commonSourceDirectory = getCommonSourceDirectory(
+      options,
+      () => mapDefined(emittedFiles, (file) => file.isDeclarationFile ? void 0 : file.fileName),
+      currentDirectory,
+      getCanonicalFileName,
+      (commonSourceDirectory2) => checkSourceFilesBelongToPath(emittedFiles, commonSourceDirectory2)
+    );
+    programDiagnostics.setCommonSourceDirectory(commonSourceDirectory);
     return commonSourceDirectory;
   }
   function getClassifiableNames() {
@@ -126904,9 +126949,10 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       }
       filesByName.set(path, filesByName.get(oldFile.path));
     });
+    const isConfigIdentical = oldOptions.configFile && oldOptions.configFile === options.configFile || !oldOptions.configFile && !options.configFile && !optionsHaveChanges(oldOptions, options, optionDeclarations);
+    programDiagnostics.reuseStateFromOldProgram(oldProgram.getProgramDiagnosticsContainer(), isConfigIdentical);
+    skipVerifyCompilerOptions = isConfigIdentical;
     files = newSourceFiles;
-    fileReasons = oldProgram.getFileIncludeReasons();
-    fileProcessingDiagnostics = oldProgram.getFileProcessingDiagnostics();
     automaticTypeDirectiveNames = oldProgram.getAutomaticTypeDirectiveNames();
     automaticTypeDirectiveResolutions = oldProgram.getAutomaticTypeDirectiveResolutions();
     sourceFileToPackageName = oldProgram.sourceFileToPackageName;
@@ -127122,7 +127168,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     if (skipTypeChecking(sourceFile, options, program)) {
       return emptyArray;
     }
-    const programDiagnosticsInFile = updateAndGetProgramDiagnostics().getDiagnostics(sourceFile.fileName);
+    const programDiagnosticsInFile = programDiagnostics.getCombinedDiagnostics(program).getDiagnostics(sourceFile.fileName);
     if (!((_a2 = sourceFile.commentDirectives) == null ? void 0 : _a2.length)) {
       return programDiagnosticsInFile;
     }
@@ -127480,15 +127526,15 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function getOptionsDiagnostics() {
     return sortAndDeduplicateDiagnostics(concatenate(
-      updateAndGetProgramDiagnostics().getGlobalDiagnostics(),
+      programDiagnostics.getCombinedDiagnostics(program).getGlobalDiagnostics(),
       getOptionsDiagnosticsOfConfigFile()
     ));
   }
   function getOptionsDiagnosticsOfConfigFile() {
     if (!options.configFile) return emptyArray;
-    let diagnostics = updateAndGetProgramDiagnostics().getDiagnostics(options.configFile.fileName);
+    let diagnostics = programDiagnostics.getCombinedDiagnostics(program).getDiagnostics(options.configFile.fileName);
     forEachResolvedProjectReference2((resolvedRef) => {
-      diagnostics = concatenate(diagnostics, updateAndGetProgramDiagnostics().getDiagnostics(resolvedRef.sourceFile.fileName));
+      diagnostics = concatenate(diagnostics, programDiagnostics.getCombinedDiagnostics(program).getDiagnostics(resolvedRef.sourceFile.fileName));
     });
     return diagnostics;
   }
@@ -127695,7 +127741,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     );
   }
   function reportFileNamesDifferOnlyInCasingError(fileName, existingFile, reason) {
-    const hasExistingReasonToReportErrorOn = !isReferencedFile(reason) && some(fileReasons.get(existingFile.path), isReferencedFile);
+    const hasExistingReasonToReportErrorOn = !isReferencedFile(reason) && some(programDiagnostics.getFileReasons().get(existingFile.path), isReferencedFile);
     if (hasExistingReasonToReportErrorOn) {
       addFilePreprocessingFileExplainingDiagnostic(existingFile, reason, Diagnostics.Already_included_file_name_0_differs_from_file_name_1_only_in_casing, [existingFile.fileName, fileName]);
     } else {
@@ -127882,7 +127928,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function addFileIncludeReason(file, reason, checkExisting) {
     if (file && (!checkExisting || !isReferencedFile(reason) || !(filesWithReferencesProcessed == null ? void 0 : filesWithReferencesProcessed.has(reason.file)))) {
-      fileReasons.add(file.path, reason);
+      programDiagnostics.getFileReasons().add(file.path, reason);
       return true;
     }
     return false;
@@ -128081,7 +128127,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
           { kind: 7 /* LibReferenceDirective */, file: file.path, index }
         );
       } else {
-        (fileProcessingDiagnostics || (fileProcessingDiagnostics = [])).push({
+        programDiagnostics.addFileProcessingDiagnostic({
           kind: 0 /* FilePreprocessingLibReferenceDiagnostic */,
           reason: { kind: 7 /* LibReferenceDirective */, file: file.path, index }
         });
@@ -128144,10 +128190,11 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       if (!sourceFile.isDeclarationFile) {
         const absoluteSourceFilePath = host.getCanonicalFileName(getNormalizedAbsolutePath(sourceFile.fileName, currentDirectory));
         if (absoluteSourceFilePath.indexOf(absoluteRootDirectoryPath) !== 0) {
-          addLazyProgramDiagnosticExplainingFile(
+          programDiagnostics.addLazyConfigDiagnostic(
             sourceFile,
             Diagnostics.File_0_is_not_under_rootDir_1_rootDir_is_expected_to_contain_all_source_files,
-            [sourceFile.fileName, rootDirectory]
+            sourceFile.fileName,
+            rootDirectory
           );
           allFilesBelongToPath = false;
         }
@@ -128262,7 +128309,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     }
     const outputFile = options.outFile;
     if (!options.tsBuildInfoFile && options.incremental && !outputFile && !options.configFilePath) {
-      programDiagnostics.add(createCompilerDiagnostic(Diagnostics.Option_incremental_can_only_be_specified_using_tsconfig_emitting_to_single_file_or_when_option_tsBuildInfoFile_is_specified));
+      programDiagnostics.addConfigDiagnostic(createCompilerDiagnostic(Diagnostics.Option_incremental_can_only_be_specified_using_tsconfig_emitting_to_single_file_or_when_option_tsBuildInfoFile_is_specified));
     }
     verifyDeprecatedCompilerOptions();
     verifyProjectReferences();
@@ -128270,10 +128317,11 @@ 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)) {
-          addLazyProgramDiagnosticExplainingFile(
+          programDiagnostics.addLazyConfigDiagnostic(
             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 || ""]
+            file.fileName,
+            options.configFilePath || ""
           );
         }
       }
@@ -128364,14 +128412,14 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       }
     } else if (firstNonAmbientExternalModuleSourceFile && languageVersion < 2 /* ES2015 */ && options.module === 0 /* None */) {
       const span = getErrorSpanForNode(firstNonAmbientExternalModuleSourceFile, typeof firstNonAmbientExternalModuleSourceFile.externalModuleIndicator === "boolean" ? firstNonAmbientExternalModuleSourceFile : firstNonAmbientExternalModuleSourceFile.externalModuleIndicator);
-      programDiagnostics.add(createFileDiagnostic(firstNonAmbientExternalModuleSourceFile, span.start, span.length, Diagnostics.Cannot_use_imports_exports_or_module_augmentations_when_module_is_none));
+      programDiagnostics.addConfigDiagnostic(createFileDiagnostic(firstNonAmbientExternalModuleSourceFile, span.start, span.length, Diagnostics.Cannot_use_imports_exports_or_module_augmentations_when_module_is_none));
     }
     if (outputFile && !options.emitDeclarationOnly) {
       if (options.module && !(options.module === 2 /* AMD */ || options.module === 4 /* System */)) {
         createDiagnosticForOptionName(Diagnostics.Only_amd_and_system_modules_are_supported_alongside_0, "outFile", "module");
       } else if (options.module === void 0 && firstNonAmbientExternalModuleSourceFile) {
         const span = getErrorSpanForNode(firstNonAmbientExternalModuleSourceFile, typeof firstNonAmbientExternalModuleSourceFile.externalModuleIndicator === "boolean" ? firstNonAmbientExternalModuleSourceFile : firstNonAmbientExternalModuleSourceFile.externalModuleIndicator);
-        programDiagnostics.add(createFileDiagnostic(firstNonAmbientExternalModuleSourceFile, span.start, span.length, Diagnostics.Cannot_compile_modules_using_option_0_unless_the_module_flag_is_amd_or_system, "outFile"));
+        programDiagnostics.addConfigDiagnostic(createFileDiagnostic(firstNonAmbientExternalModuleSourceFile, span.start, span.length, Diagnostics.Cannot_compile_modules_using_option_0_unless_the_module_flag_is_amd_or_system, "outFile"));
       }
     }
     if (getResolveJsonModule(options)) {
@@ -128623,90 +128671,8 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       }
     });
   }
-  function createDiagnosticExplainingFile(file, fileProcessingReason, diagnostic, args) {
-    let seenReasons;
-    const reasons = file && fileReasons.get(file.path);
-    let fileIncludeReasons;
-    let relatedInfo;
-    let locationReason = isReferencedFile(fileProcessingReason) ? fileProcessingReason : void 0;
-    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);
-    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);
-    return location && isReferenceFileLocation(location) ? createFileDiagnosticFromMessageChain(location.file, location.pos, location.end - location.pos, chain, relatedInfo) : createCompilerDiagnosticFromMessageChain(chain, relatedInfo);
-    function processReason(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, getFileIncludeReasonToRelatedInformation(reason));
-      }
-    }
-    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) {
-    (fileProcessingDiagnostics || (fileProcessingDiagnostics = [])).push({
+    programDiagnostics.addFileProcessingDiagnostic({
       kind: 1 /* FilePreprocessingFileExplainingDiagnostic */,
       file: file && file.path,
       fileProcessingReason,
@@ -128714,99 +128680,6 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       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)) {
-      const referenceLocation = getReferencedFileLocation(program, reason);
-      let message2;
-      switch (reason.kind) {
-        case 3 /* Import */:
-          message2 = Diagnostics.File_is_included_via_import_here;
-          break;
-        case 4 /* ReferenceFile */:
-          message2 = Diagnostics.File_is_included_via_reference_here;
-          break;
-        case 5 /* TypeReferenceDirective */:
-          message2 = Diagnostics.File_is_included_via_type_library_reference_here;
-          break;
-        case 7 /* LibReferenceDirective */:
-          message2 = Diagnostics.File_is_included_via_library_reference_here;
-          break;
-        default:
-          Debug.assertNever(reason);
-      }
-      return isReferenceFileLocation(referenceLocation) ? createFileDiagnostic(
-        referenceLocation.file,
-        referenceLocation.pos,
-        referenceLocation.end - referenceLocation.pos,
-        message2
-      ) : void 0;
-    }
-    if (!options.configFile) return void 0;
-    let configFileNode;
-    let message;
-    switch (reason.kind) {
-      case 0 /* RootFile */:
-        if (!options.configFile.configFileSpecs) return void 0;
-        const fileName = getNormalizedAbsolutePath(rootNames[reason.index], currentDirectory);
-        const matchedByFiles = getMatchedFileSpec(program, fileName);
-        if (matchedByFiles) {
-          configFileNode = getTsConfigPropArrayElementValue(options.configFile, "files", matchedByFiles);
-          message = Diagnostics.File_is_matched_by_files_list_specified_here;
-          break;
-        }
-        const matchedByInclude = getMatchedIncludeSpec(program, fileName);
-        if (!matchedByInclude || !isString(matchedByInclude)) return void 0;
-        configFileNode = getTsConfigPropArrayElementValue(options.configFile, "include", matchedByInclude);
-        message = Diagnostics.File_is_matched_by_include_pattern_specified_here;
-        break;
-      case 1 /* SourceFromProjectReference */:
-      case 2 /* OutputFromProjectReference */:
-        const referencedResolvedRef = Debug.checkDefined(resolvedProjectReferences == null ? void 0 : resolvedProjectReferences[reason.index]);
-        const referenceInfo = forEachProjectReference(
-          projectReferences,
-          resolvedProjectReferences,
-          (resolvedRef, parent2, index2) => resolvedRef === referencedResolvedRef ? { sourceFile: (parent2 == null ? void 0 : parent2.sourceFile) || options.configFile, index: index2 } : void 0
-        );
-        if (!referenceInfo) return void 0;
-        const { sourceFile, index } = referenceInfo;
-        const referencesSyntax = forEachTsConfigPropArray(sourceFile, "references", (property) => isArrayLiteralExpression(property.initializer) ? property.initializer : void 0);
-        return referencesSyntax && referencesSyntax.elements.length > index ? createDiagnosticForNodeInSourceFile(
-          sourceFile,
-          referencesSyntax.elements[index],
-          reason.kind === 2 /* OutputFromProjectReference */ ? Diagnostics.File_is_output_from_referenced_project_specified_here : Diagnostics.File_is_source_from_referenced_project_specified_here
-        ) : void 0;
-      case 8 /* AutomaticTypeDirectiveFile */:
-        if (!options.types) return void 0;
-        configFileNode = getOptionsSyntaxByArrayElementValue("types", reason.typeReference);
-        message = Diagnostics.File_is_entry_point_of_type_library_specified_here;
-        break;
-      case 6 /* LibFile */:
-        if (reason.index !== void 0) {
-          configFileNode = getOptionsSyntaxByArrayElementValue("lib", options.lib[reason.index]);
-          message = Diagnostics.File_is_library_specified_here;
-          break;
-        }
-        const target = getNameOfScriptTarget(getEmitScriptTarget(options));
-        configFileNode = target ? getOptionsSyntaxByValue("target", target) : void 0;
-        message = Diagnostics.File_is_default_library_for_target_specified_here;
-        break;
-      default:
-        Debug.assertNever(reason);
-    }
-    return configFileNode && createDiagnosticForNodeInSourceFile(
-      options.configFile,
-      configFileNode,
-      message
-    );
-  }
   function verifyProjectReferences() {
     const buildInfoPath = !options.suppressOutputPathCheck ? getTsBuildInfoEmitOutputFilePath(options) : void 0;
     forEachProjectReference(
@@ -128842,7 +128715,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
         forEachPropertyAssignment(pathProp.initializer, key, (keyProps) => {
           const initializer = keyProps.initializer;
           if (isArrayLiteralExpression(initializer) && initializer.elements.length > valueIndex) {
-            programDiagnostics.add(createDiagnosticForNodeInSourceFile(options.configFile, initializer.elements[valueIndex], message, ...args));
+            programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeInSourceFile(options.configFile, initializer.elements[valueIndex], message, ...args));
             needCompilerDiagnostic = false;
           }
         });
@@ -128871,18 +128744,8 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       createCompilerOptionsDiagnostic(message, ...args);
     }
   }
-  function forEachOptionsSyntaxByName(name, callback) {
-    return forEachPropertyAssignment(getCompilerOptionsObjectLiteralSyntax(), name, callback);
-  }
   function forEachOptionPathsSyntax(callback) {
-    return forEachOptionsSyntaxByName("paths", callback);
-  }
-  function getOptionsSyntaxByValue(name, value) {
-    return forEachOptionsSyntaxByName(name, (property) => isStringLiteral(property.initializer) && property.initializer.text === value ? property.initializer : void 0);
-  }
-  function getOptionsSyntaxByArrayElementValue(name, value) {
-    const compilerOptionsObjectLiteralSyntax = getCompilerOptionsObjectLiteralSyntax();
-    return compilerOptionsObjectLiteralSyntax && getPropertyArrayElementValue(compilerOptionsObjectLiteralSyntax, name, value);
+    return forEachOptionsSyntaxByName(getCompilerOptionsObjectLiteralSyntax(), "paths", callback);
   }
   function createDiagnosticForOptionName(message, option1, option2, option3) {
     createDiagnosticForOption(
@@ -128910,9 +128773,9 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   function createDiagnosticForReference(sourceFile, index, message, ...args) {
     const referencesSyntax = forEachTsConfigPropArray(sourceFile || options.configFile, "references", (property) => isArrayLiteralExpression(property.initializer) ? property.initializer : void 0);
     if (referencesSyntax && referencesSyntax.elements.length > index) {
-      programDiagnostics.add(createDiagnosticForNodeInSourceFile(sourceFile || options.configFile, referencesSyntax.elements[index], message, ...args));
+      programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeInSourceFile(sourceFile || options.configFile, referencesSyntax.elements[index], message, ...args));
     } else {
-      programDiagnostics.add(createCompilerDiagnostic(message, ...args));
+      programDiagnostics.addConfigDiagnostic(createCompilerDiagnostic(message, ...args));
     }
   }
   function createDiagnosticForOption(onKey, option1, option2, message, ...args) {
@@ -128926,14 +128789,14 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     const compilerOptionsProperty = getCompilerOptionsPropertySyntax();
     if (compilerOptionsProperty) {
       if ("messageText" in message) {
-        programDiagnostics.add(createDiagnosticForNodeFromMessageChain(options.configFile, compilerOptionsProperty.name, message));
+        programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeFromMessageChain(options.configFile, compilerOptionsProperty.name, message));
       } else {
-        programDiagnostics.add(createDiagnosticForNodeInSourceFile(options.configFile, compilerOptionsProperty.name, message, ...args));
+        programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeInSourceFile(options.configFile, compilerOptionsProperty.name, message, ...args));
       }
     } else if ("messageText" in message) {
-      programDiagnostics.add(createCompilerDiagnosticFromMessageChain(message));
+      programDiagnostics.addConfigDiagnostic(createCompilerDiagnosticFromMessageChain(message));
     } else {
-      programDiagnostics.add(createCompilerDiagnostic(message, ...args));
+      programDiagnostics.addConfigDiagnostic(createCompilerDiagnostic(message, ...args));
     }
   }
   function getCompilerOptionsObjectLiteralSyntax() {
@@ -128957,9 +128820,9 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     let needsCompilerDiagnostic = false;
     forEachPropertyAssignment(objectLiteral, key1, (prop) => {
       if ("messageText" in message) {
-        programDiagnostics.add(createDiagnosticForNodeFromMessageChain(options.configFile, onKey ? prop.name : prop.initializer, message));
+        programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeFromMessageChain(options.configFile, onKey ? prop.name : prop.initializer, message));
       } else {
-        programDiagnostics.add(createDiagnosticForNodeInSourceFile(options.configFile, onKey ? prop.name : prop.initializer, message, ...args));
+        programDiagnostics.addConfigDiagnostic(createDiagnosticForNodeInSourceFile(options.configFile, onKey ? prop.name : prop.initializer, message, ...args));
       }
       needsCompilerDiagnostic = true;
     }, key2);
@@ -128967,7 +128830,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
   }
   function blockEmittingOfFile(emitFileName, diag2) {
     hasEmitBlockingDiagnostics.set(toPath3(emitFileName), true);
-    programDiagnostics.add(diag2);
+    programDiagnostics.addConfigDiagnostic(diag2);
   }
   function isEmittedFile(file) {
     if (options.noEmit) {
@@ -129290,6 +129153,293 @@ function getModuleNameStringLiteralAt({ imports, moduleAugmentations }, index) {
   Debug.fail("should never ask for module name at index higher than possible module name");
 }
 
+// src/compiler/programDiagnostics.ts
+function createProgramDiagnostics(getCompilerOptionsObjectLiteralSyntax) {
+  let computedDiagnostics;
+  let fileReasons = createMultiMap();
+  let fileProcessingDiagnostics;
+  let commonSourceDirectory;
+  let configDiagnostics;
+  let lazyConfigDiagnostics;
+  let fileReasonsToChain;
+  let reasonToRelatedInfo;
+  return {
+    addConfigDiagnostic(diag2) {
+      Debug.assert(computedDiagnostics === void 0, "Cannot modify program diagnostic state after requesting combined diagnostics");
+      (configDiagnostics ?? (configDiagnostics = createDiagnosticCollection())).add(diag2);
+    },
+    addLazyConfigDiagnostic(file, message, ...args) {
+      Debug.assert(computedDiagnostics === void 0, "Cannot modify program diagnostic state after requesting combined diagnostics");
+      (lazyConfigDiagnostics ?? (lazyConfigDiagnostics = [])).push({ file, diagnostic: message, args });
+    },
+    addFileProcessingDiagnostic(diag2) {
+      Debug.assert(computedDiagnostics === void 0, "Cannot modify program diagnostic state after requesting combined diagnostics");
+      (fileProcessingDiagnostics ?? (fileProcessingDiagnostics = [])).push(diag2);
+    },
+    setCommonSourceDirectory(directory) {
+      commonSourceDirectory = directory;
+    },
+    reuseStateFromOldProgram(oldProgramDiagnostics, isConfigIdentical) {
+      fileReasons = oldProgramDiagnostics.getFileReasons();
+      fileProcessingDiagnostics = oldProgramDiagnostics.getFileProcessingDiagnostics();
+      if (isConfigIdentical) {
+        commonSourceDirectory = oldProgramDiagnostics.getCommonSourceDirectory();
+        configDiagnostics = oldProgramDiagnostics.getConfigDiagnostics();
+        lazyConfigDiagnostics = oldProgramDiagnostics.getLazyConfigDiagnostics();
+      }
+    },
+    getFileProcessingDiagnostics() {
+      return fileProcessingDiagnostics;
+    },
+    getFileReasons() {
+      return fileReasons;
+    },
+    getCommonSourceDirectory() {
+      return commonSourceDirectory;
+    },
+    getConfigDiagnostics() {
+      return configDiagnostics;
+    },
+    getLazyConfigDiagnostics() {
+      return lazyConfigDiagnostics;
+    },
+    getCombinedDiagnostics(program) {
+      if (computedDiagnostics) {
+        return computedDiagnostics;
+      }
+      computedDiagnostics = createDiagnosticCollection();
+      configDiagnostics == null ? void 0 : configDiagnostics.getDiagnostics().forEach((d) => computedDiagnostics.add(d));
+      fileProcessingDiagnostics == null ? void 0 : fileProcessingDiagnostics.forEach((diagnostic) => {
+        switch (diagnostic.kind) {
+          case 1 /* FilePreprocessingFileExplainingDiagnostic */:
+            return computedDiagnostics.add(
+              createDiagnosticExplainingFile(
+                program,
+                diagnostic.file && program.getSourceFileByPath(diagnostic.file),
+                diagnostic.fileProcessingReason,
+                diagnostic.diagnostic,
+                diagnostic.args || emptyArray
+              )
+            );
+          case 0 /* FilePreprocessingLibReferenceDiagnostic */:
+            return computedDiagnostics.add(filePreprocessingLibreferenceDiagnostic(program, diagnostic));
+          case 2 /* ResolutionDiagnostics */:
+            return diagnostic.diagnostics.forEach((d) => computedDiagnostics.add(d));
+          default:
+            Debug.assertNever(diagnostic);
+        }
+      });
+      lazyConfigDiagnostics == null ? void 0 : lazyConfigDiagnostics.forEach(
+        ({ file, diagnostic, args }) => computedDiagnostics.add(
+          createDiagnosticExplainingFile(
+            program,
+            file,
+            /*fileProcessingReason*/
+            void 0,
+            diagnostic,
+            args
+          )
+        )
+      );
+      fileReasonsToChain = void 0;
+      reasonToRelatedInfo = void 0;
+      return computedDiagnostics;
+    }
+  };
+  function filePreprocessingLibreferenceDiagnostic(program, { 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 createDiagnosticExplainingFile(program, file, fileProcessingReason, diagnostic, args) {
+    let seenReasons;
+    let fileIncludeReasons;
+    let relatedInfo;
+    let fileIncludeReasonDetails;
+    let redirectInfo;
+    let chain;
+    const reasons = file && fileReasons.get(file.path);
+    let locationReason = isReferencedFile(fileProcessingReason) ? fileProcessingReason : void 0;
+    let cachedChain = file && (fileReasonsToChain == null ? void 0 : fileReasonsToChain.get(file.path));
+    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, program.getCompilerOptionsForFile(file));
+    }
+    if (fileProcessingReason) processReason(fileProcessingReason);
+    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);
+    return location && isReferenceFileLocation(location) ? createFileDiagnosticFromMessageChain(location.file, location.pos, location.end - location.pos, chain, relatedInfo) : createCompilerDiagnosticFromMessageChain(chain, relatedInfo);
+    function processReason(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, getFileIncludeReasonToRelatedInformation(program, reason));
+      }
+    }
+    function cachedFileIncludeDetailsHasProcessedExtraReason() {
+      var _a;
+      return ((_a = cachedChain.fileIncludeReasonDetails.next) == null ? void 0 : _a.length) !== (reasons == null ? void 0 : reasons.length);
+    }
+  }
+  function getFileIncludeReasonToRelatedInformation(program, reason) {
+    let relatedInfo = reasonToRelatedInfo == null ? void 0 : reasonToRelatedInfo.get(reason);
+    if (relatedInfo === void 0) (reasonToRelatedInfo ?? (reasonToRelatedInfo = /* @__PURE__ */ new Map())).set(reason, relatedInfo = fileIncludeReasonToRelatedInformation(program, reason) ?? false);
+    return relatedInfo || void 0;
+  }
+  function fileIncludeReasonToRelatedInformation(program, reason) {
+    if (isReferencedFile(reason)) {
+      const referenceLocation = getReferencedFileLocation(program, reason);
+      let message2;
+      switch (reason.kind) {
+        case 3 /* Import */:
+          message2 = Diagnostics.File_is_included_via_import_here;
+          break;
+        case 4 /* ReferenceFile */:
+          message2 = Diagnostics.File_is_included_via_reference_here;
+          break;
+        case 5 /* TypeReferenceDirective */:
+          message2 = Diagnostics.File_is_included_via_type_library_reference_here;
+          break;
+        case 7 /* LibReferenceDirective */:
+          message2 = Diagnostics.File_is_included_via_library_reference_here;
+          break;
+        default:
+          Debug.assertNever(reason);
+      }
+      return isReferenceFileLocation(referenceLocation) ? createFileDiagnostic(
+        referenceLocation.file,
+        referenceLocation.pos,
+        referenceLocation.end - referenceLocation.pos,
+        message2
+      ) : void 0;
+    }
+    const currentDirectory = program.getCurrentDirectory();
+    const rootNames = program.getRootFileNames();
+    const options = program.getCompilerOptions();
+    if (!options.configFile) return void 0;
+    let configFileNode;
+    let message;
+    switch (reason.kind) {
+      case 0 /* RootFile */:
+        if (!options.configFile.configFileSpecs) return void 0;
+        const fileName = getNormalizedAbsolutePath(rootNames[reason.index], currentDirectory);
+        const matchedByFiles = getMatchedFileSpec(program, fileName);
+        if (matchedByFiles) {
+          configFileNode = getTsConfigPropArrayElementValue(options.configFile, "files", matchedByFiles);
+          message = Diagnostics.File_is_matched_by_files_list_specified_here;
+          break;
+        }
+        const matchedByInclude = getMatchedIncludeSpec(program, fileName);
+        if (!matchedByInclude || !isString(matchedByInclude)) return void 0;
+        configFileNode = getTsConfigPropArrayElementValue(options.configFile, "include", matchedByInclude);
+        message = Diagnostics.File_is_matched_by_include_pattern_specified_here;
+        break;
+      case 1 /* SourceFromProjectReference */:
+      case 2 /* OutputFromProjectReference */:
+        const resolvedProjectReferences = program.getResolvedProjectReferences();
+        const projectReferences = program.getProjectReferences();
+        const referencedResolvedRef = Debug.checkDefined(resolvedProjectReferences == null ? void 0 : resolvedProjectReferences[reason.index]);
+        const referenceInfo = forEachProjectReference(
+          projectReferences,
+          resolvedProjectReferences,
+          (resolvedRef, parent2, index2) => resolvedRef === referencedResolvedRef ? { sourceFile: (parent2 == null ? void 0 : parent2.sourceFile) || options.configFile, index: index2 } : void 0
+        );
+        if (!referenceInfo) return void 0;
+        const { sourceFile, index } = referenceInfo;
+        const referencesSyntax = forEachTsConfigPropArray(sourceFile, "references", (property) => isArrayLiteralExpression(property.initializer) ? property.initializer : void 0);
+        return referencesSyntax && referencesSyntax.elements.length > index ? createDiagnosticForNodeInSourceFile(
+          sourceFile,
+          referencesSyntax.elements[index],
+          reason.kind === 2 /* OutputFromProjectReference */ ? Diagnostics.File_is_output_from_referenced_project_specified_here : Diagnostics.File_is_source_from_referenced_project_specified_here
+        ) : void 0;
+      case 8 /* AutomaticTypeDirectiveFile */:
+        if (!options.types) return void 0;
+        configFileNode = getOptionsSyntaxByArrayElementValue(getCompilerOptionsObjectLiteralSyntax(), "types", reason.typeReference);
+        message = Diagnostics.File_is_entry_point_of_type_library_specified_here;
+        break;
+      case 6 /* LibFile */:
+        if (reason.index !== void 0) {
+          configFileNode = getOptionsSyntaxByArrayElementValue(getCompilerOptionsObjectLiteralSyntax(), "lib", options.lib[reason.index]);
+          message = Diagnostics.File_is_library_specified_here;
+          break;
+        }
+        const target = getNameOfScriptTarget(getEmitScriptTarget(options));
+        configFileNode = target ? getOptionsSyntaxByValue(getCompilerOptionsObjectLiteralSyntax(), "target", target) : void 0;
+        message = Diagnostics.File_is_default_library_for_target_specified_here;
+        break;
+      default:
+        Debug.assertNever(reason);
+    }
+    return configFileNode && createDiagnosticForNodeInSourceFile(
+      options.configFile,
+      configFileNode,
+      message
+    );
+  }
+}
+
 // src/compiler/builderState.ts
 function getFileEmitOutput(program, sourceFile, emitOnlyDtsFiles, cancellationToken, customTransformers, forceDtsEmit) {
   const outputFiles = [];
@@ -182620,6 +182770,7 @@ __export(ts_exports2, {
   createPrinterWithRemoveCommentsNeverAsciiEscape: () => createPrinterWithRemoveCommentsNeverAsciiEscape,
   createPrinterWithRemoveCommentsOmitTrailingSemicolon: () => createPrinterWithRemoveCommentsOmitTrailingSemicolon,
   createProgram: () => createProgram,
+  createProgramDiagnostics: () => createProgramDiagnostics,
   createProgramHost: () => createProgramHost,
   createPropertyNameNodeForIdentifierOrLiteral: () => createPropertyNameNodeForIdentifierOrLiteral,
   createQueue: () => createQueue,
@@ -182789,6 +182940,8 @@ __export(ts_exports2, {
   forEachLeadingCommentRange: () => forEachLeadingCommentRange,
   forEachNameInAccessChainWalkingLeft: () => forEachNameInAccessChainWalkingLeft,
   forEachNameOfDefaultExport: () => forEachNameOfDefaultExport,
+  forEachOptionsSyntaxByName: () => forEachOptionsSyntaxByName,
+  forEachProjectReference: () => forEachProjectReference,
   forEachPropertyAssignment: () => forEachPropertyAssignment,
   forEachResolvedProjectReference: () => forEachResolvedProjectReference,
   forEachReturnStatement: () => forEachReturnStatement,
@@ -183028,6 +183181,8 @@ __export(ts_exports2, {
   getLeadingCommentRangesOfNode: () => getLeadingCommentRangesOfNode,
   getLeftmostAccessExpression: () => getLeftmostAccessExpression,
   getLeftmostExpression: () => getLeftmostExpression,
+  getLibFileNameFromLibReference: () => getLibFileNameFromLibReference,
+  getLibNameFromLibReference: () => getLibNameFromLibReference,
   getLibraryNameFromLibFileName: () => getLibraryNameFromLibFileName,
   getLineAndCharacterOfPosition: () => getLineAndCharacterOfPosition,
   getLineInfo: () => getLineInfo,
@@ -183100,6 +183255,8 @@ __export(ts_exports2, {
   getOptionFromName: () => getOptionFromName,
   getOptionsForLibraryResolution: () => getOptionsForLibraryResolution,
   getOptionsNameMap: () => getOptionsNameMap,
+  getOptionsSyntaxByArrayElementValue: () => getOptionsSyntaxByArrayElementValue,
+  getOptionsSyntaxByValue: () => getOptionsSyntaxByValue,
   getOrCreateEmitNode: () => getOrCreateEmitNode,
   getOrUpdate: () => getOrUpdate,
   getOriginalNode: () => getOriginalNode,
@@ -183136,7 +183293,6 @@ __export(ts_exports2, {
   getPrivateIdentifier: () => getPrivateIdentifier,
   getProperties: () => getProperties,
   getProperty: () => getProperty,
-  getPropertyArrayElementValue: () => getPropertyArrayElementValue,
   getPropertyAssignmentAliasLikeExpression: () => getPropertyAssignmentAliasLikeExpression,
   getPropertyNameForPropertyNameNode: () => getPropertyNameForPropertyNameNode,
   getPropertyNameFromType: () => getPropertyNameFromType,
@@ -197368,6 +197524,7 @@ if (typeof console !== "undefined") {
   createPrinterWithRemoveCommentsNeverAsciiEscape,
   createPrinterWithRemoveCommentsOmitTrailingSemicolon,
   createProgram,
+  createProgramDiagnostics,
   createProgramHost,
   createPropertyNameNodeForIdentifierOrLiteral,
   createQueue,
@@ -197537,6 +197694,8 @@ if (typeof console !== "undefined") {
   forEachLeadingCommentRange,
   forEachNameInAccessChainWalkingLeft,
   forEachNameOfDefaultExport,
+  forEachOptionsSyntaxByName,
+  forEachProjectReference,
   forEachPropertyAssignment,
   forEachResolvedProjectReference,
   forEachReturnStatement,
@@ -197776,6 +197935,8 @@ if (typeof console !== "undefined") {
   getLeadingCommentRangesOfNode,
   getLeftmostAccessExpression,
   getLeftmostExpression,
+  getLibFileNameFromLibReference,
+  getLibNameFromLibReference,
   getLibraryNameFromLibFileName,
   getLineAndCharacterOfPosition,
   getLineInfo,
@@ -197848,6 +198009,8 @@ if (typeof console !== "undefined") {
   getOptionFromName,
   getOptionsForLibraryResolution,
   getOptionsNameMap,
+  getOptionsSyntaxByArrayElementValue,
+  getOptionsSyntaxByValue,
   getOrCreateEmitNode,
   getOrUpdate,
   getOriginalNode,
@@ -197884,7 +198047,6 @@ if (typeof console !== "undefined") {
   getPrivateIdentifier,
   getProperties,
   getProperty,
-  getPropertyArrayElementValue,
   getPropertyAssignmentAliasLikeExpression,
   getPropertyNameForPropertyNameNode,
   getPropertyNameFromType,