@rushstack/heft-typescript-plugin 0.0.0

package/lib/configureProgramForMultiEmit.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureProgramForMultiEmit = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+// symbols for attaching hidden metadata to ts.Program instances.
+const INNER_GET_COMPILER_OPTIONS_SYMBOL = Symbol('getCompilerOptions');
+const INNER_EMIT_SYMBOL = Symbol('emit');
+const JS_EXTENSION_REGEX = /\.js(\.map)?$/;
+function wrapWriteFile(baseWriteFile, jsExtensionOverride) {
+    if (!jsExtensionOverride) {
+        return baseWriteFile;
+    }
+    const replacementExtension = `${jsExtensionOverride}$1`;
+    return (fileName, data, writeBOM, onError, sourceFiles) => {
+        return baseWriteFile(fileName.replace(JS_EXTENSION_REGEX, replacementExtension), data, writeBOM, onError, sourceFiles);
+    };
+}
+function configureProgramForMultiEmit(innerProgram, ts, moduleKindsToEmit, mode) {
+    const program = innerProgram;
+    // Check to see if this Program has already been modified.
+    let { [INNER_EMIT_SYMBOL]: innerEmit, [INNER_GET_COMPILER_OPTIONS_SYMBOL]: innerGetCompilerOptions } = program;
+    if (!innerGetCompilerOptions) {
+        program[INNER_GET_COMPILER_OPTIONS_SYMBOL] = innerGetCompilerOptions = program.getCompilerOptions;
+    }
+    if (!innerEmit) {
+        program[INNER_EMIT_SYMBOL] = innerEmit = program.emit;
+    }
+    let foundPrimary = false;
+    let defaultModuleKind;
+    const multiEmitMap = new Map();
+    for (const moduleKindToEmit of moduleKindsToEmit) {
+        const kindCompilerOptions = moduleKindToEmit.isPrimary
+            ? Object.assign({}, innerGetCompilerOptions()) : Object.assign(Object.assign({}, innerGetCompilerOptions()), { module: moduleKindToEmit.moduleKind, outDir: moduleKindToEmit.outFolderPath, 
+            // Don't emit declarations for secondary module kinds
+            declaration: false, declarationMap: false });
+        if (!kindCompilerOptions.outDir) {
+            throw new node_core_library_1.InternalError('Expected compilerOptions.outDir to be assigned');
+        }
+        if (mode === 'transpile') {
+            kindCompilerOptions.declaration = false;
+            kindCompilerOptions.declarationMap = false;
+        }
+        else if (mode === 'declaration') {
+            kindCompilerOptions.emitDeclarationOnly = true;
+        }
+        if (moduleKindToEmit.isPrimary || mode !== 'declaration') {
+            multiEmitMap.set(moduleKindToEmit, kindCompilerOptions);
+        }
+        if (moduleKindToEmit.isPrimary) {
+            if (foundPrimary) {
+                throw new Error('Multiple primary module emit kinds encountered.');
+            }
+            else {
+                foundPrimary = true;
+            }
+            defaultModuleKind = moduleKindToEmit.moduleKind;
+        }
+    }
+    const changedFiles = new Set();
+    program.emit = (targetSourceFile, writeFile, cancellationToken, emitOnlyDtsFiles, customTransformers) => {
+        if (emitOnlyDtsFiles) {
+            return program[INNER_EMIT_SYMBOL](targetSourceFile, writeFile, cancellationToken, emitOnlyDtsFiles, customTransformers);
+        }
+        if (targetSourceFile && changedFiles) {
+            changedFiles.add(targetSourceFile);
+        }
+        const originalCompilerOptions = program[INNER_GET_COMPILER_OPTIONS_SYMBOL]();
+        let defaultModuleKindResult;
+        const diagnostics = [];
+        let emitSkipped = false;
+        try {
+            for (const [moduleKindToEmit, kindCompilerOptions] of multiEmitMap) {
+                program.getCompilerOptions = () => kindCompilerOptions;
+                // Need to mutate the compiler options for the `module` field specifically, because emitWorker() captures
+                // options in the closure and passes it to `ts.getTransformers()`
+                originalCompilerOptions.module = moduleKindToEmit.moduleKind;
+                const flavorResult = program[INNER_EMIT_SYMBOL](targetSourceFile, writeFile && wrapWriteFile(writeFile, moduleKindToEmit.jsExtensionOverride), cancellationToken, emitOnlyDtsFiles, customTransformers);
+                emitSkipped = emitSkipped || flavorResult.emitSkipped;
+                // Need to aggregate diagnostics because some are impacted by the target module type
+                for (const diagnostic of flavorResult.diagnostics) {
+                    diagnostics.push(diagnostic);
+                }
+                if (moduleKindToEmit.moduleKind === defaultModuleKind) {
+                    defaultModuleKindResult = flavorResult;
+                }
+            }
+            const mergedDiagnostics = ts.sortAndDeduplicateDiagnostics(diagnostics);
+            return Object.assign(Object.assign({}, defaultModuleKindResult), { changedSourceFiles: changedFiles, diagnostics: mergedDiagnostics, emitSkipped });
+        }
+        finally {
+            // Restore the original compiler options and module kind for future calls
+            program.getCompilerOptions = program[INNER_GET_COMPILER_OPTIONS_SYMBOL];
+            originalCompilerOptions.module = defaultModuleKind;
+        }
+    };
+    return { changedFiles };
+}
+exports.configureProgramForMultiEmit = configureProgramForMultiEmit;
+//# sourceMappingURL=configureProgramForMultiEmit.js.map

