@rushstack/heft-typescript-plugin 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1,24 @@
+@rushstack/heft-typescript-plugin
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# @rushstack/heft-typescript-plugin
+
+This is a Heft plugin for compiling TypeScript.
+
+## Links
+
+- [CHANGELOG.md](
+  https://github.com/microsoft/rushstack/blob/main/heft-plugins/heft-typescript-plugin/CHANGELOG.md) - Find
+  out what's new in the latest version
+- [@rushstack/heft](https://www.npmjs.com/package/@rushstack/heft) - Heft is a config-driven toolchain that invokes popular tools such as TypeScript, ESLint, Jest, Webpack, and API Extractor.
+
+Heft is part of the [Rush Stack](https://rushstack.io/) family of projects.

package/dist/heft-typescript-plugin.d.ts

@@ -0,0 +1,111 @@
+/**
+ * A Heft plugin for using TypeScript.
+ *
+ * @packageDocumentation
+ */
+
+import type { HeftConfiguration } from '@rushstack/heft';
+import { ITerminal } from '@rushstack/node-core-library';
+import { SyncHook } from 'tapable';
+import type * as TTypescript from 'typescript';
+
+/**
+ * @beta
+ */
+export declare interface IChangedFilesHookOptions {
+    program: TTypescript.Program;
+    changedFiles?: ReadonlySet<TTypescript.SourceFile>;
+}
+
+/**
+ * @beta
+ */
+export declare interface IEmitModuleKind {
+    moduleKind: 'commonjs' | 'amd' | 'umd' | 'system' | 'es2015' | 'esnext';
+    outFolderName: string;
+    jsExtensionOverride?: string;
+}
+
+/**
+ * @beta
+ */
+export declare interface IPartialTsconfig {
+    compilerOptions?: IPartialTsconfigCompilerOptions;
+}
+
+/**
+ * @beta
+ */
+export declare interface IPartialTsconfigCompilerOptions {
+    outDir?: string;
+}
+
+/**
+ * @beta
+ */
+export declare interface IStaticAssetsCopyConfiguration {
+    fileExtensions: string[];
+    excludeGlobs: string[];
+    includeGlobs: string[];
+}
+
+/**
+ * @beta
+ */
+export declare interface ITypeScriptConfigurationJson {
+    /**
+     * 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.
+     */
+    additionalModuleKindsToEmit?: IEmitModuleKind[] | undefined;
+    /**
+     * If 'true', emit CommonJS output into the TSConfig outDir with the file extension '.cjs'
+     */
+    emitCjsExtensionForCommonJS?: boolean | undefined;
+    /**
+     * If 'true', emit ESModule output into the TSConfig outDir with the file extension '.mjs'
+     */
+    emitMjsExtensionForESModule?: boolean | undefined;
+    /**
+     * If true, enable behavior analogous to the "tsc --build" command. Will build projects referenced by the main project in dependency order.
+     * Note that this will effectively enable \"noEmitOnError\".
+     */
+    buildProjectReferences?: boolean;
+    project?: string;
+    /**
+     * 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.
+     */
+    staticAssetsToCopy?: IStaticAssetsCopyConfiguration;
+    /**
+     * Set this to change the maximum number of file handles that will be opened concurrently for writing.
+     * The default is 50.
+     */
+    maxWriteParallelism?: number;
+}
+
+/**
+ * @beta
+ */
+export declare interface ITypeScriptPluginAccessor {
+    readonly onChangedFilesHook: SyncHook<IChangedFilesHookOptions>;
+}
+
+/**
+ * @beta
+ */
+export declare function loadPartialTsconfigFileAsync(heftConfiguration: HeftConfiguration, terminal: ITerminal, typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined): Promise<IPartialTsconfig | undefined>;
+
+/**
+ * @beta
+ */
+export declare function loadTypeScriptConfigurationFileAsync(heftConfiguration: HeftConfiguration, terminal: ITerminal): Promise<ITypeScriptConfigurationJson | undefined>;
+
+/**
+ * The name of the plugin, as specified in heft-plugin.json
+ *
+ * @public
+ */
+export declare const TypeScriptPluginName: 'TypeScriptPlugin';
+
+export { }

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.29.0"
+    }
+  ]
+}

