@rushstack/heft-typescript-plugin 0.0.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,110 @@
+/**
+ * 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;
+    /**
+     * If true, and the tsconfig has \"isolatedModules\": true, then transpilation will happen in parallel in a worker thread.
+     */
+    useTranspilerWorker?: 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;
+}
+
+/**
+ * @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: 'typescript-plugin';
+
+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.35.0"
+    }
+  ]
+}

package/heft-plugin.json

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

package/lib/Performance.d.ts

@@ -0,0 +1,7 @@
+export type PerformanceMeasurer = <TResult extends object | void>(measurementName: string, fn: () => TResult) => TResult & {
+    duration: number;
+};
+export 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,MAAM,MAAM,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,MAAM,MAAM,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/TranspilerWorker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TranspilerWorker.d.ts.map

package/lib/TranspilerWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranspilerWorker.d.ts","sourceRoot":"","sources":["../src/TranspilerWorker.ts"],"names":[],"mappings":""}

package/lib/TranspilerWorker.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+const node_worker_threads_1 = require("node:worker_threads");
+const configureProgramForMultiEmit_1 = require("./configureProgramForMultiEmit");
+const typedWorkerData = node_worker_threads_1.workerData;
+const ts = require(typedWorkerData.typeScriptToolPath);
+function handleMessage(message) {
+    if (!message) {
+        process.exit(0);
+    }
+    try {
+        const response = runTranspiler(message);
+        node_worker_threads_1.parentPort.postMessage(response);
+    }
+    catch (err) {
+        const errorResponse = {
+            requestId: message.requestId,
+            type: 'error',
+            result: Object.assign({ message: err.message }, Object.fromEntries(Object.entries(err)))
+        };
+        node_worker_threads_1.parentPort.postMessage(errorResponse);
+    }
+}
+function runTranspiler(message) {
+    const { requestId, compilerOptions, moduleKindsToEmit, filesToTranspile } = message;
+    const fullySkipTypeCheck = 
+    /* TypeScript 5+ */ compilerOptions.verbatimModuleSyntax ||
+        /* TypeScript 4 */ compilerOptions.importsNotUsedAsValues === ts.ImportsNotUsedAsValues.Error;
+    for (const [option, value] of Object.entries(ts.getDefaultCompilerOptions())) {
+        if (compilerOptions[option] === undefined) {
+            compilerOptions[option] = value;
+        }
+    }
+    const { target: rawTarget } = compilerOptions;
+    for (const option of ts.transpileOptionValueCompilerOptions) {
+        compilerOptions[option.name] = option.transpileOptionValue;
+    }
+    compilerOptions.suppressOutputPathCheck = true;
+    compilerOptions.skipDefaultLibCheck = true;
+    // To fully disable the type checker, we have to set `hasNoDefaultLib: true` on every source file.
+    // However, doing so loses the information about which imports are used.
+    // To retain the imports, we use `preserveValueImports`. However, if some imports are only used for types,
+    // this will produce invalid runtime output unless said imports are marked with `type `.
+    // Thus we can only enable this optimization if `verbatimModuleSyntax` is enabled (or equivalent).
+    compilerOptions.preserveValueImports = fullySkipTypeCheck;
+    const sourceFileByPath = new Map();
+    const includedFiles = [];
+    for (const [fileName, sourceText] of filesToTranspile) {
+        if (sourceText) {
+            const sourceFile = ts.createSourceFile(fileName, sourceText, rawTarget);
+            sourceFile.hasNoDefaultLib = fullySkipTypeCheck;
+            sourceFileByPath.set(fileName, sourceFile);
+            includedFiles.push(fileName);
+        }
+    }
+    const newLine = ts.getNewLineCharacter(compilerOptions);
+    const compilerHost = {
+        getSourceFile: (fileName) => sourceFileByPath.get(fileName),
+        writeFile: ts.sys.writeFile,
+        getDefaultLibFileName: () => 'lib.d.ts',
+        useCaseSensitiveFileNames: () => true,
+        getCanonicalFileName: (fileName) => fileName,
+        getCurrentDirectory: () => '',
+        getNewLine: () => newLine,
+        fileExists: (fileName) => sourceFileByPath.has(fileName),
+        readFile: () => '',
+        directoryExists: () => true,
+        getDirectories: () => []
+    };
+    const program = ts.createProgram(includedFiles, compilerOptions, compilerHost);
+    (0, configureProgramForMultiEmit_1.configureProgramForMultiEmit)(program, ts, moduleKindsToEmit, 'transpile');
+    const result = program.emit(undefined, 
+    // The writeFile callback must be provided for the multi-emit redirector
+    ts.sys.writeFile, undefined, undefined, undefined);
+    const response = {
+        requestId,
+        type: 'success',
+        result
+    };
+    return response;
+}
+node_worker_threads_1.parentPort.on('message', handleMessage);
+//# sourceMappingURL=TranspilerWorker.js.map

