ts-jest 29.0.0 → 29.0.2

package/.ts-jest-digest

@@ -1 +1 @@
-f9fb4e4bd207c5c42e82ee8e8107b923ea6a903b
+60d16d7ed3a05cdc98e1c7fc94b0fb03a86f0172

package/CHANGELOG.md

@@ -1,3 +1,36 @@
+## [29.0.2](https://github.com/kulshekhar/ts-jest/compare/v29.0.1...v29.0.2) (2022-09-23)
+
+
+### Bug Fixes
+
+* mark `ts-jest` as optional in `ConfigGlobals` ([#3816](https://github.com/kulshekhar/ts-jest/issues/3816)) ([cbb88bb](https://github.com/kulshekhar/ts-jest/commit/cbb88bba34dbb852d8f4013be6e020769feb306d)), closes [#3815](https://github.com/kulshekhar/ts-jest/issues/3815)
+* use correct typings for `config:init` command ([#3825](https://github.com/kulshekhar/ts-jest/issues/3825)) ([21b94db](https://github.com/kulshekhar/ts-jest/commit/21b94dbca25b762f79e63b92dea12d830f444570))
+
+
+
+## [29.0.2](https://github.com/kulshekhar/ts-jest/compare/v29.0.1...v29.0.2) (2022-09-22)
+
+
+### Bug Fixes
+
+* mark `ts-jest` as optional in `ConfigGlobals` ([#3816](https://github.com/kulshekhar/ts-jest/issues/3816)) ([cbb88bb](https://github.com/kulshekhar/ts-jest/commit/cbb88bba34dbb852d8f4013be6e020769feb306d)), closes [#3815](https://github.com/kulshekhar/ts-jest/issues/3815)
+
+
+
+## [29.0.1](https://github.com/kulshekhar/ts-jest/compare/v29.0.0...v29.0.1) (2022-09-13)
+
+
+### Bug Fixes
+
+* **legacy:** include existing globals config in cached config ([#3803](https://github.com/kulshekhar/ts-jest/issues/3803)) ([e79be47](https://github.com/kulshekhar/ts-jest/commit/e79be47d2b81a677d0dd39d84328a38ca0f0ffc6))
+
+
+### Features
+
+* add typings for `ts-jest` options via `transform` config ([#3805](https://github.com/kulshekhar/ts-jest/issues/3805)) ([664b0f2](https://github.com/kulshekhar/ts-jest/commit/664b0f2b446a36dd7661f4840ca3dd7722f1f6ff))
+
+
+
 # [29.0.0](https://github.com/kulshekhar/ts-jest/compare/v29.0.0-next.1...v29.0.0) (2022-09-08)
 
 

package/dist/cli/config/init.d.ts

@@ -1 +1,6 @@
+/**
+ * This has been written quickly. While trying to improve I realised it'd be better to have it in Jest...
+ * ...and I saw a merged PR with `jest --init` tool!
+ * TODO: see what's the best path for this
+ */
 export {};

package/dist/cli/config/init.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * This has been written quickly. While trying to improve I realised it'd be better to have it in Jest...
+ * ...and I saw a merged PR with `jest --init` tool!
+ * TODO: see what's the best path for this
+ */
 var __assign = (this && this.__assign) || function () {
     __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
@@ -46,16 +51,35 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.help = exports.run = void 0;
 var fs_1 = require("fs");
 var path_1 = require("path");
 var json5_1 = require("json5");
 var presets_1 = require("../helpers/presets");
-var run = function (args) { return __awaiter(void 0, void 0, void 0, function () {
-    var file, filePath, name, isPackage, exists, pkgFile, hasPackage, _a, jestPreset, askedTsconfig, force, jsdom, tsconfig, pkgJson, jsFilesProcessor, shouldPostProcessWithBabel, preset, body, base, tsJestConf, content;
-    var _b, _c;
-    return __generator(this, function (_d) {
+/**
+ * @internal
+ */
+var run = function (args /* , logger: Logger */) { return __awaiter(void 0, void 0, void 0, function () {
+    var file, filePath, name, isPackage, exists, pkgFile, hasPackage, _a, jestPreset, askedTsconfig, force, jsdom, tsconfig, pkgJson, jsFilesProcessor, shouldPostProcessWithBabel, preset, body, jestConfig, transformerConfig, content;
+    var _b, _c, _d;
+    return __generator(this, function (_e) {
         file = (_c = (_b = args._[0]) === null || _b === void 0 ? void 0 : _b.toString()) !== null && _c !== void 0 ? _c : 'jest.config.js';
         filePath = (0, path_1.join)(process.cwd(), file);
         name = (0, path_1.basename)(file);
@@ -67,10 +91,13 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
         tsconfig = askedTsconfig === 'tsconfig.json' ? undefined : askedTsconfig;
         pkgJson = hasPackage ? JSON.parse((0, fs_1.readFileSync)(pkgFile, 'utf8')) : {};
         jsFilesProcessor = args.js, shouldPostProcessWithBabel = args.babel;
+        // set defaults for missing options
         if (jsFilesProcessor == null) {
+            // set default js files processor depending on whether the user wants to post-process with babel
             jsFilesProcessor = shouldPostProcessWithBabel ? 'babel' : undefined;
         }
         else if (shouldPostProcessWithBabel == null) {
+            // auto enables babel post-processing if the user wants babel to process js files
             shouldPostProcessWithBabel = jsFilesProcessor === 'babel';
         }
         if (jsFilesProcessor === 'babel') {
@@ -101,25 +128,36 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
             }
         }
         if (isPackage) {
-            base = jestPreset ? { preset: preset.name } : __assign({}, preset.value);
+            jestConfig = jestPreset ? { preset: preset.name } : __assign({}, preset.value);
             if (!jsdom)
-                base.testEnvironment = 'node';
-            if (tsconfig || shouldPostProcessWithBabel) {
-                tsJestConf = {};
-                base.globals = { 'ts-jest': tsJestConf };
-                if (tsconfig)
-                    tsJestConf.tsconfig = tsconfig;
-                if (shouldPostProcessWithBabel)
-                    tsJestConf.babelConfig = true;
+                jestConfig.testEnvironment = 'node';
+            transformerConfig = Object.entries((_d = jestConfig.transform) !== null && _d !== void 0 ? _d : {}).reduce(function (acc, _a) {
+                var _b, _c;
+                var _d = __read(_a, 2), fileRegex = _d[0], transformerName = _d[1];
+                if (transformerName === 'ts-jest') {
+                    if (tsconfig || shouldPostProcessWithBabel) {
+                        var tsJestConf = {};
+                        if (tsconfig)
+                            tsJestConf.tsconfig = tsconfig;
+                        if (shouldPostProcessWithBabel)
+                            tsJestConf.babelConfig = true;
+                        return __assign(__assign({}, acc), (_b = {}, _b[fileRegex] = [transformerName, tsJestConf], _b));
+                    }
+                    return __assign(__assign({}, acc), (_c = {}, _c[fileRegex] = transformerName, _c));
+                }
+                return acc;
+            }, {});
+            if (Object.keys(transformerConfig).length) {
+                jestConfig.transform = __assign(__assign({}, jestConfig.transform), transformerConfig);
             }
-            body = JSON.stringify(__assign(__assign({}, pkgJson), { jest: base }), undefined, '  ');
+            body = JSON.stringify(__assign(__assign({}, pkgJson), { jest: jestConfig }), undefined, '  ');
         }
         else {
             content = [];
             if (!jestPreset) {
                 content.push("".concat(preset.jsImport('tsjPreset'), ";"), '');
             }
-            content.push("/** @type {import('ts-jest/dist/types').InitialOptionsTsJest} */");
+            content.push("/** @type {import('ts-jest').JestConfigWithTsJest} */");
             content.push('module.exports = {');
             if (jestPreset) {
                 content.push("  preset: '".concat(preset.name, "',"));
@@ -130,28 +168,32 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
             if (!jsdom)
                 content.push("  testEnvironment: 'node',");
             if (tsconfig || shouldPostProcessWithBabel) {
-                content.push('  globals: {');
-                content.push("    'ts-jest': {");
+                content.push('  transform: {');
+                content.push("    '^.+\\\\.[tj]sx?$': ['ts-jest', {");
                 if (tsconfig)
                     content.push("      tsconfig: ".concat((0, json5_1.stringify)(tsconfig), ","));
                 if (shouldPostProcessWithBabel)
                     content.push('      babelConfig: true,');
-                content.push('    },');
+                content.push('    }],');
                 content.push('  },');
             }
             content.push('};');
+            // join all together
             body = content.join('\n');
         }
         (0, fs_1.writeFileSync)(filePath, body);
         process.stderr.write("\nJest configuration written to \"".concat(filePath, "\".\n"));
-        return [2];
+        return [2 /*return*/];
     });
 }); };
 exports.run = run;
+/**
+ * @internal
+ */
 var help = function () { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
         process.stdout.write("\nUsage:\n  ts-jest config:init [options] [<config-file>]\n\nArguments:\n  <config-file>         Can be a js or json Jest config file. If it is a\n                        package.json file, the configuration will be read from\n                        the \"jest\" property.\n                        Default: jest.config.js\n\nOptions:\n  --force               Discard any existing Jest config\n  --js ts|babel         Process .js files with ts-jest if 'ts' or with\n                        babel-jest if 'babel'\n  --no-jest-preset      Disable the use of Jest presets\n  --tsconfig <file>     Path to the tsconfig.json file\n  --babel               Pipe babel-jest after ts-jest\n  --jsdom               Use jsdom as test environment instead of node\n");
-        return [2];
+        return [2 /*return*/];
     });
 }); };
 exports.help = help;

package/dist/cli/config/migrate.js

@@ -72,7 +72,10 @@ var fast_json_stable_stringify_1 = __importDefault(require("fast-json-stable-str
 var json5_1 = require("json5");
 var backports_1 = require("../../utils/backports");
 var presets_1 = require("../helpers/presets");
-var run = function (args) { return __awaiter(void 0, void 0, void 0, function () {
+/**
+ * @internal
+ */
+var run = function (args /* , logger: Logger*/) { return __awaiter(void 0, void 0, void 0, function () {
     var nullLogger, file, filePath, footNotes, name, isPackage, actualConfig, migratedConfig, presetName, preset, jsTransformers, jsWithTs, jsWithBabel, presetValue, migratedValue, presetValue, migratedValue, globalsTsJestConfig, before, after, stringify, prefix;
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     return __generator(this, function (_l) {
@@ -90,18 +93,22 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
         }
         actualConfig = require(filePath);
         if (isPackage) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             actualConfig = actualConfig.jest;
         }
         if (!actualConfig)
             actualConfig = {};
         migratedConfig = (0, backports_1.backportJestConfig)(nullLogger, actualConfig);
+        // then we check if we can use `preset`
         if (!migratedConfig.preset && args.jestPreset) {
+            // find the best preset
             if (args.js) {
-                presetName = args.js === 'babel' ? "ts-jest/presets/js-with-babel" : "ts-jest/presets/js-with-ts";
+                presetName = args.js === 'babel' ? "ts-jest/presets/js-with-babel" /* JestPresetNames.jsWIthBabel */ : "ts-jest/presets/js-with-ts" /* JestPresetNames.jsWithTs */;
             }
             else {
                 jsTransformers = Object.keys(migratedConfig.transform || {}).reduce(function (list, pattern) {
                     if (RegExp(pattern.replace(/^<rootDir>\/?/, '/dummy-project/')).test('/dummy-project/src/foo.js')) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         var transformer = migratedConfig.transform[pattern];
                         if (/\bbabel-jest\b/.test(transformer))
                             transformer = 'babel-jest';
@@ -114,16 +121,18 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
                 jsWithTs = jsTransformers.includes('ts-jest');
                 jsWithBabel = jsTransformers.includes('babel-jest');
                 if (jsWithBabel && !jsWithTs) {
-                    presetName = "ts-jest/presets/js-with-babel";
+                    presetName = "ts-jest/presets/js-with-babel" /* JestPresetNames.jsWIthBabel */;
                 }
                 else if (jsWithTs && !jsWithBabel) {
-                    presetName = "ts-jest/presets/js-with-ts";
+                    presetName = "ts-jest/presets/js-with-ts" /* JestPresetNames.jsWithTs */;
                 }
                 else {
-                    presetName = "ts-jest/presets/default";
+                    // sounds like js files are NOT handled, or handled with a unknown transformer, so we do not need to handle it
+                    presetName = "ts-jest/presets/default" /* JestPresetNames.default */;
                 }
             }
-            presetName = presetName !== null && presetName !== void 0 ? presetName : "ts-jest/presets/default";
+            // ensure we are using a preset
+            presetName = presetName !== null && presetName !== void 0 ? presetName : "ts-jest/presets/default" /* JestPresetNames.default */;
             preset = presets_1.allPresets[presetName];
             footNotes.push("Detected preset '".concat(preset.label, "' as the best matching preset for your configuration.\nVisit https://kulshekhar.github.io/ts-jest/user/config/#jest-preset for more information about presets.\n"));
         }
@@ -132,11 +141,14 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
                 delete migratedConfig.preset;
             }
             else {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 preset = (_c = presets_1.allPresets[migratedConfig.preset]) !== null && _c !== void 0 ? _c : presets_1.defaults;
             }
         }
+        // enforce the correct name
         if (preset)
             migratedConfig.preset = preset.name;
+        // check the extensions
         if (((_d = migratedConfig.moduleFileExtensions) === null || _d === void 0 ? void 0 : _d.length) && preset) {
             presetValue = dedupSort((_e = preset.value.moduleFileExtensions) !== null && _e !== void 0 ? _e : []).join('::');
             migratedValue = dedupSort(migratedConfig.moduleFileExtensions).join('::');
@@ -144,9 +156,11 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
                 delete migratedConfig.moduleFileExtensions;
             }
         }
+        // there is a testRegex, remove our testMatch
         if ((typeof migratedConfig.testRegex === 'string' || ((_f = migratedConfig.testRegex) === null || _f === void 0 ? void 0 : _f.length)) && preset) {
             delete migratedConfig.testMatch;
         }
+        // check the testMatch
         else if (((_g = migratedConfig.testMatch) === null || _g === void 0 ? void 0 : _g.length) && preset) {
             presetValue = dedupSort((_h = preset.value.testMatch) !== null && _h !== void 0 ? _h : []).join('::');
             migratedValue = dedupSort(migratedConfig.testMatch).join('::');
@@ -154,10 +168,13 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
                 delete migratedConfig.testMatch;
             }
         }
+        // migrate the transform
         if (migratedConfig.transform) {
             Object.keys(migratedConfig.transform).forEach(function (key) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 var val = migratedConfig.transform[key];
                 if (typeof val === 'string' && /\/?ts-jest?(?:\/preprocessor\.js)?$/.test(val)) {
+                    // eslint-disable-next-line
                     ;
                     migratedConfig.transform[key] = 'ts-jest';
                 }
@@ -166,44 +183,63 @@ var run = function (args) { return __awaiter(void 0, void 0, void 0, function ()
         globalsTsJestConfig = (_j = migratedConfig.globals) === null || _j === void 0 ? void 0 : _j['ts-jest'];
         if (globalsTsJestConfig && migratedConfig.transform) {
             Object.keys(migratedConfig.transform).forEach(function (key) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 var val = migratedConfig.transform[key];
                 if (typeof val === 'string' && val.includes('ts-jest')) {
+                    // eslint-disable-next-line
                     ;
                     migratedConfig.transform[key] = Object.keys(globalsTsJestConfig).length ? [val, globalsTsJestConfig] : val;
                 }
             });
             delete ((_k = migratedConfig.globals) !== null && _k !== void 0 ? _k : Object.create(null))['ts-jest'];
         }
+        // check if it's the same as the preset's one
         if (preset &&
             migratedConfig.transform &&
             (0, fast_json_stable_stringify_1.default)(migratedConfig.transform) === (0, fast_json_stable_stringify_1.default)(preset.value.transform)) {
             delete migratedConfig.transform;
         }
+        // cleanup
         cleanupConfig(actualConfig);
         cleanupConfig(migratedConfig);
         before = (0, fast_json_stable_stringify_1.default)(actualConfig);
         after = (0, fast_json_stable_stringify_1.default)(migratedConfig);
         if (after === before) {
             process.stderr.write("\nNo migration needed for given Jest configuration\n    ");
-            return [2];
+            return [2 /*return*/];
         }
         stringify = file.endsWith('.json') ? JSON.stringify : json5_1.stringify;
         prefix = file.endsWith('.json') ? '"jest": ' : 'module.exports = ';
+        // if we are using preset, inform the user that he might be able to remove some section(s)
+        // we couldn't check for equality
+        //   if (usesPreset && migratedConfig.testMatch) {
+        //     footNotes.push(`
+        // I couldn't check if your "testMatch" value is the same as mine which is: ${stringify(
+        //       presets.testMatch,
+        //       undefined,
+        //       '  ',
+        //     )}
+        // If it is the case, you can safely remove the "testMatch" from what I've migrated.
+        // `)
+        //   }
         if (preset && migratedConfig.transform) {
             footNotes.push("\nI couldn't check if your \"transform\" value is the same as mine which is: ".concat(stringify(preset.value.transform, undefined, '  '), "\nIf it is the case, you can safely remove the \"transform\" from what I've migrated.\n"));
         }
+        // output new config
         process.stderr.write("\nMigrated Jest configuration:\n");
         process.stdout.write("".concat(prefix).concat(stringify(migratedConfig, undefined, '  '), "\n"));
         if (footNotes.length) {
             process.stderr.write("\n".concat(footNotes.join('\n'), "\n"));
         }
-        return [2];
+        return [2 /*return*/];
     });
 }); };
 exports.run = run;
 function cleanupConfig(config) {
     if (config.globals) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (config.globals['ts-jest'] && Object.keys(config.globals['ts-jest']).length === 0) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             delete config.globals['ts-jest'];
         }
         if (!Object.keys(config.globals).length) {
@@ -223,18 +259,22 @@ function cleanupConfig(config) {
         if (!config.testMatch.length)
             delete config.testMatch;
     }
-    if (config.preset === "ts-jest/presets/default")
+    if (config.preset === "ts-jest/presets/default" /* JestPresetNames.default */)
         config.preset = presets_1.defaults.name;
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function dedupSort(arr) {
     return arr
         .filter(function (s, i, a) { return a.findIndex(function (e) { return s.toString() === e.toString(); }) === i; })
         .sort(function (a, b) { return (a.toString() > b.toString() ? 1 : a.toString() < b.toString() ? -1 : 0); });
 }
+/**
+ * @internal
+ */
 var help = function () { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
         process.stdout.write("\nUsage:\n  ts-jest config:migrate [options] <config-file>\n\nArguments:\n  <config-file>         Can be a js or json Jest config file. If it is a\n                        package.json file, the configuration will be read from\n                        the \"jest\" property.\n\nOptions:\n  --js ts|babel         Process .js files with ts-jest if 'ts' or with\n                        babel-jest if 'babel'\n  --no-jest-preset      Disable the use of Jest presets\n");
-        return [2];
+        return [2 /*return*/];
     });
 }); };
 exports.help = help;

package/dist/cli/help.js

@@ -37,11 +37,17 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.help = exports.run = void 0;
+/**
+ * @internal
+ */
 var run = function (_) { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
         process.stdout.write("\nUsage:\n  ts-jest command [options] [...args]\n\nCommands:\n  config:init           Creates initial Jest configuration\n  config:migrate        Migrates a given Jest configuration\n  help [command]        Show this help, or help about a command\n\nExample:\n  ts-jest help config:migrate\n");
-        return [2];
+        return [2 /*return*/];
     });
 }); };
 exports.run = run;
+/**
+ * @internal
+ */
 exports.help = exports.run;

package/dist/cli/helpers/presets.js

@@ -7,15 +7,17 @@ var definePreset = function (fullName) { return ({
         return this.isDefault ? 'ts-jest' : fullName;
     },
     get label() {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         return fullName.split('/').pop();
     },
     get jsVarName() {
         return this.isDefault
             ? 'defaults'
-            :
+            : // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 fullName
                     .split('/')
                     .pop()
+                    // eslint-disable-next-line no-useless-escape
                     .replace(/\-([a-z])/g, function (_, l) { return l.toUpperCase(); });
     },
     get value() {
@@ -26,10 +28,15 @@ var definePreset = function (fullName) { return ({
         return "const { ".concat(this.jsVarName, ": ").concat(varName, " } = require('ts-jest/presets')");
     },
     get isDefault() {
-        return fullName === "ts-jest/presets/default";
+        return fullName === "ts-jest/presets/default" /* JestPresetNames.default */;
     },
 }); };
+/** @internal */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 exports.allPresets = {};
-exports.defaults = (exports.allPresets["ts-jest/presets/default"] = definePreset("ts-jest/presets/default"));
-exports.jsWithTs = (exports.allPresets["ts-jest/presets/js-with-ts"] = definePreset("ts-jest/presets/js-with-ts"));
-exports.jsWIthBabel = (exports.allPresets["ts-jest/presets/js-with-babel"] = definePreset("ts-jest/presets/js-with-babel"));
+/** @internal */
+exports.defaults = (exports.allPresets["ts-jest/presets/default" /* JestPresetNames.default */] = definePreset("ts-jest/presets/default" /* JestPresetNames.default */));
+/** @internal */
+exports.jsWithTs = (exports.allPresets["ts-jest/presets/js-with-ts" /* JestPresetNames.jsWithTs */] = definePreset("ts-jest/presets/js-with-ts" /* JestPresetNames.jsWithTs */));
+/** @internal */
+exports.jsWIthBabel = (exports.allPresets["ts-jest/presets/js-with-babel" /* JestPresetNames.jsWIthBabel */] = definePreset("ts-jest/presets/js-with-babel" /* JestPresetNames.jsWIthBabel */));

package/dist/cli/index.js

@@ -65,6 +65,7 @@ function cli(args) {
                     },
                 },
             });
+            // deprecated
             if (parsedArgv.allowJs != null) {
                 if (parsedArgv.js)
                     throw new Error("The 'allowJs' and 'js' options cannot be set together.");
@@ -78,7 +79,7 @@ function cli(args) {
                 command = 'help';
             _a = require("./".concat(command.replace(/:/g, '/'))), run = _a.run, help = _a.help;
             cmd = isHelp && command !== 'help' ? help : run;
-            return [2, cmd(parsedArgv, logger)];
+            return [2 /*return*/, cmd(parsedArgv, logger)];
         });
     });
 }
@@ -87,6 +88,9 @@ var errorHasMessage = function (err) {
         return false;
     return 'message' in err;
 };
+/**
+ * @internal
+ */
 function processArgv() {
     return __awaiter(this, void 0, void 0, function () {
         var err_1;
@@ -94,19 +98,19 @@ function processArgv() {
             switch (_a.label) {
                 case 0:
                     _a.trys.push([0, 2, , 3]);
-                    return [4, cli(process.argv.slice(2))];
+                    return [4 /*yield*/, cli(process.argv.slice(2))];
                 case 1:
                     _a.sent();
                     process.exit(0);
-                    return [3, 3];
+                    return [3 /*break*/, 3];
                 case 2:
                     err_1 = _a.sent();
                     if (errorHasMessage(err_1)) {
                         logger.fatal(err_1.message);
                         process.exit(1);
                     }
-                    return [3, 3];
-                case 3: return [2];
+                    return [3 /*break*/, 3];
+                case 3: return [2 /*return*/];
             }
         });
     });

package/dist/config/paths-to-module-name-mapper.js

@@ -16,6 +16,8 @@ exports.pathsToModuleNameMapper = void 0;
 var bs_logger_1 = require("bs-logger");
 var utils_1 = require("../utils");
 var messages_1 = require("../utils/messages");
+// we don't need to escape all chars, so commented out is the real one
+// const escapeRegex = (str: string) => str.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&')
 var escapeRegex = function (str) { return str.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&'); };
 var logger = utils_1.rootLogger.child((_a = {}, _a[bs_logger_1.LogContexts.namespace] = 'path-mapper', _a));
 var pathsToModuleNameMapper = function (mapping, _a) {
@@ -27,10 +29,12 @@ var pathsToModuleNameMapper = function (mapping, _a) {
             var fromPath = _f.value;
             var pattern = void 0;
             var toPaths = mapping[fromPath];
+            // check that we have only one target path
             if (toPaths.length === 0) {
-                logger.warn((0, messages_1.interpolate)("Not mapping \"{{path}}\" because it has no target.", { path: fromPath }));
+                logger.warn((0, messages_1.interpolate)("Not mapping \"{{path}}\" because it has no target." /* Errors.NotMappingPathWithEmptyMap */, { path: fromPath }));
                 continue;
             }
+            // split with '*'
             var segments = fromPath.split(/\*/g);
             if (segments.length === 1) {
                 var paths = toPaths.map(function (target) {
@@ -50,7 +54,7 @@ var pathsToModuleNameMapper = function (mapping, _a) {
                 jestMap[pattern] = paths.length === 1 ? paths[0] : paths;
             }
             else {
-                logger.warn((0, messages_1.interpolate)("Not mapping \"{{path}}\" because it has more than one star (`*`).", { path: fromPath }));
+                logger.warn((0, messages_1.interpolate)("Not mapping \"{{path}}\" because it has more than one star (`*`)." /* Errors.NotMappingMultiStarPath */, { path: fromPath }));
             }
         }
     }

package/dist/constants.js

@@ -6,6 +6,11 @@ exports.DECLARATION_TYPE_EXT = '.d.ts';
 exports.JS_JSX_EXTENSIONS = ['.js', '.jsx'];
 exports.TS_TSX_REGEX = /\.m?tsx?$/;
 exports.JS_JSX_REGEX = /\.m?jsx?$/;
+// `extensionsToTreatAsEsm` will throw error with `.mjs`
 exports.TS_EXT_TO_TREAT_AS_ESM = ['.ts', '.tsx', '.mts'];
 exports.JS_EXT_TO_TREAT_AS_ESM = ['.jsx'];
+/**
+ * @internal
+ * See https://jestjs.io/docs/en/configuration#testmatch-arraystring
+ */
 exports.DEFAULT_JEST_TEST_MATCH = ['**/__tests__/**/*.[jt]s?(x)', '**/?(*.)+(spec|test).[jt]s?(x)'];

package/dist/legacy/compiler/compiler-utils.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Rely on TypeScript compiled output generation which contains this prefix to point to sourcemap location.
+ */
 export declare const SOURCE_MAPPING_PREFIX = "sourceMappingURL=";
+/**
+ * Update the output remapping the source map.
+ */
 export declare function updateOutput(outputText: string, normalizedFileName: string, sourceMap?: string): string;

package/dist/legacy/compiler/compiler-utils.js

@@ -2,17 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateOutput = exports.SOURCE_MAPPING_PREFIX = void 0;
 var utils_1 = require("../../utils");
+/**
+ * Rely on TypeScript compiled output generation which contains this prefix to point to sourcemap location.
+ */
 exports.SOURCE_MAPPING_PREFIX = 'sourceMappingURL=';
+/**
+ * Update the output remapping the source map.
+ */
 function updateOutput(outputText, normalizedFileName, sourceMap) {
     if (sourceMap) {
         var base64Map = Buffer.from(updateSourceMap(sourceMap, normalizedFileName), 'utf8').toString('base64');
         var sourceMapContent = "data:application/json;charset=utf-8;base64,".concat(base64Map);
+        // sourceMappingURL= prefix is always at the end of compiledOutput, using lastIndexOf should be the safest way to substring
         return (outputText.slice(0, outputText.lastIndexOf(exports.SOURCE_MAPPING_PREFIX) + exports.SOURCE_MAPPING_PREFIX.length) +
             sourceMapContent);
     }
     return outputText;
 }
 exports.updateOutput = updateOutput;
+/**
+ * Update the source map contents for improved output.
+ */
 var updateSourceMap = function (sourceMapText, normalizedFileName) {
     var sourceMap = JSON.parse(sourceMapText);
     sourceMap.file = normalizedFileName;

package/dist/legacy/compiler/ts-compiler.d.ts

@@ -10,7 +10,13 @@ export declare class TsCompiler implements TsCompilerInstance {
     protected readonly _ts: TTypeScript;
     protected readonly _initialCompilerOptions: CompilerOptions;
     protected _compilerOptions: CompilerOptions;
+    /**
+     * @private
+     */
     private _runtimeCacheFS;
+    /**
+     * @private
+     */
     private _fileContentCache;
     program: Program | undefined;
     constructor(configSet: ConfigSet, runtimeCacheFS: StringMap);