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

package/dist/system/cache.js

@@ -0,0 +1,79 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCacheRoot = getCacheRoot;
+exports.getCachePath = getCachePath;
+exports.getLockFilePath = getLockFilePath;
+const path_1 = __importDefault(require("path"));
+const os = __importStar(require("os"));
+const utils_1 = require("../utils");
+const config_1 = require("../config");
+const fs_1 = __importDefault(require("fs"));
+/* ****************************************************************************************************************** */
+// region: Locals
+/* ****************************************************************************************************************** */
+let cacheRoot;
+let lockFileRoot;
+// endregion
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+function getCacheRoot() {
+    if (!cacheRoot) {
+        cacheRoot =
+            process.env.TSP_CACHE_DIR ||
+                (0, utils_1.findCacheDirectory)({ name: 'ts-patch', cwd: path_1.default.resolve(config_1.appRoot, '..') }) ||
+                path_1.default.join(os.tmpdir(), 'ts-patch');
+        if (!fs_1.default.existsSync(cacheRoot))
+            fs_1.default.mkdirSync(cacheRoot, { recursive: true });
+    }
+    return cacheRoot;
+}
+function getCachePath(key, ...p) {
+    return path_1.default.resolve(getCacheRoot(), key, ...p);
+}
+function getLockFilePath(key) {
+    if (!lockFileRoot) {
+        lockFileRoot = path_1.default.join(getCacheRoot(), config_1.lockFileDir);
+        if (!fs_1.default.existsSync(lockFileRoot))
+            fs_1.default.mkdirSync(lockFileRoot, { recursive: true });
+    }
+    return path_1.default.join(getCacheRoot(), config_1.lockFileDir, key);
+}
+// endregion
+//# sourceMappingURL=cache.js.map

package/dist/system/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../projects/core/src/system/cache.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,oCAWC;AAED,oCAEC;AAED,0CAOC;AA7CD,gDAAwB;AACxB,uCAAyB;AACzB,oCAA8C;AAC9C,sCAAiD;AACjD,4CAAoB;AAGpB,wHAAwH;AACxH,iBAAiB;AACjB,wHAAwH;AAExH,IAAI,SAA6B,CAAC;AAClC,IAAI,YAAgC,CAAC;AAErC,YAAY;AAGZ,wHAAwH;AACxH,gBAAgB;AAChB,wHAAwH;AAExH,SAAgB,YAAY;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS;YACP,OAAO,CAAC,GAAG,CAAC,aAAa;gBACzB,IAAA,0BAAkB,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,gBAAO,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC1E,cAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;QAErC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW,EAAE,GAAG,CAAW;IACtD,OAAO,cAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,oBAAW,CAAC,CAAC;QACtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,YAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,oBAAW,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,YAAY"}

package/dist/utils/file-utils.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mkdirIfNotExist = void 0;
+exports.getGlobalTsDir = getGlobalTsDir;
+exports.withFileLock = withFileLock;
+exports.writeFileWithLock = writeFileWithLock;
+exports.readFileWithLock = readFileWithLock;
+exports.copyFileWithLock = copyFileWithLock;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const ts_package_1 = require("../ts-package");
+const system_1 = require("../system");
+const general_1 = require("./general");
+/* ****************************************************************************************************************** */
+// region: Config
+/* ****************************************************************************************************************** */
+const lockFileWaitMs = 2000;
+// endregion
+/* ****************************************************************************************************************** */
+// region: Helpers
+/* ****************************************************************************************************************** */
+function waitForLockRelease(lockFilePath) {
+    const start = Date.now();
+    while (fs_1.default.existsSync(lockFilePath)) {
+        sleep(100);
+        if ((Date.now() - start) > lockFileWaitMs)
+            throw new Error(`Could not acquire lock to write file. If problem persists, run ts-patch clear-cache and try again.
+      `);
+    }
+    function sleep(ms) {
+        const wakeUpTime = Date.now() + ms;
+        while (Date.now() < wakeUpTime) { }
+    }
+}
+// endregion
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+/**
+ * Attempts to locate global installation of TypeScript
+ */
+function getGlobalTsDir() {
+    const errors = [];
+    const dir = require('global-prefix');
+    const check = (dir) => {
+        try {
+            return (0, ts_package_1.getTsPackage)(dir);
+        }
+        catch (e) {
+            errors.push(e);
+            return {};
+        }
+    };
+    const { packageDir } = (check(dir) || check(path_1.default.join(dir, 'lib')));
+    if (!packageDir)
+        throw new system_1.PackageError(`Could not find global TypeScript installation! Are you sure it's installed globally?`);
+    return packageDir;
+}
+const mkdirIfNotExist = (dir) => !fs_1.default.existsSync(dir) && fs_1.default.mkdirSync(dir, { recursive: true });
+exports.mkdirIfNotExist = mkdirIfNotExist;
+function withFileLock(filePath, fn) {
+    const lockFileName = (0, general_1.getHash)(filePath) + '.lock';
+    const lockFilePath = (0, system_1.getLockFilePath)(lockFileName);
+    try {
+        const lockFileDir = path_1.default.dirname(lockFilePath);
+        if (!fs_1.default.existsSync(lockFileDir))
+            fs_1.default.mkdirSync(lockFileDir, { recursive: true });
+        waitForLockRelease(lockFilePath);
+        fs_1.default.writeFileSync(lockFilePath, '');
+        return fn();
+    }
+    finally {
+        if (fs_1.default.existsSync(lockFilePath))
+            fs_1.default.rmSync(lockFilePath, { force: true });
+    }
+}
+function writeFileWithLock(filePath, content) {
+    withFileLock(filePath, () => {
+        fs_1.default.writeFileSync(filePath, content);
+    });
+}
+function readFileWithLock(filePath) {
+    return withFileLock(filePath, () => {
+        return fs_1.default.readFileSync(filePath, 'utf8');
+    });
+}
+function copyFileWithLock(src, dest) {
+    withFileLock(src, () => {
+        withFileLock(dest, () => {
+            fs_1.default.copyFileSync(src, dest);
+        });
+    });
+}
+// endregion
+//# sourceMappingURL=file-utils.js.map

