@samchon/ts-patch 3.2.2-dev.20241204

package/module/source-section.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSourceSection = createSourceSection;
+const typescript_1 = __importDefault(require("typescript"));
+const path_1 = __importDefault(require("path"));
+// endregion
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+function createSourceSection(moduleFile, sectionName, startPos, endPos, indentLevel = 0, srcFileName) {
+    let sourceText;
+    let originalSourceFile;
+    let sourceFile;
+    let sourceFileName;
+    return {
+        hasTransformed: false,
+        hasUpdatedSourceText: false,
+        sectionName,
+        srcFileName,
+        indentLevel,
+        pos: { start: startPos, end: endPos },
+        get sourceText() {
+            return sourceText ?? (sourceText = moduleFile.content.slice(startPos, endPos));
+        },
+        getSourceFile() {
+            if (!sourceFile) {
+                if (this.hasUpdatedSourceText)
+                    return createSourceFile(this);
+                else
+                    return this.getOriginalSourceFile();
+            }
+            return sourceFile;
+        },
+        updateSourceText(newText) {
+            sourceText = newText;
+            sourceFile = undefined;
+        },
+        getOriginalSourceFile() {
+            originalSourceFile ?? (originalSourceFile = createSourceFile(this));
+            return originalSourceFile;
+        },
+        transform(transformers) {
+            const result = typescript_1.default.transform(this.getSourceFile(), transformers);
+            sourceFile = result.transformed[0];
+            this.hasTransformed = true;
+            this.indentLevel = 0;
+        },
+        print(printer) {
+            if (!this.hasTransformed)
+                return this.sourceText;
+            printer ?? (printer = typescript_1.default.createPrinter());
+            return printer.printFile(this.getSourceFile());
+        }
+    };
+    function createSourceFile(sourceSection) {
+        return typescript_1.default.createSourceFile(getSourceFileName(), sourceSection.sourceText, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.JS);
+    }
+    function getSourceFileName() {
+        if (!sourceFileName) {
+            sourceFileName = srcFileName;
+            if (!sourceFileName) {
+                const baseName = path_1.default.basename(moduleFile.filePath, path_1.default.extname(moduleFile.filePath));
+                sourceFileName = `${baseName}.${sectionName}.ts`;
+            }
+        }
+        return sourceFileName;
+    }
+}
+// endregion
+//# sourceMappingURL=source-section.js.map

package/module/source-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-section.js","sourceRoot":"","sources":["../../../projects/core/src/module/source-section.ts"],"names":[],"mappings":";;;;;AAiCA,kDA0EC;AA3GD,4DAA4B;AAE5B,gDAAwB;AAwBxB,YAAY;AAGZ,wHAAwH;AACxH,gBAAgB;AAChB,wHAAwH;AAExH,SAAgB,mBAAmB,CACjC,UAAsB,EACtB,WAAyC,EACzC,QAAgB,EAChB,MAAc,EACd,cAAsB,CAAC,EACvB,WAAoB;IAIpB,IAAI,UAA8B,CAAC;IACnC,IAAI,kBAA6C,CAAC;IAClD,IAAI,UAAqC,CAAC;IAC1C,IAAI,cAAkC,CAAC;IAEvC,OAAO;QACL,cAAc,EAAE,KAAK;QACrB,oBAAoB,EAAE,KAAK;QAC3B,WAAW;QACX,WAAW;QACX,WAAW;QACX,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE;QACrC,IAAI,UAAU;YACZ,OAAO,UAAU,KAAV,UAAU,GAAK,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAC;QACnE,CAAC;QACD,aAAa;YACX,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,oBAAoB;oBAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;;oBACxD,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3C,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,gBAAgB,CAAC,OAAe;YAC9B,UAAU,GAAG,OAAO,CAAC;YACrB,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,qBAAqB;YACnB,kBAAkB,KAAlB,kBAAkB,GAAK,gBAAgB,CAAC,IAAI,CAAC,EAAC;YAC9C,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,SAAS,CAAC,YAAoD;YAC5D,MAAM,MAAM,GAAG,oBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,YAAY,CAAC,CAAC;YAChE,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,OAAoB;YACxB,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,OAAO,IAAI,CAAC,UAAU,CAAC;YAEjD,OAAO,KAAP,OAAO,GAAK,oBAAE,CAAC,aAAa,EAAE,EAAC;YAC/B,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACjD,CAAC;KACF,CAAA;IAED,SAAS,gBAAgB,CAAC,aAA4B;QACpD,OAAO,oBAAE,CAAC,gBAAgB,CACxB,iBAAiB,EAAE,EACnB,aAAa,CAAC,UAAU,EACxB,oBAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,oBAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;IACJ,CAAC;IAED,SAAS,iBAAiB;QACxB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,WAAW,CAAC;YAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvF,cAAc,GAAG,GAAG,QAAQ,IAAI,WAAW,KAAK,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAED,YAAY"}