package/heft-plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/heft/heft-plugin.schema.json",
+
+  "taskPlugins": [
+    {
+      "pluginName": "TypeScriptPlugin",
+      "entryPoint": "./lib/TypeScriptPlugin"
+    }
+  ]
+}

package/lib/EmitFilesPatch.d.ts

@@ -0,0 +1,28 @@
+import type * as TTypescript from 'typescript';
+import { ExtendedTypeScript } from './internalTypings/TypeScriptInternals';
+export interface ICachedEmitModuleKind {
+    moduleKind: TTypescript.ModuleKind;
+    outFolderPath: string;
+    /**
+     * File extension to use instead of '.js' for emitted ECMAScript files.
+     * For example, '.cjs' to indicate commonjs content, or '.mjs' to indicate ECMAScript modules.
+     */
+    jsExtensionOverride: string | undefined;
+    /**
+     * Set to true if this is the emit kind that is specified in the tsconfig.json.
+     * Declarations are only emitted for the primary module kind.
+     */
+    isPrimary: boolean;
+}
+export declare class EmitFilesPatch {
+    private static _patchedTs;
+    private static _baseEmitFiles;
+    static install(ts: ExtendedTypeScript, tsconfig: TTypescript.ParsedCommandLine, moduleKindsToEmit: ICachedEmitModuleKind[], changedFiles?: Set<TTypescript.SourceFile>): void;
+    static get isInstalled(): boolean;
+    /**
+     * Wraps the writeFile callback on the IEmitHost to override the .js extension, if applicable
+     */
+    static wrapWriteFile(baseWriteFile: TTypescript.WriteFileCallback, jsExtensionOverride: string | undefined): TTypescript.WriteFileCallback;
+    static uninstall(ts: ExtendedTypeScript): void;
+}
+//# sourceMappingURL=EmitFilesPatch.d.ts.map

package/lib/EmitFilesPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmitFilesPatch.d.ts","sourceRoot":"","sources":["../src/EmitFilesPatch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAInB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IAEnC,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA6C;IAEtE,OAAO,CAAC,MAAM,CAAC,cAAc,CAA8B;WAE7C,OAAO,CACnB,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,WAAW,CAAC,iBAAiB,EACvC,iBAAiB,EAAE,qBAAqB,EAAE,EAC1C,YAAY,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,GACzC,IAAI;IAsHP,WAAkB,WAAW,IAAI,OAAO,CAEvC;IAED;;OAEG;WACW,aAAa,CACzB,aAAa,EAAE,WAAW,CAAC,iBAAiB,EAC5C,mBAAmB,EAAE,MAAM,GAAG,SAAS,GACtC,WAAW,CAAC,iBAAiB;WAuBlB,SAAS,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;CAatD"}

package/lib/EmitFilesPatch.js

