typescript 5.7.0-dev.20240904 → 5.7.0-dev.20240911

package/lib/tsc.js

@@ -18,7 +18,7 @@ and limitations under the License.
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.7";
-var version = `${versionMajorMinor}.0-dev.20240904`;
+var version = `${versionMajorMinor}.0-dev.20240911`;
 
 // src/compiler/core.ts
 var emptyArray = [];
@@ -11118,29 +11118,33 @@ function isExternalModuleNameRelative(moduleName) {
 function sortAndDeduplicateDiagnostics(diagnostics) {
   return sortAndDeduplicate(diagnostics, compareDiagnostics, diagnosticsEqualityComparer);
 }
+var targetToLibMap = /* @__PURE__ */ new Map([
+  [99 /* ESNext */, "lib.esnext.full.d.ts"],
+  [10 /* ES2023 */, "lib.es2023.full.d.ts"],
+  [9 /* ES2022 */, "lib.es2022.full.d.ts"],
+  [8 /* ES2021 */, "lib.es2021.full.d.ts"],
+  [7 /* ES2020 */, "lib.es2020.full.d.ts"],
+  [6 /* ES2019 */, "lib.es2019.full.d.ts"],
+  [5 /* ES2018 */, "lib.es2018.full.d.ts"],
+  [4 /* ES2017 */, "lib.es2017.full.d.ts"],
+  [3 /* ES2016 */, "lib.es2016.full.d.ts"],
+  [2 /* ES2015 */, "lib.es6.d.ts"]
+  // We don't use lib.es2015.full.d.ts due to breaking change.
+]);
 function getDefaultLibFileName(options) {
-  switch (getEmitScriptTarget(options)) {
+  const target = getEmitScriptTarget(options);
+  switch (target) {
     case 99 /* ESNext */:
-      return "lib.esnext.full.d.ts";
     case 10 /* ES2023 */:
-      return "lib.es2023.full.d.ts";
     case 9 /* ES2022 */:
-      return "lib.es2022.full.d.ts";
     case 8 /* ES2021 */:
-      return "lib.es2021.full.d.ts";
     case 7 /* ES2020 */:
-      return "lib.es2020.full.d.ts";
     case 6 /* ES2019 */:
-      return "lib.es2019.full.d.ts";
     case 5 /* ES2018 */:
-      return "lib.es2018.full.d.ts";
     case 4 /* ES2017 */:
-      return "lib.es2017.full.d.ts";
     case 3 /* ES2016 */:
-      return "lib.es2016.full.d.ts";
     case 2 /* ES2015 */:
-      return "lib.es6.d.ts";
-    // We don't use lib.es2015.full.d.ts due to breaking change.
+      return targetToLibMap.get(target);
     default:
       return "lib.d.ts";
   }
@@ -27020,23 +27024,21 @@ function hasRecordedExternalHelpers(sourceFile) {
 }
 function createExternalHelpersImportDeclarationIfNeeded(nodeFactory, helperFactory, sourceFile, compilerOptions, hasExportStarsToExportValues, hasImportStar, hasImportDefault) {
   if (compilerOptions.importHelpers && isEffectiveExternalModule(sourceFile, compilerOptions)) {
-    let namedBindings;
     const moduleKind = getEmitModuleKind(compilerOptions);
-    if (moduleKind >= 5 /* ES2015 */ && moduleKind <= 99 /* ESNext */ || getImpliedNodeFormatForEmitWorker(sourceFile, compilerOptions) === 99 /* ESNext */) {
-      const helpers = getEmitHelpers(sourceFile);
+    const impliedModuleKind = getImpliedNodeFormatForEmitWorker(sourceFile, compilerOptions);
+    const helpers = getImportedHelpers(sourceFile);
+    if (moduleKind >= 5 /* ES2015 */ && moduleKind <= 99 /* ESNext */ || impliedModuleKind === 99 /* ESNext */ || impliedModuleKind === void 0 && moduleKind === 200 /* Preserve */) {
       if (helpers) {
         const helperNames = [];
         for (const helper of helpers) {
-          if (!helper.scoped) {
-            const importName = helper.importName;
-            if (importName) {
-              pushIfUnique(helperNames, importName);
-            }
+          const importName = helper.importName;
+          if (importName) {
+            pushIfUnique(helperNames, importName);
           }
         }
         if (some(helperNames)) {
           helperNames.sort(compareStringsCaseSensitive);
-          namedBindings = nodeFactory.createNamedImports(
+          const namedBindings = nodeFactory.createNamedImports(
             map(helperNames, (name) => isFileLevelUniqueName(sourceFile, name) ? nodeFactory.createImportSpecifier(
               /*isTypeOnly*/
               false,
@@ -27053,57 +27055,54 @@ function createExternalHelpersImportDeclarationIfNeeded(nodeFactory, helperFacto
           const parseNode = getOriginalNode(sourceFile, isSourceFile);
           const emitNode = getOrCreateEmitNode(parseNode);
           emitNode.externalHelpers = true;
+          const externalHelpersImportDeclaration = nodeFactory.createImportDeclaration(
+            /*modifiers*/
+            void 0,
+            nodeFactory.createImportClause(
+              /*isTypeOnly*/
+              false,
+              /*name*/
+              void 0,
+              namedBindings
+            ),
+            nodeFactory.createStringLiteral(externalHelpersModuleNameText),
+            /*attributes*/
+            void 0
+          );
+          addInternalEmitFlags(externalHelpersImportDeclaration, 2 /* NeverApplyImportHelper */);
+          return externalHelpersImportDeclaration;
         }
       }
     } else {
-      const externalHelpersModuleName = getOrCreateExternalHelpersModuleNameIfNeeded(nodeFactory, sourceFile, compilerOptions, hasExportStarsToExportValues, hasImportStar || hasImportDefault);
+      const externalHelpersModuleName = getOrCreateExternalHelpersModuleNameIfNeeded(nodeFactory, sourceFile, compilerOptions, helpers, hasExportStarsToExportValues, hasImportStar || hasImportDefault);
       if (externalHelpersModuleName) {
-        namedBindings = nodeFactory.createNamespaceImport(externalHelpersModuleName);
-      }
-    }
-    if (namedBindings) {
-      const externalHelpersImportDeclaration = nodeFactory.createImportDeclaration(
-        /*modifiers*/
-        void 0,
-        nodeFactory.createImportClause(
+        const externalHelpersImportDeclaration = nodeFactory.createImportEqualsDeclaration(
+          /*modifiers*/
+          void 0,
           /*isTypeOnly*/
           false,
-          /*name*/
-          void 0,
-          namedBindings
-        ),
-        nodeFactory.createStringLiteral(externalHelpersModuleNameText),
-        /*attributes*/
-        void 0
-      );
-      addInternalEmitFlags(externalHelpersImportDeclaration, 2 /* NeverApplyImportHelper */);
-      return externalHelpersImportDeclaration;
+          externalHelpersModuleName,
+          nodeFactory.createExternalModuleReference(nodeFactory.createStringLiteral(externalHelpersModuleNameText))
+        );
+        addInternalEmitFlags(externalHelpersImportDeclaration, 2 /* NeverApplyImportHelper */);
+        return externalHelpersImportDeclaration;
+      }
     }
   }
 }
-function getOrCreateExternalHelpersModuleNameIfNeeded(factory2, node, compilerOptions, hasExportStarsToExportValues, hasImportStarOrImportDefault) {
-  if (compilerOptions.importHelpers && isEffectiveExternalModule(node, compilerOptions)) {
-    const externalHelpersModuleName = getExternalHelpersModuleName(node);
-    if (externalHelpersModuleName) {
-      return externalHelpersModuleName;
-    }
-    let create = (hasExportStarsToExportValues || getESModuleInterop(compilerOptions) && hasImportStarOrImportDefault) && getEmitModuleFormatOfFileWorker(node, compilerOptions) < 4 /* System */;
-    if (!create) {
-      const helpers = getEmitHelpers(node);
-      if (helpers) {
-        for (const helper of helpers) {
-          if (!helper.scoped) {
-            create = true;
-            break;
-          }
-        }
-      }
-    }
-    if (create) {
-      const parseNode = getOriginalNode(node, isSourceFile);
-      const emitNode = getOrCreateEmitNode(parseNode);
-      return emitNode.externalHelpersModuleName || (emitNode.externalHelpersModuleName = factory2.createUniqueName(externalHelpersModuleNameText));
-    }
+function getImportedHelpers(sourceFile) {
+  return filter(getEmitHelpers(sourceFile), (helper) => !helper.scoped);
+}
+function getOrCreateExternalHelpersModuleNameIfNeeded(factory2, node, compilerOptions, helpers, hasExportStarsToExportValues, hasImportStarOrImportDefault) {
+  const externalHelpersModuleName = getExternalHelpersModuleName(node);
+  if (externalHelpersModuleName) {
+    return externalHelpersModuleName;
+  }
+  const create = some(helpers) || (hasExportStarsToExportValues || getESModuleInterop(compilerOptions) && hasImportStarOrImportDefault) && getEmitModuleFormatOfFileWorker(node, compilerOptions) < 4 /* System */;
+  if (create) {
+    const parseNode = getOriginalNode(node, isSourceFile);
+    const emitNode = getOrCreateEmitNode(parseNode);
+    return emitNode.externalHelpersModuleName || (emitNode.externalHelpersModuleName = factory2.createUniqueName(externalHelpersModuleNameText));
   }
 }
 function getLocalNameForExternalImport(factory2, node, sourceFile) {
@@ -36261,15 +36260,6 @@ var commandOptionsWithoutBuild = [
     paramType: Diagnostics.FILE_OR_DIRECTORY,
     description: Diagnostics.Compile_the_project_given_the_path_to_its_configuration_file_or_to_a_folder_with_a_tsconfig_json
   },
-  {
-    name: "build",
-    type: "boolean",
-    shortName: "b",
-    showInSimplifiedHelpView: true,
-    category: Diagnostics.Command_line_Options,
-    description: Diagnostics.Build_one_or_more_projects_and_their_dependencies_if_out_of_date,
-    defaultValueDescription: false
-  },
   {
     name: "showConfig",
     type: "boolean",
@@ -37254,7 +37244,17 @@ var commandLineOptionOfCustomType = optionDeclarations.filter(isCommandLineOptio
 function isCommandLineOptionOfCustomType(option) {
   return !isString(option.type);
 }
+var tscBuildOption = {
+  name: "build",
+  type: "boolean",
+  shortName: "b",
+  showInSimplifiedHelpView: true,
+  category: Diagnostics.Command_line_Options,
+  description: Diagnostics.Build_one_or_more_projects_and_their_dependencies_if_out_of_date,
+  defaultValueDescription: false
+};
 var optionsForBuild = [
+  tscBuildOption,
   {
     name: "verbose",
     shortName: "v",
@@ -37390,8 +37390,14 @@ function getOptionName(option) {
 }
 function createUnknownOptionError(unknownOption, diagnostics, unknownOptionErrorText, node, sourceFile) {
   var _a;
-  if ((_a = diagnostics.alternateMode) == null ? void 0 : _a.getOptionsNameMap().optionsNameMap.has(unknownOption.toLowerCase())) {
-    return createDiagnosticForNodeInSourceFileOrCompilerDiagnostic(sourceFile, node, diagnostics.alternateMode.diagnostic, unknownOption);
+  const otherOption = (_a = diagnostics.alternateMode) == null ? void 0 : _a.getOptionsNameMap().optionsNameMap.get(unknownOption.toLowerCase());
+  if (otherOption) {
+    return createDiagnosticForNodeInSourceFileOrCompilerDiagnostic(
+      sourceFile,
+      node,
+      otherOption !== tscBuildOption ? diagnostics.alternateMode.diagnostic : Diagnostics.Option_build_must_be_the_first_command_line_argument,
+      unknownOption
+    );
   }
   const possibleOption = getSpellingSuggestion(unknownOption, diagnostics.optionDeclarations, getOptionName);
   return possibleOption ? createDiagnosticForNodeInSourceFileOrCompilerDiagnostic(sourceFile, node, diagnostics.unknownDidYouMeanDiagnostic, unknownOptionErrorText || unknownOption, possibleOption.name) : createDiagnosticForNodeInSourceFileOrCompilerDiagnostic(sourceFile, node, diagnostics.unknownOptionDiagnostic, unknownOptionErrorText || unknownOption);
@@ -37577,10 +37583,10 @@ var buildOptionsDidYouMeanDiagnostics = {
   unknownDidYouMeanDiagnostic: Diagnostics.Unknown_build_option_0_Did_you_mean_1,
   optionTypeMismatchDiagnostic: Diagnostics.Build_option_0_requires_a_value_of_type_1
 };
-function parseBuildCommand(args) {
+function parseBuildCommand(commandLine) {
   const { options, watchOptions, fileNames: projects, errors } = parseCommandLineWorker(
     buildOptionsDidYouMeanDiagnostics,
-    args
+    commandLine
   );
   const buildOptions = options;
   if (projects.length === 0) {
@@ -38504,7 +38510,7 @@ function parseConfig(json, sourceFile, host, basePath, configFileName, resolutio
     if (ownConfig.raw.compileOnSave === void 0 && result.compileOnSave) ownConfig.raw.compileOnSave = result.compileOnSave;
     if (sourceFile && result.extendedSourceFiles) sourceFile.extendedSourceFiles = arrayFrom(result.extendedSourceFiles.keys());
     ownConfig.options = assign(result.options, ownConfig.options);
-    ownConfig.watchOptions = ownConfig.watchOptions && result.watchOptions ? assign(result.watchOptions, ownConfig.watchOptions) : ownConfig.watchOptions || result.watchOptions;
+    ownConfig.watchOptions = ownConfig.watchOptions && result.watchOptions ? assignWatchOptions(result, ownConfig.watchOptions) : ownConfig.watchOptions || result.watchOptions;
   }
   return ownConfig;
   function applyExtendedConfig(result, extendedConfigPath) {
@@ -38528,9 +38534,14 @@ function parseConfig(json, sourceFile, host, basePath, configFileName, resolutio
         result.compileOnSave = extendsRaw.compileOnSave;
       }
       assign(result.options, extendedConfig.options);
-      result.watchOptions = result.watchOptions && extendedConfig.watchOptions ? assign({}, result.watchOptions, extendedConfig.watchOptions) : result.watchOptions || extendedConfig.watchOptions;
+      result.watchOptions = result.watchOptions && extendedConfig.watchOptions ? assignWatchOptions(result, extendedConfig.watchOptions) : result.watchOptions || extendedConfig.watchOptions;
     }
   }
+  function assignWatchOptions(result, watchOptions) {
+    if (result.watchOptionsCopied) return assign(result.watchOptions, watchOptions);
+    result.watchOptionsCopied = true;
+    return assign({}, result.watchOptions, watchOptions);
+  }
 }
 function parseOwnConfigOfJson(json, host, basePath, configFileName, errors) {
   if (hasProperty(json, "excludes")) {
@@ -40498,7 +40509,8 @@ function getTemporaryModuleResolutionState(packageJsonInfoCache, host, options)
   };
 }
 function getPackageScopeForPath(directory, state) {
-  return forEachAncestorDirectory(
+  return forEachAncestorDirectoryStoppingAtGlobalCache(
+    state.host,
     directory,
     (dir) => getPackageJsonInfo(
       dir,
@@ -41137,17 +41149,30 @@ function loadModuleFromNearestNodeModulesDirectoryWorker(extensions, moduleName,
     return lookup(secondaryExtensions);
   }
   function lookup(extensions2) {
-    return forEachAncestorDirectory(normalizeSlashes(directory), (ancestorDirectory) => {
-      if (getBaseFileName(ancestorDirectory) !== "node_modules") {
-        const resolutionFromCache = tryFindNonRelativeModuleNameInCache(cache, moduleName, mode, ancestorDirectory, redirectedReference, state);
-        if (resolutionFromCache) {
-          return resolutionFromCache;
+    return forEachAncestorDirectoryStoppingAtGlobalCache(
+      state.host,
+      normalizeSlashes(directory),
+      (ancestorDirectory) => {
+        if (getBaseFileName(ancestorDirectory) !== "node_modules") {
+          const resolutionFromCache = tryFindNonRelativeModuleNameInCache(cache, moduleName, mode, ancestorDirectory, redirectedReference, state);
+          if (resolutionFromCache) {
+            return resolutionFromCache;
+          }
+          return toSearchResult(loadModuleFromImmediateNodeModulesDirectory(extensions2, moduleName, ancestorDirectory, state, typesScopeOnly, cache, redirectedReference));
         }
-        return toSearchResult(loadModuleFromImmediateNodeModulesDirectory(extensions2, moduleName, ancestorDirectory, state, typesScopeOnly, cache, redirectedReference));
       }
-    });
+    );
   }
 }
+function forEachAncestorDirectoryStoppingAtGlobalCache(host, directory, callback) {
+  var _a;
+  const globalCache = (_a = host == null ? void 0 : host.getGlobalTypingsCacheLocation) == null ? void 0 : _a.call(host);
+  return forEachAncestorDirectory(directory, (ancestorDirectory) => {
+    const result = callback(ancestorDirectory);
+    if (result !== void 0) return result;
+    if (ancestorDirectory === globalCache) return false;
+  }) || void 0;
+}
 function loadModuleFromImmediateNodeModulesDirectory(extensions, moduleName, directory, state, typesScopeOnly, cache, redirectedReference) {
   const nodeModulesFolder = combinePaths(directory, "node_modules");
   const nodeModulesFolderExists = directoryProbablyExists(nodeModulesFolder, state.host);
@@ -41343,28 +41368,32 @@ function classicNameResolver(moduleName, containingFile, compilerOptions, host,
       return { value: resolvedUsingSettings };
     }
     if (!isExternalModuleNameRelative(moduleName)) {
-      const resolved2 = forEachAncestorDirectory(containingDirectory, (directory) => {
-        const resolutionFromCache = tryFindNonRelativeModuleNameInCache(
-          cache,
-          moduleName,
-          /*mode*/
-          void 0,
-          directory,
-          redirectedReference,
-          state
-        );
-        if (resolutionFromCache) {
-          return resolutionFromCache;
-        }
-        const searchName = normalizePath(combinePaths(directory, moduleName));
-        return toSearchResult(loadModuleFromFileNoPackageId(
-          extensions,
-          searchName,
-          /*onlyRecordFailures*/
-          false,
-          state
-        ));
-      });
+      const resolved2 = forEachAncestorDirectoryStoppingAtGlobalCache(
+        state.host,
+        containingDirectory,
+        (directory) => {
+          const resolutionFromCache = tryFindNonRelativeModuleNameInCache(
+            cache,
+            moduleName,
+            /*mode*/
+            void 0,
+            directory,
+            redirectedReference,
+            state
+          );
+          if (resolutionFromCache) {
+            return resolutionFromCache;
+          }
+          const searchName = normalizePath(combinePaths(directory, moduleName));
+          return toSearchResult(loadModuleFromFileNoPackageId(
+            extensions,
+            searchName,
+            /*onlyRecordFailures*/
+            false,
+            state
+          ));
+        }
+      );
       if (resolved2) return resolved2;
       if (extensions & (1 /* TypeScript */ | 4 /* Declaration */)) {
         let resolved3 = loadModuleFromNearestNodeModulesDirectoryTypesScope(moduleName, containingDirectory, state);
@@ -44886,9 +44915,11 @@ function getNearestAncestorDirectoryWithPackageJson(host, fileName) {
   if (host.getNearestAncestorDirectoryWithPackageJson) {
     return host.getNearestAncestorDirectoryWithPackageJson(fileName);
   }
-  return forEachAncestorDirectory(fileName, (directory) => {
-    return host.fileExists(combinePaths(directory, "package.json")) ? directory : void 0;
-  });
+  return forEachAncestorDirectoryStoppingAtGlobalCache(
+    host,
+    fileName,
+    (directory) => host.fileExists(combinePaths(directory, "package.json")) ? directory : void 0
+  );
 }
 function forEachFileNameOfModule(importingFileName, importedFileName, host, preferSymlinks, cb) {
   var _a;
@@ -44906,25 +44937,29 @@ function forEachFileNameOfModule(importingFileName, importedFileName, host, pref
   }
   const symlinkedDirectories = (_a = host.getSymlinkCache) == null ? void 0 : _a.call(host).getSymlinkedDirectoriesByRealpath();
   const fullImportedFileName = getNormalizedAbsolutePath(importedFileName, cwd);
-  const result = symlinkedDirectories && forEachAncestorDirectory(getDirectoryPath(fullImportedFileName), (realPathDirectory) => {
-    const symlinkDirectories = symlinkedDirectories.get(ensureTrailingDirectorySeparator(toPath(realPathDirectory, cwd, getCanonicalFileName)));
-    if (!symlinkDirectories) return void 0;
-    if (startsWithDirectory(importingFileName, realPathDirectory, getCanonicalFileName)) {
-      return false;
-    }
-    return forEach(targets, (target) => {
-      if (!startsWithDirectory(target, realPathDirectory, getCanonicalFileName)) {
-        return;
-      }
-      const relative = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
-      for (const symlinkDirectory of symlinkDirectories) {
-        const option = resolvePath(symlinkDirectory, relative);
-        const result2 = cb(option, target === referenceRedirect);
-        shouldFilterIgnoredPaths = true;
-        if (result2) return result2;
+  const result = symlinkedDirectories && forEachAncestorDirectoryStoppingAtGlobalCache(
+    host,
+    getDirectoryPath(fullImportedFileName),
+    (realPathDirectory) => {
+      const symlinkDirectories = symlinkedDirectories.get(ensureTrailingDirectorySeparator(toPath(realPathDirectory, cwd, getCanonicalFileName)));
+      if (!symlinkDirectories) return void 0;
+      if (startsWithDirectory(importingFileName, realPathDirectory, getCanonicalFileName)) {
+        return false;
       }
-    });
-  });
+      return forEach(targets, (target) => {
+        if (!startsWithDirectory(target, realPathDirectory, getCanonicalFileName)) {
+          return;
+        }
+        const relative = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
+        for (const symlinkDirectory of symlinkDirectories) {
+          const option = resolvePath(symlinkDirectory, relative);
+          const result2 = cb(option, target === referenceRedirect);
+          shouldFilterIgnoredPaths = true;
+          if (result2) return result2;
+        }
+      });
+    }
+  );
   return result || (preferSymlinks ? forEach(targets, (p) => shouldFilterIgnoredPaths && containsIgnoredPath(p) ? void 0 : cb(p, p === referenceRedirect)) : void 0);
 }
 var runtimeDependencyFields = ["dependencies", "peerDependencies", "optionalDependencies"];
@@ -88698,7 +88733,8 @@ function createBasicNodeBuilderModuleSpecifierResolutionHost(host) {
     getFileIncludeReasons: () => host.getFileIncludeReasons(),
     readFile: host.readFile ? (fileName) => host.readFile(fileName) : void 0,
     getDefaultResolutionModeForFile: (file) => host.getDefaultResolutionModeForFile(file),
-    getModeForResolutionAtIndex: (file, index) => host.getModeForResolutionAtIndex(file, index)
+    getModeForResolutionAtIndex: (file, index) => host.getModeForResolutionAtIndex(file, index),
+    getGlobalTypingsCacheLocation: maybeBind(host, host.getGlobalTypingsCacheLocation)
   };
 }
 var SymbolTrackerImpl = class _SymbolTrackerImpl {
@@ -111107,6 +111143,7 @@ function transformECMAScriptModule(context) {
   context.onSubstituteNode = onSubstituteNode;
   context.enableEmitNotification(307 /* SourceFile */);
   context.enableSubstitution(80 /* Identifier */);
+  const noSubstitution = /* @__PURE__ */ new Set();
   let helperNameSubstitutions;
   let currentSourceFile;
   let importRequireStatements;
@@ -111141,7 +111178,7 @@ function transformECMAScriptModule(context) {
     if (externalHelpersImportDeclaration) {
       const statements = [];
       const statementOffset = factory2.copyPrologue(node.statements, statements);
-      append(statements, externalHelpersImportDeclaration);
+      addRange(statements, visitArray([externalHelpersImportDeclaration], visitor, isStatement));
       addRange(statements, visitNodes2(node.statements, visitor, isStatement, statementOffset));
       return factory2.updateSourceFile(
         node,
@@ -111356,7 +111393,9 @@ function transformECMAScriptModule(context) {
       if ((isExternalModule(node) || getIsolatedModules(compilerOptions)) && compilerOptions.importHelpers) {
         helperNameSubstitutions = /* @__PURE__ */ new Map();
       }
+      currentSourceFile = node;
       previousOnEmitNode(hint, node, emitCallback);
+      currentSourceFile = void 0;
       helperNameSubstitutions = void 0;
     } else {
       previousOnEmitNode(hint, node, emitCallback);
@@ -111364,18 +111403,29 @@ function transformECMAScriptModule(context) {
   }
   function onSubstituteNode(hint, node) {
     node = previousOnSubstituteNode(hint, node);
-    if (helperNameSubstitutions && isIdentifier(node) && getEmitFlags(node) & 8192 /* HelperName */) {
+    if (node.id && noSubstitution.has(node.id)) {
+      return node;
+    }
+    if (isIdentifier(node) && getEmitFlags(node) & 8192 /* HelperName */) {
       return substituteHelperName(node);
     }
     return node;
   }
   function substituteHelperName(node) {
-    const name = idText(node);
-    let substitution = helperNameSubstitutions.get(name);
-    if (!substitution) {
-      helperNameSubstitutions.set(name, substitution = factory2.createUniqueName(name, 16 /* Optimistic */ | 32 /* FileLevel */));
+    const externalHelpersModuleName = currentSourceFile && getExternalHelpersModuleName(currentSourceFile);
+    if (externalHelpersModuleName) {
+      noSubstitution.add(getNodeId(node));
+      return factory2.createPropertyAccessExpression(externalHelpersModuleName, node);
+    }
+    if (helperNameSubstitutions) {
+      const name = idText(node);
+      let substitution = helperNameSubstitutions.get(name);
+      if (!substitution) {
+        helperNameSubstitutions.set(name, substitution = factory2.createUniqueName(name, 16 /* Optimistic */ | 32 /* FileLevel */));
+      }
+      return substitution;
     }
-    return substitution;
+    return node;
   }
 }
 
@@ -120638,7 +120688,8 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
     getCanonicalFileName,
     getFileIncludeReasons: () => fileReasons,
     structureIsReused,
-    writeFile: writeFile2
+    writeFile: writeFile2,
+    getGlobalTypingsCacheLocation: maybeBind(host, host.getGlobalTypingsCacheLocation)
   };
   onProgramCreateComplete();
   verifyCompilerOptions();
@@ -121204,7 +121255,8 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       getFileIncludeReasons: program.getFileIncludeReasons,
       createHash: maybeBind(host, host.createHash),
       getModuleResolutionCache: () => program.getModuleResolutionCache(),
-      trace: maybeBind(host, host.trace)
+      trace: maybeBind(host, host.trace),
+      getGlobalTypingsCacheLocation: program.getGlobalTypingsCacheLocation
     };
   }
   function writeFile2(fileName, text, writeByteOrderMark, onError, sourceFiles, data) {
@@ -125510,6 +125562,9 @@ function canWatchDirectoryOrFile(pathComponents2, length2) {
   const perceivedOsRootLength = perceivedOsRootLengthForWatching(pathComponents2, length2);
   return length2 > perceivedOsRootLength + 1;
 }
+function canWatchDirectoryOrFilePath(path) {
+  return canWatchDirectoryOrFile(getPathComponents(path));
+}
 function canWatchAtTypes(atTypes) {
   return canWatchAffectedPackageJsonOrNodeModulesOfAtTypes(getDirectoryPath(atTypes));
 }
@@ -125521,12 +125576,12 @@ function isInDirectoryPath(dirComponents, fileOrDirComponents) {
   return true;
 }
 function canWatchAffectedPackageJsonOrNodeModulesOfAtTypes(fileOrDirPath) {
-  return canWatchDirectoryOrFile(getPathComponents(fileOrDirPath));
+  return canWatchDirectoryOrFilePath(fileOrDirPath);
 }
 function canWatchAffectingLocation(filePath) {
   return canWatchAffectedPackageJsonOrNodeModulesOfAtTypes(filePath);
 }
-function getDirectoryToWatchFailedLookupLocation(failedLookupLocation, failedLookupLocationPath, rootDir, rootPath, rootPathComponents, getCurrentDirectory, preferNonRecursiveWatch) {
+function getDirectoryToWatchFailedLookupLocation(failedLookupLocation, failedLookupLocationPath, rootDir, rootPath, rootPathComponents, isRootWatchable, getCurrentDirectory, preferNonRecursiveWatch) {
   const failedLookupPathComponents = getPathComponents(failedLookupLocationPath);
   failedLookupLocation = isRootedDiskPath(failedLookupLocation) ? normalizePath(failedLookupLocation) : getNormalizedAbsolutePath(failedLookupLocation, getCurrentDirectory());
   const failedLookupComponents = getPathComponents(failedLookupLocation);
@@ -125535,7 +125590,7 @@ function getDirectoryToWatchFailedLookupLocation(failedLookupLocation, failedLoo
   const nodeModulesIndex = failedLookupPathComponents.indexOf("node_modules");
   if (nodeModulesIndex !== -1 && nodeModulesIndex + 1 <= perceivedOsRootLength + 1) return void 0;
   const lastNodeModulesIndex = failedLookupPathComponents.lastIndexOf("node_modules");
-  if (isInDirectoryPath(rootPathComponents, failedLookupPathComponents)) {
+  if (isRootWatchable && isInDirectoryPath(rootPathComponents, failedLookupPathComponents)) {
     if (failedLookupPathComponents.length > rootPathComponents.length + 1) {
       return getDirectoryOfFailedLookupWatch(
         failedLookupComponents,
@@ -125607,9 +125662,9 @@ function getDirectoryOfFailedLookupWatch(dirComponents, dirPathComponents, lengt
     packageDirPath: packageDirLength !== void 0 ? getPathFromPathComponents(dirPathComponents, packageDirLength) : void 0
   };
 }
-function getDirectoryToWatchFailedLookupLocationFromTypeRoot(typeRoot, typeRootPath, rootPath, rootPathComponents, getCurrentDirectory, preferNonRecursiveWatch, filterCustomPath) {
+function getDirectoryToWatchFailedLookupLocationFromTypeRoot(typeRoot, typeRootPath, rootPath, rootPathComponents, isRootWatchable, getCurrentDirectory, preferNonRecursiveWatch, filterCustomPath) {
   const typeRootPathComponents = getPathComponents(typeRootPath);
-  if (isInDirectoryPath(rootPathComponents, typeRootPathComponents)) {
+  if (isRootWatchable && isInDirectoryPath(rootPathComponents, typeRootPathComponents)) {
     return rootPath;
   }
   typeRoot = isRootedDiskPath(typeRoot) ? normalizePath(typeRoot) : getNormalizedAbsolutePath(typeRoot, getCurrentDirectory());
@@ -125650,10 +125705,10 @@ function createModuleResolutionLoaderUsingGlobalCache(containingFile, redirected
 function resolveModuleNameUsingGlobalCache(resolutionHost, moduleResolutionCache, moduleName, containingFile, compilerOptions, redirectedReference, mode) {
   const host = getModuleResolutionHost(resolutionHost);
   const primaryResult = resolveModuleName(moduleName, containingFile, compilerOptions, host, moduleResolutionCache, redirectedReference, mode);
-  if (!resolutionHost.getGlobalCache) {
+  if (!resolutionHost.getGlobalTypingsCacheLocation) {
     return primaryResult;
   }
-  const globalCache = resolutionHost.getGlobalCache();
+  const globalCache = resolutionHost.getGlobalTypingsCacheLocation();
   if (globalCache !== void 0 && !isExternalModuleNameRelative(moduleName) && !(primaryResult.resolvedModule && extensionIsTS(primaryResult.resolvedModule.extension))) {
     const { resolvedModule, failedLookupLocations, affectingLocations, resolutionDiagnostics } = loadModuleFromGlobalCache(
       Debug.checkDefined(resolutionHost.globalCacheResolutionModuleName)(moduleName),
@@ -125717,6 +125772,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
   const rootDir = getRootDirectoryOfResolutionCache(rootDirForResolution, getCurrentDirectory);
   const rootPath = resolutionHost.toPath(rootDir);
   const rootPathComponents = getPathComponents(rootPath);
+  const isRootWatchable = canWatchDirectoryOrFile(rootPathComponents);
   const isSymlinkCache = /* @__PURE__ */ new Map();
   const packageDirWatchers = /* @__PURE__ */ new Map();
   const dirPathToSymlinkPackageRefCount = /* @__PURE__ */ new Map();
@@ -126128,6 +126184,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
       rootDir,
       rootPath,
       rootPathComponents,
+      isRootWatchable,
       getCurrentDirectory,
       resolutionHost.preferNonRecursiveWatch
     );
@@ -126316,6 +126373,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
       rootDir,
       rootPath,
       rootPathComponents,
+      isRootWatchable,
       getCurrentDirectory,
       resolutionHost.preferNonRecursiveWatch
     );
@@ -126459,6 +126517,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
           return false;
         }
         (failedLookupChecks || (failedLookupChecks = /* @__PURE__ */ new Set())).add(fileOrDirectoryPath);
+        (startsWithPathChecks || (startsWithPathChecks = /* @__PURE__ */ new Set())).add(fileOrDirectoryPath);
         const packagePath = parseNodeModuleFromPath(
           fileOrDirectoryPath,
           /*isFolder*/
@@ -126540,6 +126599,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
         resolutionHost.toPath(typeRoot),
         rootPath,
         rootPathComponents,
+        isRootWatchable,
         getCurrentDirectory,
         resolutionHost.preferNonRecursiveWatch,
         (dirPath2) => directoryWatchesOfFailedLookups.has(dirPath2) || dirPathToSymlinkPackageRefCount.has(dirPath2)
@@ -127272,6 +127332,7 @@ function createWatchProgram(host) {
   let updateLevel;
   let missingFilesMap;
   let watchedWildcardDirectories;
+  let staleWatches = /* @__PURE__ */ new Map([[void 0, void 0]]);
   let timerToUpdateProgram;
   let timerToInvalidateFailedLookupResolutions;
   let parsedConfigs;
@@ -127360,8 +127421,6 @@ function createWatchProgram(host) {
   const customHasInvalidLibResolutions = host.resolveLibrary ? maybeBind(host, host.hasInvalidatedLibResolutions) || returnTrue : returnFalse;
   builderProgram = readBuilderProgram(compilerOptions, compilerHost);
   synchronizeProgram();
-  watchConfigFileWildCardDirectories();
-  if (configFileName) updateExtendedConfigFilesWatches(toPath3(configFileName), compilerOptions, watchOptions, WatchType.ExtendedConfigFile);
   return configFileName ? { getCurrentProgram: getCurrentBuilderProgram, getProgram: updateProgram, close, getResolutionCache } : { getCurrentProgram: getCurrentBuilderProgram, getProgram: updateProgram, updateRootFileNames, close, getResolutionCache };
   function close() {
     clearInvalidateResolutionsOfFailedLookupLocations();
@@ -127464,6 +127523,16 @@ function createWatchProgram(host) {
     compilerHost.directoryExists = originalDirectoryExists;
     compilerHost.createDirectory = originalCreateDirectory;
     compilerHost.writeFile = originalWriteFile;
+    staleWatches == null ? void 0 : staleWatches.forEach((configFile, configPath) => {
+      if (!configPath) {
+        watchConfigFileWildCardDirectories();
+        if (configFileName) updateExtendedConfigFilesWatches(toPath3(configFileName), compilerOptions, watchOptions, WatchType.ExtendedConfigFile);
+      } else {
+        const config = parsedConfigs == null ? void 0 : parsedConfigs.get(configPath);
+        if (config) watchReferencedProject(configFile, configPath, config);
+      }
+    });
+    staleWatches = void 0;
     return builderProgram;
   }
   function createNewProgram(hasInvalidatedResolutions, hasInvalidatedLibResolutions) {
@@ -127670,9 +127739,8 @@ function createWatchProgram(host) {
     }
     parseConfigFile2();
     hasChangedCompilerOptions = true;
+    (staleWatches ?? (staleWatches = /* @__PURE__ */ new Map())).set(void 0, void 0);
     synchronizeProgram();
-    watchConfigFileWildCardDirectories();
-    updateExtendedConfigFilesWatches(toPath3(configFileName), compilerOptions, watchOptions, WatchType.ExtendedConfigFile);
   }
   function parseConfigFile2() {
     Debug.assert(configFileName);
@@ -127724,7 +127792,7 @@ function createWatchProgram(host) {
     } else {
       (parsedConfigs || (parsedConfigs = /* @__PURE__ */ new Map())).set(configPath, config = { parsedCommandLine });
     }
-    watchReferencedProject(configFileName2, configPath, config);
+    (staleWatches ?? (staleWatches = /* @__PURE__ */ new Map())).set(configPath, configFileName2);
     return parsedCommandLine;
   }
   function getParsedCommandLineFromConfigFileHost(configFileName2) {
@@ -129709,7 +129777,7 @@ function shouldBePretty(sys2, options) {
   return options.pretty;
 }
 function getOptionsForHelp(commandLine) {
-  return !!commandLine.options.all ? toSorted(optionDeclarations, (a, b) => compareStringsCaseInsensitive(a.name, b.name)) : filter(optionDeclarations.slice(), (v) => !!v.showInSimplifiedHelpView);
+  return !!commandLine.options.all ? toSorted(optionDeclarations.concat(tscBuildOption), (a, b) => compareStringsCaseInsensitive(a.name, b.name)) : filter(optionDeclarations.concat(tscBuildOption), (v) => !!v.showInSimplifiedHelpView);
 }
 function printVersion(sys2) {
   sys2.write(getDiagnosticText(Diagnostics.Version_0, version) + sys2.newLine);
@@ -130033,7 +130101,7 @@ function printAllHelp(sys2, compilerOptions, buildOptions, watchOptions) {
   output = [...output, ...generateSectionOptionsOutput(
     sys2,
     getDiagnosticText(Diagnostics.BUILD_OPTIONS),
-    buildOptions,
+    filter(buildOptions, (option) => option !== tscBuildOption),
     /*subCategory*/
     false,
     formatMessage(Diagnostics.Using_build_b_will_make_tsc_behave_more_like_a_build_orchestrator_than_a_compiler_This_is_used_to_trigger_building_composite_projects_which_you_can_learn_more_about_at_0, "https://aka.ms/tsc-composite-builds")
@@ -130047,7 +130115,7 @@ function printBuildHelp(sys2, buildOptions) {
   output = [...output, ...generateSectionOptionsOutput(
     sys2,
     getDiagnosticText(Diagnostics.BUILD_OPTIONS),
-    buildOptions,
+    filter(buildOptions, (option) => option !== tscBuildOption),
     /*subCategory*/
     false,
     formatMessage(Diagnostics.Using_build_b_will_make_tsc_behave_more_like_a_build_orchestrator_than_a_compiler_This_is_used_to_trigger_building_composite_projects_which_you_can_learn_more_about_at_0, "https://aka.ms/tsc-composite-builds")
@@ -130084,10 +130152,6 @@ function printHelp(sys2, commandLine) {
 }
 function executeCommandLineWorker(sys2, cb, commandLine) {
   let reportDiagnostic = createDiagnosticReporter(sys2);
-  if (commandLine.options.build) {
-    reportDiagnostic(createCompilerDiagnostic(Diagnostics.Option_build_must_be_the_first_command_line_argument));
-    return sys2.exit(1 /* DiagnosticsPresent_OutputsSkipped */);
-  }
   let configFileName;
   if (commandLine.options.locale) {
     validateLocaleAndSetLanguage(commandLine.options.locale, sys2, commandLine.errors);
@@ -130233,16 +130297,16 @@ function executeCommandLineWorker(sys2, cb, commandLine) {
     }
   }
 }
-function isBuild(commandLineArgs) {
+function isBuildCommand(commandLineArgs) {
   if (commandLineArgs.length > 0 && commandLineArgs[0].charCodeAt(0) === 45 /* minus */) {
     const firstOption = commandLineArgs[0].slice(commandLineArgs[0].charCodeAt(1) === 45 /* minus */ ? 2 : 1).toLowerCase();
-    return firstOption === "build" || firstOption === "b";
+    return firstOption === tscBuildOption.name || firstOption === tscBuildOption.shortName;
   }
   return false;
 }
 function executeCommandLine(system, cb, commandLineArgs) {
-  if (isBuild(commandLineArgs)) {
-    const { buildOptions, watchOptions, projects, errors } = parseBuildCommand(commandLineArgs.slice(1));
+  if (isBuildCommand(commandLineArgs)) {
+    const { buildOptions, watchOptions, projects, errors } = parseBuildCommand(commandLineArgs);
     if (buildOptions.generateCpuProfile && system.enableCPUProfiler) {
       system.enableCPUProfiler(buildOptions.generateCpuProfile, () => performBuild(
         system,