package/module/ts-module.d.ts

@@ -0,0 +1,35 @@
+import type { TsPackage } from '../ts-package';
+import { ModuleSource } from './module-source';
+import { ModuleFile } from './module-file';
+export declare namespace TsModule {
+    const names: readonly ["tsc.js", "tsserverlibrary.js", "typescript.js", "tsserver.js", "_tsc.js", "_tsserver.js"];
+}
+export interface TsModule {
+    package: TsPackage;
+    majorVer: number;
+    minorVer: number;
+    isPatched: boolean;
+    moduleName: TsModule.Name;
+    modulePath: string;
+    moduleFile: ModuleFile;
+    dtsPath: string | undefined;
+    cacheKey: string;
+    backupCachePaths: {
+        js: string;
+        dts?: string;
+    };
+    patchedCachePaths: {
+        js: string;
+        dts?: string;
+    };
+    getUnpatchedModuleFile(): ModuleFile;
+    getUnpatchedSource(): ModuleSource;
+}
+export declare namespace TsModule {
+    type Name = (typeof names)[number] | string;
+}
+export interface GetTsModuleOptions {
+    skipCache?: boolean;
+}
+export declare function getTsModule(tsPackage: TsPackage, moduleName: TsModule.Name, options?: GetTsModuleOptions): TsModule;
+export declare function getTsModule(tsPackage: TsPackage, moduleFile: ModuleFile, options?: GetTsModuleOptions): TsModule;

package/module/ts-module.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsModule = void 0;
+exports.getTsModule = getTsModule;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const module_source_1 = require("./module-source");
+const system_1 = require("../system");
+const module_file_1 = require("./module-file");
+const config_1 = require("../config");
+/* ****************************************************************************************************************** */
+// region: Config
+/* ****************************************************************************************************************** */
+var TsModule;
+(function (TsModule) {
+    TsModule.names = [
+        'tsc.js',
+        'tsserverlibrary.js',
+        'typescript.js',
+        'tsserver.js',
+        '_tsc.js',
+        '_tsserver.js',
+    ];
+})(TsModule || (exports.TsModule = TsModule = {}));
+function getTsModule(tsPackage, moduleNameOrModuleFile, options) {
+    const skipCache = options?.skipCache;
+    /* Get Module File */
+    let moduleFile;
+    let moduleName;
+    let modulePath;
+    if (typeof moduleNameOrModuleFile === "object" && moduleNameOrModuleFile.content) {
+        moduleFile = moduleNameOrModuleFile;
+        moduleName = moduleFile.moduleName;
+        modulePath = moduleFile.filePath;
+    }
+    else {
+        moduleName = moduleNameOrModuleFile;
+    }
+    /* Handle Local Cache */
+    if (!skipCache && tsPackage.moduleCache.has(moduleName))
+        return tsPackage.moduleCache.get(moduleName);
+    /* Load File (if not already) */
+    if (!modulePath)
+        modulePath = path_1.default.join(tsPackage.libDir, moduleName);
+    if (!moduleFile)
+        moduleFile = (0, module_file_1.getModuleFile)(modulePath);
+    /* Get DTS if exists */
+    const maybeDtsFile = modulePath.replace(/\.js$/, '.d.ts');
+    const dtsPath = fs_1.default.existsSync(maybeDtsFile) ? maybeDtsFile : undefined;
+    const dtsName = dtsPath && path_1.default.basename(dtsPath);
+    /* Get Cache Paths */
+    const cacheKey = moduleFile.patchDetail?.originalHash || moduleFile.getHash();
+    const backupCachePaths = {
+        js: (0, system_1.getCachePath)(cacheKey, moduleName),
+        dts: dtsName && (0, system_1.getCachePath)(cacheKey, dtsName)
+    };
+    const patchedCachePaths = {
+        js: (0, system_1.getCachePath)(cacheKey, config_1.cachedFilePatchedPrefix + moduleName),
+        dts: dtsName && (0, system_1.getCachePath)(cacheKey, config_1.cachedFilePatchedPrefix + dtsName)
+    };
+    /* Create Module */
+    const isPatched = !!moduleFile.patchDetail;
+    let originalModuleFile;
+    const tsModule = {
+        package: tsPackage,
+        majorVer: tsPackage.majorVer,
+        minorVer: tsPackage.minorVer,
+        isPatched,
+        moduleName,
+        modulePath,
+        moduleFile,
+        dtsPath,
+        cacheKey,
+        backupCachePaths,
+        patchedCachePaths,
+        getUnpatchedSource() {
+            return (0, module_source_1.getModuleSource)(this);
+        },
+        getUnpatchedModuleFile() {
+            if (!originalModuleFile) {
+                if (isPatched) {
+                    if (!fs_1.default.existsSync(backupCachePaths.js))
+                        throw new system_1.TspError(`Cannot find backup cache file for ${moduleName}. Please wipe node_modules and reinstall.`);
+                    originalModuleFile = (0, module_file_1.getModuleFile)(backupCachePaths.js);
+                }
+                else {
+                    originalModuleFile = isPatched ? (0, module_file_1.getModuleFile)(backupCachePaths.js) : moduleFile;
+                }
+            }
+            return originalModuleFile;
+        }
+    };
+    tsPackage.moduleCache.set(moduleName, tsModule);
+    return tsModule;
+}
+// endregion
+//# sourceMappingURL=ts-module.js.map