@@ -0,0 +1,99 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmitFilesPatch = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+class EmitFilesPatch {
+    static install(ts, tsconfig, moduleKindsToEmit, changedFiles) {
+        if (EmitFilesPatch._patchedTs === ts) {
+            // We already patched this instance of TS
+            return;
+        }
+        if (EmitFilesPatch._patchedTs !== undefined) {
+            throw new node_core_library_1.InternalError('EmitFilesPatch.install() cannot be called without first uninstalling the existing patch');
+        }
+        EmitFilesPatch._patchedTs = ts;
+        EmitFilesPatch._baseEmitFiles = ts.emitFiles;
+        let foundPrimary = false;
+        let defaultModuleKind;
+        for (const moduleKindToEmit of moduleKindsToEmit) {
+            if (moduleKindToEmit.isPrimary) {
+                if (foundPrimary) {
+                    throw new Error('Multiple primary module emit kinds encountered.');
+                }
+                else {
+                    foundPrimary = true;
+                }
+                defaultModuleKind = moduleKindToEmit.moduleKind;
+            }
+        }
+        const patchedEmitFiles = (resolver, host, targetSourceFile, emitTransformers, emitOnlyDtsFiles, onlyBuildInfo, forceDtsEmit) => {
+            if (onlyBuildInfo || emitOnlyDtsFiles) {
+                // There should only be one tsBuildInfo and one set of declaration files
+                return EmitFilesPatch._baseEmitFiles(resolver, host, targetSourceFile, emitTransformers, emitOnlyDtsFiles, onlyBuildInfo, forceDtsEmit);
+            }
+            else {
+                if (targetSourceFile && changedFiles) {
+                    changedFiles.add(targetSourceFile);
+                }
+                let defaultModuleKindResult;
+                const diagnostics = [];
+                let emitSkipped = false;
+                for (const moduleKindToEmit of moduleKindsToEmit) {
+                    const compilerOptions = moduleKindToEmit.isPrimary
+                        ? Object.assign({}, tsconfig.options) : Object.assign(Object.assign({}, tsconfig.options), { module: moduleKindToEmit.moduleKind, outDir: moduleKindToEmit.outFolderPath, 
+                        // Don't emit declarations for secondary module kinds
+                        declaration: false, declarationMap: false });
+                    if (!compilerOptions.outDir) {
+                        throw new node_core_library_1.InternalError('Expected compilerOptions.outDir to be assigned');
+                    }
+                    const flavorResult = EmitFilesPatch._baseEmitFiles(resolver, Object.assign(Object.assign({}, host), { writeFile: EmitFilesPatch.wrapWriteFile(host.writeFile, moduleKindToEmit.jsExtensionOverride), getCompilerOptions: () => compilerOptions }), targetSourceFile, ts.getTransformers(compilerOptions, undefined, emitOnlyDtsFiles), emitOnlyDtsFiles, onlyBuildInfo, forceDtsEmit);
+                    emitSkipped = emitSkipped || flavorResult.emitSkipped;
+                    for (const diagnostic of flavorResult.diagnostics) {
+                        diagnostics.push(diagnostic);
+                    }
+                    if (moduleKindToEmit.moduleKind === defaultModuleKind) {
+                        defaultModuleKindResult = flavorResult;
+                    }
+                    // Should results be aggregated, in case for whatever reason the diagnostics are not the same?
+                }
+                const mergedDiagnostics = ts.sortAndDeduplicateDiagnostics(diagnostics);
+                return Object.assign(Object.assign({}, defaultModuleKindResult), { diagnostics: mergedDiagnostics, emitSkipped });
+            }
+        };
+        // Override the underlying file emitter to run itself once for each flavor
+        // This is a rather inelegant way to convince the TypeScript compiler not to duplicate parse/link/check
+        ts.emitFiles = patchedEmitFiles;
+    }
+    static get isInstalled() {
+        return this._patchedTs !== undefined;
+    }
+    /**
+     * Wraps the writeFile callback on the IEmitHost to override the .js extension, if applicable
+     */
+    static wrapWriteFile(baseWriteFile, jsExtensionOverride) {
+        if (!jsExtensionOverride) {
+            return baseWriteFile;
+        }
+        const replacementExtension = `${jsExtensionOverride}$1`;
+        return (fileName, data, writeBOM, onError, sourceFiles) => {
+            return baseWriteFile(fileName.replace(/\.js(\.map)?$/g, replacementExtension), data, writeBOM, onError, sourceFiles);
+        };
+    }
+    static uninstall(ts) {
+        if (EmitFilesPatch._patchedTs === undefined) {
+            throw new node_core_library_1.InternalError('EmitFilesPatch.uninstall() cannot be called if no patch was installed');
+        }
+        if (ts !== EmitFilesPatch._patchedTs) {
+            throw new node_core_library_1.InternalError('EmitFilesPatch.uninstall() called for the wrong object');
+        }
+        ts.emitFiles = EmitFilesPatch._baseEmitFiles;
+        EmitFilesPatch._patchedTs = undefined;
+        EmitFilesPatch._baseEmitFiles = undefined;
+    }
+}
+exports.EmitFilesPatch = EmitFilesPatch;
+EmitFilesPatch._patchedTs = undefined;
+EmitFilesPatch._baseEmitFiles = undefined; // eslint-disable-line
+//# sourceMappingURL=EmitFilesPatch.js.map

