@naturalcycles/dev-lib 20.50.0 → 20.51.1

package/cfg/summaryReporter.js

@@ -11,7 +11,11 @@ export class SummaryReporter {
     let stats = []
 
     for (const mod of testModules) {
-      const name = mod.moduleId.split('/').at(-1)
+      // In the monorepo root run testModules span all projects, so prefix with the
+      // (short) package name to disambiguate identically-named files across packages.
+      const pkg = mod.project?.name?.split('/').at(-1)
+      const file = mod.moduleId.split('/').at(-1)
+      const name = pkg ? `${pkg} ${file}` : file
       const diag = mod.diagnostic()
       stats.push({ name, ms: diag.duration })
     }

package/cfg/vitest.config.d.ts

@@ -20,6 +20,13 @@ export function defineVitestConfig(config?: Partial<ViteUserConfig>, cwd?: strin
  */
 export function getSharedConfig(cwd?: string): InlineConfig
 
+/**
+ * Reporters for the monorepo root config (Vitest `projects` mode), where
+ * `reporters` is a root-only option. Returns the compact 'agent' reporter for
+ * agents, otherwise the default reporters plus a monorepo-wide SummaryReporter.
+ */
+export function getRootReporters(): InlineConfig['reporters']
+
 export const CollectReporter: any
 
 export class SummaryReporter {}

package/cfg/vitest.config.js

@@ -128,16 +128,10 @@ export function getSharedConfig(cwd) {
 }
 
 function getReporters(junitReporterEnabled, testType) {
-  // VITEST_REPORTER env var allows overriding the default reporter
-  const { VITEST_REPORTER, GITHUB_ACTIONS } = process.env
-  if (VITEST_REPORTER) {
-    return [VITEST_REPORTER]
-  }
-
-  if (isAgent) {
-    return ['agent']
-  }
+  const override = getReporterOverride()
+  if (override) return override
 
+  const { GITHUB_ACTIONS } = process.env
   return [
     'default',
     GITHUB_ACTIONS && 'github-actions',
@@ -152,6 +146,50 @@ function getReporters(junitReporterEnabled, testType) {
   ].filter(Boolean)
 }
 
+/**
+ * Reporters for the monorepo root config (Vitest `projects` mode).
+ *
+ * `reporters` is a root-only Vitest option: per-project reporters are ignored
+ * when running via `projects`. So the per-package SummaryReporter never runs in
+ * the aggregate root run, and - crucially - a root-level SummaryReporter sees
+ * the test modules of ALL projects at once, letting it report the slowest tests
+ * across the entire monorepo.
+ *
+ * Use it in the root vitest.config.ts:
+ *
+ * export default defineConfig({
+ *   test: {
+ *     projects: ['./packages/*'],
+ *     reporters: getRootReporters(),
+ *   },
+ * })
+ */
+export function getRootReporters() {
+  const override = getReporterOverride()
+  if (override) return override
+
+  const { GITHUB_ACTIONS } = process.env
+  return ['default', GITHUB_ACTIONS && 'github-actions', new SummaryReporter()].filter(Boolean)
+}
+
+/**
+ * Reporter overrides shared by both the per-package and root configs:
+ * - VITEST_REPORTER env var fully replaces the reporter set
+ * - agents get the compact 'agent' reporter, with no summary
+ *
+ * Returns `undefined` when no override applies (caller uses its own defaults).
+ */
+function getReporterOverride() {
+  const { VITEST_REPORTER } = process.env
+  if (VITEST_REPORTER) {
+    return [VITEST_REPORTER]
+  }
+  if (isAgent) {
+    return ['agent']
+  }
+  return undefined
+}
+
 function doesItRunInIDE() {
   // example command line below:
   // /usr/local/bin/node /Users/some/Idea/some/node_modules/vitest/vitest.mjs --run --reporter /Users/some/Library/Application Support/JetBrains/IntelliJIdea2025.2/plugins/javascript-plugin/helpers/vitest-intellij/node_modules/vitest-intellij-reporter-safe.js --testNamePattern=^ ?case 001: empty data$ /Users/some/Idea/some/src/some/some.integration.test.ts

package/dist/bin/dev-lib.js

@@ -47,7 +47,11 @@ const commands = [
         fn: cleanBuild,
         desc: 'Cleans ./dist, then runs the build.',
     },
-    { name: 'test', fn: runTest, desc: 'Run vitest for *.test.ts files.' },
+    {
+        name: 'test',
+        fn: runTest,
+        desc: 'Run vitest for *.test.ts files. Runs once and exits; pass --watch to watch.',
+    },
     {
         name: 'test-integration',
         fn: () => runTest({ integration: true }),

package/dist/check.util.js

@@ -470,6 +470,13 @@ function runVitest(opt) {
             TEST_TYPE: 'manual',
         });
     }
+    // Default to "run once and exit" mode, rather than vitest's default of "watch"
+    // (which, in an interactive terminal, stays open waiting for input).
+    // Pass `--watch` (or `-w`, or the `watch` subcommand) explicitly to opt into watch mode.
+    const watch = args.some(a => a === '--watch' || a === '-w' || a === 'watch');
+    if (!watch) {
+        args.unshift('run');
+    }
     const vitestPath = findPackageBinPath('vitest', 'vitest');
     exec2.spawn(vitestPath, {
         args: _uniq(args),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/dev-lib",
   "type": "module",
-  "version": "20.50.0",
+  "version": "20.51.1",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@naturalcycles/nodejs-lib": "^15",