package/lib/configureProgramForMultiEmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configureProgramForMultiEmit.js","sourceRoot":"","sources":["../src/configureProgramForMultiEmit.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 type * as TTypescript from 'typescript';\nimport { InternalError } from '@rushstack/node-core-library';\n\nimport type { ExtendedTypeScript } from './internalTypings/TypeScriptInternals';\nimport type { ICachedEmitModuleKind } from './types';\n\n// symbols for attaching hidden metadata to ts.Program instances.\nconst INNER_GET_COMPILER_OPTIONS_SYMBOL: unique symbol = Symbol('getCompilerOptions');\nconst INNER_EMIT_SYMBOL: unique symbol = Symbol('emit');\n\nconst JS_EXTENSION_REGEX: RegExp = /\\.js(\\.map)?$/;\n\nfunction wrapWriteFile(\n  this: void,\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_EXTENSION_REGEX, replacementExtension),\n      data,\n      writeBOM,\n      onError,\n      sourceFiles\n    );\n  };\n}\n\nexport function configureProgramForMultiEmit(\n  this: void,\n  innerProgram: TTypescript.Program,\n  ts: ExtendedTypeScript,\n  moduleKindsToEmit: ICachedEmitModuleKind[],\n  mode: 'transpile' | 'declaration' | 'both'\n): { changedFiles: Set<TTypescript.SourceFile> } {\n  interface IProgramWithMultiEmit extends TTypescript.Program {\n    // Attach the originals to the Program instance to avoid modifying the same Program twice.\n    // Don't use WeakMap because this Program could theoretically get a { ... } applied to it.\n    [INNER_GET_COMPILER_OPTIONS_SYMBOL]?: TTypescript.Program['getCompilerOptions'];\n    [INNER_EMIT_SYMBOL]?: TTypescript.Program['emit'];\n  }\n\n  const program: IProgramWithMultiEmit = innerProgram;\n\n  // Check to see if this Program has already been modified.\n  let { [INNER_EMIT_SYMBOL]: innerEmit, [INNER_GET_COMPILER_OPTIONS_SYMBOL]: innerGetCompilerOptions } =\n    program;\n\n  if (!innerGetCompilerOptions) {\n    program[INNER_GET_COMPILER_OPTIONS_SYMBOL] = innerGetCompilerOptions = program.getCompilerOptions;\n  }\n\n  if (!innerEmit) {\n    program[INNER_EMIT_SYMBOL] = innerEmit = program.emit;\n  }\n\n  let foundPrimary: boolean = false;\n  let defaultModuleKind: TTypescript.ModuleKind;\n\n  const multiEmitMap: Map<ICachedEmitModuleKind, TTypescript.CompilerOptions> = new Map();\n  for (const moduleKindToEmit of moduleKindsToEmit) {\n    const kindCompilerOptions: TTypescript.CompilerOptions = moduleKindToEmit.isPrimary\n      ? {\n          ...innerGetCompilerOptions()\n        }\n      : {\n          ...innerGetCompilerOptions(),\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    if (!kindCompilerOptions.outDir) {\n      throw new InternalError('Expected compilerOptions.outDir to be assigned');\n    }\n    if (mode === 'transpile') {\n      kindCompilerOptions.declaration = false;\n      kindCompilerOptions.declarationMap = false;\n    } else if (mode === 'declaration') {\n      kindCompilerOptions.emitDeclarationOnly = true;\n    }\n\n    if (moduleKindToEmit.isPrimary || mode !== 'declaration') {\n      multiEmitMap.set(moduleKindToEmit, kindCompilerOptions);\n    }\n\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 changedFiles: Set<TTypescript.SourceFile> = new Set();\n\n  program.emit = (\n    targetSourceFile?: TTypescript.SourceFile,\n    writeFile?: TTypescript.WriteFileCallback,\n    cancellationToken?: TTypescript.CancellationToken,\n    emitOnlyDtsFiles?: boolean,\n    customTransformers?: TTypescript.CustomTransformers\n  ) => {\n    if (emitOnlyDtsFiles) {\n      return program[INNER_EMIT_SYMBOL]!(\n        targetSourceFile,\n        writeFile,\n        cancellationToken,\n        emitOnlyDtsFiles,\n        customTransformers\n      );\n    }\n\n    if (targetSourceFile && changedFiles) {\n      changedFiles.add(targetSourceFile);\n    }\n\n    const originalCompilerOptions: TTypescript.CompilerOptions =\n      program[INNER_GET_COMPILER_OPTIONS_SYMBOL]!();\n\n    let defaultModuleKindResult: TTypescript.EmitResult;\n    const diagnostics: TTypescript.Diagnostic[] = [];\n    let emitSkipped: boolean = false;\n    try {\n      for (const [moduleKindToEmit, kindCompilerOptions] of multiEmitMap) {\n        program.getCompilerOptions = () => kindCompilerOptions;\n        // Need to mutate the compiler options for the `module` field specifically, because emitWorker() captures\n        // options in the closure and passes it to `ts.getTransformers()`\n        originalCompilerOptions.module = moduleKindToEmit.moduleKind;\n        const flavorResult: TTypescript.EmitResult = program[INNER_EMIT_SYMBOL]!(\n          targetSourceFile,\n          writeFile && wrapWriteFile(writeFile, moduleKindToEmit.jsExtensionOverride),\n          cancellationToken,\n          emitOnlyDtsFiles,\n          customTransformers\n        );\n\n        emitSkipped = emitSkipped || flavorResult.emitSkipped;\n        // Need to aggregate diagnostics because some are impacted by the target module type\n        for (const diagnostic of flavorResult.diagnostics) {\n          diagnostics.push(diagnostic);\n        }\n\n        if (moduleKindToEmit.moduleKind === defaultModuleKind) {\n          defaultModuleKindResult = flavorResult;\n        }\n      }\n\n      const mergedDiagnostics: readonly TTypescript.Diagnostic[] =\n        ts.sortAndDeduplicateDiagnostics(diagnostics);\n\n      return {\n        ...defaultModuleKindResult!,\n        changedSourceFiles: changedFiles,\n        diagnostics: mergedDiagnostics,\n        emitSkipped\n      };\n    } finally {\n      // Restore the original compiler options and module kind for future calls\n      program.getCompilerOptions = program[INNER_GET_COMPILER_OPTIONS_SYMBOL]!;\n      originalCompilerOptions.module = defaultModuleKind;\n    }\n  };\n  return { changedFiles };\n}\n"]}