package/lib/EmitFilesPatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmitFilesPatch.js","sourceRoot":"","sources":["../src/EmitFilesPatch.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,oEAA6D;AA2B7D,MAAa,cAAc;IAKlB,MAAM,CAAC,OAAO,CACnB,EAAsB,EACtB,QAAuC,EACvC,iBAA0C,EAC1C,YAA0C;QAE1C,IAAI,cAAc,CAAC,UAAU,KAAK,EAAE,EAAE;YACpC,yCAAyC;YACzC,OAAO;SACR;QAED,IAAI,cAAc,CAAC,UAAU,KAAK,SAAS,EAAE;YAC3C,MAAM,IAAI,iCAAa,CACrB,yFAAyF,CAC1F,CAAC;SACH;QAED,cAAc,CAAC,UAAU,GAAG,EAAE,CAAC;QAC/B,cAAc,CAAC,cAAc,GAAG,EAAE,CAAC,SAAS,CAAC;QAE7C,IAAI,YAAY,GAAY,KAAK,CAAC;QAClC,IAAI,iBAAyC,CAAC;QAE9C,KAAK,MAAM,gBAAgB,IAAI,iBAAiB,EAAE;YAChD,IAAI,gBAAgB,CAAC,SAAS,EAAE;gBAC9B,IAAI,YAAY,EAAE;oBAChB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;iBACpE;qBAAM;oBACL,YAAY,GAAG,IAAI,CAAC;iBACrB;gBAED,iBAAiB,GAAG,gBAAgB,CAAC,UAAU,CAAC;aACjD;SACF;QAED,MAAM,gBAAgB,GAAG,CACvB,QAAuB,EACvB,IAAe,EACf,gBAAoD,EACpD,gBAAmC,EACnC,gBAA0B,EAC1B,aAAuB,EACvB,YAAsB,EACE,EAAE;YAC1B,IAAI,aAAa,IAAI,gBAAgB,EAAE;gBACrC,wEAAwE;gBACxE,OAAO,cAAc,CAAC,cAAc,CAClC,QAAQ,EACR,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,CACb,CAAC;aACH;iBAAM;gBACL,IAAI,gBAAgB,IAAI,YAAY,EAAE;oBACpC,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;iBACpC;gBAED,IAAI,uBAA+C,CAAC;gBACpD,MAAM,WAAW,GAA6B,EAAE,CAAC;gBACjD,IAAI,WAAW,GAAY,KAAK,CAAC;gBACjC,KAAK,MAAM,gBAAgB,IAAI,iBAAiB,EAAE;oBAChD,MAAM,eAAe,GAAgC,gBAAgB,CAAC,SAAS;wBAC7E,CAAC,mBACM,QAAQ,CAAC,OAAO,EAEvB,CAAC,iCACM,QAAQ,CAAC,OAAO,KACnB,MAAM,EAAE,gBAAgB,CAAC,UAAU,EACnC,MAAM,EAAE,gBAAgB,CAAC,aAAa;wBAEtC,qDAAqD;wBACrD,WAAW,EAAE,KAAK,EAClB,cAAc,EAAE,KAAK,GACtB,CAAC;oBAEN,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE;wBAC3B,MAAM,IAAI,iCAAa,CAAC,gDAAgD,CAAC,CAAC;qBAC3E;oBAED,MAAM,YAAY,GAA2B,cAAc,CAAC,cAAc,CACxE,QAAQ,kCAEH,IAAI,KACP,SAAS,EAAE,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,EAC7F,kBAAkB,EAAE,GAAG,EAAE,CAAC,eAAe,KAE3C,gBAAgB,EAChB,EAAE,CAAC,eAAe,CAAC,eAAe,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAChE,gBAAgB,EAChB,aAAa,EACb,YAAY,CACb,CAAC;oBAEF,WAAW,GAAG,WAAW,IAAI,YAAY,CAAC,WAAW,CAAC;oBACtD,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,WAAW,EAAE;wBACjD,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;qBAC9B;oBAED,IAAI,gBAAgB,CAAC,UAAU,KAAK,iBAAiB,EAAE;wBACrD,uBAAuB,GAAG,YAAY,CAAC;qBACxC;oBACD,8FAA8F;iBAC/F;gBAED,MAAM,iBAAiB,GACrB,EAAE,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAC;gBAEhD,uCACK,uBAAwB,KAC3B,WAAW,EAAE,iBAAiB,EAC9B,WAAW,IACX;aACH;QACH,CAAC,CAAC;QAEF,0EAA0E;QAC1E,uGAAuG;QACvG,EAAE,CAAC,SAAS,GAAG,gBAAgB,CAAC;IAClC,CAAC;IAEM,MAAM,KAAK,WAAW;QAC3B,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CACzB,aAA4C,EAC5C,mBAAuC;QAEvC,IAAI,CAAC,mBAAmB,EAAE;YACxB,OAAO,aAAa,CAAC;SACtB;QAED,MAAM,oBAAoB,GAAW,GAAG,mBAAmB,IAAI,CAAC;QAChE,OAAO,CACL,QAAgB,EAChB,IAAY,EACZ,QAAiB,EACjB,OAAiD,EACjD,WAA2D,EAC3D,EAAE;YACF,OAAO,aAAa,CAClB,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,EACxD,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,WAAW,CACZ,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,EAAsB;QAC5C,IAAI,cAAc,CAAC,UAAU,KAAK,SAAS,EAAE;YAC3C,MAAM,IAAI,iCAAa,CAAC,uEAAuE,CAAC,CAAC;SAClG;QACD,IAAI,EAAE,KAAK,cAAc,CAAC,UAAU,EAAE;YACpC,MAAM,IAAI,iCAAa,CAAC,wDAAwD,CAAC,CAAC;SACnF;QAED,EAAE,CAAC,SAAS,GAAG,cAAc,CAAC,cAAc,CAAC;QAE7C,cAAc,CAAC,UAAU,GAAG,SAAS,CAAC;QACtC,cAAc,CAAC,cAAc,GAAG,SAAS,CAAC;IAC5C,CAAC;;AA7KH,wCA8KC;AA7KgB,yBAAU,GAAmC,SAAS,CAAC;AAEvD,6BAAc,GAAoB,SAAS,CAAC,CAAC,sBAAsB","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 { InternalError } from '@rushstack/node-core-library';\nimport type * as TTypescript from 'typescript';\nimport {\n  ExtendedTypeScript,\n  IEmitResolver,\n  IEmitHost,\n  IEmitTransformers\n} from './internalTypings/TypeScriptInternals';\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\nexport class EmitFilesPatch {\n  private static _patchedTs: ExtendedTypeScript | undefined = undefined;\n\n  private static _baseEmitFiles: any | undefined = undefined; // eslint-disable-line\n\n  public static install(\n    ts: ExtendedTypeScript,\n    tsconfig: TTypescript.ParsedCommandLine,\n    moduleKindsToEmit: ICachedEmitModuleKind[],\n    changedFiles?: Set<TTypescript.SourceFile>\n  ): void {\n    if (EmitFilesPatch._patchedTs === ts) {\n      // We already patched this instance of TS\n      return;\n    }\n\n    if (EmitFilesPatch._patchedTs !== undefined) {\n      throw new InternalError(\n        'EmitFilesPatch.install() cannot be called without first uninstalling the existing patch'\n      );\n    }\n\n    EmitFilesPatch._patchedTs = ts;\n    EmitFilesPatch._baseEmitFiles = ts.emitFiles;\n\n    let foundPrimary: boolean = false;\n    let defaultModuleKind: TTypescript.ModuleKind;\n\n    for (const moduleKindToEmit of moduleKindsToEmit) {\n      if (moduleKindToEmit.isPrimary) {\n        if (foundPrimary) {\n          throw new Error('Multiple primary module emit kinds encountered.');\n        } else {\n          foundPrimary = true;\n        }\n\n        defaultModuleKind = moduleKindToEmit.moduleKind;\n      }\n    }\n\n    const patchedEmitFiles = (\n      resolver: IEmitResolver,\n      host: IEmitHost,\n      targetSourceFile: TTypescript.SourceFile | undefined,\n      emitTransformers: IEmitTransformers,\n      emitOnlyDtsFiles?: boolean,\n      onlyBuildInfo?: boolean,\n      forceDtsEmit?: boolean\n    ): TTypescript.EmitResult => {\n      if (onlyBuildInfo || emitOnlyDtsFiles) {\n        // There should only be one tsBuildInfo and one set of declaration files\n        return EmitFilesPatch._baseEmitFiles(\n          resolver,\n          host,\n          targetSourceFile,\n          emitTransformers,\n          emitOnlyDtsFiles,\n          onlyBuildInfo,\n          forceDtsEmit\n        );\n      } else {\n        if (targetSourceFile && changedFiles) {\n          changedFiles.add(targetSourceFile);\n        }\n\n        let defaultModuleKindResult: TTypescript.EmitResult;\n        const diagnostics: TTypescript.Diagnostic[] = [];\n        let emitSkipped: boolean = false;\n        for (const moduleKindToEmit of moduleKindsToEmit) {\n          const compilerOptions: TTypescript.CompilerOptions = moduleKindToEmit.isPrimary\n            ? {\n                ...tsconfig.options\n              }\n            : {\n                ...tsconfig.options,\n                module: moduleKindToEmit.moduleKind,\n                outDir: moduleKindToEmit.outFolderPath,\n\n                // Don't emit declarations for secondary module kinds\n                declaration: false,\n                declarationMap: false\n              };\n\n          if (!compilerOptions.outDir) {\n            throw new InternalError('Expected compilerOptions.outDir to be assigned');\n          }\n\n          const flavorResult: TTypescript.EmitResult = EmitFilesPatch._baseEmitFiles(\n            resolver,\n            {\n              ...host,\n              writeFile: EmitFilesPatch.wrapWriteFile(host.writeFile, moduleKindToEmit.jsExtensionOverride),\n              getCompilerOptions: () => compilerOptions\n            },\n            targetSourceFile,\n            ts.getTransformers(compilerOptions, undefined, emitOnlyDtsFiles),\n            emitOnlyDtsFiles,\n            onlyBuildInfo,\n            forceDtsEmit\n          );\n\n          emitSkipped = emitSkipped || flavorResult.emitSkipped;\n          for (const diagnostic of flavorResult.diagnostics) {\n            diagnostics.push(diagnostic);\n          }\n\n          if (moduleKindToEmit.moduleKind === defaultModuleKind) {\n            defaultModuleKindResult = flavorResult;\n          }\n          // Should results be aggregated, in case for whatever reason the diagnostics are not the same?\n        }\n\n        const mergedDiagnostics: readonly TTypescript.Diagnostic[] =\n          ts.sortAndDeduplicateDiagnostics(diagnostics);\n\n        return {\n          ...defaultModuleKindResult!,\n          diagnostics: mergedDiagnostics,\n          emitSkipped\n        };\n      }\n    };\n\n    // Override the underlying file emitter to run itself once for each flavor\n    // This is a rather inelegant way to convince the TypeScript compiler not to duplicate parse/link/check\n    ts.emitFiles = patchedEmitFiles;\n  }\n\n  public static get isInstalled(): boolean {\n    return this._patchedTs !== undefined;\n  }\n\n  /**\n   * Wraps the writeFile callback on the IEmitHost to override the .js extension, if applicable\n   */\n  public static wrapWriteFile(\n    baseWriteFile: TTypescript.WriteFileCallback,\n    jsExtensionOverride: string | undefined\n  ): TTypescript.WriteFileCallback {\n    if (!jsExtensionOverride) {\n      return baseWriteFile;\n    }\n\n    const replacementExtension: string = `${jsExtensionOverride}$1`;\n    return (\n      fileName: string,\n      data: string,\n      writeBOM: boolean,\n      onError?: ((message: string) => void) | undefined,\n      sourceFiles?: readonly TTypescript.SourceFile[] | undefined\n    ) => {\n      return baseWriteFile(\n        fileName.replace(/\\.js(\\.map)?$/g, replacementExtension),\n        data,\n        writeBOM,\n        onError,\n        sourceFiles\n      );\n    };\n  }\n\n  public static uninstall(ts: ExtendedTypeScript): void {\n    if (EmitFilesPatch._patchedTs === undefined) {\n      throw new InternalError('EmitFilesPatch.uninstall() cannot be called if no patch was installed');\n    }\n    if (ts !== EmitFilesPatch._patchedTs) {\n      throw new InternalError('EmitFilesPatch.uninstall() called for the wrong object');\n    }\n\n    ts.emitFiles = EmitFilesPatch._baseEmitFiles;\n\n    EmitFilesPatch._patchedTs = undefined;\n    EmitFilesPatch._baseEmitFiles = undefined;\n  }\n}\n"]}

package/lib/Performance.d.ts

@@ -0,0 +1,7 @@
+export declare type PerformanceMeasurer = <TResult extends object | void>(measurementName: string, fn: () => TResult) => TResult & {
+    duration: number;
+};
+export declare type PerformanceMeasurerAsync = <TResult extends object | void>(measurementName: string, fn: () => Promise<TResult>) => Promise<TResult & {
+    duration: number;
+}>;
+//# sourceMappingURL=Performance.d.ts.map

package/lib/Performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Performance.d.ts","sourceRoot":"","sources":["../src/Performance.ts"],"names":[],"mappings":"AAGA,oBAAY,mBAAmB,GAAG,CAAC,OAAO,SAAS,MAAM,GAAG,IAAI,EAC9D,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,OAAO,KACd,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,oBAAY,wBAAwB,GAAG,CAAC,OAAO,SAAS,MAAM,GAAG,IAAI,EACnE,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KACvB,OAAO,CAAC,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/lib/Performance.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Performance.js.map

package/lib/Performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Performance.js","sourceRoot":"","sources":["../src/Performance.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\nexport type PerformanceMeasurer = <TResult extends object | void>(\n  measurementName: string,\n  fn: () => TResult\n) => TResult & { duration: number };\n\nexport type PerformanceMeasurerAsync = <TResult extends object | void>(\n  measurementName: string,\n  fn: () => Promise<TResult>\n) => Promise<TResult & { duration: number }>;\n"]}

package/lib/TypeScriptBuilder.d.ts

@@ -0,0 +1,69 @@
+import type * as TTypescript from 'typescript';
+import type { IScopedLogger } from '@rushstack/heft';
+import type { ExtendedTypeScript } from './internalTypings/TypeScriptInternals';
+import type { ITypeScriptConfigurationJson } from './TypeScriptPlugin';
+import type { PerformanceMeasurer, PerformanceMeasurerAsync } from './Performance';
+export interface ITypeScriptBuilderConfiguration extends ITypeScriptConfigurationJson {
+    /**
+     * The root folder of the build.
+     */
+    buildFolderPath: string;
+    /**
+     * The folder to write build metadata.
+     */
+    buildMetadataFolderPath: string;
+    /**
+     * The path to the TypeScript tool.
+     */
+    typeScriptToolPath: string;
+    /**
+     * The path to the tsconfig file being built.
+     */
+    tsconfigPath: string;
+    /**
+     * Set this to change the maximum number of file handles that will be opened concurrently for writing.
+     * The default is 50.
+     */
+    maxWriteParallelism: number;
+    /**
+     * The scoped logger that the builder will log to.
+     */
+    scopedLogger: IScopedLogger;
+    /**
+     * The callback used to emit the typescript program (or programs) from the builder.
+     */
+    emitChangedFilesCallback: (program: TTypescript.Program, changedFiles?: Set<TTypescript.SourceFile>) => void;
+}
+export declare class TypeScriptBuilder {
+    private readonly _configuration;
+    private readonly _typescriptLogger;
+    private readonly _typescriptTerminal;
+    private _typescriptVersion;
+    private _typescriptParsedVersion;
+    private _capabilities;
+    private _useSolutionBuilder;
+    private _moduleKindsToEmit;
+    private __tsCacheFilePath;
+    private _tsReadJsonCache;
+    private _cachedFileSystem;
+    private get _tsCacheFilePath();
+    constructor(configuration: ITypeScriptBuilderConfiguration);
+    invokeAsync(): Promise<void>;
+    _runBuildAsync(ts: ExtendedTypeScript, measureTsPerformance: PerformanceMeasurer, measureTsPerformanceAsync: PerformanceMeasurerAsync): Promise<void>;
+    _runSolutionBuild(ts: ExtendedTypeScript, measureTsPerformance: PerformanceMeasurer): void;
+    private _logDiagnostics;
+    private _logEmitPerformance;
+    private _logReadPerformance;
+    private _printDiagnosticMessage;
+    private _getAdjustedDiagnosticCategory;
+    private _emit;
+    private _validateTsconfig;
+    private _addModuleKindToEmit;
+    private _loadTsconfig;
+    private _buildSolutionBuilderHost;
+    private _buildIncrementalCompilerHost;
+    private _getCachingTypeScriptSystem;
+    private _overrideTypeScriptReadJson;
+    private _parseModuleKind;
+}
+//# sourceMappingURL=TypeScriptBuilder.d.ts.map

package/lib/TypeScriptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptBuilder.d.ts","sourceRoot":"","sources":["../src/TypeScriptBuilder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAW/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEnF,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAI3B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,YAAY,EAAE,aAAa,CAAC;IAE5B;;OAEG;IACH,wBAAwB,EAAE,CACxB,OAAO,EAAE,WAAW,CAAC,OAAO,EAC5B,YAAY,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,KACvC,IAAI,CAAC;CACX;AA+CD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAY;IAEhD,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,wBAAwB,CAAiB;IAEjD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,mBAAmB,CAAW;IAEtC,OAAO,CAAC,kBAAkB,CAA2B;IAErD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,gBAAgB,CAAkD;IAC1E,OAAO,CAAC,iBAAiB,CAAgE;IAEzF,OAAO,KAAK,gBAAgB,GAuB3B;gBAEkB,aAAa,EAAE,+BAA+B;IAMpD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAgJ5B,cAAc,CACzB,EAAE,EAAE,kBAAkB,EACtB,oBAAoB,EAAE,mBAAmB,EACzC,yBAAyB,EAAE,wBAAwB,GAClD,OAAO,CAAC,IAAI,CAAC;IAqGT,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,GAAG,IAAI;IA8DjG,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,uBAAuB;IA0C/B,OAAO,CAAC,8BAA8B;IA2BtC,OAAO,CAAC,KAAK;IA4Bb,OAAO,CAAC,iBAAiB;IAyHzB,OAAO,CAAC,oBAAoB;IA8D5B,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,yBAAyB;IAqBjC,OAAO,CAAC,6BAA6B;IAWrC,OAAO,CAAC,2BAA2B;IAiGnC,OAAO,CAAC,2BAA2B;IAgCnC,OAAO,CAAC,gBAAgB;CAwBzB"}