package/module/ts-module.js.map

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

package/options.d.ts

@@ -0,0 +1,19 @@
+import { Logger, LogLevel } from './system';
+export interface InstallerOptions {
+    logLevel: LogLevel;
+    useColor: boolean;
+    dir: string;
+    silent: boolean;
+    logger: Logger;
+    skipCache: boolean;
+}
+export declare namespace InstallerOptions {
+    function getDefaults(): {
+        logLevel: LogLevel.normal;
+        useColor: true;
+        dir: string;
+        silent: false;
+        skipCache: false;
+    };
+}
+export declare function getInstallerOptions(options?: Partial<InstallerOptions>): InstallerOptions;

package/options.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallerOptions = void 0;
+exports.getInstallerOptions = getInstallerOptions;
+const system_1 = require("./system");
+var InstallerOptions;
+(function (InstallerOptions) {
+    function getDefaults() {
+        return {
+            logLevel: system_1.LogLevel.normal,
+            useColor: true,
+            dir: process.cwd(),
+            silent: false,
+            skipCache: false
+        };
+    }
+    InstallerOptions.getDefaults = getDefaults;
+})(InstallerOptions || (exports.InstallerOptions = InstallerOptions = {}));
+// endregion
+/* ********************************************************************************************************************
+ * Parser
+ * ********************************************************************************************************************/
+function getInstallerOptions(options) {
+    if (!options && typeof options === "object" && Object.isSealed(options))
+        return options;
+    const res = { ...InstallerOptions.getDefaults(), ...options };
+    return Object.seal({
+        ...res,
+        logger: res.logger ?? (0, system_1.createLogger)(res.logLevel, res.useColor, res.silent)
+    });
+}
+//# sourceMappingURL=options.js.map