package/dist/utils/file-utils.js.map

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

package/jest.config.ts

@@ -0,0 +1,26 @@
+import type { Config } from '@jest/types';
+import * as os from 'os';
+
+const config: Config.InitialOptions = {
+  testEnvironment: "node",
+  preset: 'ts-jest',
+  roots: [ '<rootDir>/test/tests' ],
+  testRegex: '.*(test|spec)\\.tsx?$',
+  moduleFileExtensions: [ 'ts', 'tsx', 'js', 'jsx', 'json', 'node' ],
+  transform: {
+    '^.+\\.(ts|tsx)$': ['ts-jest', { tsconfig: './test/tsconfig.json' }],
+  },
+  modulePaths: [ "<rootDir>/node_modules" ],
+  // coveragePathIgnorePatterns: [
+  //   'src/installer/lib/system/errors.ts$'
+  // ],
+  globalSetup: '<rootDir>/test/src/prepare.ts',
+  globalTeardown: '<rootDir>/test/src/cleanup.ts',
+  testTimeout: 10000,
+  transformIgnorePatterns: [
+    '/node_modules/(?!(ts-transformer-keys|ts-transformer-enumerate|ts-nameof)/)'
+  ],
+  maxConcurrency: os.cpus().length
+}
+
+export default config;

package/package.json

@@ -1,9 +1,26 @@
 {
   "name": "@samchon/ts-patch",
-  "version": "3.2.2-dev.20241204-2",
+  "version": "3.4.0",
   "description": "Patch typescript to support custom transformers in tsconfig.json",
-  "main": "./index.js",
-  "types": "./index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "compile": "yarn run compile:core && yarn run compile:patch",
+    "build": "yarn run clean && yarn run compile:patch && yarn run compile:core",
+    "compile:core": "tsc -p projects/core",
+    "compile:patch": "tsc -p projects/patch",
+    "------------ ": "-------------",
+    "clean": "npx -y rimraf -g dist coverage *.tsbuildinfo test/.tmp",
+    "clean:global": "yarn run clean && npx -y rimraf -g ./**/node_modules ./**/yarn.lock",
+    "reset": "yarn run clean:global && yarn install && yarn build",
+    "------------  ": "-------------",
+    "test": "jest",
+    "perf": "cd test && yarn run perf",
+    "------------": "-------------",
+    "prepare": "ts-patch install -s && yarn prepare:test",
+    "prepare:test": "cd test && yarn install",
+    "postbuild": "node scripts/postbuild.js"
+  },
   "keywords": [
     "typescript",
     "transform",
@@ -27,18 +44,51 @@
   "homepage": "https://github.com/nonara/ts-patch#readme",
   "dependencies": {
     "chalk": "^4.1.2",
-    "global-prefix": "^3.0.0",
+    "global-prefix": "^4.0.0",
     "minimist": "^1.2.8",
     "resolve": "^1.22.2",
-    "semver": "^7.5.4",
+    "semver": "^7.6.3",
     "strip-ansi": "^6.0.1"
   },
   "bin": {
-    "ts-patch": "./bin/ts-patch.js",
-    "tspc": "./bin/tspc.js"
+    "ts-patch": "./dist/bin/ts-patch.js",
+    "tspc": "./dist/bin/tspc.js"
+  },
+  "devDependencies": {
+    "@types/esm": "^3.2.2",
+    "@types/jest": "^29.5.10",
+    "@types/minimist": "^1.2.2",
+    "@types/mock-fs": "^4.13.1",
+    "@types/node": "^16.11.5",
+    "@types/resolve": "^1.20.1",
+    "@types/semver": "^7.3.13",
+    "@types/shelljs": "^0.8.9",
+    "esm": "^3.2.25",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.7",
+    "shelljs": "^0.8.5",
+    "standard-version": "^9.5.0",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "ts-patch": "^3.3.0",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "~6.0.2",
+    "ts-next": "npm:typescript@beta",
+    "ts-expose-internals": "npm:ts-expose-internals@5.4.5"
+  },
+  "workspaces": {
+    "packages": [
+      "projects/path",
+      "projects/core"
+    ],
+    "nohoist": [
+      "jest",
+      "ts-jest",
+      "typescript"
+    ]
   },
   "directories": {
-    "resources": "./resources"
+    "resources": "./dist/resources"
   },
   "standard-version": {
     "types": [
@@ -102,6 +152,5 @@
         "section": "Changes"
       }
     ]
-  },
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+  }
+}

