@nx/vitest 22.4.0-canary.20260115-21d1555 → 22.4.0-canary.20260119-6bb82c0

package/PLUGIN.md

@@ -0,0 +1,41 @@
+# Vitest
+
+After making changes to a project, run the relevant test file to verify your changes work correctly.
+
+## Mode Detection
+
+Check in order (first match wins):
+
+| Mode      | Detection                                                           |
+| --------- | ------------------------------------------------------------------- |
+| Atomized  | `ciTargetName` in nx.json `@nx/vitest` or `@nx/vite` plugin options |
+| Inference | `@nx/vitest` or `@nx/vite/plugin` in nx.json plugins array          |
+| Executor  | `@nx/vitest:test` executor in project.json targets                  |
+
+## Run Specific Test File
+
+### Atomized
+
+```bash
+nx run <project>:<ciTargetName>--<path/to/file.spec.ts>
+# Example: nx run my-lib:test-ci--src/utils.spec.ts
+```
+
+### Inference
+
+```bash
+nx test <project> -- <path/to/file.spec.ts>
+```
+
+### Executor
+
+```bash
+nx run <project>:test --testFile=<path/to/file.spec.ts>
+```
+
+## Quick Reference
+
+| Task        | Atomized                                 | Inference                           | Executor                                        |
+| ----------- | ---------------------------------------- | ----------------------------------- | ----------------------------------------------- |
+| Run file    | `nx run proj:test-ci--path/file.spec.ts` | `nx test proj -- path/file.spec.ts` | `nx run proj:test --testFile=path/file.spec.ts` |
+| Run pattern | N/A                                      | `nx test proj -- -t "pattern"`      | `nx run proj:test --testNamePattern="pattern"`  |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nx/vitest",
   "description": "The Nx Plugin for Vitest to enable fast unit testing with Vitest.",
-  "version": "22.4.0-canary.20260115-21d1555",
+  "version": "22.4.0-canary.20260119-6bb82c0",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"
@@ -52,8 +52,8 @@
   "executors": "./executors.json",
   "generators": "./generators.json",
   "dependencies": {
-    "@nx/devkit": "22.4.0-canary.20260115-21d1555",
-    "@nx/js": "22.4.0-canary.20260115-21d1555",
+    "@nx/devkit": "22.4.0-canary.20260119-6bb82c0",
+    "@nx/js": "22.4.0-canary.20260119-6bb82c0",
     "tslib": "^2.3.0",
     "semver": "^7.6.3",
     "@phenomnomnominal/tsquery": "~6.1.4"
@@ -71,7 +71,7 @@
     }
   },
   "devDependencies": {
-    "nx": "22.4.0-canary.20260115-21d1555"
+    "nx": "22.4.0-canary.20260119-6bb82c0"
   },
   "types": "./src/index.d.ts"
 }

package/project.json

@@ -40,6 +40,11 @@
                         "glob": "**/*.d.ts",
                         "output": "/"
                     },