package/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../projects/core/src/options.ts"],"names":[],"mappings":";;;AA6CA,kDASC;AAtDD,qCAA0D;AA0B1D,IAAiB,gBAAgB,CAUhC;AAVD,WAAiB,gBAAgB;IAC/B,SAAgB,WAAW;QACzB,OAAO;YACL,QAAQ,EAAE,iBAAQ,CAAC,MAAM;YACzB,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,KAAK;SACO,CAAA;IAC3B,CAAC;IARe,4BAAW,cAQ1B,CAAA;AACH,CAAC,EAVgB,gBAAgB,gCAAhB,gBAAgB,QAUhC;AAED,YAAY;AAGZ;;wHAEwH;AAExH,SAAgB,mBAAmB,CAAC,OAAmC;IACrE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAA2B,CAAC;IAE5G,MAAM,GAAG,GAAG,EAAE,GAAG,gBAAgB,CAAC,WAAW,EAAE,EAAE,GAAG,OAAO,EAAmB,CAAC;IAE/E,OAAO,MAAM,CAAC,IAAI,CAAC;QACjB,GAAG,GAAG;QACN,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAA,qBAAY,EAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@samchon/ts-patch",
+  "version": "3.2.2-dev.20241204",
+  "description": "Patch typescript to support custom transformers in tsconfig.json",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "keywords": [
+    "typescript",
+    "transform",
+    "transformer",
+    "plugin",
+    "config",
+    "ast"
+  ],
+  "author": {
+    "name": "Ron S.",
+    "url": "http://twitter.com/ron"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/nonara/ts-patch.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nonara/ts-patch/issues"
+  },
+  "homepage": "https://github.com/nonara/ts-patch#readme",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "global-prefix": "^3.0.0",
+    "minimist": "^1.2.8",
+    "resolve": "^1.22.2",
+    "semver": "^7.5.4",
+    "strip-ansi": "^6.0.1"
+  },
+  "bin": {
+    "ts-patch": "./bin/ts-patch.js",
+    "tspc": "./bin/tspc.js"
+  },
+  "directories": {
+    "resources": "./resources"
+  },
+  "standard-version": {
+    "types": [
+      {
+        "type": "feat",
+        "section": "Features"
+      },
+      {
+        "type": "feature",
+        "section": "Features"
+      },
+      {
+        "type": "fix",
+        "section": "Bug Fixes"
+      },
+      {
+        "type": "perf",
+        "section": "Performance Improvements"
+      },
+      {
+        "type": "revert",
+        "section": "Reverts"
+      },
+      {
+        "type": "docs",
+        "section": "Documentation",
+        "hidden": true
+      },
+      {
+        "type": "style",
+        "section": "Styles",
+        "hidden": true
+      },
+      {
+        "type": "chore",
+        "section": "Miscellaneous Chores",
+        "hidden": true
+      },
+      {
+        "type": "refactor",
+        "section": "Code Refactoring",
+        "hidden": true
+      },
+      {
+        "type": "test",
+        "section": "Tests",
+        "hidden": true
+      },
+      {
+        "type": "build",
+        "section": "Build System",
+        "hidden": true
+      },
+      {
+        "type": "ci",
+        "section": "Continuous Integration",
+        "hidden": true
+      },
+      {
+        "type": "change",
+        "section": "Changes"
+      }
+    ]
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}

package/patch/get-patched-source.d.ts

@@ -0,0 +1,12 @@
+import { Logger } from '../system';
+import { TsModule } from '../module';
+export interface GetPatchedSourceOptions {
+    log?: Logger;
+    skipCache?: boolean;
+    skipDts?: boolean;
+}
+export declare function getPatchedSource(tsModule: TsModule, options?: GetPatchedSourceOptions): {
+    js: string;
+    dts: string | undefined;
+    loadedFromCache: boolean;
+};

