@7n/test 0.14.2 → 0.14.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.14.4] - 2026-07-11
+
+### Fixed
+
+- `measureCoveragePerFile`: не додавати `--coverage.exclude=**/*.d.ts` на CLI, коли target-проєкт має власний локальний vitest + `vitest.config.js` — CLI-флаг повністю замінює (не мерджить) масив `test.coverage.exclude` із конфіга проєкту, через що тихо затирались власні винятки (напр. bun-native-тести, що можуть виконуватись лише під `bun test`) і колектор помилково бачив уже покриті файли як 0%, намагаючись згенерувати для них нові тести. У bundled/shim-режимі (без локального vitest) флаг лишається — там немає стороннього конфіга для затирання.
+
+## [0.14.3] - 2026-07-11
+
+### Changed
+
+- feat(coverage): bun-native workspace підтримка — coverage через `bun test`
+
 ## [0.14.2] - 2026-07-11
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",

package/src/coverage/bun-native.mjs

@@ -0,0 +1,84 @@
+/**
+ * Детекція bun-native workspace-ів: prod-код імпортує `'bun'` (або `'bun:sqlite'`,
+ * `'bun:ffi'` тощо — усе крім `'bun:test'`, який конвертує lint-правило
+ * `test/no-bun-test-import`). vitest структурно не виконує такий код: модуль `bun`
+ * існує лише всередині Bun runtime (Node ESM/vitest module-runner його не резолвить),
+ * тож coverage для таких workspace-ів збирається через `bun test --coverage`
+ * (Bun автоматично ремапить `import ... from 'vitest'` у тест-файлах на `bun:test`).
+ */
+import { readFile, readdir } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** import/require/dynamic-import специфікатора `bun` або `bun:*` (крім `bun:test`). */
+const BUN_NATIVE_IMPORT_RE = /(?:from|import\s*\(|require\s*\()\s*(['"])bun(?::(?!test)[\w.-]+)?\1/u
+
+/** JS/TS prod-розширення, які скануємо на bun-native імпорти. */
+const JS_SOURCE_RE = /\.(c|m)?[jt]sx?$/
+/** Тест-файли — не prod-код: `bun:test`/vitest-імпорти там не сигнал bun-native. */
+const TEST_FILE_RE = /\.(test|spec)\.[^.]+$/
+/** Тест-файли, які запускає `bun test` (для пре-скану «чи є що ганяти»). */
+const RUNNABLE_TEST_RE = /\.test\.(m?js|ts)$/
+
+const IGNORE_DIRS = new Set(['node_modules', 'dist', 'build', 'out', '.git', 'coverage', 'reports', 'docs', 'types'])
+
+/**
+ * Рекурсивний обхід каталогу з відсіюванням службових директорій.
+ * @param {string} dir абсолютний шлях
+ * @param {(absPath: string) => void} onFile колбек для кожного файлу
+ * @returns {Promise<void>}
+ */
+async function walk(dir, onFile) {
+  let entries
+  try {
+    entries = await readdir(dir, { withFileTypes: true })
+  } catch {
+    return
+  }
+  for (const entry of entries) {
+    if (entry.name.startsWith('.')) continue
+    const abs = join(dir, entry.name)
+    if (entry.isDirectory()) {
+      if (!IGNORE_DIRS.has(entry.name)) await walk(abs, onFile)
+    } else if (entry.isFile()) {
+      onFile(abs)
+    }
+  }
+}
+
+/**
+ * Чи workspace bun-native: хоч один prod JS/TS-файл імпортує `bun`/`bun:*` (крім `bun:test`).
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @returns {Promise<boolean>} true для bun-native workspace
+ */
+export async function isBunNativeRoot(jsRoot) {
+  /** @type {string[]} */
+  const prodFiles = []
+  await walk(jsRoot, abs => {
+    if (JS_SOURCE_RE.test(abs) && !TEST_FILE_RE.test(abs)) prodFiles.push(abs)
+  })
+  for (const abs of prodFiles) {
+    let body
+    try {
+      body = await readFile(abs, 'utf8')
+    } catch {
+      continue
+    }
+    if (BUN_NATIVE_IMPORT_RE.test(body)) return true
+  }
+  return false
+}
+
+/**
+ * Чи workspace має тест-файли, які запустить `bun test` (`*.test.{js,mjs,ts}`).
+ * Пре-скан перед запуском: `bun test` без тестів завершується помилкою, а нам
+ * потрібен той самий graceful skip, що дає vitest `--passWithNoTests`.
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @returns {Promise<boolean>} true, якщо є хоча б один тест-файл
+ */
+export async function hasRunnableTests(jsRoot) {
+  let found = false
+  await walk(jsRoot, abs => {
+    if (RUNNABLE_TEST_RE.test(abs)) found = true
+  })
+  return found
+}

package/src/coverage/coverage.mjs

@@ -171,7 +171,7 @@ export function resolveChangedScope(cwd) {
 
 /**
  * Виконує coverage-pipeline: JS-колектор (detect+collect), агрегація, запис COVERAGE.md.
- * @param {{cwd?:string, fix?:boolean, changed?:boolean}} [opts]
+ * @param {{cwd?:string, fix?:boolean, changed?:boolean}} [opts] опції прогону
  * @returns {Promise<number>} exit code (0 OK, 1 помилка)
  */
 export async function runCoverageSteps(opts = {}) {
@@ -240,7 +240,7 @@ function lockKey(changed) {
 
 /**
  * CLI entrypoint для `@7n/test coverage [--fix] [--changed]`.
- * @param {{cwd?:string, fix?:boolean, changed?:boolean}} [opts]
+ * @param {{cwd?:string, fix?:boolean, changed?:boolean}} [opts] опції CLI-виклику
  * @returns {Promise<number>} exit code
  */
 export async function runCoverageCli(opts = {}) {

package/src/coverage/js-collector.mjs

@@ -14,6 +14,7 @@ import { dirname, isAbsolute, join, relative } from 'node:path'
 
 import { resolveAllJsRoots } from '../lib/resolve-js-root.mjs'
 import { addCoverage, addMutation } from './aggregate.mjs'
+import { hasRunnableTests, isBunNativeRoot } from './bun-native.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
@@ -281,6 +282,17 @@ const defaultRunner = {
     )
     return r.status ?? 1
   },
+  runBunCoverage({ cwd, lcovDir }) {
+    // Bun-native workspace (prod-код імпортує `bun`/`bun:*`): vitest такий модуль не
+    // резолвить, тож coverage ганяємо нативним `bun test`. Bun ремапить
+    // `import ... from 'vitest'` у тест-файлах на `bun:test` — тести лишаються canon.
+    const r = spawnSync('bun', ['test', '--coverage', '--coverage-reporter=lcov', `--coverage-dir=${lcovDir}`], {
+      cwd,
+      stdio: 'inherit',
+      env: process.env
+    })
+    return r.status ?? 1
+  },
   runStryker({ cwd, mutate }) {
     // Plugin-discovery Stryker (`@stryker-mutator/*`) globиться відносно CORE-install-каталогу
     // (`core/dist/src/di/plugin-loader.js` → `../../../../../@stryker-mutator/*`). Тож core
@@ -311,11 +323,15 @@ const defaultRunner = {
  * NoCoverage-мутанти (gate впаде, як і має). Якщо змінено лише тест-файли (нема
  * production-src) — Stryker не запускаємо (мутувати нічого), повертаємо лише coverage.
  *
- * Реальні помилки (vitest exit ≠ 0, відсутній mutation.json попри запуск Stryker)
+ * Bun-native workspace (prod-код імпортує `bun`/`bun:*`): coverage через
+ * `bun test --coverage` (vitest не резолвить модуль `bun`), mutation пропускається
+ * з попередженням — Stryker vitest-runner такий код не виконає.
+ *
+ * Реальні помилки (vitest/bun exit ≠ 0, відсутній mutation.json попри запуск Stryker)
  * кидаються — у multi-root режимі це не маскує справжній збій.
  * @param {string} jsRoot абсолютний шлях до workspace-кореня
  * @param {string} cwd корінь проєкту (для рібейзингу `survived[].file`)
- * @param {{runJsCoverage:Function, runStryker:Function}} runner spawn-ін'єкція
+ * @param {{runJsCoverage:Function, runStryker:Function, runBunCoverage:Function}} runner spawn-ін'єкція
  * @param {{files:string[], base:string|null}|null} [scope] changed-scope (null = full-режим)
  * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результати або null коли full-режим і workspace без тестів
  */
@@ -324,11 +340,27 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   // У changed-режимі production-файли для мутації = змінені JS цього root без тест-файлів.
   const mutateSrc = scope ? scope.files.filter(f => !TEST_FILE.test(f)) : null
 
-  // 1. Coverage через vitest run --passWithNoTests --coverage (+ --changed у changed-режимі)
+  // Bun-native workspace: coverage через `bun test`, mutation пропускається
+  // (Stryker vitest-runner не виконає код з `import ... from 'bun'`).
+  const bunNative = await isBunNativeRoot(jsRoot)
+  if (bunNative && !(await hasRunnableTests(jsRoot))) {
+    // `bun test` без тестів завершується помилкою — graceful skip як vitest --passWithNoTests.
+    return scope
+      ? {
+          coverage: { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } },
+          mutation: { caught: 0, total: 0 },
+          survived: []
+        }
+      : null
+  }
+
+  // 1. Coverage: vitest run --passWithNoTests --coverage (+ --changed) або `bun test --coverage`
   const lcovDir = await mkdtemp(join(tmpdir(), 'js-cov-'))
   let coverage
   try {
-    const code = await runner.runJsCoverage(scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir })
+    const code = bunNative
+      ? await runner.runBunCoverage({ cwd: jsRoot, lcovDir })
+      : await runner.runJsCoverage(scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir })
     if (code !== 0) throw new Error(`JS coverage exit ${code}`)
     const lcovPath = join(lcovDir, 'lcov.info')
     coverage = existsSync(lcovPath)
@@ -338,6 +370,16 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
     await rm(lcovDir, { recursive: true, force: true })
   }
 
+  // Bun-native: mutation testing пропускаємо чесно, з попередженням — Stryker
+  // vitest-runner структурно несумісний із bun-native кодом.
+  if (bunNative) {
+    console.error(
+      `⚠ ${wsRel || '.'}: bun-native workspace (import 'bun' у prod-коді) — ` +
+        'mutation testing пропущено (Stryker vitest-runner несумісний), лише line coverage'
+    )
+    return { coverage, mutation: { caught: 0, total: 0 }, survived: [] }
+  }
+
   // Full-режим: порожній lcov ⇔ vitest не знайшов тестів → пропускаємо workspace,
   // щоб не ганяти Stryker марно. У changed-режимі НЕ пропускаємо (див. JSDoc).
   if (!scope) {

package/src/coverage-per-file.mjs

@@ -98,6 +98,22 @@ export async function measureCoveragePerFile(dir) {
   const jsonResultsFile = join(lcovDir, 'test-results.json')
 
   const { bin, configArgs } = resolveVitestRun(dir)
+  // `--coverage.exclude` на CLI ПОВНІСТЮ замінює (не мерджить) масив
+  // `test.coverage.exclude` із target-проєкту vitest.config.js — так влаштований
+  // vitest CLI-override для array-полів. Коли `configArgs` порожній, resolveVitestRun
+  // вже обрав ЛОКАЛЬНИЙ vitest target-проєкту (він сам підхопить свій vitest.config.js) —
+  // додавання CLI-флагу тут тихо затирає власні винятки проєкту (напр. тести, що
+  // структурно можуть виконуватись лише під `bun test`, а не vitest), через що колектор
+  // бачить їх як 0%-покриті й намагається згенерувати для них НОВІ тести, хоча вони вже
+  // покриті. У bundled/shim-режимі (`configArgs` непорожній) конфлікту немає — стороннього
+  // конфіга для затирання нема, а shim (`ensureVitestShim`) вже сам включає `**/*.d.ts`.
+  const coverageExcludeArgs =
+    configArgs.length === 0
+      ? []
+      : [
+          // vitest 4 прибрав дефолтний exclude **/*.d.ts — без нього v8-remap падає на TS-синтаксисі декларацій
+          '--coverage.exclude=**/*.d.ts'
+        ]
   try {
     spawnSync(
       process.execPath,
@@ -112,8 +128,7 @@ export async function measureCoveragePerFile(dir) {
         '--coverage.reporter=lcov',
         // vitest 4 прибрав coverage.all — явний include, щоб файли без тестів лишались у lcov (0%)
         '--coverage.include=**/*.{js,mjs,ts,vue}',
-        // vitest 4 прибрав дефолтний exclude **/*.d.ts — без нього v8-remap падає на TS-синтаксисі декларацій
-        '--coverage.exclude=**/*.d.ts',
+        ...coverageExcludeArgs,
         `--coverage.reportsDirectory=${lcovDir}`,
         '--reporter=verbose',
         '--reporter=json',

package/src/docs/coverage-per-file.md

@@ -3,7 +3,7 @@ type: JS Module
 title: coverage-per-file.mjs
 resource: npm/src/coverage-per-file.mjs
 docgen:
-  crc: 2b4a460d
+  crc: 388282cc
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98