package/projects/core/plugin.ts

@@ -0,0 +1,42 @@
+import type * as ts from 'typescript';
+import * as path from 'path';
+type TS = typeof ts;
+
+
+/* ****************************************************************************************************************** *
+ * Program Transformer - Merge rootDirs
+ * ****************************************************************************************************************** */
+
+export default function transformProgram(
+  program: ts.Program,
+  host: ts.CompilerHost,
+  opt: any,
+  { ts }: { ts: TS }
+)
+{
+  host ??= ts.createCompilerHost(program.getCompilerOptions(), true);
+  const rootDirs = program.getCompilerOptions().rootDirs ?? [];
+
+  hookWriteRootDirsFilenames();
+
+  return ts.createProgram(program.getRootFileNames(), program.getCompilerOptions(), host, program);
+
+  function hookWriteRootDirsFilenames() {
+    // TODO - tsei
+    const sourceDir = (<any>program).getCommonSourceDirectory();
+    const outputDir = program.getCompilerOptions().outDir!;
+
+    const originalWriteFile = host.writeFile;
+    host.writeFile = (fileName: string, data: string, ...args: any[]) => {
+      let srcPath = path.resolve(sourceDir, path.relative(outputDir, fileName));
+
+      for (const dir of rootDirs) {
+        const relPath = path.relative(dir, srcPath);
+        // TODO - tsei
+        if (relPath.slice(0, 2) !== '..') fileName = (<any>ts).normalizePath(path.resolve(outputDir, relPath));
+      }
+
+      return (<any>originalWriteFile)(fileName, data, ...args);
+    }
+  }
+}

package/projects/core/resolver-hook.js

@@ -0,0 +1,55 @@
+const path = require('path');
+const Module = require('module');
+
+
+/* ****************************************************************************************************************** */
+// region: Helpers
+/* ****************************************************************************************************************** */
+
+/**
+ * Enable rootDirs merge support for require (used with ts-node)
+ */
+function hookRequire() {
+  if (rootDirs.length > 0) {
+    const originalRequire = Module.prototype.require;
+
+    Module.prototype.require = function (request) {
+      if (!path.isAbsolute(request) && request.startsWith('.')) {
+        const moduleDir = path.dirname(this.filename);
+        const moduleRootDir = rootDirs.find(rootDir => moduleDir.startsWith(rootDir));
+
+        if (moduleRootDir) {
+          const moduleRelativeFromRoot = path.relative(moduleRootDir, moduleDir);
+
+          if (moduleRootDir) {
+            for (const rootDir of rootDirs) {
+              const possiblePath = path.join(rootDir, moduleRelativeFromRoot, request);
+
+              let resolvedPath;
+              try {
+                resolvedPath = require.resolve(possiblePath);
+              } catch (e) {
+                continue;
+              }
+
+              return originalRequire.call(this, resolvedPath);
+            }
+          }
+        }
+      }
+
+      return originalRequire.call(this, request);
+    };
+  }
+}
+
+// endregion
+
+/* ****************************************************************************************************************** *
+ * Entry
+ * ****************************************************************************************************************** */
+
+const tsConfig = require(path.join(__dirname, 'tsconfig.json'));
+const rootDirs = tsConfig.compilerOptions.rootDirs.map(rootDir => path.join(__dirname, rootDir));
+
+hookRequire();