+                    {
+                        "input": "packages/vitest",
+                        "glob": "PLUGIN.md",
+                        "output": "/"
+                    },
                     {
                         "input": "",
                         "glob": "LICENSE",

package/src/executors/test/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../packages/vitest/src/executors/test/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAIhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAQlD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,gCAuEpB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAcnE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../packages/vitest/src/executors/test/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAIhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAQlD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAuF9B;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAcnE"}

package/src/executors/test/lib/utils.js

@@ -8,7 +8,7 @@ const path_1 = require("path");
 const executor_utils_1 = require("../../../utils/executor-utils");
 async function getOptions(options, context, projectRoot) {
     // Allows ESM to be required in CJS modules. Vite will be published as ESM in the future.
-    const { loadConfigFromFile, mergeConfig } = await (0, executor_utils_1.loadViteDynamicImport)();
+    const { loadConfigFromFile } = await (0, executor_utils_1.loadViteDynamicImport)();
     const viteConfigPath = (0, options_utils_1.normalizeViteConfigFilePath)(context.root, projectRoot, options.configFile);
     if (!viteConfigPath) {
         throw new Error((0, devkit_1.stripIndents) `
@@ -20,10 +20,10 @@ async function getOptions(options, context, projectRoot) {
         `);
     }
     const resolved = await loadConfigFromFile({
-        mode: options?.mode ?? 'production',
+        mode: options?.mode ?? 'test',
         command: 'serve',
     }, viteConfigPath);
-    if (!viteConfigPath || !resolved?.config?.['test']) {
+    if (!resolved?.config?.['test']) {
         devkit_1.logger.warn((0, devkit_1.stripIndents) `Unable to load test config from config file ${resolved?.path ?? viteConfigPath}
   Some settings may not be applied as expected.
   You can manually set the config in the project, ${context.projectName}, configuration.
@@ -33,23 +33,34 @@ async function getOptions(options, context, projectRoot) {
         ? process.cwd()
         : (0, path_1.relative)(context.cwd, (0, devkit_1.joinPathFragments)(context.root, projectRoot));
     const { parseCLI } = await (0, executor_utils_1.loadVitestDynamicImport)();
+    // Use parseCLI for Vitest-specific normalization/validation
     const { options: { watch, ...normalizedExtraArgs }, } = parseCLI(['vitest', ...getOptionsAsArgv(options)]);
-    const { reportsDirectory, coverage, ...restNormalizedArgs } = normalizedExtraArgs;
-    const settings = {
+    // Filter out options that are handled specially or are parseCLI artifacts
+    const { 
+    // Handled specially by executor
+    testFiles: _testFiles, configFile: _configFile, mode: _mode, runMode: _runMode, reportsDirectory, coverage, 
+    // parseCLI artifacts
+    '--': _dashdash, color: _color, w: _w, 
+    // Pass through any additional Vitest options
+    ...passThroughOptions } = normalizedExtraArgs;
+    return {
         // Explicitly set watch mode to false if not provided otherwise vitest
         // will enable watch mode by default for non CI environments
         watch: watch ?? false,
-        ...restNormalizedArgs,
+        // Pass through any additional Vitest options
+        ...passThroughOptions,
         // This should not be needed as it's going to be set in vite.config.ts
         // but leaving it here in case someone did not migrate correctly
-        root: resolved.config.root ?? root,
+        root: resolved?.config?.root ?? root,
         config: viteConfigPath,
+        // Pass reporters from config so NxReporter can be merged without losing config reporters
+        // Safe: CLI options override (not merge with) config reporters, so no duplication
+        reporters: resolved?.config?.['test']?.reporters,
         coverage: {
             ...(coverage ?? {}),
             ...(reportsDirectory && { reportsDirectory }),
         },
     };
-    return mergeConfig(resolved?.config?.['test'] ?? {}, settings);
 }
 function getOptionsAsArgv(obj) {
     const argv = [];

package/src/executors/test/schema.d.ts

@@ -4,4 +4,5 @@ export interface VitestExecutorOptions {
   testFiles?: string[];
   watch?: boolean;
   mode?: string;
+  runMode?: 'test' | 'benchmark';
 }

package/src/executors/test/schema.json

@@ -19,7 +19,13 @@
     },
     "mode": {
       "type": "string",
-      "description": "Mode for Vite."
+      "description": "Vite mode for loading configuration."
+    },
+    "runMode": {
+      "type": "string",
+      "description": "Vitest execution mode.",
+      "enum": ["test", "benchmark"],
+      "default": "test"
     },
     "testFiles": {
       "aliases": ["testFile"],

package/src/executors/test/vitest.impl.js

@@ -24,7 +24,7 @@ async function* vitestExecutor(options, context) {
     }
     resolvedOptions['reporters'].push(nxReporter);
     const cliFilters = options.testFiles ?? [];
-    const ctx = await startVitest(resolvedOptions['mode'] ?? 'test', cliFilters, resolvedOptions);
+    const ctx = await startVitest(options.runMode ?? 'test', cliFilters, resolvedOptions);
     let hasErrors = false;
     const processExit = () => {
         ctx.exit();