@samchon/ts-patch 3.2.2-dev.20241204-2 → 3.4.0

package/dist/README.md

@@ -0,0 +1,348 @@
+[![npm version](https://badge.fury.io/js/ts-patch.svg)](https://badge.fury.io/js/ts-patch)
+[![NPM Downloads](https://img.shields.io/npm/dm/ts-patch.svg?style=flat)](https://npmjs.org/package/ts-patch)
+![Build Status](https://github.com/nonara/ts-patch/workflows/Build/badge.svg)
+
+# ts-patch
+
+Patch typescript to allow custom transformers (plugins) during build.
+
+Plugins are specified in `tsconfig.json`, or provided programmatically in `CompilerOptions`.
+
+_Migrating from ttypescript is easy! See: [Method 1: Live Compiler](#method-1-live-compiler)_
+
+## Features
+
+* Patch typescript installation via on-the-fly, in-memory patching _or_ as a persistent patch
+* Can patch individual libraries (see `ts-patch /?`)
+* Hook build process by transforming the `Program` (see: [Transforming Program](#transforming-program))
+* Add, remove, or modify diagnostics (see: [Altering Diagnostics](#altering-diagnostics))
+* Fully compatible with legacy [ttypescript](https://github.com/cevek/ttypescript) projects
+* **(new)** Experimental support for ES Module based transformers
+
+# Table of Contents
+
+<!-- TOC -->
+* [ts-patch](#ts-patch)
+  * [Features](#features)
+* [Table of Contents](#table-of-contents)
+* [Installation](#installation)
+* [Usage](#usage)
+  * [Method 1: Live Compiler](#method-1-live-compiler)
+  * [Method 2: Persistent Patch](#method-2-persistent-patch)
+* [Configuration](#configuration)
+  * [Plugin Options](#plugin-options)
+* [Writing Transformers](#writing-transformers)
+  * [Source Transformers](#source-transformers)
+    * [Source Transformer Entry Point](#source-transformer-entry-point)
+    * [Source Transformer Example](#source-transformer-example)
+    * [Altering Diagnostics](#altering-diagnostics)
+    * [Note](#note)
+  * [Program Transformers](#program-transformers)
+    * [Program Transformer Entry Point](#program-transformer-entry-point)
+    * [Configuring Program Transformers](#configuring-program-transformers)
+    * [Program Transformer Example](#program-transformer-example)
+  * [Plugin Package Configuration](#plugin-package-configuration)
+    * [Example](#example)
+  * [Resources](#resources)
+    * [Recommended Reading](#recommended-reading)
+    * [Recommended Tools](#recommended-tools)
+    * [Discussion](#discussion)
+* [Advanced Options](#advanced-options)
+* [Maintainers](#maintainers)
+  * [Help Wanted](#help-wanted)
+* [License](#license)
+<!-- TOC -->
+
+# Installation
+
+1. Install package
+```sh
+<yarn|npm|pnpm> add -D ts-patch
+```
+
+# Usage
+
+## Method 1: Live Compiler
+
+The live compiler patches on-the-fly, each time it is run.
+
+**Via commandline:** Simply use `tspc` (instead of `tsc`)
+
+**With tools such as ts-node, webpack, ts-jest, etc:** specify the compiler as  `ts-patch/compiler`
+
+## Method 2: Persistent Patch
+
+Persistent patch modifies the typescript installation within the node_modules path. It requires additional configuration
+to remain persisted, but it carries less load time and complexity compared to the live compiler.
+
+1. Install the patch
+
+```shell
+# For advanced options, see: ts-patch /?
+ts-patch install
+```
+
+2. Add `prepare` script (keeps patch persisted after npm install)
+
+`package.json`
+ ```jsonc
+{
+  /* ... */
+  "scripts": {
+    "prepare": "ts-patch install -s"
+  }
+}
+ ```
+
+# Configuration
+
+**tsconfig.json**: Add transformers to `compilerOptions` in `plugins` array.
+
+**Examples**
+```jsonc
+{
+    "compilerOptions": {
+        "plugins": [
+            // Source Transformers
+            { "transform": "transformer-module" },
+            { "transform": "transformer2", "extraOption": 123 },
+            { "transform": "trans-with-mapping", "resolvePathAliases": true },
+            { "transform": "esm-transformer", "isEsm": true },
+
+            // Program Transformer
+            { "transform": "transformer-module5", "transformProgram": true }
+        ]
+    }
+}
+```
+
+## Plugin Options
+
+| Option             | Type    | Description                                                                                                   |
+|--------------------|---------|:--------------------------------------------------------------------------------------------------------------|
+| **transform**      | string  | Module name or path to transformer _(*.ts or *.js)_                                                           |
+| after              | boolean | Apply transformer after stock TS transformers                                                                 |
+| afterDeclarations  | boolean | Apply transformer to declaration (*.d.ts) files                                                               |
+| transformProgram   | boolean | Transform `Program` during `ts.createProgram()` _(see: [Program Transformers](#program-transformers))_        |
+| isEsm              | boolean | Transformer is ES Module (_note: experimental_ — requires [esm](https://www.npmjs.com/package/esm))           |
+| resolvePathAliases | boolean | Resolve path aliases in transformer (requires [tsconfig-paths](https://www.npmjs.com/package/tsconfig-paths)) |
+| type               | string  | See: [Source Transformer Entry Point](#source-transformer-entry-point) (default: 'program')                   |
+| import             | string  | Name of exported transformer function _(defaults to `default` export)_                                        |
+| tsConfig           | string  | tsconfig.json file _for transformer_ (allows specifying compileOptions, path mapping support, etc)            |
+| _..._              |         | Provide your own custom options, which will be passed to the transformer                                      |
+
+_Note: Required options are bold_
+
+# Writing Transformers
+
+For an overview of the typescript compiler (such as what a `SourceFile` and `Program` is) see: [Typescript Compiler Notes](https://github.com/microsoft/TypeScript-Compiler-Notes).
+
+## Source Transformers
+
+Source Transformers will transform the AST of SourceFiles during compilation, allowing you to alter the output of the JS or declarations files.
+
+### Source Transformer Entry Point
+
+```ts
+(program: ts.Program, config: PluginConfig, extras: TransformerExtras) => ts.TransformerFactory
+```
+
+**PluginConfig**: [Type Declaration](https://github.com/nonara/ts-patch/blob/master/projects/core/shared/plugin-types.ts)  
+**TransformerExtras**: [Type Declaration](https://github.com/nonara/ts-patch/blob/master/projects/core/shared/plugin-types.ts)  
+**ts.TransformerFactory**: `(context: ts.TransformationContext) => (sourceFile: ts.SourceFile) => ts.SourceFile`
+
+_Note: Additional [legacy signatures](https://github.com/cevek/ttypescript#pluginconfigtype) are supported, but it is not recommended to develop a new transformer using them._
+
+### Source Transformer Example
+
+Transformers can be written in JS or TS.
+
+```ts
+import type * as ts from 'typescript';
+import type { TransformerExtras, PluginConfig } from 'ts-patch';
+
+/** Changes string literal 'before' to 'after' */
+export default function (program: ts.Program, pluginConfig: PluginConfig, { ts: tsInstance }: TransformerExtras) {
+  return (ctx: ts.TransformationContext) => {
+    const { factory } = ctx;
+    
+    return (sourceFile: ts.SourceFile) => {
+      function visit(node: ts.Node): ts.Node {
+        if (tsInstance.isStringLiteral(node) && node.text === 'before') {
+          return factory.createStringLiteral('after');
+        }
+        return tsInstance.visitEachChild(node, visit, ctx);
+      }
+      return tsInstance.visitNode(sourceFile, visit);
+    };
+  };
+}
+
+```
+
+**Live Examples**:
+
+[`{ transform: "typescript-transform-paths" }`](https://github.com/LeDDGroup/typescript-transform-paths)
+
+[`{ transform: "typescript-is/lib/transform-inline/transformer" }`](https://github.com/woutervh-/typescript-is)
+
+[`{ transform: "typia/lib/transform" }`](https://github.com/samchon/typia) ([💻playground](https://typia.io/playground))
+
+[`{ transform: "@nestia/core/lib/transform" }`](https://github.com/samchon/nestia)
+
+### Altering Diagnostics
+
+Diagnostics can be altered in a Source Transformer.
+
+To alter diagnostics you can use the following, provided from the `TransformerExtras` parameter:
+
+| property           | description                                         |
+|--------------------|-----------------------------------------------------|
+| diagnostics        | Reference to `Diagnostic` array                     |   
+| addDiagnostic()    | Safely add `Diagnostic` to `diagnostics` array      |
+| removeDiagnostic() | Safely remove `Diagnostic` from `diagnostics` array | 
+
+### Note
+
+_This alters diagnostics during _emit only_. If you want to alter diagnostics in your IDE as well, you'll need to create a LanguageService plugin to accompany your source transformer_
+
+## Program Transformers
+
+Sometimes you want to do more than just transform source code. For example you may want to:
+
+- TypeCheck code after it's been transformed
+- Generate code and add it to the program
+- Add or remove emit files during transformation
+
+For this, we've introduced what we call a Program Transformer. The transform action takes place during `ts.createProgram`, and allows
+re-creating the `Program` instance that typescript uses.
+
+### Program Transformer Entry Point
+
+```ts
+(program: ts.Program, host: ts.CompilerHost | undefined, options: PluginConfig, extras: ProgramTransformerExtras) => ts.Program
+```
+
+**ProgramTransformerExtras** >>> [Type Declaration](https://github.com/nonara/ts-patch/blob/master/projects/core/shared/plugin-types.ts)
+
+### Configuring Program Transformers
+
+To configure a Program Transformer, supply `"transformProgram": true` in the config transformer entry.
+
+_Note: The `before`, `after`, and `afterDeclarations` options do not apply to a Program Transformer and will be ignored_
+
+[See Config Example](#configuration)
+
+### Program Transformer Example
+```TypeScript
+/** 
+ * Add a file to Program
+ */
+import * as path from 'path';
+import type * as ts from 'typescript';
+import type { ProgramTransformerExtras, PluginConfig } from 'ts-patch';
+
+export const newFile = path.resolve(__dirname, 'added-file.ts');
+
+export default function (
+  program: ts.Program, 
+  host: ts.CompilerHost | undefined, 
+  options: PluginConfig, 
+  { ts: tsInstance }: ProgramTransformerExtras
+) {
+  return tsInstance.createProgram(
+    /* rootNames */ program.getRootFileNames().concat([ newFile ]),
+    program.getCompilerOptions(),
+    host,
+    /* oldProgram */ program
+  );
+}
+```
+
+**Note:** For a more complete example, see [Transforming Program with additional AST transformations](https://github.com/nonara/ts-patch/discussions/29#discussioncomment-325979)
+
+**Live Examples**:
+
+[`{ transform: "@typescript-virtual-barrel/compiler-plugin", transformProgram: true }`](https://github.com/zaguiini/typescript-virtual-barrel)
+
+[`{ transform: "ts-overrides-plugin", transformProgram: true }`](https://github.com/DiFuks/ts-overrides-plugin)
+
+## Plugin Package Configuration
+
+The plugin package configuration allows you to specify custom options for your TypeScript plugin. 
+This configuration is defined in the `package.json` of your plugin under the `tsp` property.
+
+An example use case is enabling `parseAllJsDoc` if you require full JSDoc parsing in tsc for your transformer in TS v5.3+. (see: [5.3 JSDoc parsing changes](https://devblogs.microsoft.com/typescript/announcing-typescript-5-3/#optimizations-by-skipping-jsdoc-parsing))
+
+For all available options, see the `PluginPackageConfig` type in [plugin-types.ts](https://github.com/nonara/ts-patch/blob/master/projects/core/shared/plugin-types.ts)
+
+### Example
+
+```jsonc
+{
+  "name": "your-plugin-name",
+  "version": "1.0.0",
+  "tsp": {
+    "tscOptions": {
+      "parseAllJsDoc": true
+    }
+  }
+}
+```
+
+## Resources
+
+### Recommended Reading
+
+- How-To: [Advice for working with the TS Compiler API](https://github.com/nonara/ts-patch/discussions/31)
+- How-To: [TypeScript Transformer Handbook](https://github.com/madou/typescript-transformer-handbook)
+- Article: [How to Write a TypeScript Transform (Plugin)](https://dev.doctorevidence.com/how-to-write-a-typescript-transform-plugin-fc5308fdd943)
+- Article: [Creating a TypeScript Transformer](https://43081j.com/2018/08/creating-a-typescript-transform?source=post_page-----731e2b0b66e6----------------------)
+
+### Recommended Tools
+
+| Tool                                                                 | Type        | Description                                                                                 |
+|----------------------------------------------------------------------|-------------|---------------------------------------------------------------------------------------------|
+| [TS AST Viewer](https://ts-ast-viewer.com/)                          | Web App     | Allows you to see the `Node` structure and other TS properties of your source code.         |
+| [ts-expose-internals](https://github.com/nonara/ts-expose-internals) | NPM Package | Exposes internal types and methods of the TS compiler API                                   |
+
+### Discussion
+
+- `#compiler-internals-and-api` on [TypeScript Discord Server](https://discord.com/invite/typescript)
+- TSP [Discussions](https://github.com/nonara/ts-patch/discussions) Board
+
+# Advanced Options
+
+**(env) `TSP_SKIP_CACHE`**
+
+Skips patch cache when patching via cli or live compiler.
+
+**(env) `TSP_COMPILER_TS_PATH`**
+
+Specify typescript library path to use for `ts-patch/compiler` (defaults to `require.resolve('typescript')`)
+
+**(env) `TSP_CACHE_DIR`**
+
+Override patch cache directory
+
+**(cli) `ts-patch clear-cache`**
+
+Cleans patch cache & lockfiles
+
+# Maintainers
+
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/nonara"><img src="https://avatars0.githubusercontent.com/u/1427565?v=4" width="100px;" alt=""/><br /><sub><b>Ron S.</b></sub></a></td>
+  </tr>
+</table>
+
+## Help Wanted
+
+If you're interested in helping and are knowledgeable with the TS compiler codebase, feel free to reach out!
+
+# License
+
+This project is licensed under the MIT License, as described in `LICENSE.md`

package/dist/actions/check.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.check = check;
+const system_1 = require("../system");
+const chalk_1 = __importDefault(require("chalk"));
+const ts_package_1 = require("../ts-package");
+const module_1 = require("../module");
+const options_1 = require("../options");
+function check(moduleNameOrNames, opts) {
+    let targetModuleNames = moduleNameOrNames ? [moduleNameOrNames].flat() : undefined;
+    const options = (0, options_1.getInstallerOptions)(opts);
+    const { logger: log, dir } = options;
+    /* Load Package */
+    const tsPackage = (0, ts_package_1.getTsPackage)(dir);
+    const { packageDir, version } = tsPackage;
+    targetModuleNames ?? (targetModuleNames = tsPackage.moduleNames);
+    /* Check Modules */
+    log(`Checking TypeScript ${chalk_1.default.blueBright(`v${version}`)} installation in ${chalk_1.default.blueBright(packageDir)}\r\n`);
+    let res = {};
+    for (const moduleName of targetModuleNames) {
+        /* Validate */
+        if (!tsPackage.moduleNames.includes(moduleName))
+            throw new system_1.PatchError(`${moduleName} is not a valid TypeScript module in ${packageDir}`);
+        /* Report non-patchable modules (thin wrappers in TS 6+) */
+        if (!module_1.TsModule.isPatchable(moduleName, tsPackage.majorVer)) {
+            log(['~',
+                `${chalk_1.default.blueBright(moduleName)} delegates to ${chalk_1.default.blueBright('typescript.js')} (no independent patch needed)`
+            ]);
+            res[moduleName] = undefined;
+            continue;
+        }
+        /* Report */
+        const tsModule = (0, module_1.getTsModule)(tsPackage, moduleName, { skipCache: options.skipCache });
+        const { patchDetail } = tsModule.moduleFile;
+        if (patchDetail !== undefined) {
+            const { isOutdated } = patchDetail;
+            log(['+',
+                `${chalk_1.default.blueBright(moduleName)} is patched with ts-patch version ` +
+                    `${chalk_1.default[isOutdated ? 'redBright' : 'blueBright'](patchDetail.tspVersion)} ${isOutdated ? '(out of date)' : ''}`
+            ]);
+        }
+        else
+            log(['-', `${chalk_1.default.blueBright(moduleName)} is not patched.`]);
+        res[moduleName] = patchDetail;
+        log('', system_1.LogLevel.verbose);
+    }
+    return res;
+}
+// endregion
+//# sourceMappingURL=check.js.map

package/dist/actions/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../projects/core/src/actions/check.ts"],"names":[],"mappings":";;;;;AA4BA,sBAgDC;AA5ED,sCAAiD;AACjD,kDAA0B;AAC1B,8CAA6C;AAE7C,sCAAkD;AAClD,wCAAmE;AAuBnE,SAAgB,KAAK,CAAC,iBAAqC,EAAE,IAAgC;IAC3F,IAAI,iBAAiB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAE,iBAAiB,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,OAAO,GAAG,IAAA,6BAAmB,EAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAErC,kBAAkB;IAClB,MAAM,SAAS,GAAG,IAAA,yBAAY,EAAC,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAG1C,iBAAiB,KAAjB,iBAAiB,GAAK,SAAS,CAAC,WAAW,EAAC;IAE5C,mBAAmB;IACnB,GAAG,CAAC,uBAAuB,eAAK,CAAC,UAAU,CAAC,IAAI,OAAO,EAAE,CAAC,oBAAoB,eAAK,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAElH,IAAI,GAAG,GAAgB,EAAE,CAAC;IAC1B,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,cAAc;QACd,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC7C,MAAM,IAAI,mBAAU,CAAC,GAAG,UAAU,wCAAwC,UAAU,EAAE,CAAC,CAAC;QAE1F,2DAA2D;QAC3D,IAAI,CAAC,iBAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,CAAE,GAAG;gBACP,GAAG,eAAK,CAAC,UAAU,CAAC,UAAU,CAAC,iBAAiB,eAAK,CAAC,UAAU,CAAC,eAAe,CAAC,gCAAgC;aAClH,CAAC,CAAC;YACH,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,YAAY;QACZ,MAAM,QAAQ,GAAG,IAAA,oBAAW,EAAC,SAAS,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC;QAE5C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC;YACnC,GAAG,CAAC,CAAE,GAAG;gBACP,GAAG,eAAK,CAAC,UAAU,CAAC,UAAU,CAAC,oCAAoC;oBACnE,GAAG,eAAK,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE;aACjH,CAAC,CAAC;QACL,CAAC;;YAAM,GAAG,CAAC,CAAE,GAAG,EAAE,GAAG,eAAK,CAAC,UAAU,CAAC,UAAU,CAAC,kBAAkB,CAAE,CAAC,CAAC;QAEvE,GAAG,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC;QAE9B,GAAG,CAAC,EAAE,EAAE,iBAAQ,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,YAAY"}

package/dist/actions/patch.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patch = patch;
+const system_1 = require("../system");
+const ts_package_1 = require("../ts-package");
+const chalk_1 = __importDefault(require("chalk"));
+const module_1 = require("../module");
+const path_1 = __importDefault(require("path"));
+const options_1 = require("../options");
+const utils_1 = require("../utils");
+const get_patched_source_1 = require("../patch/get-patched-source");
+function patch(moduleNameOrNames, opts) {
+    const targetModuleNames = [moduleNameOrNames].flat();
+    if (!targetModuleNames.length)
+        throw new system_1.PatchError(`Must provide at least one module name to patch`);
+    const options = (0, options_1.getInstallerOptions)(opts);
+    const { logger: log, dir, skipCache } = options;
+    /* Load Package */
+    const tsPackage = (0, ts_package_1.getTsPackage)(dir);
+    /* Skip non-patchable modules (e.g. thin wrappers in TS 6+) */
+    const patchableModuleNames = targetModuleNames.filter(m => {
+        if (!module_1.TsModule.isPatchable(m, tsPackage.majorVer)) {
+            log(['~',
+                `${chalk_1.default.blueBright(m)} is not independently patchable in TS ${tsPackage.majorVer}+ ` +
+                    `(delegates to ${chalk_1.default.blueBright('typescript.js')})`
+            ]);
+            return false;
+        }
+        return true;
+    });
+    /* Get modules to patch and patch info */
+    const moduleFiles = patchableModuleNames.map(m => [m, (0, module_1.getModuleFile)(tsPackage.getModulePath(m))]);
+    /* Determine files not already patched or outdated  */
+    const patchableFiles = moduleFiles.filter(entry => {
+        const [moduleName, moduleFile] = entry;
+        if (!moduleFile.patchDetail || moduleFile.patchDetail.isOutdated)
+            return true;
+        else {
+            log(['!',
+                `${chalk_1.default.blueBright(moduleName)} is already patched with the latest version. For details, run: ` +
+                    chalk_1.default.bgBlackBright('ts-patch check')
+            ]);
+            return false;
+        }
+    });
+    if (!patchableFiles.length)
+        return true;
+    /* Patch modules */
+    const failedModulePaths = [];
+    for (let entry of patchableFiles) {
+        /* Load Module */
+        const { 1: moduleFile } = entry;
+        const tsModule = (0, module_1.getTsModule)(tsPackage, moduleFile, { skipCache: true });
+        const { moduleName, modulePath, moduleContentFilePath } = tsModule;
+        log(['~', `Patching ${chalk_1.default.blueBright(moduleName)} in ${chalk_1.default.blueBright(path_1.default.dirname(modulePath))}`], system_1.LogLevel.verbose);
+        try {
+            const { js, dts, loadedFromCache } = (0, get_patched_source_1.getPatchedSource)(tsModule, { skipCache, log });
+            /* Write Patched Module */
+            log([
+                '~',
+                `Writing patched ${chalk_1.default.blueBright(moduleName)} to ` +
+                    `${chalk_1.default.blueBright(moduleContentFilePath)}${loadedFromCache ? ' (cached)' : ''}`
+            ], system_1.LogLevel.verbose);
+            (0, utils_1.writeFileWithLock)(moduleContentFilePath, js);
+            if (dts)
+                (0, utils_1.writeFileWithLock)(tsModule.dtsPath, dts);
+            log(['+', chalk_1.default.green(`Successfully patched ${chalk_1.default.bold.yellow(moduleName)}.\r\n`)], system_1.LogLevel.verbose);
+        }
+        catch (e) {
+            if (e instanceof system_1.TspError || options.logLevel >= system_1.LogLevel.verbose)
+                log(['!', e.message]);
+            failedModulePaths.push(tsModule.modulePath);
+        }
+    }
+    if (failedModulePaths.length > 1) {
+        log(['!',
+            `Some files can't be patched! You can run again with --verbose to get specific error detail. The following files are unable to be ` +
+                `patched:\n  - ${failedModulePaths.join('\n  - ')}`
+        ]);
+        return false;
+    }
+    return true;
+}
+// endregion
+//# sourceMappingURL=patch.js.map

package/dist/actions/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../projects/core/src/actions/patch.ts"],"names":[],"mappings":"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"}

package/dist/actions/unpatch.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpatch = unpatch;
+const system_1 = require("../system");
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const ts_package_1 = require("../ts-package");
+const module_1 = require("../module");
+const fs_1 = __importDefault(require("fs"));
+const options_1 = require("../options");
+const utils_1 = require("../utils");
+function unpatch(moduleNameOrNames, opts) {
+    let res = false;
+    const targetModuleNames = [moduleNameOrNames].flat();
+    if (!targetModuleNames.length)
+        throw new system_1.PatchError(`Must provide at least one module name to patch`);
+    const options = (0, options_1.getInstallerOptions)(opts);
+    const { logger: log, dir } = options;
+    /* Load Package */
+    const tsPackage = (0, ts_package_1.getTsPackage)(dir);
+    /* Get modules to patch and patch info */
+    const moduleFiles = targetModuleNames.map(m => [m, (0, module_1.getModuleFile)(tsPackage.getModulePath(m))]);
+    /* Determine patched files */
+    const unpatchableFiles = moduleFiles.filter(entry => {
+        const [moduleName, moduleFile] = entry;
+        if (moduleFile.patchDetail)
+            return true;
+        else {
+            log(['!', `${chalk_1.default.blueBright(moduleName)} is not patched. For details, run: ` + chalk_1.default.bgBlackBright('ts-patch check')]);
+            return false;
+        }
+    });
+    /* Restore files */
+    const errors = {};
+    for (const entry of unpatchableFiles) {
+        /* Load Module */
+        const { 1: moduleFile } = entry;
+        const tsModule = (0, module_1.getTsModule)(tsPackage, moduleFile, { skipCache: true });
+        try {
+            /* Get Backups */
+            const backupPaths = [];
+            backupPaths.push(tsModule.backupCachePaths.js);
+            if (tsModule.backupCachePaths.dts)
+                backupPaths.push(tsModule.backupCachePaths.dts);
+            const baseNames = backupPaths.map(p => path_1.default.basename(p)).join(' & ');
+            log([
+                '~',
+                `Restoring ${chalk_1.default.blueBright(baseNames)} in ${chalk_1.default.blueBright(path_1.default.dirname(tsPackage.libDir))}`
+            ], system_1.LogLevel.verbose);
+            /* Restore files */
+            for (const backupPath of backupPaths) {
+                if (!fs_1.default.existsSync(backupPath))
+                    throw new Error(`Cannot find backup file: ${backupPath}. Try reinstalling typescript.`);
+                const moduleDir = path_1.default.dirname(tsModule.modulePath);
+                /* Determine destination path (Need to use moduleContentPath if we're working with a cached module file */
+                const baseFileName = path_1.default.basename(backupPath);
+                const destPathName = baseFileName === tsModule.moduleName
+                    ? path_1.default.basename(tsModule.moduleContentFilePath)
+                    : baseFileName;
+                const destPath = path_1.default.join(moduleDir, destPathName);
+                (0, utils_1.copyFileWithLock)(backupPath, destPath);
+            }
+            log(['+', chalk_1.default.green(`Successfully restored ${chalk_1.default.bold.yellow(baseNames)}.\r\n`)], system_1.LogLevel.verbose);
+        }
+        catch (e) {
+            errors[tsModule.moduleName] = e;
+        }
+    }
+    /* Handle errors */
+    if (Object.keys(errors).length > 0) {
+        Object.values(errors).forEach(e => {
+            log(['!', e.message], system_1.LogLevel.verbose);
+        });
+        log('');
+        throw new system_1.RestoreError(`[${Object.keys(errors).join(', ')}]`, 'Try reinstalling typescript.' +
+            (options.logLevel < system_1.LogLevel.verbose ? ' (Or, run uninstall again with --verbose for specific error detail)' : ''));
+    }
+    else {
+        res = true;
+    }
+    return res;
+}
+// endregion
+//# sourceMappingURL=unpatch.js.map

package/dist/actions/unpatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpatch.js","sourceRoot":"","sources":["../../../projects/core/src/actions/unpatch.ts"],"names":[],"mappings":"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"}

package/dist/bin/ts-patch.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const cliModule = __importStar(require("../cli/cli"));
+/* ****************************************************************************************************************** *
+ * Entry
+ * ****************************************************************************************************************** */
+cliModule.run();
+//# sourceMappingURL=ts-patch.js.map

package/dist/bin/ts-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-patch.js","sourceRoot":"","sources":["../../../projects/core/src/bin/ts-patch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAuC;AAEvC;;wHAEwH;AAExH,SAAS,CAAC,GAAG,EAAE,CAAC"}