package/patch/get-patched-source.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPatchedSource = getPatchedSource;
+const system_1 = require("../system");
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("../utils");
+const fs_1 = __importDefault(require("fs"));
+const module_1 = require("../module");
+const patch_module_1 = require("./patch-module");
+// endregion
+/* ****************************************************************************************************************** */
+// region: Utils
+/* ****************************************************************************************************************** */
+function getPatchedSource(tsModule, options) {
+    const { backupCachePaths, patchedCachePaths } = tsModule;
+    const { log, skipCache } = options || {};
+    /* Write backup if not patched */
+    if (!tsModule.isPatched) {
+        for (const [key, backupPath] of Object.entries(backupCachePaths)) {
+            const srcPath = key === 'dts' ? tsModule.dtsPath : tsModule.modulePath;
+            if (key === 'dts' && options?.skipDts)
+                continue;
+            if (!srcPath)
+                continue;
+            log?.(['~', `Writing backup cache to ${chalk_1.default.blueBright(backupPath)}`], system_1.LogLevel.verbose);
+            const cacheDir = path_1.default.dirname(backupPath);
+            (0, utils_1.mkdirIfNotExist)(cacheDir);
+            (0, utils_1.copyFileWithLock)(srcPath, backupPath);
+        }
+    }
+    /* Get Patched Module */
+    const canUseCache = !skipCache
+        && !tsModule.moduleFile.patchDetail?.isOutdated
+        && (!patchedCachePaths.dts || fs_1.default.existsSync(patchedCachePaths.dts))
+        && fs_1.default.existsSync(patchedCachePaths.js)
+        && !(0, module_1.getModuleFile)(patchedCachePaths.js).patchDetail?.isOutdated;
+    let js;
+    let dts;
+    if (canUseCache) {
+        js = (0, utils_1.readFileWithLock)(patchedCachePaths.js);
+        dts = !options?.skipDts && patchedCachePaths.dts ? (0, utils_1.readFileWithLock)(patchedCachePaths.dts) : undefined;
+    }
+    else {
+        const res = (0, patch_module_1.patchModule)(tsModule, options?.skipDts);
+        js = res.js;
+        dts = res.dts;
+        /* Write patched cache */
+        if (!skipCache) {
+            const cacheDir = path_1.default.dirname(patchedCachePaths.js);
+            for (const [key, patchPath] of Object.entries(patchedCachePaths)) {
+                const srcPath = key === 'dts' ? dts : js;
+                if (key === 'dts' && options?.skipDts)
+                    continue;
+                if (!srcPath)
+                    continue;
+                log?.(['~', `Writing patched cache to ${chalk_1.default.blueBright(patchPath)}`], system_1.LogLevel.verbose);
+                (0, utils_1.mkdirIfNotExist)(cacheDir);
+                (0, utils_1.writeFileWithLock)(patchPath, srcPath);
+            }
+        }
+    }
+    return { js, dts, loadedFromCache: canUseCache };
+}
+// endregion
+//# sourceMappingURL=get-patched-source.js.map

package/patch/get-patched-source.js.map

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

package/patch/patch-detail.d.ts

@@ -0,0 +1,36 @@
+import { TsModule } from '../module';
+export declare const tspHeaderBlockStart = "/// tsp-module:";
+export declare const tspHeaderBlockStop = "/// :tsp-module";
+export declare const currentPatchDetailVersion = "0.1.0";
+export interface PatchDetail {
+    tsVersion: string;
+    tspVersion: string;
+    patchDetailVersion: string;
+    moduleName: TsModule.Name;
+    originalHash: string;
+    hash: string;
+    patches: PatchDetail.PatchEntry[];
+}
+export declare namespace PatchDetail {
+    interface PatchEntry {
+        library: string;
+        version: string;
+        patchName?: string;
+        hash?: string;
+        blocksCache?: boolean;
+    }
+}
+export declare class PatchDetail {
+    get isOutdated(): boolean;
+    toHeader(): string;
+    static fromHeader(header: string | string[]): PatchDetail | undefined;
+    static fromModule(tsModule: TsModule, patchedContent: string, patches?: PatchDetail.PatchEntry[]): PatchDetail & {
+        tsVersion: string;
+        tspVersion: any;
+        patchDetailVersion: string;
+        moduleName: string;
+        originalHash: string;
+        hash: string;
+        patches: PatchDetail.PatchEntry[];
+    };
+}