package/lib/fileSystem/TypeScriptCachedFileSystem.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" />
+import { IFileSystemWriteFileOptions, IFileSystemReadFileOptions, IFileSystemCopyFileOptions, IFileSystemDeleteFileOptions, IFileSystemCreateLinkOptions, FileSystemStats } from '@rushstack/node-core-library';
+export interface IReadFolderFilesAndDirectoriesResult {
+    files: string[];
+    directories: string[];
+}
+/**
+ * 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 declare class TypeScriptCachedFileSystem {
+    private _statsCache;
+    private _readFolderCache;
+    private _readFileCache;
+    private _realPathCache;
+    exists: (path: string) => boolean;
+    directoryExists: (path: string) => boolean;
+    getStatistics: (path: string) => FileSystemStats;
+    ensureFolder: (folderPath: string) => void;
+    ensureFolderAsync: (folderPath: string) => Promise<void>;
+    writeFile: (filePath: string, contents: string | Buffer, options?: IFileSystemWriteFileOptions | undefined) => void;
+    readFile: (filePath: string, options?: IFileSystemReadFileOptions | undefined) => string;
+    readFileToBuffer: (filePath: string) => Buffer;
+    copyFileAsync: (options: IFileSystemCopyFileOptions) => Promise<void>;
+    deleteFile: (filePath: string, options?: IFileSystemDeleteFileOptions | undefined) => void;
+    createHardLinkAsync: (options: IFileSystemCreateLinkOptions) => Promise<void>;
+    getRealPath: (linkPath: string) => string;
+    readFolderFilesAndDirectories: (folderPath: string) => IReadFolderFilesAndDirectoriesResult;
+    private _sortFolderEntries;
+    private _withCaching;
+    private _invalidateCacheEntry;
+}
+//# sourceMappingURL=TypeScriptCachedFileSystem.d.ts.map

package/lib/fileSystem/TypeScriptCachedFileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptCachedFileSystem.d.ts","sourceRoot":"","sources":["../../src/fileSystem/TypeScriptCachedFileSystem.ts"],"names":[],"mappings":";AAGA,OAAO,EAGL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAE5B,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,oCAAoC;IACnD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,gBAAgB,CAA6E;IACrG,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA+C;IAE9D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAWtC;IAEK,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAW/C;IAEK,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,CAErD;IAEK,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAK/C;IAEK,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAK7D;IAEK,SAAS,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,KAC9C,IAAI,CAOP;IAEK,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,SAAS,KAAK,MAAM,CAU7F;IAEK,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAEnD;IAEK,aAAa,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAK1E;IAEK,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,4BAA4B,GAAG,SAAS,KAAK,IAAI,CAW/F;IAEK,mBAAmB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAKlF;IAEK,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAiB9C;IAEK,6BAA6B,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,oCAAoC,CAWhG;IAEF,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,qBAAqB;CAM9B"}

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,56 @@
+import type * as TTypescript from 'typescript';
+export interface IExtendedSolutionBuilder extends TTypescript.SolutionBuilder<TTypescript.EmitAndSemanticDiagnosticsBuilderProgram> {
+    getBuildOrder(): readonly string[];
+    invalidateProject(configFilePath: string, mode: 0 | 1 | 2): void;
+}
+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#L119-L121
+         */
+        disable(): void;
+        /**
+         * 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;
+    };
+    transpileOptionValueCompilerOptions: {
+        name: keyof TTypescript.CompilerOptions;
+        transpileOptionValue: any;
+    }[];
+    getNewLineCharacter(compilerOptions: TTypescript.CompilerOptions): string;
+    /**
+     * 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[];
+    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 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":"AAGA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,wBACf,SAAQ,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,wCAAwC,CAAC;IACzF,aAAa,IAAI,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE;QACX;;WAEG;QACH,OAAO,IAAI,IAAI,CAAC;QAEhB;;WAEG;QACH,MAAM,IAAI,IAAI,CAAC;QAEf;;WAEG;QACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAErC;;WAEG;QACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEjF;;WAEG;QACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAEzC;;WAEG;QACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;KACvC,CAAC;IAEF,mCAAmC,EAAE;QACnC,IAAI,EAAE,MAAM,WAAW,CAAC,eAAe,CAAC;QAExC,oBAAoB,EAAE,GAAG,CAAC;KAC3B,EAAE,CAAC;IAEJ,mBAAmB,CAAC,eAAe,EAAE,WAAW,CAAC,eAAe,GAAG,MAAM,CAAC;IAE1E;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAC7C,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,yBAAyB,EAAE,OAAO,EAClC,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QACtC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KAC7C,EACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAClC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACzC,MAAM,EAAE,CAAC;IAEZ,WAAW,EAAE;QAGX,uCAAuC,EAAE,WAAW,CAAC,iBAAiB,CAAC;QAIvE,wCAAwC,EAAE,WAAW,CAAC,iBAAiB,CAAC;QAIxE,+EAA+E,EAAE,WAAW,CAAC,iBAAiB,CAAC;QAI/G,6FAA6F,EAAE,WAAW,CAAC,iBAAiB,CAAC;KAC9H,CAAC;CACH;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,WAAW,GAAG,mBAAmB,CAAC"}

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\nexport interface IExtendedSolutionBuilder\n  extends TTypescript.SolutionBuilder<TTypescript.EmitAndSemanticDiagnosticsBuilderProgram> {\n  getBuildOrder(): readonly string[];\n  invalidateProject(configFilePath: string, mode: 0 | 1 | 2): void;\n}\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  /**\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"]}

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"
+    },
+
+    "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": "[^\\\\]"
+          }
+        }
+      }
+    }
+  }
+}