package/lib/TranspilerWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranspilerWorker.js","sourceRoot":"","sources":["../src/TranspilerWorker.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.\nimport { parentPort, workerData } from 'node:worker_threads';\n\nimport type * as TTypescript from 'typescript';\nimport type {\n  ITranspilationErrorMessage,\n  ITranspilationRequestMessage,\n  ITranspilationSuccessMessage,\n  ITypescriptWorkerData\n} from './types';\nimport type { ExtendedTypeScript } from './internalTypings/TypeScriptInternals';\nimport { configureProgramForMultiEmit } from './configureProgramForMultiEmit';\n\nconst typedWorkerData: ITypescriptWorkerData = workerData;\n\nconst ts: ExtendedTypeScript = require(typedWorkerData.typeScriptToolPath);\n\nfunction handleMessage(message: ITranspilationRequestMessage | false): void {\n  if (!message) {\n    process.exit(0);\n  }\n\n  try {\n    const response: ITranspilationSuccessMessage = runTranspiler(message);\n    parentPort!.postMessage(response);\n  } catch (err) {\n    const errorResponse: ITranspilationErrorMessage = {\n      requestId: message.requestId,\n      type: 'error',\n      result: {\n        message: err.message,\n        ...Object.fromEntries(Object.entries(err))\n      }\n    };\n    parentPort!.postMessage(errorResponse);\n  }\n}\n\nfunction runTranspiler(message: ITranspilationRequestMessage): ITranspilationSuccessMessage {\n  const { requestId, compilerOptions, moduleKindsToEmit, filesToTranspile } = message;\n\n  const fullySkipTypeCheck: boolean =\n    /* TypeScript 5+ */ compilerOptions.verbatimModuleSyntax ||\n    /* TypeScript 4 */ compilerOptions.importsNotUsedAsValues === ts.ImportsNotUsedAsValues.Error;\n\n  for (const [option, value] of Object.entries(ts.getDefaultCompilerOptions())) {\n    if (compilerOptions[option] === undefined) {\n      compilerOptions[option] = value;\n    }\n  }\n\n  const { target: rawTarget } = compilerOptions;\n\n  for (const option of ts.transpileOptionValueCompilerOptions) {\n    compilerOptions[option.name] = option.transpileOptionValue;\n  }\n\n  compilerOptions.suppressOutputPathCheck = true;\n  compilerOptions.skipDefaultLibCheck = true;\n  // To fully disable the type checker, we have to set `hasNoDefaultLib: true` on every source file.\n  // However, doing so loses the information about which imports are used.\n  // To retain the imports, we use `preserveValueImports`. However, if some imports are only used for types,\n  // this will produce invalid runtime output unless said imports are marked with `type `.\n  // Thus we can only enable this optimization if `verbatimModuleSyntax` is enabled (or equivalent).\n  compilerOptions.preserveValueImports = fullySkipTypeCheck;\n\n  const sourceFileByPath: Map<string, TTypescript.SourceFile> = new Map();\n\n  const includedFiles: string[] = [];\n  for (const [fileName, sourceText] of filesToTranspile) {\n    if (sourceText) {\n      const sourceFile: TTypescript.SourceFile = ts.createSourceFile(fileName, sourceText, rawTarget!);\n      sourceFile.hasNoDefaultLib = fullySkipTypeCheck;\n      sourceFileByPath.set(fileName, sourceFile);\n      includedFiles.push(fileName);\n    }\n  }\n\n  const newLine: string = ts.getNewLineCharacter(compilerOptions);\n\n  const compilerHost: TTypescript.CompilerHost = {\n    getSourceFile: (fileName: string) => sourceFileByPath.get(fileName),\n    writeFile: ts.sys.writeFile,\n    getDefaultLibFileName: () => 'lib.d.ts',\n    useCaseSensitiveFileNames: () => true,\n    getCanonicalFileName: (fileName: string) => fileName,\n    getCurrentDirectory: () => '',\n    getNewLine: () => newLine,\n    fileExists: (fileName: string) => sourceFileByPath.has(fileName),\n    readFile: () => '',\n    directoryExists: () => true,\n    getDirectories: () => []\n  };\n\n  const program: TTypescript.Program = ts.createProgram(includedFiles, compilerOptions, compilerHost);\n\n  configureProgramForMultiEmit(program, ts, moduleKindsToEmit, 'transpile');\n\n  const result: TTypescript.EmitResult = program.emit(\n    undefined,\n    // The writeFile callback must be provided for the multi-emit redirector\n    ts.sys.writeFile,\n    undefined,\n    undefined,\n    undefined\n  );\n\n  const response: ITranspilationSuccessMessage = {\n    requestId,\n    type: 'success',\n    result\n  };\n\n  return response;\n}\n\nparentPort!.on('message', handleMessage);\n"]}

package/lib/TypeScriptBuilder.d.ts

@@ -0,0 +1,96 @@
+/// <reference types="node" />
+import { Worker } from 'worker_threads';
+import type * as TTypescript from 'typescript';
+import type { IScopedLogger } from '@rushstack/heft';
+import type { ExtendedTypeScript, IExtendedSolutionBuilder } from './internalTypings/TypeScriptInternals';
+import type { ITypeScriptConfigurationJson } from './TypeScriptPlugin';
+import type { PerformanceMeasurer } 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;
+    /**
+     * 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;
+}
+type TWatchProgram = TTypescript.WatchOfFilesAndCompilerOptions<TTypescript.EmitAndSemanticDiagnosticsBuilderProgram>;
+interface IPendingWork {
+    (): void;
+}
+interface ITranspileSignal {
+    resolve: (result: TTypescript.EmitResult) => void;
+    reject: (error: Error) => void;
+}
+interface ITypeScriptTool {
+    ts: ExtendedTypeScript;
+    measureSync: PerformanceMeasurer;
+    sourceFileCache: Map<string, TTypescript.SourceFile>;
+    watchProgram: TWatchProgram | undefined;
+    solutionBuilder: IExtendedSolutionBuilder | undefined;
+    rawDiagnostics: TTypescript.Diagnostic[];
+    pendingOperations: Set<IPendingWork>;
+    executing: boolean;
+    worker: Worker | undefined;
+    pendingTranspilePromises: Map<number, Promise<TTypescript.EmitResult>>;
+    pendingTranspileSignals: Map<number, ITranspileSignal>;
+    reportDiagnostic: TTypescript.DiagnosticReporter;
+    clearTimeout: (timeout: IPendingWork) => void;
+    setTimeout: <T extends unknown[]>(timeout: (...args: T) => void, ms: number, ...args: T) => IPendingWork;
+}
+export declare class TypeScriptBuilder {
+    private readonly _configuration;
+    private readonly _typescriptLogger;
+    private readonly _typescriptTerminal;
+    private _typescriptVersion;
+    private _typescriptParsedVersion;
+    private _capabilities;
+    private _useSolutionBuilder;
+    private _moduleKindsToEmit;
+    private readonly _suppressedDiagnosticCodes;
+    private __tsCacheFilePath;
+    private _tool;
+    private _nextRequestId;
+    private get _tsCacheFilePath();
+    constructor(configuration: ITypeScriptBuilderConfiguration);
+    invokeAsync(onChangeDetected?: () => void): Promise<void>;
+    _runWatchAsync(tool: ITypeScriptTool): Promise<void>;
+    _runBuildAsync(tool: ITypeScriptTool): Promise<void>;
+    _runSolutionBuildAsync(tool: ITypeScriptTool): Promise<void>;
+    private _logDiagnostics;
+    private _logEmitPerformance;
+    private _logReadPerformance;
+    private _printDiagnosticMessage;
+    private _getAdjustedDiagnosticCategory;
+    private _validateTsconfig;
+    private _addModuleKindToEmit;
+    private _loadTsconfig;
+    private _getCreateBuilderProgram;
+    private _buildSolutionBuilderHost;
+    private _buildIncrementalCompilerHost;
+    private _buildWatchCompilerHost;
+    private _changeCompilerHostToUseCache;
+    private _buildWatchSolutionBuilderHost;
+    private _parseModuleKind;
+    private _queueTranspileInWorker;
+    private _cleanupWorker;
+}
+export {};
+//# 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":"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"}