package/patch/patch-detail.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchDetail = exports.currentPatchDetailVersion = exports.tspHeaderBlockStop = exports.tspHeaderBlockStart = void 0;
+const config_1 = require("../config");
+const semver_1 = __importDefault(require("semver"));
+const utils_1 = require("../utils");
+/* ****************************************************************************************************************** */
+// region: Config
+/* ****************************************************************************************************************** */
+exports.tspHeaderBlockStart = '/// tsp-module:';
+exports.tspHeaderBlockStop = '/// :tsp-module';
+exports.currentPatchDetailVersion = '0.1.0';
+// endregion
+/* ****************************************************************************************************************** */
+// region: PatchDetail (class)
+/* ****************************************************************************************************************** */
+class PatchDetail {
+    /* ********************************************************* */
+    // region: Methods
+    /* ********************************************************* */
+    get isOutdated() {
+        const packageVersion = config_1.tspPackageJSON.version;
+        return semver_1.default.gt(packageVersion, this.tspVersion);
+    }
+    toHeader() {
+        const lines = JSON.stringify(this, null, 2)
+            .split('\n')
+            .map(line => `/// ${line}`)
+            .join('\n');
+        return `${exports.tspHeaderBlockStart}\n${lines}\n${exports.tspHeaderBlockStop}`;
+    }
+    static fromHeader(header) {
+        const headerLines = Array.isArray(header) ? header : header.split('\n');
+        let patchDetail;
+        const startIdx = headerLines.findIndex(line => line === exports.tspHeaderBlockStart) + 1;
+        let endIdx = headerLines.findIndex(line => line === exports.tspHeaderBlockStop);
+        if (endIdx === -1)
+            headerLines.length;
+        if (startIdx && endIdx) {
+            const patchInfoStr = headerLines
+                .slice(startIdx, endIdx)
+                .map(line => line.replace('/// ', ''))
+                .join('\n');
+            patchDetail = Object.assign(new PatchDetail(), JSON.parse(patchInfoStr));
+        }
+        return patchDetail;
+    }
+    static fromModule(tsModule, patchedContent, patches = []) {
+        patches.unshift({ library: 'ts-patch', patchName: config_1.corePatchName, version: config_1.tspPackageJSON.version });
+        const patchDetail = {
+            tsVersion: tsModule.package.version,
+            tspVersion: config_1.tspPackageJSON.version,
+            patchDetailVersion: exports.currentPatchDetailVersion,
+            moduleName: tsModule.moduleName,
+            originalHash: tsModule.cacheKey,
+            hash: (0, utils_1.getHash)(patchedContent),
+            patches: patches
+        };
+        return Object.assign(new PatchDetail(), patchDetail);
+    }
+}
+exports.PatchDetail = PatchDetail;
+// endregion
+//# sourceMappingURL=patch-detail.js.map

package/patch/patch-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-detail.js","sourceRoot":"","sources":["../../../projects/core/src/patch/patch-detail.ts"],"names":[],"mappings":";;;;;;AACA,sCAA0D;AAC1D,oDAA4B;AAC5B,oCAAmC;AAGnC,wHAAwH;AACxH,iBAAiB;AACjB,wHAAwH;AAE3G,QAAA,mBAAmB,GAAG,iBAAiB,CAAC;AACxC,QAAA,kBAAkB,GAAG,iBAAiB,CAAC;AACvC,QAAA,yBAAyB,GAAG,OAAO,CAAC;AA6BjD,YAAY;AAGZ,wHAAwH;AACxH,8BAA8B;AAC9B,wHAAwH;AAExH,MAAa,WAAW;IAEtB,+DAA+D;IAC/D,kBAAkB;IAClB,+DAA+D;IAE/D,IAAI,UAAU;QACZ,MAAM,cAAc,GAAG,uBAAc,CAAC,OAAO,CAAC;QAC9C,OAAO,gBAAM,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACxC,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;aAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,GAAG,2BAAmB,KAAK,KAAK,KAAK,0BAAkB,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAyB;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExE,IAAI,WAAoC,CAAC;QACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,2BAAmB,CAAC,GAAG,CAAC,CAAC;QACjF,IAAI,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,0BAAkB,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,CAAC,CAAC;YAAE,WAAW,CAAC,MAAM,CAAC;QACtC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,WAAW;iBAC7B,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;iBACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;iBACrC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAgB,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,QAAkB,EAAE,cAAsB,EAAE,UAAoC,EAAE;QAClG,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAa,EAAE,OAAO,EAAE,uBAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAEpG,MAAM,WAAW,GAAG;YAClB,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;YACnC,UAAU,EAAE,uBAAc,CAAC,OAAO;YAClC,kBAAkB,EAAE,iCAAyB;YAC7C,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,YAAY,EAAE,QAAQ,CAAC,QAAQ;YAC/B,IAAI,EAAE,IAAA,eAAO,EAAC,cAAc,CAAC;YAC7B,OAAO,EAAE,OAAO;SACsC,CAAA;QAExD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;CAGF;AAvDD,kCAuDC;AAED,YAAY"}

package/patch/patch-module.d.ts

@@ -0,0 +1,5 @@
+import { TsModule } from '../module';
+export declare function patchModule(tsModule: TsModule, skipDts?: boolean): {
+    js: string;
+    dts?: string;
+};