@rushstack/heft-typescript-plugin 1.1.14 → 1.2.1

package/lib-esm/fileSystem/TypeScriptCachedFileSystem.js

@@ -0,0 +1,159 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { Encoding, Text, FileSystem, Sort } from '@rushstack/node-core-library';
+/**
+ * This is a FileSystem API (largely unrelated to the @rushstack/node-core-library FileSystem API)
+ * that provides caching to the Heft TypeScriptBuilder.
+ * It uses an in-memory cache to avoid requests against the disk. It assumes that the disk stays
+ * static after construction, except for writes performed through the TypeScriptCachedFileSystem
+ * instance.
+ */
+export class TypeScriptCachedFileSystem {
+    constructor() {
+        this._statsCache = new Map();
+        this._readFolderCache = new Map();
+        this._readFileCache = new Map();
+        this._realPathCache = new Map();
+        this.exists = (path) => {
+            try {
+                this.getStatistics(path);
+                return true;
+            }
+            catch (e) {
+                if (FileSystem.isNotExistError(e)) {
+                    return false;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+        this.directoryExists = (path) => {
+            try {
+                const stats = this.getStatistics(path);
+                return stats.isDirectory();
+            }
+            catch (e) {
+                if (FileSystem.isNotExistError(e)) {
+                    return false;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+        this.getStatistics = (path) => {
+            return this._withCaching(path, FileSystem.getStatistics, this._statsCache);
+        };
+        this.ensureFolder = (folderPath) => {
+            var _a, _b;
+            if (!((_a = this._readFolderCache.get(folderPath)) === null || _a === void 0 ? void 0 : _a.entry) && !((_b = this._statsCache.get(folderPath)) === null || _b === void 0 ? void 0 : _b.entry)) {
+                FileSystem.ensureFolder(folderPath);
+                this._invalidateCacheEntry(folderPath);
+            }
+        };
+        this.ensureFolderAsync = async (folderPath) => {
+            var _a, _b;
+            if (!((_a = this._readFolderCache.get(folderPath)) === null || _a === void 0 ? void 0 : _a.entry) && !((_b = this._statsCache.get(folderPath)) === null || _b === void 0 ? void 0 : _b.entry)) {
+                await FileSystem.ensureFolderAsync(folderPath);
+                this._invalidateCacheEntry(folderPath);
+            }
+        };
+        this.writeFile = (filePath, contents, options) => {
+            FileSystem.writeFile(filePath, contents, options);
+            this._invalidateCacheEntry(filePath);
+        };
+        this.readFile = (filePath, options) => {
+            let contents = this.readFileToBuffer(filePath).toString((options === null || options === void 0 ? void 0 : options.encoding) || Encoding.Utf8);
+            if (options === null || options === void 0 ? void 0 : options.convertLineEndings) {
+                contents = Text.convertTo(contents, options.convertLineEndings);
+            }
+            return contents;
+        };
+        this.readFileToBuffer = (filePath) => {
+            return this._withCaching(filePath, FileSystem.readFileToBuffer, this._readFileCache);
+        };
+        this.copyFileAsync = async (options) => {
+            await FileSystem.copyFileAsync(options);
+            this._invalidateCacheEntry(options.destinationPath);
+        };
+        this.deleteFile = (filePath, options) => {
+            var _a;
+            const cachedError = (_a = this._statsCache.get(filePath)) === null || _a === void 0 ? void 0 : _a.error;
+            if (!cachedError || !FileSystem.isFileDoesNotExistError(cachedError)) {
+                FileSystem.deleteFile(filePath);
+                this._invalidateCacheEntry(filePath);
+            }
+            else if (options === null || options === void 0 ? void 0 : options.throwIfNotExists) {
+                throw cachedError;
+            }
+        };
+        this.createHardLinkAsync = async (options) => {
+            await FileSystem.createHardLinkAsync(options);
+            this._invalidateCacheEntry(options.newLinkPath);
+        };
+        this.getRealPath = (linkPath) => {
+            return this._withCaching(linkPath, (path) => {
+                try {
+                    return FileSystem.getRealPath(path);
+                }
+                catch (e) {
+                    if (FileSystem.isNotExistError(e)) {
+                        // TypeScript's ts.sys.realpath returns the path it's provided if that path doesn't exist
+                        return path;
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }, this._realPathCache);
+        };
+        this.readFolderFilesAndDirectories = (folderPath) => {
+            return this._withCaching(folderPath, (path) => {
+                const folderEntries = FileSystem.readFolderItems(path);
+                return this._sortFolderEntries(folderEntries);
+            }, this._readFolderCache);
+        };
+    }
+    _sortFolderEntries(folderEntries) {
+        // TypeScript expects entries sorted ordinally by name
+        // In practice this might not matter
+        folderEntries.sort((a, b) => Sort.compareByValue(a, b));
+        const files = [];
+        const directories = [];
+        for (const folderEntry of folderEntries) {
+            if (folderEntry.isFile()) {
+                files.push(folderEntry.name);
+            }
+            else if (folderEntry.isDirectory()) {
+                directories.push(folderEntry.name);
+            }
+        }
+        return { files, directories };
+    }
+    _withCaching(path, fn, cache) {
+        let cacheEntry = cache.get(path);
+        if (!cacheEntry) {
+            try {
+                cacheEntry = { entry: fn(path) };
+            }
+            catch (e) {
+                cacheEntry = { error: e, entry: undefined };
+            }
+            cache.set(path, cacheEntry);
+        }
+        if (cacheEntry.entry) {
+            return cacheEntry.entry;
+        }
+        else {
+            throw cacheEntry.error;
+        }
+    }
+    _invalidateCacheEntry(path) {
+        this._statsCache.delete(path);
+        this._readFolderCache.delete(path);
+        this._readFileCache.delete(path);
+        this._realPathCache.delete(path);
+    }
+}
+//# sourceMappingURL=TypeScriptCachedFileSystem.js.map

package/lib-esm/fileSystem/TypeScriptCachedFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptCachedFileSystem.js","sourceRoot":"","sources":["../../src/fileSystem/TypeScriptCachedFileSystem.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport {\n  Encoding,\n  Text,\n  type IFileSystemWriteFileOptions,\n  type IFileSystemReadFileOptions,\n  type IFileSystemCopyFileOptions,\n  type IFileSystemDeleteFileOptions,\n  type IFileSystemCreateLinkOptions,\n  FileSystem,\n  type FileSystemStats,\n  Sort,\n  type FolderItem\n} from '@rushstack/node-core-library';\n\nexport interface IReadFolderFilesAndDirectoriesResult {\n  files: string[];\n  directories: string[];\n}\n\ninterface ICacheEntry<TEntry> {\n  entry: TEntry | undefined;\n  error?: NodeJS.ErrnoException;\n}\n\n/**\n * This is a FileSystem API (largely unrelated to the @rushstack/node-core-library FileSystem API)\n * that provides caching to the Heft TypeScriptBuilder.\n * It uses an in-memory cache to avoid requests against the disk. It assumes that the disk stays\n * static after construction, except for writes performed through the TypeScriptCachedFileSystem\n * instance.\n */\nexport class TypeScriptCachedFileSystem {\n  private _statsCache: Map<string, ICacheEntry<FileSystemStats>> = new Map();\n  private _readFolderCache: Map<string, ICacheEntry<IReadFolderFilesAndDirectoriesResult>> = new Map();\n  private _readFileCache: Map<string, ICacheEntry<Buffer>> = new Map();\n  private _realPathCache: Map<string, ICacheEntry<string>> = new Map();\n\n  public exists: (path: string) => boolean = (path: string) => {\n    try {\n      this.getStatistics(path);\n      return true;\n    } catch (e) {\n      if (FileSystem.isNotExistError(e as Error)) {\n        return false;\n      } else {\n        throw e;\n      }\n    }\n  };\n\n  public directoryExists: (path: string) => boolean = (path: string) => {\n    try {\n      const stats: FileSystemStats = this.getStatistics(path);\n      return stats.isDirectory();\n    } catch (e) {\n      if (FileSystem.isNotExistError(e as Error)) {\n        return false;\n      } else {\n        throw e;\n      }\n    }\n  };\n\n  public getStatistics: (path: string) => FileSystemStats = (path: string) => {\n    return this._withCaching(path, FileSystem.getStatistics, this._statsCache);\n  };\n\n  public ensureFolder: (folderPath: string) => void = (folderPath: string) => {\n    if (!this._readFolderCache.get(folderPath)?.entry && !this._statsCache.get(folderPath)?.entry) {\n      FileSystem.ensureFolder(folderPath);\n      this._invalidateCacheEntry(folderPath);\n    }\n  };\n\n  public ensureFolderAsync: (folderPath: string) => Promise<void> = async (folderPath: string) => {\n    if (!this._readFolderCache.get(folderPath)?.entry && !this._statsCache.get(folderPath)?.entry) {\n      await FileSystem.ensureFolderAsync(folderPath);\n      this._invalidateCacheEntry(folderPath);\n    }\n  };\n\n  public writeFile: (\n    filePath: string,\n    contents: string | Buffer,\n    options?: IFileSystemWriteFileOptions | undefined\n  ) => void = (\n    filePath: string,\n    contents: string | Buffer,\n    options?: IFileSystemWriteFileOptions | undefined\n  ) => {\n    FileSystem.writeFile(filePath, contents, options);\n    this._invalidateCacheEntry(filePath);\n  };\n\n  public readFile: (filePath: string, options?: IFileSystemReadFileOptions | undefined) => string = (\n    filePath: string,\n    options?: IFileSystemReadFileOptions | undefined\n  ) => {\n    let contents: string = this.readFileToBuffer(filePath).toString(options?.encoding || Encoding.Utf8);\n    if (options?.convertLineEndings) {\n      contents = Text.convertTo(contents, options.convertLineEndings);\n    }\n\n    return contents;\n  };\n\n  public readFileToBuffer: (filePath: string) => Buffer = (filePath: string) => {\n    return this._withCaching(filePath, FileSystem.readFileToBuffer, this._readFileCache);\n  };\n\n  public copyFileAsync: (options: IFileSystemCopyFileOptions) => Promise<void> = async (\n    options: IFileSystemCopyFileOptions\n  ) => {\n    await FileSystem.copyFileAsync(options);\n    this._invalidateCacheEntry(options.destinationPath);\n  };\n\n  public deleteFile: (filePath: string, options?: IFileSystemDeleteFileOptions | undefined) => void = (\n    filePath: string,\n    options?: IFileSystemDeleteFileOptions | undefined\n  ) => {\n    const cachedError: Error | undefined = this._statsCache.get(filePath)?.error;\n    if (!cachedError || !FileSystem.isFileDoesNotExistError(cachedError)) {\n      FileSystem.deleteFile(filePath);\n      this._invalidateCacheEntry(filePath);\n    } else if (options?.throwIfNotExists) {\n      throw cachedError;\n    }\n  };\n\n  public createHardLinkAsync: (options: IFileSystemCreateLinkOptions) => Promise<void> = async (\n    options: IFileSystemCreateLinkOptions\n  ) => {\n    await FileSystem.createHardLinkAsync(options);\n    this._invalidateCacheEntry(options.newLinkPath);\n  };\n\n  public getRealPath: (linkPath: string) => string = (linkPath: string) => {\n    return this._withCaching(\n      linkPath,\n      (path: string) => {\n        try {\n          return FileSystem.getRealPath(path);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e as Error)) {\n            // TypeScript's ts.sys.realpath returns the path it's provided if that path doesn't exist\n            return path;\n          } else {\n            throw e;\n          }\n        }\n      },\n      this._realPathCache\n    );\n  };\n\n  public readFolderFilesAndDirectories: (folderPath: string) => IReadFolderFilesAndDirectoriesResult = (\n    folderPath: string\n  ) => {\n    return this._withCaching(\n      folderPath,\n      (path: string) => {\n        const folderEntries: FolderItem[] = FileSystem.readFolderItems(path);\n        return this._sortFolderEntries(folderEntries);\n      },\n      this._readFolderCache\n    );\n  };\n\n  private _sortFolderEntries(folderEntries: FolderItem[]): IReadFolderFilesAndDirectoriesResult {\n    // TypeScript expects entries sorted ordinally by name\n    // In practice this might not matter\n    folderEntries.sort((a, b) => Sort.compareByValue(a, b));\n\n    const files: string[] = [];\n    const directories: string[] = [];\n    for (const folderEntry of folderEntries) {\n      if (folderEntry.isFile()) {\n        files.push(folderEntry.name);\n      } else if (folderEntry.isDirectory()) {\n        directories.push(folderEntry.name);\n      }\n    }\n\n    return { files, directories };\n  }\n\n  private _withCaching<TResult>(\n    path: string,\n    fn: (path: string) => TResult,\n    cache: Map<string, ICacheEntry<TResult>>\n  ): TResult {\n    let cacheEntry: ICacheEntry<TResult> | undefined = cache.get(path);\n    if (!cacheEntry) {\n      try {\n        cacheEntry = { entry: fn(path) };\n      } catch (e) {\n        cacheEntry = { error: e as Error, entry: undefined };\n      }\n\n      cache.set(path, cacheEntry);\n    }\n\n    if (cacheEntry.entry) {\n      return cacheEntry.entry;\n    } else {\n      throw cacheEntry.error;\n    }\n  }\n\n  private _invalidateCacheEntry(path: string): void {\n    this._statsCache.delete(path);\n    this._readFolderCache.delete(path);\n    this._readFileCache.delete(path);\n    this._realPathCache.delete(path);\n  }\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { PLUGIN_NAME as TypeScriptPluginName, loadTypeScriptConfigurationFileAsync, loadPartialTsconfigFileAsync } from './TypeScriptPlugin';
+export { loadTypeScriptToolAsync as _loadTypeScriptToolAsync } from './loadTypeScriptTool';
+export { loadTsconfig as _loadTsconfig, getTsconfigFilePath as _getTsconfigFilePath } from './tsconfigLoader';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAkB3D,OAAO,EACL,WAAW,IAAI,oBAAoB,EACnC,oCAAoC,EACpC,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,uBAAuB,IAAI,wBAAwB,EAIpD,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,IAAI,aAAa,EAC7B,mBAAmB,IAAI,oBAAoB,EAE5C,MAAM,kBAAkB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * A Heft plugin for using TypeScript.\n *\n * @packageDocumentation\n */\n\nexport type {\n  IEmitModuleKind,\n  IStaticAssetsCopyConfiguration,\n  ITypeScriptConfigurationJson,\n  IPartialTsconfigCompilerOptions,\n  IPartialTsconfig,\n  IChangedFilesHookOptions,\n  ITypeScriptPluginAccessor\n} from './TypeScriptPlugin';\n\nexport {\n  PLUGIN_NAME as TypeScriptPluginName,\n  loadTypeScriptConfigurationFileAsync,\n  loadPartialTsconfigFileAsync\n} from './TypeScriptPlugin';\n\nexport type { IBaseTypeScriptTool as _IBaseTypeScriptTool } from './TypeScriptBuilder';\nexport {\n  loadTypeScriptToolAsync as _loadTypeScriptToolAsync,\n  type ILoadedTypeScriptTool as _ILoadedTypeScriptTool,\n  type ICompilerCapabilities as _ICompilerCapabilities,\n  type ILoadTypeScriptToolOptions as _ILoadTypeScriptToolOptions\n} from './loadTypeScriptTool';\nexport {\n  loadTsconfig as _loadTsconfig,\n  getTsconfigFilePath as _getTsconfigFilePath,\n  type ILoadTsconfigOptions as _ILoadTsconfigOptions\n} from './tsconfigLoader';\nimport type * as TTypeScript from 'typescript';\nexport { TTypeScript as _TTypeScript };\n"]}

package/lib-esm/internalTypings/TypeScriptInternals.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=TypeScriptInternals.js.map

package/lib-esm/internalTypings/TypeScriptInternals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptInternals.js","sourceRoot":"","sources":["../../src/internalTypings/TypeScriptInternals.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type * as TTypescript from 'typescript';\n\nexport interface IExtendedSolutionBuilder\n  extends TTypescript.SolutionBuilder<TTypescript.EmitAndSemanticDiagnosticsBuilderProgram> {\n  getBuildOrder(): readonly string[];\n  invalidateProject(configFilePath: string, mode: 0 | 1 | 2): void;\n}\n\n/**\n * @internal\n */\nexport interface ITypeScriptNodeSystem extends TTypescript.System {\n  /**\n   * https://github.com/microsoft/TypeScript/blob/d85767abfd83880cea17cea70f9913e9c4496dcc/src/compiler/sys.ts#L1438\n   */\n  getAccessibleFileSystemEntries?: (folderPath: string) => {\n    files: string[];\n    directories: string[];\n  };\n}\n\n/**\n * @internal\n */\nexport interface IExtendedTypeScript {\n  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L3\n   */\n  performance: {\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L119-L121\n     */\n    disable(): void;\n\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L110-L116\n     */\n    enable(): void;\n\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L55-L61\n     */\n    mark(performanceMaker: string): void;\n\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L72-L78\n     */\n    measure(measureName: string, startMarkName?: string, endMarkName?: string): void;\n\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L94-L96\n     */\n    getDuration(measureName: string): number;\n\n    /**\n     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L85-L87\n     */\n    getCount(measureName: string): number;\n  };\n\n  transpileOptionValueCompilerOptions: {\n    name: keyof TTypescript.CompilerOptions;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    transpileOptionValue: any;\n  }[];\n\n  getNewLineCharacter(compilerOptions: TTypescript.CompilerOptions): string;\n\n  createCompilerHost(\n    options: TTypescript.CompilerOptions,\n    setParentNodes?: boolean,\n    system?: TTypescript.System\n  ): TTypescript.CompilerHost;\n\n  createCompilerHostWorker(\n    options: TTypescript.CompilerOptions,\n    setParentNodes?: boolean,\n    system?: TTypescript.System\n  ): TTypescript.CompilerHost;\n\n  combinePaths(path1: string, path2: string): string;\n\n  /**\n   * https://github.com/microsoft/TypeScript/blob/782c09d783e006a697b4ba6d1e7ec2f718ce8393/src/compiler/utilities.ts#L6540\n   */\n  matchFiles(\n    path: string,\n    extensions: ReadonlyArray<string> | undefined,\n    excludes: ReadonlyArray<string> | undefined,\n    includes: ReadonlyArray<string> | undefined,\n    useCaseSensitiveFileNames: boolean,\n    currentDirectory: string,\n    depth: number | undefined,\n    getFileSystemEntries: (path: string) => {\n      readonly files: ReadonlyArray<string>;\n      readonly directories: ReadonlyArray<string>;\n    },\n    realpath: (path: string) => string,\n    directoryExists: (path: string) => boolean\n  ): string[];\n\n  Diagnostics: {\n    // https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/diagnosticMessages.json#L4252-L4255\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    Found_1_error_Watching_for_file_changes: TTypescript.DiagnosticMessage;\n\n    // https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/diagnosticMessages.json#L4256-L4259\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    Found_0_errors_Watching_for_file_changes: TTypescript.DiagnosticMessage;\n\n    // https://github.com/microsoft/TypeScript/blob/2428ade1a91248e847f3e1561e31a9426650efee/src/compiler/diagnosticMessages.json#L2252\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    Property_0_has_no_initializer_and_is_not_definitely_assigned_in_the_constructor: TTypescript.DiagnosticMessage;\n\n    // https://github.com/microsoft/TypeScript/blob/2428ade1a91248e847f3e1561e31a9426650efee/src/compiler/diagnosticMessages.json#L4920\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    Element_implicitly_has_an_any_type_because_expression_of_type_0_can_t_be_used_to_index_type_1: TTypescript.DiagnosticMessage;\n  };\n}\n\nexport type ExtendedTypeScript = typeof TTypescript & IExtendedTypeScript;\n\nexport type ExtendedBuilderProgram = TTypescript.BuilderProgram & {\n  /**\n   * Typescript 5.6+\n   */\n  state?: { changedFilesSet: Set<string> };\n  /**\n   * Typescript < 5.6\n   */\n  getState(): { changedFilesSet: Set<string> };\n};\n"]}

package/lib-esm/loadTypeScriptTool.js

@@ -0,0 +1,75 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import semver from 'semver';
+import { JsonFile, RealNodeModulePathResolver } from '@rushstack/node-core-library';
+const OLDEST_SUPPORTED_TS_MAJOR_VERSION = 2;
+const OLDEST_SUPPORTED_TS_MINOR_VERSION = 9;
+const NEWEST_SUPPORTED_TS_MAJOR_VERSION = 5;
+const NEWEST_SUPPORTED_TS_MINOR_VERSION = 8;
+/**
+ * @internal
+ */
+export async function loadTypeScriptToolAsync(options) {
+    const { terminal, heftConfiguration, buildProjectReferences, onlyResolveSymlinksInNodeModules } = options;
+    const typeScriptToolPath = await heftConfiguration.rigPackageResolver.resolvePackageAsync('typescript', terminal);
+    // Determine the compiler version
+    const compilerPackageJsonFilename = `${typeScriptToolPath}/package.json`;
+    const packageJson = await JsonFile.loadAsync(compilerPackageJsonFilename);
+    const typescriptVersion = packageJson.version;
+    const typescriptParsedVersion = semver.parse(typescriptVersion);
+    if (!typescriptParsedVersion) {
+        throw new Error(`Unable to parse version "${typescriptVersion}" for TypeScript compiler package in: ` +
+            compilerPackageJsonFilename);
+    }
+    // Detect what features this compiler supports.  Note that manually comparing major/minor numbers
+    // loosens the matching to accept prereleases such as "3.6.0-dev.20190530"
+    const capabilities = {
+        incrementalProgram: false,
+        solutionBuilder: typescriptParsedVersion.major >= 3
+    };
+    if (typescriptParsedVersion.major > 3 ||
+        (typescriptParsedVersion.major === 3 && typescriptParsedVersion.minor >= 6)) {
+        capabilities.incrementalProgram = true;
+    }
+    if (buildProjectReferences && !capabilities.solutionBuilder) {
+        throw new Error(`Building project references requires TypeScript@>=3.0, but the current version is ${typescriptVersion}`);
+    }
+    // Report a warning if the TypeScript version is too old/new.  The current oldest supported version is
+    // TypeScript 2.9. Prior to that the "ts.getConfigFileParsingDiagnostics()" API is missing; more fixups
+    // would be required to deal with that.  We won't do that work unless someone requests it.
+    if (typescriptParsedVersion.major < OLDEST_SUPPORTED_TS_MAJOR_VERSION ||
+        (typescriptParsedVersion.major === OLDEST_SUPPORTED_TS_MAJOR_VERSION &&
+            typescriptParsedVersion.minor < OLDEST_SUPPORTED_TS_MINOR_VERSION)) {
+        // We don't use writeWarningLine() here because, if the person wants to take their chances with
+        // a seemingly unsupported compiler, their build should be allowed to succeed.
+        terminal.writeLine(`The TypeScript compiler version ${typescriptVersion} is very old` +
+            ` and has not been tested with Heft; it may not work correctly.`);
+    }
+    else if (typescriptParsedVersion.major > NEWEST_SUPPORTED_TS_MAJOR_VERSION ||
+        (typescriptParsedVersion.major === NEWEST_SUPPORTED_TS_MAJOR_VERSION &&
+            typescriptParsedVersion.minor > NEWEST_SUPPORTED_TS_MINOR_VERSION)) {
+        terminal.writeLine(`The TypeScript compiler version ${typescriptVersion} is newer` +
+            ' than the latest version that was tested with Heft ' +
+            `(${NEWEST_SUPPORTED_TS_MAJOR_VERSION}.${NEWEST_SUPPORTED_TS_MINOR_VERSION}); it may not work correctly.`);
+    }
+    const ts = require(typeScriptToolPath);
+    let realpath = ts.sys.realpath;
+    if (onlyResolveSymlinksInNodeModules) {
+        const resolver = new RealNodeModulePathResolver();
+        realpath = resolver.realNodeModulePath;
+    }
+    return {
+        tool: {
+            ts,
+            system: {
+                ...ts.sys,
+                realpath
+            },
+            typeScriptToolPath
+        },
+        typescriptVersion,
+        typescriptParsedVersion,
+        capabilities
+    };
+}
+//# sourceMappingURL=loadTypeScriptTool.js.map

package/lib-esm/loadTypeScriptTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTypeScriptTool.js","sourceRoot":"","sources":["../src/loadTypeScriptTool.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport semver from 'semver';\n\nimport type { HeftConfiguration } from '@rushstack/heft';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { type IPackageJson, JsonFile, RealNodeModulePathResolver } from '@rushstack/node-core-library';\n\nimport type { ExtendedTypeScript } from './internalTypings/TypeScriptInternals';\nimport type { IBaseTypeScriptTool } from './TypeScriptBuilder';\n\nconst OLDEST_SUPPORTED_TS_MAJOR_VERSION: number = 2;\nconst OLDEST_SUPPORTED_TS_MINOR_VERSION: number = 9;\n\nconst NEWEST_SUPPORTED_TS_MAJOR_VERSION: number = 5;\nconst NEWEST_SUPPORTED_TS_MINOR_VERSION: number = 8;\n\n/**\n * @internal\n */\nexport interface ILoadedTypeScriptTool {\n  tool: IBaseTypeScriptTool;\n  typescriptVersion: string;\n  typescriptParsedVersion: semver.SemVer;\n  capabilities: ICompilerCapabilities;\n}\n\n/**\n * @internal\n */\nexport interface ICompilerCapabilities {\n  /**\n   * Support for incremental compilation via `ts.createIncrementalProgram()`.\n   * Introduced with TypeScript 3.6.\n   */\n  incrementalProgram: boolean;\n\n  /**\n   * Support for composite projects via `ts.createSolutionBuilder()`.\n   * Introduced with TypeScript 3.0.\n   */\n  solutionBuilder: boolean;\n}\n\n/**\n * @internal\n */\nexport interface ILoadTypeScriptToolOptions {\n  terminal: ITerminal;\n  heftConfiguration: HeftConfiguration;\n  onlyResolveSymlinksInNodeModules?: boolean;\n  buildProjectReferences?: boolean;\n}\n\n/**\n * @internal\n */\nexport async function loadTypeScriptToolAsync(\n  options: ILoadTypeScriptToolOptions\n): Promise<ILoadedTypeScriptTool> {\n  const { terminal, heftConfiguration, buildProjectReferences, onlyResolveSymlinksInNodeModules } = options;\n\n  const typeScriptToolPath: string = await heftConfiguration.rigPackageResolver.resolvePackageAsync(\n    'typescript',\n    terminal\n  );\n\n  // Determine the compiler version\n  const compilerPackageJsonFilename: string = `${typeScriptToolPath}/package.json`;\n  const packageJson: IPackageJson = await JsonFile.loadAsync(compilerPackageJsonFilename);\n  const typescriptVersion: string = packageJson.version;\n  const typescriptParsedVersion: semver.SemVer | null = semver.parse(typescriptVersion);\n  if (!typescriptParsedVersion) {\n    throw new Error(\n      `Unable to parse version \"${typescriptVersion}\" for TypeScript compiler package in: ` +\n        compilerPackageJsonFilename\n    );\n  }\n\n  // Detect what features this compiler supports.  Note that manually comparing major/minor numbers\n  // loosens the matching to accept prereleases such as \"3.6.0-dev.20190530\"\n  const capabilities: ICompilerCapabilities = {\n    incrementalProgram: false,\n    solutionBuilder: typescriptParsedVersion.major >= 3\n  };\n\n  if (\n    typescriptParsedVersion.major > 3 ||\n    (typescriptParsedVersion.major === 3 && typescriptParsedVersion.minor >= 6)\n  ) {\n    capabilities.incrementalProgram = true;\n  }\n\n  if (buildProjectReferences && !capabilities.solutionBuilder) {\n    throw new Error(\n      `Building project references requires TypeScript@>=3.0, but the current version is ${typescriptVersion}`\n    );\n  }\n\n  // Report a warning if the TypeScript version is too old/new.  The current oldest supported version is\n  // TypeScript 2.9. Prior to that the \"ts.getConfigFileParsingDiagnostics()\" API is missing; more fixups\n  // would be required to deal with that.  We won't do that work unless someone requests it.\n  if (\n    typescriptParsedVersion.major < OLDEST_SUPPORTED_TS_MAJOR_VERSION ||\n    (typescriptParsedVersion.major === OLDEST_SUPPORTED_TS_MAJOR_VERSION &&\n      typescriptParsedVersion.minor < OLDEST_SUPPORTED_TS_MINOR_VERSION)\n  ) {\n    // We don't use writeWarningLine() here because, if the person wants to take their chances with\n    // a seemingly unsupported compiler, their build should be allowed to succeed.\n    terminal.writeLine(\n      `The TypeScript compiler version ${typescriptVersion} is very old` +\n        ` and has not been tested with Heft; it may not work correctly.`\n    );\n  } else if (\n    typescriptParsedVersion.major > NEWEST_SUPPORTED_TS_MAJOR_VERSION ||\n    (typescriptParsedVersion.major === NEWEST_SUPPORTED_TS_MAJOR_VERSION &&\n      typescriptParsedVersion.minor > NEWEST_SUPPORTED_TS_MINOR_VERSION)\n  ) {\n    terminal.writeLine(\n      `The TypeScript compiler version ${typescriptVersion} is newer` +\n        ' than the latest version that was tested with Heft ' +\n        `(${NEWEST_SUPPORTED_TS_MAJOR_VERSION}.${NEWEST_SUPPORTED_TS_MINOR_VERSION}); it may not work correctly.`\n    );\n  }\n\n  const ts: ExtendedTypeScript = require(typeScriptToolPath);\n\n  let realpath: typeof ts.sys.realpath = ts.sys.realpath;\n  if (onlyResolveSymlinksInNodeModules) {\n    const resolver: RealNodeModulePathResolver = new RealNodeModulePathResolver();\n    realpath = resolver.realNodeModulePath;\n  }\n\n  return {\n    tool: {\n      ts,\n      system: {\n        ...ts.sys,\n        realpath\n      },\n      typeScriptToolPath\n    },\n    typescriptVersion,\n    typescriptParsedVersion,\n    capabilities\n  };\n}\n"]}

package/lib-esm/schemas/anything.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "description": "Schema that matches anything",
+
+  "oneOf": [
+    {
+      "type": "array"
+    },
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "object"
+    },
+    {
+      "type": "string"
+    }
+  ]
+}

package/lib-esm/schemas/typescript.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "title": "TypeScript Build Configuration",
+  "description": "Defines optional options for TypeScript build.",
+  "type": "object",
+
+  "additionalProperties": false,
+
+  "properties": {
+    "$schema": {
+      "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
+      "type": "string"
+    },
+
+    "extends": {
+      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects. To delete an inherited setting, set it to `null` in this file.",
+      "type": "string"
+    },
+
+    "additionalModuleKindsToEmit": {
+      "type": "array",
+      "description": "If provided, emit these module kinds in addition to the modules specified in the tsconfig. Note that this option only applies to the main tsconfig.json configuration.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "moduleKind": {
+            "type": "string",
+            "enum": ["commonjs", "amd", "umd", "system", "es2015", "esnext"]
+          },
+
+          "outFolderName": {
+            "type": "string",
+            "pattern": "[^\\\\\\/]"
+          }
+        },
+        "required": ["moduleKind", "outFolderName"]
+      }
+    },
+
+    "onlyResolveSymlinksInNodeModules": {
+      "description": "If true, the TypeScript compiler will only resolve symlinks to their targets if the links are in a node_modules folder. This significantly reduces file system operations in typical usage.",
+      "type": "boolean"
+    },
+
+    "emitCjsExtensionForCommonJS": {
+      "description": "If true, emit CommonJS module output to the folder specified in the tsconfig \"outDir\" compiler option with the .cjs extension alongside (or instead of, if TSConfig specifies CommonJS) the default compilation output.",
+      "type": "boolean"
+    },
+
+    "emitMjsExtensionForESModule": {
+      "description": "If true, emit ESNext module output to the folder specified in the tsconfig \"outDir\" compiler option with the .mjs extension alongside (or instead of, if TSConfig specifies ESNext) the default compilation output.",
+      "type": "boolean"
+    },
+
+    "buildProjectReferences": {
+      "description": "If true, enable behavior analogous to the \"tsc --build\" command. Will build projects referenced by the main project. Note that this will effectively enable \"noEmitOnError\".",
+      "type": "boolean"
+    },
+
+    "useTranspilerWorker": {
+      "description": "If true, and the tsconfig has \"isolatedModules\": true, then transpilation will happen in parallel in a worker thread.",
+      "type": "boolean"
+    },
+
+    "project": {
+      "description": "Specifies the tsconfig.json file that will be used for compilation. Equivalent to the \"project\" argument for the 'tsc' and 'tslint' command line tools. The default value is \"./tsconfig.json\".",
+      "type": "string"
+    },
+
+    "staticAssetsToCopy": {
+      "description": "Configures additional file types that should be copied into the TypeScript compiler's emit folders, for example so that these files can be resolved by import statements.",
+      "type": "object",
+
+      "additionalProperties": false,
+
+      "properties": {
+        "fileExtensions": {
+          "type": "array",
+          "description": "File extensions that should be copied from the source folder to the destination folder(s)",
+          "items": {
+            "type": "string",
+            "pattern": "^\\.[A-z0-9-_.]*[A-z0-9-_]+$"
+          }
+        },
+
+        "excludeGlobs": {
+          "type": "array",
+          "description": "Globs that should be explicitly excluded. This takes precedence over globs listed in \"includeGlobs\" and files that match the file extensions provided in \"fileExtensions\".",
+          "items": {
+            "type": "string",
+            "pattern": "[^\\\\]"
+          }
+        },
+
+        "includeGlobs": {
+          "type": "array",
+          "description": "Globs that should be explicitly included.",
+          "items": {
+            "type": "string",
+            "pattern": "[^\\\\]"
+          }
+        }
+      }
+    }
+  }
+}

package/lib-esm/tsconfigLoader.js

@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import path from 'node:path';
+import { Path } from '@rushstack/node-core-library';
+/**
+ * @internal
+ */
+export function getTsconfigFilePath(heftConfiguration, tsconfigRelativePath) {
+    return Path.convertToSlashes(
+    // Use path.resolve because the path can start with `./` or `../`
+    path.resolve(heftConfiguration.buildFolderPath, tsconfigRelativePath !== null && tsconfigRelativePath !== void 0 ? tsconfigRelativePath : './tsconfig.json'));
+}
+/**
+ * @internal
+ */
+export function loadTsconfig(options) {
+    const { tool: { ts, system }, tsconfigPath, tsCacheFilePath } = options;
+    const parsedConfigFile = ts.readConfigFile(tsconfigPath, system.readFile);
+    const currentFolder = path.dirname(tsconfigPath);
+    const tsconfig = ts.parseJsonConfigFileContent(parsedConfigFile.config, {
+        fileExists: system.fileExists,
+        readFile: system.readFile,
+        readDirectory: system.readDirectory,
+        realpath: system.realpath,
+        useCaseSensitiveFileNames: true
+    }, currentFolder, 
+    /*existingOptions:*/ undefined, tsconfigPath);
+    if (tsconfig.options.incremental) {
+        tsconfig.options.tsBuildInfoFile = tsCacheFilePath;
+    }
+    return tsconfig;
+}
+//# sourceMappingURL=tsconfigLoader.js.map

package/lib-esm/tsconfigLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfigLoader.js","sourceRoot":"","sources":["../src/tsconfigLoader.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAcpD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,iBAAoC,EACpC,oBAAwC;IAExC,OAAO,IAAI,CAAC,gBAAgB;IAC1B,iEAAiE;IACjE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,eAAe,EAAE,oBAAoB,aAApB,oBAAoB,cAApB,oBAAoB,GAAI,iBAAiB,CAAC,CAC3F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,MAAM,EACJ,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EACpB,YAAY,EACZ,eAAe,EAChB,GAAG,OAAO,CAAC;IACZ,MAAM,gBAAgB,GAAyC,EAAE,CAAC,cAAc,CAC9E,YAAY,EACZ,MAAM,CAAC,QAAQ,CAChB,CAAC;IAEF,MAAM,aAAa,GAAW,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAkC,EAAE,CAAC,0BAA0B,CAC3E,gBAAgB,CAAC,MAAM,EACvB;QACE,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,yBAAyB,EAAE,IAAI;KAChC,EACD,aAAa;IACb,oBAAoB,CAAC,SAAS,EAC9B,YAAY,CACb,CAAC;IAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC;IACrD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport type * as TTypescript from 'typescript';\n\nimport { Path } from '@rushstack/node-core-library';\nimport type { HeftConfiguration } from '@rushstack/heft';\n\nimport type { IBaseTypeScriptTool } from './TypeScriptBuilder';\n\n/**\n * @internal\n */\nexport interface ILoadTsconfigOptions {\n  tool: IBaseTypeScriptTool;\n  tsconfigPath: string;\n  tsCacheFilePath?: string;\n}\n\n/**\n * @internal\n */\nexport function getTsconfigFilePath(\n  heftConfiguration: HeftConfiguration,\n  tsconfigRelativePath: string | undefined\n): string {\n  return Path.convertToSlashes(\n    // Use path.resolve because the path can start with `./` or `../`\n    path.resolve(heftConfiguration.buildFolderPath, tsconfigRelativePath ?? './tsconfig.json')\n  );\n}\n\n/**\n * @internal\n */\nexport function loadTsconfig(options: ILoadTsconfigOptions): TTypescript.ParsedCommandLine {\n  const {\n    tool: { ts, system },\n    tsconfigPath,\n    tsCacheFilePath\n  } = options;\n  const parsedConfigFile: ReturnType<typeof ts.readConfigFile> = ts.readConfigFile(\n    tsconfigPath,\n    system.readFile\n  );\n\n  const currentFolder: string = path.dirname(tsconfigPath);\n  const tsconfig: TTypescript.ParsedCommandLine = ts.parseJsonConfigFileContent(\n    parsedConfigFile.config,\n    {\n      fileExists: system.fileExists,\n      readFile: system.readFile,\n      readDirectory: system.readDirectory,\n      realpath: system.realpath,\n      useCaseSensitiveFileNames: true\n    },\n    currentFolder,\n    /*existingOptions:*/ undefined,\n    tsconfigPath\n  );\n\n  if (tsconfig.options.incremental) {\n    tsconfig.options.tsBuildInfoFile = tsCacheFilePath;\n  }\n\n  return tsconfig;\n}\n"]}

package/lib-esm/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=types.js.map

package/lib-esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type * as TTypescript from 'typescript';\n\nexport interface ITypescriptWorkerData {\n  /**\n   * Path to the version of TypeScript to use.\n   */\n  typeScriptToolPath: string;\n}\n\nexport interface ITranspilationRequestMessage {\n  /**\n   * Unique identifier for this request.\n   */\n  requestId: number;\n  /**\n   * The tsconfig compiler options to use for the request.\n   */\n  compilerOptions: TTypescript.CompilerOptions;\n  /**\n   * The variants to emit.\n   */\n  moduleKindsToEmit: ICachedEmitModuleKind[];\n  /**\n   * The set of files to build.\n   */\n  filesToTranspile: Map<string, string>;\n}\n\nexport interface ITranspilationSuccessMessage {\n  requestId: number;\n  type: 'success';\n  result: TTypescript.EmitResult;\n}\n\nexport interface ITranspilationErrorMessage {\n  requestId: number;\n  type: 'error';\n  result: {\n    message: string;\n    [key: string]: unknown;\n  };\n}\n\nexport type ITranspilationResponseMessage = ITranspilationSuccessMessage | ITranspilationErrorMessage;\n\nexport interface ICachedEmitModuleKind {\n  moduleKind: TTypescript.ModuleKind;\n\n  outFolderPath: string;\n\n  /**\n   * File extension to use instead of '.js' for emitted ECMAScript files.\n   * For example, '.cjs' to indicate commonjs content, or '.mjs' to indicate ECMAScript modules.\n   */\n  jsExtensionOverride: string | undefined;\n\n  /**\n   * Set to true if this is the emit kind that is specified in the tsconfig.json.\n   * Declarations are only emitted for the primary module kind.\n   */\n  isPrimary: boolean;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft-typescript-plugin",
-  "version": "1.1.14",
+  "version": "1.2.1",
   "description": "Heft plugin for TypeScript",
   "repository": {
     "type": "git",
@@ -8,27 +8,53 @@
     "directory": "heft-plugins/heft-typescript-plugin"
   },
   "homepage": "https://rushstack.io/pages/heft/overview/",
-  "main": "lib/index.js",
-  "types": "dist/heft-typescript-plugin.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/heft-typescript-plugin.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/heft-typescript-plugin.d.ts",
+      "node": "./lib-commonjs/index.js",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*.schema.json": "./lib-commonjs/*.schema.json",
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "node": "./lib-commonjs/*.js",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./heft-plugin.json": "./heft-plugin.json",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "peerDependencies": {
-    "@rushstack/heft": "1.1.14"
+    "@rushstack/heft": "1.2.1"
   },
   "dependencies": {
     "@types/tapable": "1.0.6",
     "semver": "~7.5.4",
     "tapable": "1.1.3",
-    "@rushstack/heft-config-file": "0.19.7",
-    "@rushstack/node-core-library": "5.19.1"
+    "@rushstack/node-core-library": "5.20.1",
+    "@rushstack/heft-config-file": "0.20.1"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "eslint": "~9.37.0",
     "typescript": "~5.8.2",
-    "@rushstack/heft": "1.1.14",
+    "@rushstack/heft": "1.2.1",
     "decoupled-local-node-rig": "1.0.0",
-    "@rushstack/terminal": "0.21.0"
+    "@rushstack/terminal": "0.22.1"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft test --clean",
     "start": "heft build-watch",