@nx/jest 23.0.0-beta.2 → 23.0.0-beta.20

package/dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const internal_1 = require("@nx/devkit/internal");
+const devkit_1 = require("@nx/devkit");
+const EXECUTOR_TO_MIGRATE = '@nx/jest:jest';
+const ENTRY_META_KEYS = new Set(['target', 'executor', 'projects', 'plugin']);
+async function default_1(tree) {
+    // update options from project configs
+    (0, internal_1.forEachExecutorOptions)(tree, EXECUTOR_TO_MIGRATE, (options, project, target, configuration) => {
+        if (options.tsConfig === undefined) {
+            return;
+        }
+        const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, project);
+        if (configuration) {
+            updateConfiguration(projectConfiguration.targets[target], configuration);
+        }
+        else {
+            updateOptions(projectConfiguration.targets[target]);
+        }
+        (0, devkit_1.updateProjectConfiguration)(tree, project, projectConfiguration);
+    });
+    // update options from nx.json target defaults
+    const nxJson = (0, devkit_1.readNxJson)(tree);
+    if (nxJson.targetDefaults) {
+        if (Array.isArray(nxJson.targetDefaults)) {
+            const next = [];
+            for (const entry of nxJson.targetDefaults) {
+                if (entry.target !== EXECUTOR_TO_MIGRATE &&
+                    entry.executor !== EXECUTOR_TO_MIGRATE) {
+                    next.push(entry);
+                    continue;
+                }
+                if (entry.options)
+                    updateOptions(entry);
+                Object.keys(entry.configurations ?? {}).forEach((config) => {
+                    updateConfiguration(entry, config);
+                });
+                if (!isEntryEmpty(entry)) {
+                    next.push(entry);
+                }
+            }
+            if (next.length === 0) {
+                delete nxJson.targetDefaults;
+            }
+            else {
+                nxJson.targetDefaults = next;
+            }
+        }
+        else {
+            for (const [targetOrExecutor, targetConfig] of Object.entries(nxJson.targetDefaults)) {
+                if (targetOrExecutor !== EXECUTOR_TO_MIGRATE &&
+                    targetConfig.executor !== EXECUTOR_TO_MIGRATE) {
+                    continue;
+                }
+                if (targetConfig.options) {
+                    updateOptions(targetConfig);
+                }
+                Object.keys(targetConfig.configurations ?? {}).forEach((config) => {
+                    updateConfiguration(targetConfig, config);
+                });
+                if (!Object.keys(targetConfig).length ||
+                    (Object.keys(targetConfig).length === 1 &&
+                        Object.keys(targetConfig)[0] === 'executor')) {
+                    delete nxJson.targetDefaults[targetOrExecutor];
+                }
+                if (!Object.keys(nxJson.targetDefaults).length) {
+                    delete nxJson.targetDefaults;
+                }
+            }
+        }
+        (0, devkit_1.updateNxJson)(tree, nxJson);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+// An entry is "empty" once only filter/meta keys remain (target, executor,
+// projects, plugin) — nothing else worth keeping around.
+function isEntryEmpty(entry) {
+    return Object.keys(entry).every((k) => ENTRY_META_KEYS.has(k));
+}
+function updateOptions(target) {
+    delete target.options.tsConfig;
+    if (!Object.keys(target.options).length) {
+        delete target.options;
+    }
+}
+function updateConfiguration(target, configuration) {
+    delete target.configurations[configuration].tsConfig;
+    if (!Object.keys(target.configurations[configuration]).length &&
+        (!target.defaultConfiguration ||
+            target.defaultConfiguration !== configuration)) {
+        delete target.configurations[configuration];
+    }
+    if (!Object.keys(target.configurations).length) {
+        delete target.configurations;
+    }
+}

package/dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor.md

@@ -0,0 +1,102 @@
+#### Remove `tsConfig` Option from Jest Executor
+
+Removes the previously deprecated and unused `tsConfig` option from the `@nx/jest:jest` executor configuration in all projects.
+
+#### Examples
+
+Remove the option from the project configuration:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "tsConfig": "apps/myapp/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json"
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts"
+      }
+    }
+  }
+}
+```
+
+Remove the option from a target default using the `@nx/jest:jest` executor:
+
+##### Before
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "tsConfig": "{projectRoot}/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json"
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts"
+      }
+    }
+  }
+}
+```
+
+Remove the option from a target default using the `@nx/jest:jest` executor as the key:
+
+##### Before
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "tsConfig": "{projectRoot}/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json"
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts"
+      }
+    }
+  }
+}
+```

package/{src → dist/src}/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync.d.ts

@@ -1,3 +1,2 @@
 import { Tree } from '@nx/devkit';
 export default function update(tree: Tree): Promise<void>;
-//# sourceMappingURL=replace-getJestProjects-with-getJestProjectsAsync.d.ts.map

package/{src/migrations/update-20-0-0 → dist/src/migrations/update-21-0-0}/replace-getJestProjects-with-getJestProjectsAsync.js

@@ -5,11 +5,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = update;
 const devkit_1 = require("@nx/devkit");
-const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const internal_1 = require("@nx/js/internal");
 let tsModule;
 async function update(tree) {
     if (!tsModule) {
-        tsModule = (0, ensure_typescript_1.ensureTypescript)();
+        tsModule = (0, internal_1.ensureTypescript)();
     }
     const jestConfigPaths = await (0, devkit_1.globAsync)(tree, [
         '**/jest.config.{cjs,mjs,js,cts,mts,ts}',

package/dist/src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync.md

@@ -0,0 +1,25 @@
+#### Replace Usage of `getJestProjects` with `getJestProjectsAsync`
+
+Replaces the usage of the removed `getJestProjects` function with the `getJestProjectsAsync` function.
+
+#### Sample Code Changes
+
+##### Before
+
+```ts title="jest.config.ts"
+import { getJestProjects } from '@nx/jest';
+
+export default {
+  projects: getJestProjects(),
+};
+```
+
+##### After
+
+```ts title="jest.config.ts"
+import { getJestProjectsAsync } from '@nx/jest';
+
+export default async () => ({
+  projects: await getJestProjectsAsync(),
+});
+```

package/{src → dist/src}/migrations/update-21-3-0/rename-test-path-pattern.d.ts

@@ -1,3 +1,2 @@
 import { type Tree } from '@nx/devkit';
 export default function (tree: Tree): Promise<void>;
-//# sourceMappingURL=rename-test-path-pattern.d.ts.map

package/{src → dist/src}/migrations/update-21-3-0/rename-test-path-pattern.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
+const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
-const executor_options_utils_1 = require("@nx/devkit/src/generators/executor-options-utils");
 // migration for https://github.com/jestjs/jest/commit/41133b526d2c17bc9758f90d6026b25301cf0552
 async function default_1(tree) {
     // update options from project configs
-    (0, executor_options_utils_1.forEachExecutorOptions)(tree, '@nx/jest:jest', (_, project, target, configuration) => {
+    (0, internal_1.forEachExecutorOptions)(tree, '@nx/jest:jest', (_, project, target, configuration) => {
         const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, project);
         const config = configuration
             ? projectConfiguration.targets[target].configurations[configuration]
@@ -19,17 +19,33 @@ async function default_1(tree) {
     if (!nxJson.targetDefaults) {
         return;
     }
-    for (const [targetOrExecutor, targetConfig] of Object.entries(nxJson.targetDefaults)) {
-        if (targetOrExecutor !== '@nx/jest:jest' &&
-            targetConfig.executor !== '@nx/jest:jest') {
-            continue;
+    if (Array.isArray(nxJson.targetDefaults)) {
+        for (const entry of nxJson.targetDefaults) {
+            if (entry.target !== '@nx/jest:jest' &&
+                entry.executor !== '@nx/jest:jest') {
+                continue;
+            }
+            if (entry.options) {
+                renameTestPathPattern(entry.options);
+            }
+            Object.values(entry.configurations ?? {}).forEach((config) => {
+                renameTestPathPattern(config);
+            });
         }
-        if (targetConfig.options) {
-            renameTestPathPattern(targetConfig.options);
+    }
+    else {
+        for (const [targetOrExecutor, targetConfig] of Object.entries(nxJson.targetDefaults)) {
+            if (targetOrExecutor !== '@nx/jest:jest' &&
+                targetConfig.executor !== '@nx/jest:jest') {
+                continue;
+            }
+            if (targetConfig.options) {
+                renameTestPathPattern(targetConfig.options);
+            }
+            Object.values(targetConfig.configurations ?? {}).forEach((config) => {
+                renameTestPathPattern(config);
+            });
         }
-        Object.values(targetConfig.configurations ?? {}).forEach((config) => {
-            renameTestPathPattern(config);
-        });
     }
     (0, devkit_1.updateNxJson)(tree, nxJson);
     await (0, devkit_1.formatFiles)(tree);

package/dist/src/migrations/update-21-3-0/rename-test-path-pattern.md

@@ -0,0 +1,147 @@
+#### Rename `testPathPattern` to `testPathPatterns`
+
+Renames the `testPathPattern` option to `testPathPatterns` in the `@nx/jest:jest` executor configuration to align with Jest v30 CLI changes. Read more at the [Jest v30 migration notes](https://jestjs.io/docs/upgrading-to-jest30#--testpathpattern-was-renamed-to---testpathpatterns).
+
+#### Examples
+
+Rename the option in project configuration:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```
+
+Rename the option in project configuration with configurations:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7,10,11}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPattern": "some-regex"
+      },
+      "configurations": {
+        "development": { "testPathPattern": "regex-dev" },
+        "production": { "testPathPattern": "regex-prod" }
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json" {7,10,11}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      },
+      "configurations": {
+        "development": { "testPathPatterns": "regex-dev" },
+        "production": { "testPathPatterns": "regex-prod" }
+      }
+    }
+  }
+}
+```
+
+Rename the option in a target default using the `@nx/jest:jest` executor:
+
+##### Before
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```
+
+Rename the option in a target default using the `@nx/jest:jest` executor as the key:
+
+##### Before
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```

package/{src → dist/src}/migrations/update-21-3-0/replace-removed-matcher-aliases.d.ts

@@ -1,3 +1,2 @@
 import { type Tree } from '@nx/devkit';
 export default function (tree: Tree): Promise<void>;
-//# sourceMappingURL=replace-removed-matcher-aliases.d.ts.map

package/dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md

@@ -0,0 +1,51 @@
+#### Replace Removed Matcher Aliases
+
+Replaces removed Jest matcher aliases in test files with their corresponding matchers to align with Jest v30 changes. Read more at the [Jest v30 migration notes](https://jestjs.io/docs/upgrading-to-jest30#jest-expect--matchers).
+
+#### Examples
+
+##### Before
+
+```typescript title="apps/myapp/src/app.spec.ts"
+describe('test', () => {
+  it('should pass', async () => {
+    expect(mockFn).toBeCalled();
+    expect(mockFn).toBeCalledTimes(1);
+    expect(mockFn).toBeCalledWith(arg);
+    expect(mockFn).lastCalledWith(arg);
+    expect(mockFn).nthCalledWith(1, arg);
+    expect(mockFn).toReturn();
+    expect(mockFn).toReturnTimes(1);
+    expect(mockFn).toReturnWith(value);
+    expect(mockFn).lastReturnedWith(value);
+    expect(mockFn).nthReturnedWith(1, value);
+    expect(() => someFn()).toThrowError();
+    expect(() => someFn()).not.toThrowError();
+    await expect(someAsyncFn()).rejects.toThrowError();
+    await expect(someAsyncFn()).resolves.not.toThrowError();
+  });
+});
+```
+
+##### After
+
+```typescript title="apps/myapp/src/app.spec.ts"
+describe('test', () => {
+  it('should pass', async () => {
+    expect(mockFn).toHaveBeenCalled();
+    expect(mockFn).toHaveBeenCalledTimes(1);
+    expect(mockFn).toHaveBeenCalledWith(arg);
+    expect(mockFn).toHaveBeenLastCalledWith(arg);
+    expect(mockFn).toHaveBeenNthCalledWith(1, arg);
+    expect(mockFn).toHaveReturned();
+    expect(mockFn).toHaveReturnedTimes(1);
+    expect(mockFn).toHaveReturnedWith(value);
+    expect(mockFn).toHaveLastReturnedWith(value);
+    expect(mockFn).toHaveNthReturnedWith(1, value);
+    expect(() => someFn()).toThrow();
+    expect(() => someFn()).not.toThrow();
+    await expect(someAsyncFn()).rejects.toThrow();
+    await expect(someAsyncFn()).resolves.not.toThrow();
+  });
+});
+```

package/{src → dist/src}/migrations/update-22-2-0/convert-jest-config-to-cjs.d.ts

@@ -18,4 +18,3 @@ import { Tree } from '@nx/devkit';
  * as they use ESM semantics and don't need the CJS conversion.
  */
 export default function convertJestConfigToCjs(tree: Tree): Promise<() => void>;
-//# sourceMappingURL=convert-jest-config-to-cjs.d.ts.map

package/dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs.md

@@ -0,0 +1,33 @@
+#### Convert Jest Config to CJS
+
+Converts `jest.config.ts` files to `jest.config.cts`. This is needed because Node.js type-stripping in newer versions (22+, 24+) can cause issues with ESM syntax in `.ts` files when the project is configured for CommonJS.
+
+This migration only runs if `@nx/jest/plugin` is registered in `nx.json`.
+
+#### Examples
+
+##### Before
+
+```typescript title="jest.config.ts"
+import { foo } from 'bar';
+import baz from 'qux';
+
+export default {
+  displayName: 'myapp',
+  preset: foo,
+  transform: baz,
+};
+```
+
+##### After
+
+```typescript title="jest.config.cts"
+const { foo } = require('bar');
+const baz = require('qux').default ?? require('qux');
+
+module.exports = {
+  displayName: 'myapp',
+  preset: foo,
+  transform: baz,
+};
+```

package/dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+export default function rewriteInternalSubpathImports(tree: Tree): Promise<void>;
+export declare function rewriteSubpathImports(source: string): string;