@7n/rules-lang-js 0.9.0 → 0.10.0

package/rules/storybook/vitest-config/main.mjs

@@ -0,0 +1,358 @@
+/** @see ./docs/main.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { basename, dirname, extname, join } from 'node:path'
+
+import { parseSync } from 'oxc-parser'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { collectInScopeVuePackages } from '../scope/main.mjs'
+import { detectStoriesGlob } from '../scaffold/main.mjs'
+
+// Канонічні назви vitest-конфіга пакета (пріоритет .mjs — нові файли, js.mdc);
+// .ts підтримано для "стійкості до варіацій" (vitest-config.mdc).
+export const VITEST_CONFIG_NAMES = ['vitest.config.mjs', 'vitest.config.js', 'vitest.config.ts']
+// Ті самі варіанти, що й `vite.config.*` у scope/main.mjs (не експортовано звідти — дублюємо).
+const VITE_CONFIG_NAMES = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']
+
+/** Import, який має бути присутній у файлі, щоб `storybookTest(...)` резолвився. */
+export const STORYBOOK_TEST_IMPORT = "import { storybookTest } from '@storybook/addon-vitest/vitest-plugin'\n"
+
+// Стабільні reasons (namespace: ruleId/concernId/reason).
+export const REASON_VITEST_CONFIG_MISSING = 'vitest-config-missing'
+export const REASON_STRYKER_CONFIG_MISSING = 'stryker-config-missing'
+export const REASON_CONFIG_UNRESOLVABLE = 'vitest-config-unresolvable'
+export const REASON_PROJECTS_DYNAMIC = 'projects-dynamic'
+export const REASON_UNIT_PROJECT_MISSING = 'unit-project-missing'
+export const REASON_STORYBOOK_PROJECT_MISSING = 'storybook-project-missing'
+export const REASON_STORYBOOK_PROJECT_MARKER_MISSING = 'storybook-project-marker-missing'
+
+// Маркери канонічного storybook-проєкту (текстовий пошук у зрізі джерела самого
+// елемента масиву — стійко до форматування/AST-варіацій, як і scaffold/main.mjs).
+// Три останні (chromium/browser/stories) експортовано — переюз у `adopt/main.mjs`.
+const UNIT_NAME_RE = /name\s*:\s*['"]unit['"]/u
+const STORYBOOK_NAME_RE = /name\s*:\s*['"]storybook['"]/u
+export const CHROMIUM_RE = /chromium/u
+export const BROWSER_KEY_RE = /\bbrowser\s*:/u
+export const STORIES_RE = /stories/iu
+const STORIES_GLOB_PREFIX_RE = /^\.\.\//u
+// Module-scope (prefer-static-regex): рядок-відступ цілком whitespace; leading
+// кома (можливо з whitespace) — спільні з fix-vitest-config.mjs патерном augment-у.
+export const WHITESPACE_ONLY_RE = /^\s*$/u
+export const LEADING_COMMA_RE = /^\s*,/u
+
+/**
+ * Резолвить абсолютний шлях наявного `vitest.config.*` пакета (перший знайдений
+ * за пріоритетом {@link VITEST_CONFIG_NAMES}), або `null` якщо жодного немає.
+ * @param {string} absPkgDir абсолютний шлях кореня пакета
+ * @returns {string | null} абсолютний шлях конфіга або null
+ */
+export function resolveVitestConfigPath(absPkgDir) {
+  const name = VITEST_CONFIG_NAMES.find(n => existsSync(join(absPkgDir, n)))
+  return name ? join(absPkgDir, name) : null
+}
+
+/**
+ * Резолвить ім'я `vite.config.*` пакета для import-шляху в baseline-шаблонах
+ * (той самий файл, що й `viteFinal` у `.storybook/main.js`). Пакет у скоупі
+ * гарантовано має один із них (`scope/main.mjs#hasStandardBuild`).
+ * @param {string} absPkgDir абсолютний шлях кореня пакета
+ * @returns {string} ім'я файлу vite-конфіга (дефолт `vite.config.js`)
+ */
+export function resolveViteConfigName(absPkgDir) {
+  return VITE_CONFIG_NAMES.find(n => existsSync(join(absPkgDir, n))) ?? 'vite.config.js'
+}
+
+/**
+ * Шлях до ізольованого `vitest.stryker.config.*` — той самий каталог і
+ * розширення, що й основний vitest-конфіг пакета.
+ * @param {string} vitestConfigPath абсолютний шлях `vitest.config.*`
+ * @returns {string} абсолютний шлях `vitest.stryker.config.*`
+ */
+export function strykerConfigPathFor(vitestConfigPath) {
+  return join(dirname(vitestConfigPath), `vitest.stryker.config${extname(vitestConfigPath)}`)
+}
+
+/**
+ * Stories-glob для vitest-конфіга пакета (на відміну від `detectStoriesGlob`
+ * scaffold-концерна — той повертає шлях відносно `.storybook/`, тут vitest-конфіг
+ * лежить у корені пакета, тож префікс `../` треба зняти).
+ * @param {string} absPkgDir абсолютний шлях кореня пакета
+ * @returns {string} glob відносно кореня пакета
+ */
+export function storiesGlobForVitestConfig(absPkgDir) {
+  return detectStoriesGlob(absPkgDir).replace(STORIES_GLOB_PREFIX_RE, '')
+}
+
+/**
+ * Парсить JS/TS файл через oxc-parser з обраним lang за розширенням.
+ * @param {string} absPath абсолютний шлях файлу (для diagnostics парсера)
+ * @param {string} src вміст файлу
+ * @returns {{program: object, errors?: Array<{message: string}>}} результат парсингу
+ */
+export function parseModule(absPath, src) {
+  const lang = extname(absPath) === '.ts' ? 'ts' : 'js'
+  return parseSync(absPath, src, { lang, sourceType: 'module' })
+}
+
+/**
+ * Рекурсивно шукає перший `ObjectExpression` у довільному AST-вузлі, що має
+ * property `test` зі значенням-`ObjectExpression`.
+ * @param {unknown} node довільний AST-вузол/масив/примітив
+ * @returns {object | null} `test`-ObjectExpression або null
+ */
+function findTestObjectIn(node) {
+  if (!node || typeof node !== 'object') return null
+  if (node.type === 'ObjectExpression') {
+    const prop = node.properties?.find(
+      p =>
+        p.type === 'Property' &&
+        !p.computed &&
+        p.key &&
+        (p.key.name === 'test' || p.key.value === 'test') &&
+        p.value?.type === 'ObjectExpression'
+    )
+    if (prop) return prop.value
+  }
+  for (const val of Object.values(node)) {
+    if (Array.isArray(val)) {
+      for (const item of val) {
+        const res = findTestObjectIn(item)
+        if (res) return res
+      }
+    } else if (val && typeof val === 'object') {
+      const res = findTestObjectIn(val)
+      if (res) return res
+    }
+  }
+  return null
+}
+
+/**
+ * Шукає перший `ObjectExpression` у дереві AST, що має property `test` зі
+ * значенням-`ObjectExpression` — незалежно від того, чи огорнутий він у
+ * `defineConfig(...)`/`mergeConfig(...)`, чи це простий об'єкт (стійко до
+ * варіацій testing.mdc-канону).
+ * @param {object} program oxc Program node
+ * @returns {object | null} `test`-ObjectExpression або null
+ */
+export function findTestObject(program) {
+  return findTestObjectIn(program)
+}
+
+/**
+ * Шукає property `name` у `ObjectExpression`.
+ * @param {object} objExpr ObjectExpression node
+ * @param {string} name ім'я property
+ * @returns {object | null} Property node або null
+ */
+export function findProperty(objExpr, name) {
+  return (
+    objExpr.properties.find(
+      p => p.type === 'Property' && !p.computed && p.key && (p.key.name === name || p.key.value === name)
+    ) ?? null
+  )
+}
+
+/**
+ * Класифікує елементи масиву `test.projects`: чи є `unit`-проєкт, і
+ * source-зріз елемента `storybook`-проєкту (для marker-перевірки).
+ * @param {string} src вихідний текст vitest-конфіга
+ * @param {object} arr ArrayExpression node (`test.projects`)
+ * @returns {{hasUnit: boolean, storybookSlice: string | null}} стан projects-масиву
+ */
+export function classifyProjects(src, arr) {
+  let hasUnit = false
+  let storybookSlice = null
+  for (const el of arr.elements) {
+    if (!el || el.type !== 'ObjectExpression') continue
+    const slice = src.slice(el.start, el.end)
+    if (UNIT_NAME_RE.test(slice)) hasUnit = true
+    if (STORYBOOK_NAME_RE.test(slice)) storybookSlice = slice
+  }
+  return { hasUnit, storybookSlice }
+}
+
+/**
+ * Будує спільний контекст перевірки одного пакета (label/relPrefix/шлях vitest-конфіга).
+ * @param {import('../scope/main.mjs').InScopePackage} entry пакет у скоупі
+ * @returns {{rootDir: string, absDir: string, label: string, relPrefix: string, vitestConfigPath: string | null}} контекст
+ */
+function buildPackageCtx({ rootDir, absDir }) {
+  return {
+    rootDir,
+    absDir,
+    label: rootDir === '.' ? 'корінь' : rootDir,
+    relPrefix: rootDir === '.' ? '' : `${rootDir}/`,
+    vitestConfigPath: resolveVitestConfigPath(absDir)
+  }
+}
+
+/**
+ * Перевіряє `test.projects` наявного vitest-конфіга: parse-помилки, відсутність
+ * test-блоку, відсутність/динамічність `projects`, відсутність unit/storybook-
+ * записів і канонічних маркерів storybook-запису (chromium/browser/stories).
+ * @param {ReturnType<typeof buildPackageCtx>} pkgCtx контекст пакета
+ * @param {ReturnType<typeof createViolationReporter>} reporter reporter поточного лінту
+ * @returns {Promise<void>}
+ */
+async function checkVitestConfigContent(pkgCtx, reporter) {
+  const { label, relPrefix, rootDir, vitestConfigPath } = pkgCtx
+  const relVitestFile = `${relPrefix}${basename(vitestConfigPath)}`
+  const src = await readFile(vitestConfigPath, 'utf8')
+
+  let parsed
+  try {
+    parsed = parseModule(vitestConfigPath, src)
+  } catch (error) {
+    reporter.fail(`[${label}] ${relVitestFile} не парситься (${error.message}) — перевір вручну (vitest-config.mdc)`, {
+      reason: REASON_CONFIG_UNRESOLVABLE,
+      file: relVitestFile
+    })
+    return
+  }
+  if (parsed.errors?.length) {
+    reporter.fail(`[${label}] ${relVitestFile} має syntax error — перевір вручну (vitest-config.mdc)`, {
+      reason: REASON_CONFIG_UNRESOLVABLE,
+      file: relVitestFile
+    })
+    return
+  }
+
+  const testObj = findTestObject(parsed.program)
+  if (!testObj) {
+    reporter.fail(
+      `[${label}] ${relVitestFile}: не вдалось знайти test-блок (defineConfig({ test: {...} })) — додай unit/storybook-projects вручну за template/ (vitest-config.mdc)`,
+      { reason: REASON_CONFIG_UNRESOLVABLE, file: relVitestFile }
+    )
+    return
+  }
+
+  const data = { rootDir, vitestConfigPath }
+  const projectsProp = findProperty(testObj, 'projects')
+  if (!projectsProp) {
+    reporter.fail(
+      `[${label}] ${relVitestFile}: бракує test.projects (unit) — npx @7n/rules fix storybook (vitest-config.mdc)`,
+      {
+        reason: REASON_UNIT_PROJECT_MISSING,
+        file: relVitestFile,
+        data
+      }
+    )
+    reporter.fail(
+      `[${label}] ${relVitestFile}: бракує test.projects (storybook) — npx @7n/rules fix storybook (vitest-config.mdc)`,
+      {
+        reason: REASON_STORYBOOK_PROJECT_MISSING,
+        file: relVitestFile,
+        data
+      }
+    )
+    return
+  }
+  if (projectsProp.value?.type !== 'ArrayExpression') {
+    reporter.fail(
+      `[${label}] ${relVitestFile}: test.projects — не статичний масив (spread/змінна) — додай unit/storybook-projects вручну (vitest-config.mdc)`,
+      { reason: REASON_PROJECTS_DYNAMIC, file: relVitestFile }
+    )
+    return
+  }
+
+  const { hasUnit, storybookSlice } = classifyProjects(src, projectsProp.value)
+  if (!hasUnit) {
+    reporter.fail(
+      `[${label}] ${relVitestFile}: test.projects без 'unit' — npx @7n/rules fix storybook (vitest-config.mdc)`,
+      {
+        reason: REASON_UNIT_PROJECT_MISSING,
+        file: relVitestFile,
+        data
+      }
+    )
+  }
+  if (storybookSlice) {
+    const missingHints = []
+    if (!CHROMIUM_RE.test(storybookSlice)) missingHints.push('chromium-інстанс')
+    if (!BROWSER_KEY_RE.test(storybookSlice)) missingHints.push('browser-mode')
+    if (!STORIES_RE.test(storybookSlice)) missingHints.push('stories-glob')
+    if (missingHints.length > 0) {
+      reporter.fail(
+        `[${label}] ${relVitestFile}: storybook-project без канонічних маркерів — бракує: ${missingHints.join(', ')} (vitest-config.mdc)`,
+        { reason: REASON_STORYBOOK_PROJECT_MARKER_MISSING, file: relVitestFile, data: { rootDir } }
+      )
+    }
+  } else {
+    reporter.fail(
+      `[${label}] ${relVitestFile}: test.projects без 'storybook' — npx @7n/rules fix storybook (vitest-config.mdc)`,
+      {
+        reason: REASON_STORYBOOK_PROJECT_MISSING,
+        file: relVitestFile,
+        data
+      }
+    )
+  }
+}
+
+/**
+ * Перевіряє наявність ізольованого `vitest.stryker.config.*` поруч із
+ * наявним vitest-конфігом пакета.
+ * @param {ReturnType<typeof buildPackageCtx>} pkgCtx контекст пакета
+ * @param {ReturnType<typeof createViolationReporter>} reporter reporter поточного лінту
+ * @returns {void}
+ */
+function checkStrykerConfigPresence(pkgCtx, reporter) {
+  const { label, relPrefix, rootDir, vitestConfigPath } = pkgCtx
+  const strykerPath = strykerConfigPathFor(vitestConfigPath)
+  if (existsSync(strykerPath)) return
+  const relStrykerFile = `${relPrefix}${basename(strykerPath)}`
+  reporter.fail(
+    `[${label}] відсутній ізольований ${relStrykerFile} — @stryker-mutator/vitest-runner крашиться на browser-mode projects: npx @7n/rules fix storybook (vitest-config.mdc)`,
+    { reason: REASON_STRYKER_CONFIG_MISSING, file: relStrykerFile, data: { rootDir, vitestConfigPath } }
+  )
+}
+
+/**
+ * Перевіряє один пакет у скоупі: наявність/канон `vitest.config.*`
+ * (`test.projects` — unit+storybook) і наявність ізольованого
+ * `vitest.stryker.config.*`.
+ * @param {import('../scope/main.mjs').InScopePackage} entry пакет у скоупі
+ * @param {ReturnType<typeof createViolationReporter>} reporter reporter поточного лінту
+ * @returns {Promise<void>}
+ */
+async function checkPackage(entry, reporter) {
+  const pkgCtx = buildPackageCtx(entry)
+  if (!pkgCtx.vitestConfigPath) {
+    reporter.fail(
+      `[${pkgCtx.label}] відсутній vitest.config.{mjs,js,ts} — канонічні projects unit+storybook (vitest-config.mdc): npx @7n/rules fix storybook`,
+      {
+        reason: REASON_VITEST_CONFIG_MISSING,
+        file: `${pkgCtx.relPrefix}vitest.config.mjs`,
+        data: { rootDir: pkgCtx.rootDir }
+      }
+    )
+    return
+  }
+
+  await checkVitestConfigContent(pkgCtx, reporter)
+  checkStrykerConfigPresence(pkgCtx, reporter)
+}
+
+/**
+ * Перевіряє канонічний vitest-конфіг (unit+storybook projects) і наявність
+ * ізольованого `vitest.stryker.config` для всіх пакетів у скоупі Storybook.
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат лінту
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const pkgs = await collectInScopeVuePackages(ctx.cwd)
+
+  if (pkgs.length === 0) {
+    reporter.pass('storybook: немає Vue component library пакетів у скоупі (vitest-config.mdc)')
+    return reporter.result()
+  }
+
+  for (const entry of pkgs) {
+    await checkPackage(entry, reporter)
+  }
+
+  return reporter.result()
+}

package/rules/storybook/vitest-config/template/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: plugins/lang-js/rules/storybook/vitest-config/template
+resource: plugins/lang-js/rules/storybook/vitest-config/template/
+---
+
+| Файл                                                                    | Тип       |
+| ----------------------------------------------------------------------- | --------- |
+| [storybook-project-entry.js](storybook-project-entry.md)                | JS Module |
+| [unit-project-entry.js](unit-project-entry.md)                          | JS Module |
+| [vitest.config.baseline.mjs](vitest.config.baseline.md)                 | JS Module |
+| [vitest.stryker.config.baseline.mjs](vitest.stryker.config.baseline.md) | JS Module |

package/rules/storybook/vitest-config/template/docs/storybook-project-entry.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: storybook-project-entry.js
+resource: plugins/lang-js/rules/storybook/vitest-config/template/storybook-project-entry.js
+docgen:
+  crc: 5d9feafd
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл задає еталонний фрагмент конфігурації для інструментів правил. Він потрібен як незмінний зразок для порівняння або відновлення очікуваного стану конфігурації. Механізм є read-only: не записує дані у файлову систему чи базу даних.
+
+## Поведінка
+
+1. Визначає канонічний запис окремого тестового проєкту для Storybook у конфігурації Vitest.
+
+2. Вмикає виконання Storybook-тестів у browser mode, щоб перевірки stories запускалися в браузерному середовищі.
+
+3. Обмежує браузерну перевірку Chromium, щоб результат був стабільним і відповідав прийнятому стандарту репозиторію.
+
+4. Задає пошук stories через шаблон, який підставляється під час генерації або виправлення конфігурації.
+
+5. Підключає Storybook setup-файл для Vitest, щоб тести stories отримували потрібне середовище Storybook.
+
+6. Слугує еталонним фрагментом для інструментів правил, які порівнюють або відновлюють правильний запис Storybook-проєкту в `test.projects`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/vitest-config/template/docs/unit-project-entry.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: unit-project-entry.js
+resource: plugins/lang-js/rules/storybook/vitest-config/template/unit-project-entry.js
+docgen:
+  crc: 84a0a5f8
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.94
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл містить еталонний запис для `unit`-проєкту. Він потрібен, щоб мати узгоджений фрагмент базового тестового середовища. Запис read-only: не пише у ФС/БД.
+
+## Поведінка
+
+1. Визначає канонічний запис `unit`-проєкту для списку `test.projects` у Vitest-конфігурації Storybook.
+
+2. Позначає, що `unit`-проєкт наслідує базові налаштування тестового середовища.
+
+3. Фіксує стабільну назву проєкту як `unit`, щоб конфігурація мала передбачуваний і уніфікований вигляд.
+
+4. Надає еталонний фрагмент для автоматичного вставлення в конфігурацію, не виконуючи змін у файловій системі чи зовнішніх сховищах.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/vitest-config/template/docs/vitest.config.baseline.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: vitest.config.baseline.mjs
+resource: plugins/lang-js/rules/storybook/vitest-config/template/vitest.config.baseline.mjs
+docgen:
+  crc: 1eca6e97
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл збирає спільну тестову конфігурацію для Vue-бібліотеки в Storybook-контексті: окремо для звичайних unit-тестів і окремо для storybook-сценаріїв. Він існує, щоб один набір використовувався для ізольованих DOM-тестів у unit-режимі, а інший — для перевірки історій у Storybook-оточенні.
+
+## Поведінка
+
+1. Об’єднує базову конфігурацію проєкту з канонічним тестовим профілем для бібліотеки Vue-компонентів у контексті Storybook.
+2. Визначає окремий unit-набір для звичайних тестів і окремий storybook-набір для візуально-інтеграційних сценаріїв.
+3. Для unit-набору запускає тести в середовищі, придатному для DOM-логіки без браузера, і збирає покриття у форматах для звіту та короткого підсумку.
+4. Для storybook-набору підключає перевірку історій із каталогом Storybook, вмикає browser-mode, працює без віконного інтерфейсу та обмежується Chromium.
+5. Для storybook-набору підвантажує окрему підготовку середовища з сусідньої storybook-налаштування.
+6. Не запускає browser-mode для unit-набору, щоб зберегти сумісність із окремим ізольованим mutant-testing сценарієм, який використовує той самий unit-набір без browser projects.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/vitest-config/template/docs/vitest.stryker.config.baseline.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: vitest.stryker.config.baseline.mjs
+resource: plugins/lang-js/rules/storybook/vitest-config/template/vitest.stryker.config.baseline.mjs
+docgen:
+  crc: 5cb4ea5e
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Окремий vitest-конфіг для набору тестів, який використовують у перевірках мутацій. Він повторює базові налаштування основного середовища, але додає власні обмеження для цього сценарію. Тут також задаються параметри покриття, щоб результат був придатний для подальшої автоматичної обробки та швидкого перегляду.
+
+## Поведінка
+
+1. Формує окремий vitest-конфіг для запуску Stryker поверх уже зібраного базового тестового набору.
+2. Зберігає сумісність із unit-тестами основного середовища, але відсікає storybook-частину, яка для Stryker непридатна через browser-mode.
+3. Вмикає виконання тестів у DOM-подібному середовищі, щоб мутування перевірялося в близьких до браузера умовах без справжнього браузера.
+4. Обмежує охоплення лише unit-подібними тестами проєкту; storybook-проєкти та інші browser-mode сценарії тут свідомо не проходять.
+5. Налаштовує збір покриття так, щоб результат був придатний і для машинної обробки, і для швидкого людського перегляду.
+6. Призначений саме для окремого файлу конфігурації Stryker; основний vitest-конфіг має лишатися джерелом спільних налаштувань.
+
+Changelog: not run
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/vitest-config/template/storybook-project-entry.js

@@ -0,0 +1,22 @@
+// Канонічний вигляд запису `storybook`-проєкту у `test.projects` (storybook.mdc,
+// vitest-config-концерн, ADR Кластер 5): browser-mode, лише chromium, stories-glob
+// (`__STORYBOOK_STORIES_GLOB__` — токен, `detectStoriesGlob` зі scaffold-концерна
+// без префіксу `../`). Сам файл — валідний модуль лише для JS-лінту репозиторію
+// правил; `fix-vitest-config.mjs` зчитує лише вміст `export default {...}`.
+import { storybookTest } from '@storybook/addon-vitest/vitest-plugin'
+
+export default {
+  extends: true,
+  plugins: [storybookTest({ configDir: '.storybook' })],
+  test: {
+    name: 'storybook',
+    include: ['__STORYBOOK_STORIES_GLOB__'],
+    browser: {
+      enabled: true,
+      headless: true,
+      provider: 'playwright',
+      instances: [{ browser: 'chromium' }]
+    },
+    setupFiles: ['.storybook/vitest.setup.js']
+  }
+}

package/rules/storybook/vitest-config/template/unit-project-entry.js

@@ -0,0 +1,5 @@
+// Канонічний вигляд запису `unit`-проєкту у `test.projects` (storybook.mdc,
+// vitest-config-концерн). Сам файл — валідний модуль лише для того, щоб
+// пройти JS-лінт репозиторію правил; `fix-vitest-config.mjs` зчитує лише
+// вміст `export default {...}` і вставляє його як елемент масиву `projects`.
+export default { extends: true, test: { name: 'unit' } }

package/rules/storybook/vitest-config/template/vitest.config.baseline.mjs

@@ -0,0 +1,37 @@
+import { defineConfig, mergeConfig } from 'vitest/config'
+import { storybookTest } from '@storybook/addon-vitest/vitest-plugin'
+import viteConfig from './__VITE_CONFIG_IMPORT__'
+
+// Канонічний vitest-конфіг Vue-компонентної бібліотеки у скоупі Storybook
+// (storybook.mdc, vitest-config-концерн, ADR Кластер 5): named projects
+// `unit` + `storybook`. Ізольований `vitest.stryker.config` (поруч, той
+// самий concern генерує) — той самий unit-набір БЕЗ browser-mode
+// `projects`, бо @stryker-mutator/vitest-runner крашиться на них.
+export default mergeConfig(
+  viteConfig,
+  defineConfig({
+    test: {
+      include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}'],
+      environment: 'happy-dom',
+      coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] },
+      projects: [
+        { extends: true, test: { name: 'unit' } },
+        {
+          extends: true,
+          plugins: [storybookTest({ configDir: '.storybook' })],
+          test: {
+            name: 'storybook',
+            include: ['__STORYBOOK_STORIES_GLOB__'],
+            browser: {
+              enabled: true,
+              headless: true,
+              provider: 'playwright',
+              instances: [{ browser: 'chromium' }]
+            },
+            setupFiles: ['.storybook/vitest.setup.js']
+          }
+        }
+      ]
+    }
+  })
+)

package/rules/storybook/vitest-config/template/vitest.stryker.config.baseline.mjs

@@ -0,0 +1,19 @@
+import { defineConfig, mergeConfig } from 'vitest/config'
+import viteConfig from './__VITE_CONFIG_IMPORT__'
+
+// Ізольований vitest-конфіг лише для Stryker (test.mdc, storybook.mdc, ADR
+// Кластер 5): @stryker-mutator/vitest-runner крашиться на browser-mode
+// `projects` основного vitest.config (canonical `unit`+`storybook`) — тому
+// Stryker отримує окремий конфіг з тим самим unit-набором і без
+// storybook-project/browser-mode. `stryker.config.mjs#vitest.configFile`
+// пакета має вказувати саме сюди.
+export default mergeConfig(
+  viteConfig,
+  defineConfig({
+    test: {
+      include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}'],
+      environment: 'happy-dom',
+      coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] }
+    }
+  })
+)

package/rules/storybook/vitest-config/vitest-config.mdc

@@ -0,0 +1,33 @@
+## Vitest-конфіг Storybook-пакета: named projects `unit`+`storybook` та ізоляція Stryker
+
+Джерело рішення: ADR `канон-storybook-для-vue-компонентних-бібліотек.md`, Кластер 5. Стосується лише пакетів у скоупі `storybook` (`scope/main.mjs#collectInScopeVuePackages`).
+
+### Канон `test.projects`
+
+Vue-компонентна бібліотека вже має `vitest.config.{mjs,js,ts}` за каноном `vue/testing.mdc` (`mergeConfig(viteConfig, defineConfig({ test: {...} }))` з `environment: 'happy-dom'`). Storybook-хвиля **дописує** до цього `test`-блоку named-project `unit`+`storybook` — існуючі поля (`include`, `environment`, `coverage`) лишаються без змін, `projects` — нова властивість поруч:
+
+- `{ extends: true, test: { name: 'unit' } }` — успадковує решту `test`-опцій пакета як є.
+- `storybook`-проєкт — **browser-mode, лише chromium** (`browser: { enabled: true, provider: 'playwright', instances: [{ browser: 'chromium' }] }`) і `include` на stories-glob пакета (та сама layout-детекція, що й `scaffold/main.mjs#detectStoriesGlob`, лише без префіксу `../` — vitest-конфіг лежить у корені пакета, а не в `.storybook/`).
+
+Firefox/webkit свідомо не додаються — ADR і main.mdc хвилі 1 фіксують лише chromium; розширення на інші браузери — поза обсягом цього концерну.
+
+### Чому окремий `vitest.stryker.config`
+
+`@stryker-mutator/vitest-runner` крашиться, коли конфіг, який він завантажує, містить browser-mode `projects` (сам факт присутності `storybook`-проєкту в основному vitest-конфізі ламає mutation-прогін, незалежно від того, чи Stryker фактично торкається storybook-файлів). Тому концерн генерує **сусідній** ізольований `vitest.stryker.config.<ext>` — той самий `mergeConfig(viteConfig, defineConfig({ test: {...} }))`, але **без** `projects`/browser-mode: лише unit-набір (`include`, `happy-dom`, `coverage`), на якому mutation-testing працює штатно.
+
+Концерн лише генерує/підтримує цей файл поруч з основним vitest-конфігом. Він **не** переналаштовує `stryker.config.mjs#vitest.configFile` пакета (це відповідальність `test/stryker_config`, який поки що не знає про Storybook-канон) — до появи такого зв'язку вказати `configFile: 'vitest.stryker.config.<ext>'` для пакетів у скоупі Storybook потрібно вручну.
+
+### Що перевіряє й що виправляє концерн
+
+Перевірка (`main.mjs`) — AST-аналіз (`oxc-parser`) наявного vitest-конфіга: знаходить `test`-блок (незалежно від того, чи він огорнутий у `defineConfig`/`mergeConfig`, чи це простий об'єкт), дивиться на `test.projects` і класифікує елементи за `name: 'unit'`/`name: 'storybook'`; для `storybook`-елемента перевіряє маркери `chromium`/`browser`/stories-glob текстовим пошуком. Стійка до форматування й порядку полів — не вимагає конкретного стилю запису, лише семантичну присутність маркерів.
+
+Автофікс (`fix-vitest-config.mjs`, fixability `config`) виправляє й дописує **лише відсутнє**:
+
+- Немає vitest-конфіга взагалі → створює повний файл з canonical `unit`+`storybook` projects.
+- Є test-блок без `projects` → вставляє нову property `projects: [...]` з обома записами, не займаючи `include`/`environment`/`coverage`.
+- Є `projects`, але без одного із записів → дописує відсутній запис у кінець масиву.
+- Немає `vitest.stryker.config.*` → генерує з canonical baseline.
+
+Як і в `test/stryker_config`, правка — точкові string-splice-и (insert-only) поверх існуючого тексту, а не переписаний AST-serializer, щоб не зачепити форматування й коментарі решти файлу; результат повторно парситься, і при невалідному виводі запис скасовується (fail-closed).
+
+**Свідомо без автофіксу:** `test.projects` — не статичний масив (spread/змінна), test-блок не вдалось знайти структурно, або `storybook`-запис уже присутній, але без якогось із маркерів (chromium/browser/stories-glob) — надійно виправити частковий вручну написаний запис програмно ризиковано, тож це лишається порушенням для ручного review (той самий компроміс, що й marker-порушення в `scaffold`).