package/projects/core/shared/plugin-types.ts

@@ -0,0 +1,159 @@
+/**
+ * NOTE: This file is used during the build process for patch as well
+ */
+// Note: Leave as import-star, since we don't ship built file with esModuleInterop
+import type * as ts from 'typescript';
+
+
+/* ****************************************************************************************************************** */
+// region: Plugin
+/* ****************************************************************************************************************** */
+
+export interface PluginConfig {
+  [x:string]: any
+
+  /**
+   * Language Server TypeScript Plugin name
+   */
+  name?: string;
+
+  /**
+   * Path to transformer or transformer module name
+   */
+  transform?: string;
+
+  /**
+   * Resolve Path Aliases?
+   */
+  resolvePathAliases?: boolean;
+
+  /**
+   * tsconfig.json file (for transformer)
+   */
+  tsConfig?: string;
+
+  /**
+   * The optional name of the exported transform plugin in the transform module.
+   */
+  import?: string;
+
+  /**
+   * Is the transformer an ES Module
+   */
+  isEsm?: boolean
+
+  /**
+   * Plugin entry point format type, default is program
+   */
+  type?: 'ls' | 'program' | 'config' | 'checker' | 'raw' | 'compilerOptions';
+
+  /**
+   * Apply transformer after internal TypeScript transformers
+   */
+  after?: boolean;
+
+  /**
+   * Apply transformer on d.ts files
+   */
+  afterDeclarations?: boolean;
+
+  /**
+   * Transform *Program* instance (alters during createProgram()) (`type`, `after`, & `afterDeclarations` settings will
+   * not apply) Entry point must be (program: Program, host?: CompilerHost) => Program
+   */
+  transformProgram?: boolean;
+}
+
+export type TransformerList = Required<ts.CustomTransformers>;
+export type TransformerPlugin = TransformerBasePlugin | TsTransformerFactory;
+export type TsTransformerFactory = ts.TransformerFactory<ts.SourceFile>
+
+export type PluginFactory =
+  LSPattern | ProgramPattern | ConfigPattern | CompilerOptionsPattern | TypeCheckerPattern | RawPattern;
+
+export interface TransformerBasePlugin {
+  before?: ts.TransformerFactory<ts.SourceFile> | ts.TransformerFactory<ts.SourceFile>[];
+  after?: ts.TransformerFactory<ts.SourceFile> | ts.TransformerFactory<ts.SourceFile>[];
+  afterDeclarations?: ts.TransformerFactory<ts.SourceFile | ts.Bundle> | ts.TransformerFactory<ts.SourceFile | ts.Bundle>[];
+}
+
+// endregion
+
+
+/* ****************************************************************************************************************** */
+// region: Extras
+/* ****************************************************************************************************************** */
+
+export type DiagnosticMap = WeakMap<ts.Program, ts.Diagnostic[]>;
+
+export type TransformerExtras = {
+  /**
+   * Originating TypeScript instance
+   */
+  ts: typeof ts;
+  /**
+   * TypeScript library file event was triggered in (ie. 'tsserverlibrary' or 'typescript')
+   */
+  library: string
+  addDiagnostic: (diag: ts.Diagnostic) => number,
+  removeDiagnostic: (index: number) => void,
+  diagnostics: readonly ts.Diagnostic[],
+}
+
+export type ProgramTransformerExtras = {
+  /**
+   * Originating TypeScript instance
+   */
+  ts: typeof ts;
+}
+
+// endregion
+
+
+/* ****************************************************************************************************************** */
+// region: Signatures
+/* ****************************************************************************************************************** */
+
+export type ProgramTransformer = (
+  program: ts.Program,
+  host: ts.CompilerHost | undefined,
+  config: PluginConfig,
+  extras: ProgramTransformerExtras
+) => ts.Program;
+
+export type LSPattern = (ls: ts.LanguageService, config: {}) => TransformerPlugin;
+export type CompilerOptionsPattern = (compilerOpts: ts.CompilerOptions, config: {}) => TransformerPlugin;
+export type ConfigPattern = (config: {}) => TransformerPlugin;
+export type TypeCheckerPattern = (checker: ts.TypeChecker, config: {}) => TransformerPlugin;
+
+export type ProgramPattern = (
+  program: ts.Program,
+  config: {},
+  extras: TransformerExtras
+) => TransformerPlugin;
+
+export type RawPattern = (
+  context: ts.TransformationContext,
+  program: ts.Program,
+  config: {}
+) => ts.Transformer<ts.SourceFile>;
+
+// endregion
+
+/* ****************************************************************************************************************** */
+// region: Plugin Package
+/* ****************************************************************************************************************** */
+
+export interface PluginPackageConfig {
+  tscOptions?: {
+    /**
+     * Sets the JSDocParsingMode to ParseAll
+     *
+     * @see https://devblogs.microsoft.com/typescript/announcing-typescript-5-3/#optimizations-by-skipping-jsdoc-parsing
+     * @default false
+     */
+    parseAllJsDoc?: boolean;
+  }
+}
+
+// endregion

