@naturalcycles/dev-lib 20.18.2 → 20.20.0

package/cfg/summaryOnlyReporter.js

@@ -0,0 +1,26 @@
+import { _ms } from '@naturalcycles/js-lib/datetime'
+
+/**
+ * A minimal reporter that only shows failures and the final summary.
+ * No per-test, no per-file output - just failures and final summary.
+ *
+ * Use via: VITEST_REPORTER=summary vitest run
+ */
+export class SummaryOnlyReporter {
+  onTestRunEnd(testModules) {
+    let files = 0
+    let duration = 0
+
+    for (const mod of testModules) {
+      files++
+      duration += mod.diagnostic().duration
+    }
+
+    console.log()
+    console.log(`  Files: ${files}`)
+    console.log(`  Duration: ${_ms(duration)}`)
+    console.log()
+  }
+}
+
+export default SummaryOnlyReporter

package/cfg/vitest.config.d.ts

@@ -21,4 +21,7 @@ export function defineVitestConfig(config?: Partial<ViteUserConfig>, cwd?: strin
 export function getSharedConfig(cwd?: string): InlineConfig
 
 export const CollectReporter: any
-export const SummaryReporter: any
+
+export class SummaryReporter {}
+
+export class SummaryOnlyReporter {}

package/cfg/vitest.config.js

@@ -2,8 +2,10 @@ import fs from 'node:fs'
 import { VitestAlphabeticSequencer } from './vitestAlphabeticSequencer.js'
 import { defineConfig } from 'vitest/config'
 import { SummaryReporter } from './summaryReporter.js'
+import { SummaryOnlyReporter } from './summaryOnlyReporter.js'
 export { SummaryReporter } from './summaryReporter.js'
 export { CollectReporter } from './collectReporter.js'
+export { SummaryOnlyReporter } from './summaryOnlyReporter.js'
 
 const runsInIDE = doesItRunInIDE()
 const testType = getTestType(runsInIDE)
@@ -47,19 +49,19 @@ export function defineVitestConfig(config, cwd) {
 
   const { silent, pool, maxWorkers, isolate } = mergedConfig.test
 
-  console.log({
-    testType,
-    silent,
-    isCI,
-    runsInIDE,
-    // include,
-    // exclude,
-    pool,
-    isolate,
-    maxWorkers,
-    // setupFiles,
-    // cwd,
-  })
+  // In workspace mode, cwd differs from process.cwd() (which is the monorepo root)
+  const isWorkspaceMode = cwd && process.cwd() !== cwd
+  if (!isWorkspaceMode) {
+    console.log({
+      testType,
+      silent,
+      isCI,
+      runsInIDE,
+      pool,
+      isolate,
+      maxWorkers,
+    })
+  }
 
   return mergedConfig
 }
@@ -90,17 +92,7 @@ export function getSharedConfig(cwd) {
     },
     include,
     exclude,
-    reporters: [
-      'default',
-      new SummaryReporter(),
-      junitReporterEnabled && [
-        'junit',
-        {
-          suiteName: `${testType} tests`,
-          // classNameTemplate: '{filename} - {classname}',
-        },
-      ],
-    ].filter(Boolean),
+    reporters: getReporters(junitReporterEnabled, testType),
     // outputFile location is specified for compatibility with the previous jest config
     outputFile: junitReporterEnabled ? `./tmp/jest/${testType}.xml` : undefined,
     coverage: {
@@ -130,6 +122,30 @@ export function getSharedConfig(cwd) {
   }
 }
 
+function getReporters(junitReporterEnabled, testType) {
+  // VITEST_REPORTER env var allows overriding the default reporter
+  // e.g., VITEST_REPORTER=summary for minimal output
+  const { VITEST_REPORTER, CLAUDE_CODE } = process.env
+
+  if (VITEST_REPORTER === 'summary' || CLAUDE_CODE) {
+    return [new SummaryOnlyReporter()]
+  }
+  if (VITEST_REPORTER === 'dot') {
+    return ['dot']
+  }
+
+  return [
+    'default',
+    new SummaryReporter(),
+    junitReporterEnabled && [
+      'junit',
+      {
+        suiteName: `${testType} tests`,
+      },
+    ],
+  ].filter(Boolean)
+}
+
 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

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import { select, Separator } from '@inquirer/prompts';
 import { _by } from '@naturalcycles/js-lib/array/array.util.js';
 import { _assert } from '@naturalcycles/js-lib/error/assert.js';
 import { fs2 } from '@naturalcycles/nodejs-lib/fs2';
@@ -9,8 +8,12 @@ import { runCommitlint } from '../commitlint.js';
 import { eslintAll, lintAllCommand, lintStagedCommand, requireOxlintConfig, runBiome, runOxlint, runPrettier, stylelintAll, } from '../lint.util.js';
 import { runTest } from '../test.util.js';
 const commands = [
-    new Separator(), // build
     { name: 'check', fn: check, desc: '"Run all possible checks": lint, typecheck, then test.' },
+    {
+        name: 'quick-check',
+        fn: quickCheck,
+        desc: 'Like check, but without slow parts, to perform preliminary checks',
+    },
     { name: 'bt', fn: bt, desc: 'Build & Test: run "typecheck" (via oxlint) and then "test".' },
     {
         name: 'typecheck',
@@ -42,7 +45,6 @@ const commands = [
         fn: cleanBuild,
         desc: 'Cleans ./dist, then runs the build.',
     },
-    new Separator(), // test
     { name: 'test', fn: runTest, desc: 'Run vitest for *.test.ts files.' },
     {
         name: 'test-integration',
@@ -59,7 +61,6 @@ const commands = [
         fn: () => runTest({ leaks: true }),
         desc: 'Run vitest --detectLeaks for *.test.ts files.',
     },
-    new Separator(), // lint
     {
         name: 'lint',
         fn: lintAllCommand,
@@ -107,7 +108,6 @@ const commands = [
     },
     { name: 'stylelint-no-fix', cliOnly: true, fn: () => stylelintAll(false) },
     { name: 'commitlint', fn: runCommitlint, desc: 'Run commitlint.', cliOnly: true },
-    new Separator(), // interactive-only
     {
         name: 'exit',
         fn: () => console.log('see you!'),
@@ -127,27 +127,31 @@ const commands = [
     //   })
     // },
 ];
-const commandMap = _by(commands.filter(c => !(c instanceof Separator)), c => c.name);
+const commandMap = _by(commands, c => c.name);
 const { CI } = process.env;
 runScript(async () => {
     let cmd = process.argv.find(s => commandMap[s] && !commandMap[s].interactiveOnly);
     if (!cmd) {
         // interactive mode
         _assert(!CI, 'interactive dev-lib should not be run in CI');
-        cmd = await select({
+        const { default: prompts } = await import('prompts');
+        const response = await prompts({
+            type: 'select',
+            name: 'cmd',
             message: 'Select command',
-            pageSize: 30,
+            // @ts-expect-error types are wrong
+            optionsPerPage: 30,
             choices: commands
-                .filter(c => c instanceof Separator || !c.cliOnly)
-                .map(c => {
-                if (c instanceof Separator)
-                    return c;
-                return {
-                    value: c.name,
-                    description: c.desc,
-                };
-            }),
+                .filter(c => !c.cliOnly)
+                .map(c => ({
+                title: c.name,
+                value: c.name,
+                description: c.desc,
+            })),
         });
+        cmd = response.cmd;
+        if (!cmd)
+            return; // user cancelled
     }
     await commandMap[cmd].fn();
 });
@@ -155,6 +159,10 @@ async function check() {
     await lintAllCommand();
     runTest();
 }
+async function quickCheck() {
+    await lintAllCommand(false);
+    runTest();
+}
 async function bt() {
     await typecheckWithOxlint();
     runTest();

package/dist/lint.util.d.ts

@@ -1,8 +1,10 @@
 import type { SemVerString } from '@naturalcycles/js-lib/types';
 /**
  * Run all linters.
+ *
+ * If full=false - the "slow" linters are skipped.
  */
-export declare function lintAllCommand(): Promise<void>;
+export declare function lintAllCommand(full?: boolean): Promise<void>;
 interface EslintAllOptions {
     ext?: string;
     fix?: boolean;

package/dist/lint.util.js

@@ -16,8 +16,10 @@ import { cfgDir } from './paths.js';
 const { CI, ESLINT_CONCURRENCY } = process.env;
 /**
  * Run all linters.
+ *
+ * If full=false - the "slow" linters are skipped.
  */
-export async function lintAllCommand() {
+export async function lintAllCommand(full = true) {
     const started = Date.now();
     // const { commitOnChanges, failOnChanges } = _yargs().options({
     //   commitOnChanges: {
@@ -44,16 +46,18 @@ export async function lintAllCommand() {
     runBiome(fix);
     runOxlint(fix);
     // From this point we start the "slow" linters, with ESLint leading the way
-    // We run eslint BEFORE Prettier, because eslint can delete e.g unused imports.
-    eslintAll({
-        fix,
-    });
-    if (existsSync(`node_modules/stylelint`) &&
-        existsSync(`node_modules/stylelint-config-standard-scss`)) {
-        stylelintAll(fix);
+    if (full) {
+        // We run eslint BEFORE Prettier, because eslint can delete e.g unused imports.
+        eslintAll({
+            fix,
+        });
+        if (existsSync(`node_modules/stylelint`) &&
+            existsSync(`node_modules/stylelint-config-standard-scss`)) {
+            stylelintAll(fix);
+        }
+        runPrettier({ fix });
+        await runKTLint(fix);
     }
-    runPrettier({ fix });
-    await runKTLint(fix);
     console.log(`${check(true)}${white(`lint-all`)} ${dimGrey(`took ` + _since(started))}`);
     // if (needToTrackChanges) {
     //   const gitStatusAfter = gitStatus()

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@naturalcycles/dev-lib",
   "type": "module",
-  "version": "20.18.2",
+  "version": "20.20.0",
   "dependencies": {
     "@biomejs/biome": "^2",
     "@eslint/js": "^9",
-    "@inquirer/prompts": "^8",
+    "prompts": "^2",
     "@naturalcycles/js-lib": "^15",
     "@naturalcycles/nodejs-lib": "^15",
     "@vitest/coverage-v8": "^4",
@@ -16,7 +16,7 @@
     "eslint-plugin-simple-import-sort": "^12",
     "eslint-plugin-unicorn": "^62",
     "eslint-plugin-vue": "^10",
-    "globals": "^16",
+    "globals": "^17",
     "lint-staged": "^16",
     "micromatch": "^4",
     "mitm": "^1",
@@ -42,7 +42,8 @@
   },
   "devDependencies": {
     "@types/mitm": "^1",
-    "@types/node": "^25"
+    "@types/node": "^25",
+    "@types/prompts": "^2"
   },
   "exports": {
     "./cfg/": "./cfg/",