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

package/lib/fileSystem/TypeScriptCachedFileSystem.js

@@ -0,0 +1,163 @@
+"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.TypeScriptCachedFileSystem = void 0;
+const node_core_library_1 = require("@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.
+ */
+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 (node_core_library_1.FileSystem.isNotExistError(e)) {
+                    return false;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+        this.directoryExists = (path) => {
+            try {
+                const stats = this.getStatistics(path);
+                return stats.isDirectory();
+            }
+            catch (e) {
+                if (node_core_library_1.FileSystem.isNotExistError(e)) {
+                    return false;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+        this.getStatistics = (path) => {
+            return this._withCaching(path, node_core_library_1.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)) {
+                node_core_library_1.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 node_core_library_1.FileSystem.ensureFolderAsync(folderPath);
+                this._invalidateCacheEntry(folderPath);
+            }
+        };
+        this.writeFile = (filePath, contents, options) => {
+            node_core_library_1.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) || node_core_library_1.Encoding.Utf8);
+            if (options === null || options === void 0 ? void 0 : options.convertLineEndings) {
+                contents = node_core_library_1.Text.convertTo(contents, options.convertLineEndings);
+            }
+            return contents;
+        };
+        this.readFileToBuffer = (filePath) => {
+            return this._withCaching(filePath, node_core_library_1.FileSystem.readFileToBuffer, this._readFileCache);
+        };
+        this.copyFileAsync = async (options) => {
+            await node_core_library_1.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 || !node_core_library_1.FileSystem.isFileDoesNotExistError(cachedError)) {
+                node_core_library_1.FileSystem.deleteFile(filePath);
+                this._invalidateCacheEntry(filePath);
+            }
+            else if (options === null || options === void 0 ? void 0 : options.throwIfNotExists) {
+                throw cachedError;
+            }
+        };
+        this.createHardLinkAsync = async (options) => {
+            await node_core_library_1.FileSystem.createHardLinkAsync(options);
+            this._invalidateCacheEntry(options.newLinkPath);
+        };
+        this.getRealPath = (linkPath) => {
+            return this._withCaching(linkPath, (linkPath) => {
+                try {
+                    return node_core_library_1.FileSystem.getRealPath(linkPath);
+                }
+                catch (e) {
+                    if (node_core_library_1.FileSystem.isNotExistError(e)) {
+                        // TypeScript's ts.sys.realpath returns the path it's provided if that path doesn't exist
+                        return linkPath;
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }, this._realPathCache);
+        };
+        this.readFolderFilesAndDirectories = (folderPath) => {
+            return this._withCaching(folderPath, (path) => {
+                const folderEntries = node_core_library_1.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) => node_core_library_1.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);
+    }
+}
+exports.TypeScriptCachedFileSystem = TypeScriptCachedFileSystem;
+//# sourceMappingURL=TypeScriptCachedFileSystem.js.map

package/lib/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  IFileSystemWriteFileOptions,\n  IFileSystemReadFileOptions,\n  IFileSystemCopyFileOptions,\n  IFileSystemDeleteFileOptions,\n  IFileSystemCreateLinkOptions,\n  FileSystem,\n  FileSystemStats,\n  Sort,\n  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      (linkPath: string) => {\n        try {\n          return FileSystem.getRealPath(linkPath);\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 linkPath;\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/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A Heft plugin for using TypeScript.
+ *
+ * @packageDocumentation
+ */
+export type { IEmitModuleKind, IStaticAssetsCopyConfiguration, ITypeScriptConfigurationJson, IPartialTsconfigCompilerOptions, IPartialTsconfig, IChangedFilesHookOptions, ITypeScriptPluginAccessor } from './TypeScriptPlugin';
+export { PLUGIN_NAME as TypeScriptPluginName, loadTypeScriptConfigurationFileAsync, loadPartialTsconfigFileAsync } from './TypeScriptPlugin';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,YAAY,EACV,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,+BAA+B,EAC/B,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,WAAW,IAAI,oBAAoB,EACnC,oCAAoC,EACpC,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC"}

package/lib/index.js

@@ -0,0 +1,10 @@
+"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.loadPartialTsconfigFileAsync = exports.loadTypeScriptConfigurationFileAsync = exports.TypeScriptPluginName = void 0;
+var TypeScriptPlugin_1 = require("./TypeScriptPlugin");
+Object.defineProperty(exports, "TypeScriptPluginName", { enumerable: true, get: function () { return TypeScriptPlugin_1.PLUGIN_NAME; } });
+Object.defineProperty(exports, "loadTypeScriptConfigurationFileAsync", { enumerable: true, get: function () { return TypeScriptPlugin_1.loadTypeScriptConfigurationFileAsync; } });
+Object.defineProperty(exports, "loadPartialTsconfigFileAsync", { enumerable: true, get: function () { return TypeScriptPlugin_1.loadPartialTsconfigFileAsync; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAkB3D,uDAI4B;AAH1B,wHAAA,WAAW,OAAwB;AACnC,wIAAA,oCAAoC,OAAA;AACpC,gIAAA,4BAA4B,OAAA","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"]}

package/lib/internalTypings/TypeScriptInternals.d.ts

@@ -0,0 +1,90 @@
+import type * as TTypescript from 'typescript';
+/**
+ * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L3969-L4010
+ */
+export interface IEmitResolver {
+}
+/**
+ * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L5969-L5988
+ */
+export interface IEmitHost {
+    writeFile: TTypescript.WriteFileCallback;
+}
+/**
+ * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L3338-L3341
+ */
+export interface IEmitTransformers {
+}
+/**
+ * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L3799-L3803
+ */
+export interface IResolveModuleNameResolutionHost {
+    getCanonicalFileName(p: string): string;
+    getCommonSourceDirectory(): string;
+    getCurrentDirectory(): string;
+}
+/**
+ * @beta
+ */
+export interface IExtendedTypeScript {
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L3
+     */
+    performance: {
+        /**
+         * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L110-L116
+         */
+        enable(): void;
+        /**
+         * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L55-L61
+         */
+        mark(performanceMaker: string): void;
+        /**
+         * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L72-L78
+         */
+        measure(measureName: string, startMarkName?: string, endMarkName?: string): void;
+        /**
+         * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L94-L96
+         */
+        getDuration(measureName: string): number;
+        /**
+         * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/performance.ts#L85-L87
+         */
+        getCount(measureName: string): number;
+    };
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L4720-L4734
+     */
+    readJson(filePath: string): object;
+    /**
+     * https://github.com/microsoft/TypeScript/blob/782c09d783e006a697b4ba6d1e7ec2f718ce8393/src/compiler/utilities.ts#L6540
+     */
+    matchFiles(path: string, extensions: ReadonlyArray<string> | undefined, excludes: ReadonlyArray<string> | undefined, includes: ReadonlyArray<string> | undefined, useCaseSensitiveFileNames: boolean, currentDirectory: string, depth: number | undefined, getFileSystemEntries: (path: string) => {
+        readonly files: ReadonlyArray<string>;
+        readonly directories: ReadonlyArray<string>;
+    }, realpath: (path: string) => string, directoryExists: (path: string) => boolean): string[];
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/emitter.ts#L261-L614
+     */
+    emitFiles(resolver: IEmitResolver, host: IEmitHost, targetSourceFile: TTypescript.SourceFile | undefined, emitTransformers: IEmitTransformers, emitOnlyDtsFiles?: boolean, onlyBuildInfo?: boolean, forceDtsEmit?: boolean): TTypescript.EmitResult;
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/transformer.ts#L30-L35
+     */
+    getTransformers(compilerOptions: TTypescript.CompilerOptions, customTransformers?: TTypescript.CustomTransformers, emitOnlyDtsFiles?: boolean): IEmitTransformers;
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L6100-L6108
+     */
+    removeFileExtension(path: string): string;
+    /**
+     * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L3826-L3833
+     */
+    getExternalModuleNameFromPath(host: IResolveModuleNameResolutionHost, fileName: string, referencePath?: string): string;
+    Diagnostics: {
+        Found_1_error_Watching_for_file_changes: TTypescript.DiagnosticMessage;
+        Found_0_errors_Watching_for_file_changes: TTypescript.DiagnosticMessage;
+        Property_0_has_no_initializer_and_is_not_definitely_assigned_in_the_constructor: TTypescript.DiagnosticMessage;
+        Element_implicitly_has_an_any_type_because_expression_of_type_0_can_t_be_used_to_index_type_1: TTypescript.DiagnosticMessage;
+    };
+}
+export declare type ExtendedTypeScript = typeof TTypescript & IExtendedTypeScript;
+//# sourceMappingURL=TypeScriptInternals.d.ts.map

package/lib/internalTypings/TypeScriptInternals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptInternals.d.ts","sourceRoot":"","sources":["../../src/internalTypings/TypeScriptInternals.ts"],"names":[],"mappings":"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"}

package/lib/internalTypings/TypeScriptInternals.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=TypeScriptInternals.js.map

package/lib/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\n// The specifics of these types aren't important\n/**\n * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L3969-L4010\n */\nexport interface IEmitResolver {}\n\n/**\n * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L5969-L5988\n */\nexport interface IEmitHost {\n  writeFile: TTypescript.WriteFileCallback;\n}\n\n/**\n * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/types.ts#L3338-L3341\n */\nexport interface IEmitTransformers {}\n\n/**\n * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L3799-L3803\n */\nexport interface IResolveModuleNameResolutionHost {\n  getCanonicalFileName(p: string): string;\n  getCommonSourceDirectory(): string;\n  getCurrentDirectory(): string;\n}\n\n/**\n * @beta\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#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  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L4720-L4734\n   */\n  readJson(filePath: string): object;\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  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/emitter.ts#L261-L614\n   */\n  emitFiles(\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\n  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/transformer.ts#L30-L35\n   */\n  getTransformers(\n    compilerOptions: TTypescript.CompilerOptions,\n    customTransformers?: TTypescript.CustomTransformers,\n    emitOnlyDtsFiles?: boolean\n  ): IEmitTransformers;\n\n  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L6100-L6108\n   */\n  removeFileExtension(path: string): string;\n\n  /**\n   * https://github.com/microsoft/TypeScript/blob/5f597e69b2e3b48d788cb548df40bcb703c8adb1/src/compiler/utilities.ts#L3826-L3833\n   */\n  getExternalModuleNameFromPath(\n    host: IResolveModuleNameResolutionHost,\n    fileName: string,\n    referencePath?: string\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"]}

package/lib/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/schemas/typescript.schema.json

@@ -0,0 +1,101 @@
+{
+  "$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.",
+      "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"]
+      }
+    },
+
+    "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"
+    },
+
+    "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"
+    },
+
+    "maxWriteParallelism": {
+      "description": "Set this to change the maximum write parallelism. The default is 50.",
+      "type": "number"
+    },
+
+    "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/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@rushstack/heft-typescript-plugin",
+  "version": "0.1.0-dev.0",
+  "description": "Heft plugin for TypeScript",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rushstack.git",
+    "directory": "heft-plugins/heft-typescript-plugin"
+  },
+  "homepage": "https://rushstack.io/pages/heft/overview/",
+  "main": "lib/index.js",
+  "types": "dist/heft-typescript-plugin.d.ts",
+  "license": "MIT",
+  "peerDependencies": {
+    "@rushstack/heft": "^0.48.0-dev.0"
+  },
+  "dependencies": {
+    "@rushstack/node-core-library": "3.52.0",
+    "@rushstack/heft-config-file": "0.10.0",
+    "@types/tapable": "1.0.6",
+    "semver": "~7.3.0",
+    "tapable": "1.1.3"
+  },
+  "devDependencies": {
+    "@rushstack/eslint-config": "3.0.1",
+    "@rushstack/heft": "0.48.0-dev.0",
+    "@rushstack/heft-legacy": "npm:@rushstack/heft@0.47.0",
+    "@rushstack/heft-node-rig": "1.10.0",
+    "@types/node": "12.20.24",
+    "@types/semver": "7.3.5",
+    "typescript": "~4.7.4"
+  },
+  "scripts": {
+    "build": "node ./node_modules/@rushstack/heft-legacy/bin/heft --unmanaged build --clean",
+    "start": "node ./node_modules/@rushstack/heft-legacy/bin/heft --unmanaged test --clean --watch",
+    "_phase:build": "node ./node_modules/@rushstack/heft-legacy/bin/heft --unmanaged build --clean",
+    "_phase:test": "node ./node_modules/@rushstack/heft-legacy/bin/heft --unmanaged test --no-build"
+  }
+}