package/projects/core/src/actions/check.ts

@@ -0,0 +1,79 @@
+import { LogLevel, PatchError } from '../system';
+import chalk from 'chalk';
+import { getTsPackage } from '../ts-package';
+import { PatchDetail } from "../patch/patch-detail";
+import { getTsModule, TsModule } from "../module";
+import { getInstallerOptions, InstallerOptions } from "../options";
+
+
+/* ****************************************************************************************************************** */
+// region: Types
+/* ****************************************************************************************************************** */
+
+interface CheckResult {
+  [moduleName: string]: PatchDetail | undefined;
+}
+
+// endregion
+
+
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+
+/**
+ * Check if files can be patched
+ */
+export function check(moduleName?: string | string[], opts?: Partial<InstallerOptions>): CheckResult
+export function check(moduleNames?: string[], opts?: Partial<InstallerOptions>): CheckResult
+export function check(moduleNameOrNames?: string | string[], opts?: Partial<InstallerOptions>): CheckResult {
+  let targetModuleNames = moduleNameOrNames ? [ moduleNameOrNames ].flat() : undefined;
+  const options = getInstallerOptions(opts);
+  const { logger: log, dir } = options;
+
+  /* Load Package */
+  const tsPackage = getTsPackage(dir);
+  const { packageDir, version } = tsPackage;
+
+
+  targetModuleNames ??= tsPackage.moduleNames;
+
+  /* Check Modules */
+  log(`Checking TypeScript ${chalk.blueBright(`v${version}`)} installation in ${chalk.blueBright(packageDir)}\r\n`);
+
+  let res: CheckResult = {};
+  for (const moduleName of targetModuleNames) {
+    /* Validate */
+    if (!tsPackage.moduleNames.includes(moduleName))
+      throw new PatchError(`${moduleName} is not a valid TypeScript module in ${packageDir}`);
+
+    /* Report non-patchable modules (thin wrappers in TS 6+) */
+    if (!TsModule.isPatchable(moduleName, tsPackage.majorVer)) {
+      log([ '~',
+        `${chalk.blueBright(moduleName)} delegates to ${chalk.blueBright('typescript.js')} (no independent patch needed)`
+      ]);
+      res[moduleName] = undefined;
+      continue;
+    }
+
+    /* Report */
+    const tsModule = getTsModule(tsPackage, moduleName, { skipCache: options.skipCache });
+    const { patchDetail } = tsModule.moduleFile;
+
+    if (patchDetail !== undefined) {
+      const { isOutdated } = patchDetail;
+      log([ '+',
+        `${chalk.blueBright(moduleName)} is patched with ts-patch version ` +
+        `${chalk[isOutdated ? 'redBright' : 'blueBright'](patchDetail.tspVersion)} ${isOutdated ? '(out of date)' : ''}`
+      ]);
+    } else log([ '-', `${chalk.blueBright(moduleName)} is not patched.` ]);
+
+    res[moduleName] = patchDetail;
+
+    log('', LogLevel.verbose);
+  }
+
+  return res;
+}
+
+// endregion

package/projects/core/src/actions/index.ts

@@ -0,0 +1,5 @@
+export * from './patch'
+export * from './unpatch'
+export * from './check'
+export * from './install'
+export * from './uninstall'

package/projects/core/src/actions/install.ts

@@ -0,0 +1,23 @@
+import chalk from 'chalk';
+import { getInstallerOptions, InstallerOptions, patch } from '..';
+import { defaultInstallLibraries } from '../config';
+
+
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+
+/**
+ * Patch TypeScript modules
+ */
+export function install(opts?: Partial<InstallerOptions>) {
+  const options = getInstallerOptions(opts);
+  const { logger: log } = options;
+
+  const ret = patch(defaultInstallLibraries, options);
+  if (ret) log([ '+', chalk.green(`ts-patch installed!`) ]);
+
+  return ret;
+}
+
+// endregion