@nx/jest 23.0.0-beta.21 → 23.0.0-beta.23

package/dist/src/utils/versions.d.ts

@@ -1,4 +1,6 @@
 import { type Tree } from '@nx/devkit';
+export declare const minSupportedJestVersion = "29.0.0";
+export declare const minSupportedTsJestVersion = "29.0.0";
 export declare const latestVersions: {
     nxVersion: any;
     jestVersion: string;
@@ -17,12 +19,21 @@ export type VersionMap = {
     [key in SupportedVersions]: Record<PackageVersionNames, string>;
 };
 export declare const versionMap: VersionMap;
-export declare function versions(tree: Tree): any;
+export declare function versions(tree: Tree): {
+    nxVersion: any;
+    jestVersion: string;
+    babelJestVersion: string;
+    jestTypesVersion: string;
+    tsJestVersion: string;
+    tslibVersion: string;
+    swcJestVersion: string;
+    typesNodeVersion: string;
+    tsNodeVersion: string;
+};
 export declare function getInstalledJestVersion(tree?: Tree): string | null;
 export declare function getInstalledJestVersionInfo(tree?: Tree): {
     version: string | null;
     major: number | null;
 };
 export declare function getInstalledJestMajorVersion(tree?: Tree): number | null;
-export declare function validateInstalledJestVersion(tree?: Tree): void;
 export {};

package/dist/src/utils/versions.js

@@ -1,15 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.versionMap = exports.latestVersions = void 0;
+exports.versionMap = exports.latestVersions = exports.minSupportedTsJestVersion = exports.minSupportedJestVersion = void 0;
 exports.versions = versions;
 exports.getInstalledJestVersion = getInstalledJestVersion;
 exports.getInstalledJestVersionInfo = getInstalledJestVersionInfo;
 exports.getInstalledJestMajorVersion = getInstalledJestMajorVersion;
-exports.validateInstalledJestVersion = validateInstalledJestVersion;
 const devkit_1 = require("@nx/devkit");
+const internal_1 = require("@nx/devkit/internal");
 const path_1 = require("path");
 const semver_1 = require("semver");
 const nxVersion = require((0, path_1.join)('@nx/jest', 'package.json')).version;
+exports.minSupportedJestVersion = '29.0.0';
+exports.minSupportedTsJestVersion = '29.0.0';
 // Jest is pinned to 30.3.x because jest-runtime@30.4.0 added a call to
 // `_moduleMocker.clearMocksOnScope()`, which doesn't exist on the
 // jest-mock@29 ModuleMocker that React Native's preset still feeds in
@@ -20,6 +22,9 @@ exports.latestVersions = {
     jestVersion: '~30.3.0',
     babelJestVersion: '~30.3.0',
     jestTypesVersion: '~30.0.0',
+    // ts-jest has not shipped a v30 — 29.x is its latest line and its peers
+    // already span jest 29 and 30 (`jest: '^29.0.0 || ^30.0.0'`), so a jest-30
+    // workspace correctly stays on ts-jest 29.x.
     tsJestVersion: '^29.4.0',
     tslibVersion: '^2.3.0',
     swcJestVersion: '~0.2.38',
@@ -27,8 +32,6 @@ exports.latestVersions = {
     tsNodeVersion: '10.9.1',
 };
 const supportedMajorVersions = [29, 30];
-const minSupportedMajorVersion = Math.min(...supportedMajorVersions);
-const currentMajorVersion = Math.max(...supportedMajorVersions);
 exports.versionMap = {
     29: {
         nxVersion,
@@ -49,22 +52,28 @@ function versions(tree) {
         return exports.latestVersions;
     }
     const jestMajorVersion = (0, semver_1.major)(installedJestVersion);
-    if (exports.versionMap[jestMajorVersion]) {
-        return exports.versionMap[jestMajorVersion];
-    }
-    const backwardCompatibleVersions = supportedMajorVersions.slice(0, -1);
-    throw new Error(`You're currently using an unsupported Jest version: ${installedJestVersion}. Supported major versions are ${backwardCompatibleVersions.join(', ')} and ${currentMajorVersion}.`);
+    return exports.versionMap[jestMajorVersion] ?? exports.latestVersions;
 }
 function getInstalledJestVersion(tree) {
+    if (!tree) {
+        // Fall back to `@nx/jest`'s own jest when the workspace cwd can't resolve
+        // one (e.g. inferred-plugin createNodes runs against an empty workspace).
+        return (0, internal_1.getInstalledPackageVersion)('jest') ?? getJestVersionFromRequire();
+    }
+    const installedVersion = (0, devkit_1.getDependencyVersionFromPackageJson)(tree, 'jest');
+    if (!installedVersion) {
+        return null;
+    }
+    if (installedVersion === 'latest' || installedVersion === 'next') {
+        return ((0, semver_1.clean)(exports.latestVersions.jestVersion) ??
+            (0, semver_1.coerce)(exports.latestVersions.jestVersion)?.version ??
+            null);
+    }
+    return (0, semver_1.clean)(installedVersion) ?? (0, semver_1.coerce)(installedVersion)?.version ?? null;
+}
+function getJestVersionFromRequire() {
     try {
-        let version;
-        if (tree) {
-            version = getJestVersionFromTree(tree);
-        }
-        else {
-            version = getJestVersionFromFileSystem();
-        }
-        return version;
+        return require('jest').getVersion();
     }
     catch {
         return null;
@@ -80,32 +89,3 @@ function getInstalledJestMajorVersion(tree) {
     const installedJestVersion = getInstalledJestVersion(tree);
     return installedJestVersion ? (0, semver_1.major)(installedJestVersion) : null;
 }
-function validateInstalledJestVersion(tree) {
-    const { version, major } = getInstalledJestVersionInfo(tree);
-    if (!version) {
-        return;
-    }
-    if (major < minSupportedMajorVersion || major > currentMajorVersion) {
-        const backwardCompatibleVersions = supportedMajorVersions.slice(0, -1);
-        throw new Error(`You're currently using an unsupported Jest version: ${version}. Supported major versions are ${backwardCompatibleVersions.join(', ')} and ${currentMajorVersion}.`);
-    }
-}
-function getJestVersionFromTree(tree) {
-    const installedVersion = (0, devkit_1.getDependencyVersionFromPackageJson)(tree, 'jest');
-    if (!installedVersion) {
-        return null;
-    }
-    if (installedVersion === 'latest' || installedVersion === 'next') {
-        return ((0, semver_1.clean)(exports.latestVersions.jestVersion) ??
-            (0, semver_1.coerce)(exports.latestVersions.jestVersion)?.version);
-    }
-    return (0, semver_1.clean)(installedVersion) ?? (0, semver_1.coerce)(installedVersion)?.version;
-}
-function getJestVersionFromFileSystem() {
-    try {
-        const { getVersion } = require('jest');
-        return getVersion();
-    }
-    catch { }
-    return null;
-}

package/migrations.json

@@ -4,23 +4,27 @@
       "cli": "nx",
       "version": "20.0.0-beta.5",
       "description": "Replace usage of `getJestProjects` with `getJestProjectsAsync`.",
-      "implementation": "./dist/src/migrations/update-20-0-0/replace-getJestProjects-with-getJestProjectsAsync"
+      "implementation": "./dist/src/migrations/update-20-0-0/replace-getJestProjects-with-getJestProjectsAsync",
+      "documentation": "./dist/src/migrations/update-20-0-0/replace-getJestProjects-with-getJestProjectsAsync.md"
     },
     "replace-getJestProjects-with-getJestProjectsAsync-v21": {
       "cli": "nx",
       "version": "21.0.0-beta.9",
       "description": "Replace usage of `getJestProjects` with `getJestProjectsAsync`.",
-      "implementation": "./dist/src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync"
+      "implementation": "./dist/src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync",
+      "documentation": "./dist/src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync.md"
     },
     "remove-tsconfig-option-from-jest-executor": {
       "version": "21.0.0-beta.10",
       "description": "Remove the previously deprecated and unused `tsConfig` option from the `@nx/jest:jest` executor.",
-      "implementation": "./dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor"
+      "implementation": "./dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor",
+      "documentation": "./dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor.md"
     },
     "rename-test-path-pattern": {
       "version": "21.3.0-beta.3",
       "description": "Rename the CLI option `testPathPattern` to `testPathPatterns`.",
-      "implementation": "./dist/src/migrations/update-21-3-0/rename-test-path-pattern"
+      "implementation": "./dist/src/migrations/update-21-3-0/rename-test-path-pattern",
+      "documentation": "./dist/src/migrations/update-21-3-0/rename-test-path-pattern.md"
     },
     "replace-removed-matcher-aliases": {
       "version": "21.3.0-beta.3",
@@ -28,12 +32,14 @@
         "jest": ">=30.0.0"
       },
       "description": "Replace removed matcher aliases in Jest v30 with their corresponding matcher",
-      "implementation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases"
+      "implementation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases",
+      "documentation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md"
     },
     "convert-jest-config-to-cjs": {
       "version": "22.2.0-beta.2",
       "description": "Convert jest.config.ts files from ESM to CJS syntax (export default -> module.exports, import -> require) for projects using CommonJS resolution to ensure correct loading under Node.js type-stripping.",
-      "implementation": "./dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs"
+      "implementation": "./dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs",
+      "documentation": "./dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs.md"
     },
     "replace-removed-matcher-aliases-v22-3": {
       "version": "22.3.2-beta.0",
@@ -41,7 +47,8 @@
         "jest": ">=30.0.0"
       },
       "description": "Replace removed matcher aliases in Jest v30 with their corresponding matcher",
-      "implementation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases"
+      "implementation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases",
+      "documentation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md"
     },
     "update-snapshot-guide-link": {
       "version": "23.0.0-beta.10",
@@ -49,7 +56,8 @@
         "jest": ">=30.0.0"
       },
       "description": "Update the Jest snapshot guide link in `.snap` files from the legacy `https://goo.gl/fbAQLP` URL to `https://jestjs.io/docs/snapshot-testing`, which Jest v30 now requires.",
-      "implementation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link"
+      "implementation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link",
+      "documentation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link.md"
     },
     "rewrite-jest-internal-subpath-imports": {
       "version": "23.0.0-beta.16",
@@ -60,6 +68,16 @@
       "version": "23.0.0-beta.16",
       "description": "Replaces the removed `jestProjectGenerator` export from `@nx/jest` with its replacement `configurationGenerator`.",
       "implementation": "./dist/src/migrations/update-23-0-0/rewrite-jest-project-generator"
+    },
+    "migrate-jest-executor-setup-file": {
+      "version": "23.0.0-beta.22",
+      "description": "Migrate the deprecated `setupFile` option of the `@nx/jest:jest` executor: push the file path into `setupFilesAfterEnv` in the project's Jest config and remove the option from `project.json` and `nx.json` target defaults.",
+      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-executor-setup-file"
+    },
+    "migrate-jest-configuration-skip-setup-file": {
+      "version": "23.0.0-beta.22",
+      "description": "Migrate the deprecated `skipSetupFile` option of the `@nx/jest:configuration` generator stored as a default in `nx.json` or per-project `project.json` to `setupFile: 'none'` (when `true`) or remove it (when `false`).",
+      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-configuration-skip-setup-file"
     }
   },
   "packageJsonUpdates": {
@@ -69,6 +87,9 @@
       "incompatibleWith": {
         "@angular-devkit/build-angular": "< 21.0.0"
       },
+      "requires": {
+        "jest": ">=29.0.0 <30.0.0"
+      },
       "packages": {
         "jest": {
           "version": "~30.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/jest",
-  "version": "23.0.0-beta.21",
+  "version": "23.0.0-beta.23",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -90,6 +90,18 @@
       "default": "./dist/internal.js"
     }
   },
+  "peerDependencies": {
+    "jest": "^29.0.0 || ^30.0.0",
+    "ts-jest": "^29.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    },
+    "ts-jest": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@jest/reporters": "^30.0.2",
     "@jest/test-result": "^30.0.2",
@@ -104,11 +116,11 @@
     "semver": "^7.6.3",
     "tslib": "^2.3.0",
     "yargs-parser": "21.1.1",
-    "@nx/devkit": "23.0.0-beta.21",
-    "@nx/js": "23.0.0-beta.21"
+    "@nx/devkit": "23.0.0-beta.23",
+    "@nx/js": "23.0.0-beta.23"
   },
   "devDependencies": {
-    "nx": "23.0.0-beta.21"
+    "nx": "23.0.0-beta.23"
   },
   "publishConfig": {
     "access": "public"

package/dist/src/utils/version-utils.d.ts

@@ -1,2 +0,0 @@
-export declare function getInstalledJestVersion(): string | null;
-export declare function getInstalledJestMajorVersion(): number | null;

package/dist/src/utils/version-utils.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInstalledJestVersion = getInstalledJestVersion;
-exports.getInstalledJestMajorVersion = getInstalledJestMajorVersion;
-const jest_1 = require("jest");
-const semver_1 = require("semver");
-function getInstalledJestVersion() {
-    try {
-        return (0, jest_1.getVersion)();
-    }
-    catch {
-        return null;
-    }
-}
-function getInstalledJestMajorVersion() {
-    const installedVersion = getInstalledJestVersion();
-    return installedVersion ? (0, semver_1.major)(installedVersion) : null;
-}