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

package/rules/storybook/scaffold/template/docs/preview.md

@@ -0,0 +1,46 @@
+---
+type: JS Module
+title: preview.js
+resource: plugins/lang-js/rules/storybook/scaffold/template/preview.js
+docgen:
+  crc: 5590ef55
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.96
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл задає канонічний preview для Vue-компонентних бібліотек відповідно до `storybook.mdc` та ADR `канон-storybook-для-vue-компонентних-бібліотек`. Він існує, щоб Storybook мав відтворювану базову конфігурацію для перегляду компонентів у бібліотеках.
+
+Файл згенеровано правилом `storybook`: команда `npx @7n/rules fix storybook` відтворює його, якщо файл видалено або зламано канон.
+
+Файл є read-only: не пише у ФС чи БД.
+
+## Поведінка
+
+1. Готує Storybook як канонічне середовище для Vue-компонентних бібліотек, щоб stories працювали наближено до реального застосунку-споживача.
+
+2. Підключає базові стилі Quasar, щоб компоненти відображалися з очікуваним виглядом у Storybook.
+
+3. Вмикає перехоплення мережевих запитів у Storybook, щоб компоненти могли працювати з контрольованими mock-відповідями.
+
+4. Ігнорує очікувані same-origin GET-запити dev-сервера, зокрема для HMR і статичних файлів, щоб вони не створювали зайвого шуму.
+
+5. Позначає інші мережеві запити, які не підпадають під тихий пропуск, попередженням, а не помилкою збірки, щоб дати м’який сигнал без блокування роботи Storybook.
+
+6. Встановлює Quasar у Storybook повністю, щоб бібліотечні компоненти мали доступ до глобальних Quasar-примітивів так само, як у реальному застосунку.
+
+7. Додає Quasar-плагіни для повідомлень і діалогів, щоб stories могли відтворювати сценарії з користувацькими сповіщеннями та модальними взаємодіями.
+
+8. Налаштовує набір іконок Quasar, щоб компоненти коректно показували матеріальні SVG-іконки поза повним Quasar CLI-середовищем.
+
+9. Передає Storybook декоратор для mock service worker, щоб мережеве оточення застосовувалося до stories централізовано.
+
+10. Налаштовує автоматичне розпізнавання controls-панелі Storybook для кольорів і дат, щоб інтерфейс керування props був зручнішим для перегляду компонентів.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/scaffold/template/main.js

@@ -0,0 +1,92 @@
+/**
+ * Канонічний конфіг Storybook для Vue-компонентних бібліотек (storybook.mdc, ADR
+ * канон-storybook-для-vue-компонентних-бібліотек). Згенеровано правилом `storybook` —
+ * `npx @7n/rules fix storybook` відтворює цей файл, якщо його видалено чи зламано канон.
+ */
+import { loadConfigFromFile, mergeConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { quasar, transformAssetUrls } from '@quasar/vite-plugin'
+
+// Плагіни власного Vite-збирача Storybook — порядок ФІКСОВАНИЙ: @vitejs/plugin-vue
+// ПЕРЕД quasar() (інакше Quasar-плагін не бачить SFC, уже скомпільований plugin-vue).
+const OWN_PLUGINS = [vue({ template: { transformAssetUrls } }), quasar({ sassVariables: true })]
+
+// Плагіни файлової маршрутизації додатка-споживача — не мають сенсу в ізольованому
+// рендері одного компонента, знімаються при обʼєднанні з vite.config пакета. Обидві
+// версії layouts-пакета (старий і `-next`-форк) та pages-роутери — реальні консюмери
+// мігрують поступово, старий і новий пакет можуть співіснувати в різних vite.config.
+const INCOMPATIBLE_PLUGIN_NAMES = new Set([
+  'vite-plugin-pages',
+  'unplugin-vue-router',
+  'vite-plugin-vue-layouts',
+  'vite-plugin-vue-layouts-next'
+])
+
+/**
+ * Плагін належить до сімейства Vue SFC-трансформерів, які ДУБЛЮЮТЬ `OWN_PLUGINS`'
+ * `vue()`. Реальний стек консюмерів (components/npm/vite.config.js) обгортає
+ * `@vitejs/plugin-vue` через `VueMacros({ plugins: { vue: Vue() } })` — після
+ * резолву цей виклик повертає МАСИВ плагінів: сам `vite:vue` (той самий transform,
+ * що й `OWN_PLUGINS`' `vue()` — дублювання дає ПОДВІЙНУ SFC-трансформацію) плюс
+ * службові `vue-macros-*` (devtools/exclude-dep-optimize). Плагіни macro-синтаксису
+ * (`unplugin-vue-define-props`/`define-emit`/`reactivity-transform` тощо) — НЕ
+ * фільтруються: вони не дублюються `OWN_PLUGINS` і потрібні для macro-фіч пакета;
+ * Vite впорядковує їх через власний `enforce: 'pre'|'post'` незалежно від позиції
+ * в підсумковому масиві `plugins`, тож порядок відносно `OWN_PLUGINS` тут не важливий.
+ * @param {string | undefined} name ім'я плагіна
+ * @returns {boolean} true — плагін дублює `OWN_PLUGINS`' `vue()`
+ */
+function isVueTransformFamily(name) {
+  return typeof name === 'string' && (name.startsWith('vite:vue') || name.includes('vue-macros'))
+}
+
+/**
+ * Резолвить один запис `config.plugins` у плаский масив реальних плагінів. Vite
+ * офіційно підтримує `Plugin | Promise<Plugin> | (Plugin | Promise<Plugin>)[]`
+ * (довільна вкладеність) — `VueMacros(...)` сам повертає `Promise`, що резолвиться
+ * в масив плагінів. `loadConfigFromFile` читає файл конфіга як є й НЕ виконує це
+ * resolve/flatten (це робить лише повний `resolveConfig` пізніше у власному циклі
+ * Vite) — без ручного resolve/flatten тут фільтр порівнював би ім'я з
+ * `Promise`-об'єктом, що ще не резолвився (`undefined`), і пропускав би дублікат далі.
+ * @param {unknown} entry один елемент/Promise/масив із `config.plugins`
+ * @returns {Promise<object[]>} плаский масив плагінів після resolve
+ */
+async function resolvePluginEntry(entry) {
+  const resolved = await entry
+  if (Array.isArray(resolved)) {
+    const nested = await Promise.all(resolved.map(resolvePluginEntry))
+    return nested.flat(Infinity)
+  }
+  return resolved ? [resolved] : []
+}
+
+/** @type {import('@storybook/vue3-vite').StorybookConfig} */
+const config = {
+  stories: ['__STORYBOOK_STORIES_GLOB__'],
+  framework: {
+    name: '@storybook/vue3-vite',
+    options: {}
+  },
+  // Публічний asset для msw service worker, який ініціалізує preview.js.
+  staticDirs: ['./public'],
+  async viteFinal(storybookConfig) {
+    const loaded = await loadConfigFromFile({ command: 'serve', mode: 'development' }, undefined, process.cwd())
+    const rawPlugins = loaded?.config?.plugins ?? []
+    const resolvedNested = await Promise.all(rawPlugins.map(resolvePluginEntry))
+    const userPlugins = resolvedNested
+      .flat(Infinity)
+      .filter(Boolean)
+      .filter(p => !INCOMPATIBLE_PLUGIN_NAMES.has(p.name))
+      // vue()/quasar() пакета замінюємо власними екземплярами у фіксованому порядку вище —
+      // не дублюємо; решта плагінів пакета (auto-import, VueMacros macro-sugar тощо) лишається.
+      .filter(p => !isVueTransformFamily(p.name) && p.name !== 'quasar')
+
+    return mergeConfig(storybookConfig, {
+      resolve: loaded?.config?.resolve,
+      css: loaded?.config?.css,
+      plugins: [...OWN_PLUGINS, ...userPlugins]
+    })
+  }
+}
+
+export default config

package/rules/storybook/scaffold/template/mocks/docs/gql-sse.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: gql-sse.js
+resource: plugins/lang-js/rules/storybook/scaffold/template/mocks/gql-sse.js
+docgen:
+  crc: fe63fba2
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 100
+  issues: judge:inaccurate:0.96
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надає єдиний MSW-хелпер `sseSubscription` для мокання Apollo GraphQL-підписок у Storybook через `graphql-sse`. Кожна подія виконання підписки надсилається як окремий SSE `next`-запис у distinct-connection режимі: `event: next\ndata: <JSON>\n\n`, щоб пакети не дублювали формат цього wire-протоколу.
+
+## Поведінка
+
+1. `sseSubscription` приймає послідовність готових GraphQL execution-result повідомлень для однієї підписки.
+
+2. Для кожного повідомлення створює окрему SSE-подію типу `next`, сумісну з wire-протоколом `graphql-sse` у distinct-connection режимі.
+
+3. Повертає потік тіла відповіді, який MSW-хендлер може використати для мокання Apollo GraphQL-підписки у Storybook.
+
+4. Завершує потік після надсилання всіх повідомлень, щоб сценарій підписки мав детермінований кінець.
+
+5. Централізує формат тестових subscription-подій, щоб пакети не дублювали власну реалізацію цього протоколу.
+
+## Публічний API
+
+- sseSubscription — Формує SSE-стрім тіла відповіді для MSW-хендлера підписки graphql-sse.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/storybook/scaffold/template/mocks/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: plugins/lang-js/rules/storybook/scaffold/template/mocks
+resource: plugins/lang-js/rules/storybook/scaffold/template/mocks/
+---
+
+| Файл                     | Тип       |
+| ------------------------ | --------- |
+| [gql-sse.js](gql-sse.md) | JS Module |

package/rules/storybook/scaffold/template/mocks/gql-sse.js

@@ -0,0 +1,25 @@
+/**
+ * Канонічний MSW-хелпер для мокання Apollo GraphQL-підписок через `graphql-sse` (storybook.mdc,
+ * ADR канон-storybook-для-vue-компонентних-бібліотек, Кластер 3). Wire-протокол
+ * `graphql-sse` у distinct-connection режимі — кожна подія виконання підписки надсилається
+ * як окремий SSE `next`-запис: `event: next\ndata: <JSON>\n\n`. Одне джерело істини для цього
+ * протоколу — не переносити копію логіки в кожен пакет окремо.
+ */
+
+/**
+ * Формує SSE-стрім тіла відповіді для MSW-хендлера підписки graphql-sse.
+ * @param {Array<object>} payloads послідовність GraphQL execution-result payload-ів — кожен
+ *   елемент те, що `graphql-sse` надіслав би як окрему `next`-подію одного виконання підписки
+ * @returns {ReadableStream<Uint8Array>} SSE body-стрім для MSW-response (`HttpResponse` body)
+ */
+export function sseSubscription(payloads) {
+  const encoder = new TextEncoder()
+  return new ReadableStream({
+    start(controller) {
+      for (const payload of payloads) {
+        controller.enqueue(encoder.encode(`event: next\ndata: ${JSON.stringify(payload)}\n\n`))
+      }
+      controller.close()
+    }
+  })
+}

package/rules/storybook/scaffold/template/preview.js

@@ -0,0 +1,47 @@
+/**
+ * Канонічний preview для Vue-компонентних бібліотек (storybook.mdc, ADR
+ * канон-storybook-для-vue-компонентних-бібліотек). Згенеровано правилом `storybook` —
+ * `npx @7n/rules fix storybook` відтворює цей файл, якщо його видалено чи зламано канон.
+ */
+import { setup } from '@storybook/vue3'
+import { Dialog, iconSet as quasarBuiltinIconSet, Notify, Quasar } from 'quasar'
+import iconSet from 'quasar/icon-set/svg-material-icons'
+import { initialize, mswDecorator } from 'msw-storybook-addon'
+
+import 'quasar/dist/quasar.css'
+
+// msw-storybook-addon: перехоплює мережеві запити компонентів у Storybook. Same-origin GET
+// (Vite HMR, статичні файли dev-сервера) — очікуваний шум, мовчки пропускаємо; усе інше —
+// warn (не білд-помилка навмисно, хвиля 1 — м'який сигнал, не гейт).
+initialize({
+  onUnhandledRequest(request, print) {
+    const url = new URL(request.url)
+    if (request.method === 'GET' && url.origin === globalThis.location?.origin) return
+    print.warning()
+  }
+})
+
+setup(app => {
+  // Повний install Quasar (не окремі компоненти) — бібліотека компонентів очікує
+  // глобально зареєстровані Quasar-примітиви (QBtn, QCard тощо) так само, як у реальному
+  // додатку-споживачі.
+  app.use(Quasar, {
+    plugins: { Notify, Dialog },
+    iconSet,
+    // iconMapFn — без нього внутрішні Quasar-компоненти (напр. стрілка QSelect) не
+    // резолвлять власні вбудовані іконки поза full Quasar CLI build.
+    iconMapFn(iconName) {
+      return quasarBuiltinIconSet.iconMapFn?.(iconName)
+    }
+  })
+})
+
+/** @type {import('@storybook/vue3').Preview} */
+const preview = {
+  decorators: [mswDecorator],
+  parameters: {
+    controls: { matchers: { color: /(background|color)$/iu, date: /Date$/u } }
+  }
+}
+
+export default preview

package/rules/storybook/scope/concern.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": { "scope": "full", "glob": [".n-rules.json", ".n-cursor.json"] }
+}

package/rules/storybook/scope/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: plugins/lang-js/rules/storybook/scope
+resource: plugins/lang-js/rules/storybook/scope/
+---
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/storybook/scope/docs/main.md

@@ -0,0 +1,62 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/storybook/scope/main.mjs
+docgen:
+  crc: 04c71162
+  model: openai-codex/gpt-5.5
+  tier: cloud-avg
+  score: 90
+  issues: internal-name:isVueComponentLibraryPkg,judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл визначає, які workspace-пакети мають потрапити в скоуп Storybook: спирається на `.n-rules.json`, `.n-cursor.json` і `package.json`, враховує opt-out, поріг Vue-файлів, стандартний build та окремий прапорець для app-проєктів. Також він fail-safe перевіряє, що `storybook.optOut` не містить посилань на неіснуючі пакети.
+
+## Поведінка
+
+- `VUE_FILE_THRESHOLD` задає мінімальну кількість Vue-файлів, після якої пакет може потрапити в скоуп Storybook.
+- `readStorybookOptOut` читає з `.n-rules.json` або legacy `.n-cursor.json` перелік workspace-пакетів, які свідомо виключені зі скоупу Storybook; за відсутності або пошкодженості конфіга повертає порожній перелік.
+- `readDetectAppsFlag` читає з `.n-rules.json` або legacy `.n-cursor.json` явний прапорець включення app-проєктів у детекцію Storybook; за замовчуванням лишає їх поза скоупом.
+- `countVueFiles` рахує Vue-файли в дереві пакета з урахуванням шляхів, виключених конфігурацією і правилами ігнорування.
+- `hasStandardBuild` визначає, чи має пакет підтримуваний Vite build-конфіг у корені, потрібний для канонічного Storybook setup.
+- `isVueAppPkg` визначає, чи виглядає `package.json` як Vue app-проєкт, а не компонентна бібліотека.
+- `collectInScopeVuePackages` збирає workspace-пакети зі стандартним build, достатньою кількістю Vue-файлів і без `storybook.optOut`; app-проєкти додає лише після явного увімкнення відповідного прапорця.
+- `lint` перевіряє гігієну `storybook.optOut`: кожен запис має посилатися на наявний workspace-пакет, інакше звітує про застаріле налаштування.
+
+## Публічний API
+
+- VUE_FILE_THRESHOLD — Поріг кількості `.vue`-файлів для скоупу канону Storybook (ADR Кластер 1).
+- readStorybookOptOut — Читає `storybook.optOut` з `.n-rules.json` (fallback — legacy `.n-cursor.json`). Толерантно до
+відсутнього файлу/поля/невалідного JSON — повертає порожній масив (open-by-default, як
+`read-n-rules-config-lite.mjs`). Значення — root dir пакетів (`.` для кореня, `packages/ui` тощо),
+той самий формат, що повертає `getMonorepoPackageRootDirs`.
+- readDetectAppsFlag — Читає прапорець хвилі 2 `storybook.detectApps` з `.n-rules.json`. За замовчуванням `false` —
+детекція app-проєктів (`vue` у dependencies + `src/pages/`) лишається відкритим питанням ADR
+і не впливає на скоуп, доки консюмер-репо не увімкне прапорець явно.
+- countVueFiles — Рахує `.vue`-файли в дереві пакета (поважає `.gitignore` й `ignore` з `.n-rules.json` через
+`walkDir`/`ignorePaths` — той самий обхід, що й `vue/packages`).
+- hasStandardBuild — Чи має пакет "стандартний" build — розпізнаваний `vite.config.{js,ts,mjs}` у корені пакета.
+Канонічний `.storybook/main.js` спирається саме на цей файл (`viteFinal` мерджить його
+плагіни) — без нього автоматичний скафолд неможливий, і пакет пропускається мовчки
+(ADR Кластер 1: "skip пакетів із нестандартним build").
+- isVueAppPkg — Чи є пакет app-проєктом (не бібліотекою) для хвилі 2: `vue` у `dependencies` (не лише
+`peerDependencies`) і не бібліотека компонентів. Реалізовано зараз (щоб не переписувати
+модуль пізніше), але результат впливає на скоуп лише за прапорця `storybook.detectApps`.
+- collectInScopeVuePackages — Збирає workspace-пакети у скоупі канону Storybook хвилі 1: Vue-компонентна бібліотека
+(`vue` у `peerDependencies`, маркер `isVueComponentLibraryPkg` — той самий, що й `vue.mdc`)
+з не менше {@link VUE_FILE_THRESHOLD} `.vue`-файлами, без `storybook.optOut`, зі
+стандартним build (`vite.config.*`). Хвиля 2 (app-проєкти) додається лише за явного
+прапорця `storybook.detectApps` у `.n-rules.json`.
+- lint — Self-check конфігурації: `.n-rules.json` → `storybook.optOut` не має посилатись на
+неіснуючі workspace-пакети (застаріле налаштування — пакет перейменували/видалили, а
+opt-out лишився). Сама детекція скоупу (поріг, build, app-проєкти) — pure-функції вище,
+покриті тестами напряму; тут лише конфіг-гігієна.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/rules/storybook/scope/main.mjs

@@ -0,0 +1,202 @@
+/** @see ./docs/main.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { loadCursorIgnorePaths } from '@7n/rules/scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '@7n/rules/scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '@7n/rules/scripts/lib/workspaces.mjs'
+import { isVueComponentLibraryPkg } from '../../vue/packages/main.mjs'
+
+const CONFIG_FILE = '.n-rules.json'
+const LEGACY_CONFIG_FILE = '.n-cursor.json'
+const VITE_CONFIG_FILES = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']
+
+/** Поріг кількості `.vue`-файлів для скоупу канону Storybook (ADR Кластер 1). */
+export const VUE_FILE_THRESHOLD = 3
+
+/**
+ * @typedef {object} InScopePackage
+ * @property {string} rootDir відносний (posix) корінь пакета, `.` для кореня монорепо
+ * @property {string} absDir абсолютний шлях кореня пакета
+ * @property {Record<string, unknown>} pkg розпарсений `package.json` пакета
+ * @property {number} vueFileCount кількість знайдених `.vue`-файлів
+ */
+
+/**
+ * Читає `storybook.optOut` з `.n-rules.json` (fallback — legacy `.n-cursor.json`). Толерантно до
+ * відсутнього файлу/поля/невалідного JSON — повертає порожній масив (open-by-default, як
+ * `read-n-rules-config-lite.mjs`). Значення — root dir пакетів (`.` для кореня, `packages/ui` тощо),
+ * той самий формат, що повертає `getMonorepoPackageRootDirs`.
+ * @param {string} cwd абсолютний корінь репозиторію
+ * @returns {Promise<string[]>} перелік opt-out root dir-ів
+ */
+export async function readStorybookOptOut(cwd) {
+  let file = join(cwd, CONFIG_FILE)
+  if (!existsSync(file)) file = join(cwd, LEGACY_CONFIG_FILE)
+  if (!existsSync(file)) return []
+  let raw
+  try {
+    raw = JSON.parse(await readFile(file, 'utf8'))
+  } catch {
+    return []
+  }
+  const list = raw?.storybook?.optOut
+  if (!Array.isArray(list)) return []
+  return list.filter(v => typeof v === 'string' && v.trim().length > 0)
+}
+
+/**
+ * Читає прапорець хвилі 2 `storybook.detectApps` з `.n-rules.json`. За замовчуванням `false` —
+ * детекція app-проєктів (`vue` у dependencies + `src/pages/`) лишається відкритим питанням ADR
+ * і не впливає на скоуп, доки консюмер-репо не увімкне прапорець явно.
+ * @param {string} cwd абсолютний корінь репозиторію
+ * @returns {Promise<boolean>} true, якщо app-проєкти теж треба зібрати у скоуп
+ */
+export async function readDetectAppsFlag(cwd) {
+  let file = join(cwd, CONFIG_FILE)
+  if (!existsSync(file)) file = join(cwd, LEGACY_CONFIG_FILE)
+  if (!existsSync(file)) return false
+  let raw
+  try {
+    raw = JSON.parse(await readFile(file, 'utf8'))
+  } catch {
+    return false
+  }
+  return raw?.storybook?.detectApps === true
+}
+
+/**
+ * Рахує `.vue`-файли в дереві пакета (поважає `.gitignore` й `ignore` з `.n-rules.json` через
+ * `walkDir`/`ignorePaths` — той самий обхід, що й `vue/packages`).
+ * @param {string} absPkgDir абсолютний шлях кореня пакета
+ * @param {string[]} ignorePaths абсолютні шляхи, повністю виключені з обходу
+ * @returns {Promise<number>} кількість `.vue`-файлів
+ */
+export async function countVueFiles(absPkgDir, ignorePaths) {
+  let count = 0
+  await walkDir(
+    absPkgDir,
+    absPath => {
+      if (absPath.endsWith('.vue')) count += 1
+    },
+    ignorePaths
+  )
+  return count
+}
+
+/**
+ * Чи має пакет "стандартний" build — розпізнаваний `vite.config.{js,ts,mjs}` у корені пакета.
+ * Канонічний `.storybook/main.js` спирається саме на цей файл (`viteFinal` мерджить його
+ * плагіни) — без нього автоматичний скафолд неможливий, і пакет пропускається мовчки
+ * (ADR Кластер 1: "skip пакетів із нестандартним build").
+ * @param {string} absPkgDir абсолютний шлях кореня пакета
+ * @returns {boolean} true, якщо знайдено відомий `vite.config.*`
+ */
+export function hasStandardBuild(absPkgDir) {
+  return VITE_CONFIG_FILES.some(f => existsSync(join(absPkgDir, f)))
+}
+
+/**
+ * Чи є пакет app-проєктом (не бібліотекою) для хвилі 2: `vue` у `dependencies` (не лише
+ * `peerDependencies`) і не бібліотека компонентів. Реалізовано зараз (щоб не переписувати
+ * модуль пізніше), але результат впливає на скоуп лише за прапорця `storybook.detectApps`.
+ * @param {{ dependencies?: Record<string, unknown>, peerDependencies?: Record<string, unknown> }} pkg розпарсений package.json
+ * @returns {boolean} true — app-проєкт (кандидат хвилі 2)
+ */
+export function isVueAppPkg(pkg) {
+  return Boolean(pkg?.dependencies?.vue) && !isVueComponentLibraryPkg(pkg)
+}
+
+/**
+ * Перевіряє один workspace-корінь на відповідність предикату скоупу (бібліотека чи app) і,
+ * за успіху, повертає його `InScopePackage`-запис.
+ * @param {string} rootDir відносний корінь пакета
+ * @param {string} cwd абсолютний корінь репозиторію
+ * @param {(pkg: Record<string, unknown>) => boolean} matches предикат скоупу (бібліотека/app)
+ * @param {string[]} ignorePaths абсолютні шляхи, повністю виключені з обходу
+ * @returns {Promise<InScopePackage|null>} запис пакета або `null`, якщо поза скоупом
+ */
+async function evaluateCandidate(rootDir, cwd, matches, ignorePaths) {
+  const absDir = rootDir === '.' ? cwd : join(cwd, rootDir)
+  const pkgPath = join(absDir, 'package.json')
+  if (!existsSync(pkgPath)) return null
+  let pkg
+  try {
+    pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  } catch {
+    return null
+  }
+  if (!matches(pkg)) return null
+  if (!hasStandardBuild(absDir)) return null
+  const vueFileCount = await countVueFiles(absDir, ignorePaths)
+  if (vueFileCount < VUE_FILE_THRESHOLD) return null
+  return { rootDir, absDir, pkg, vueFileCount }
+}
+
+/**
+ * Збирає workspace-пакети у скоупі канону Storybook хвилі 1: Vue-компонентна бібліотека
+ * (`vue` у `peerDependencies`, маркер `isVueComponentLibraryPkg` — той самий, що й `vue.mdc`)
+ * з не менше {@link VUE_FILE_THRESHOLD} `.vue`-файлами, без `storybook.optOut`, зі
+ * стандартним build (`vite.config.*`). Хвиля 2 (app-проєкти) додається лише за явного
+ * прапорця `storybook.detectApps` у `.n-rules.json`.
+ * @param {string} cwd абсолютний корінь репозиторію
+ * @returns {Promise<InScopePackage[]>} пакети у скоупі
+ */
+export async function collectInScopeVuePackages(cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+  const optOut = new Set(await readStorybookOptOut(cwd))
+  const candidateRoots = roots.filter(r => !optOut.has(r))
+
+  /** @type {InScopePackage[]} */
+  const result = []
+  for (const rootDir of candidateRoots) {
+    const found = await evaluateCandidate(rootDir, cwd, isVueComponentLibraryPkg, ignorePaths)
+    if (found) result.push(found)
+  }
+
+  if (await readDetectAppsFlag(cwd)) {
+    for (const rootDir of candidateRoots) {
+      if (result.some(r => r.rootDir === rootDir)) continue
+      const absDir = rootDir === '.' ? cwd : join(cwd, rootDir)
+      if (!existsSync(join(absDir, 'src/pages'))) continue
+      const found = await evaluateCandidate(rootDir, cwd, isVueAppPkg, ignorePaths)
+      if (found) result.push(found)
+    }
+  }
+
+  return result
+}
+
+/**
+ * Self-check конфігурації: `.n-rules.json` → `storybook.optOut` не має посилатись на
+ * неіснуючі workspace-пакети (застаріле налаштування — пакет перейменували/видалили, а
+ * opt-out лишився). Сама детекція скоупу (поріг, build, app-проєкти) — pure-функції вище,
+ * покриті тестами напряму; тут лише конфіг-гігієна.
+ * @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 cwd = ctx.cwd
+
+  const optOut = await readStorybookOptOut(cwd)
+  if (optOut.length === 0) {
+    reporter.pass('storybook: storybook.optOut порожній або не заданий')
+    return reporter.result()
+  }
+
+  const roots = new Set(await getMonorepoPackageRootDirs(cwd))
+  for (const rootDir of optOut) {
+    if (!roots.has(rootDir)) {
+      reporter.fail(
+        `.n-rules.json storybook.optOut містить '${rootDir}' — такого workspace-пакета немає (застаріле opt-out, storybook.mdc)`,
+        'stale-opt-out'
+      )
+    }
+  }
+
+  return reporter.result()
+}

package/rules/storybook/vitest-config/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full",
+    "glob": ["package.json", "**/*.vue", ".storybook/**", "vitest.config.*", "vitest.stryker.config.*"]
+  }
+}

package/rules/storybook/vitest-config/docs/fix-vitest-config.md

@@ -0,0 +1,37 @@
+---
+type: JS Module
+title: fix-vitest-config.mjs
+resource: plugins/lang-js/rules/storybook/vitest-config/fix-vitest-config.mjs
+docgen:
+  crc: 35b10da8
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл детерміновано приводить `vitest.config.mjs` у Vue-компонентних пакетах із Storybook до канону `test.projects`: окремі проєкти `unit` і `storybook`, а browser-mode обмежує лише `chromium`. Для Stryker він генерує ізольований `vitest.stryker.config.*` у межах того ж пакета, згідно з підходом з `ADR Кластер 5`.
+
+Для вже наявного `vitest.config.mjs` зміни вносяться точковими `string-splice`-ами лише на вставку, щоб не переписувати решту форматування й коментарів; після цього конфіг повторно парситься, і зміни відкочуються, якщо результат невалідний. Логіка побудови покладена на `buildFreshVitestConfig`, `buildStrykerConfig` і `patterns`, а читання й аналіз виконуються через `oxc-parser`. Детектор `main.mjs` працює read-only, тоді як запис зосереджений у `fix-stryker_config.mjs`.
+
+## Поведінка
+
+- `buildFreshVitestConfig` — створює новий `vitest.config.mjs` для пакета з канонічним `test.projects` для `unit` і `storybook`, підставляє шлях до локального Vite-конфіга та сторінковий glob для Storybook.
+- `buildStrykerConfig` — генерує ізольований `vitest.stryker.config.*` на основі canonical baseline-шаблону для того самого пакета, підставляючи шлях до локального Vite-конфіга.
+- `patterns` — описує autofix-сценарій, який реагує на відсутній або неканонічний vitest-конфіг, доповнює наявний файл без переписування зайвого форматування та створює `vitest.stryker.config.*` у відповідному package root.
+
+## Публічний API
+
+- buildFreshVitestConfig — Генерує повністю новий `vitest.config.mjs` (unit+storybook projects) для
+пакета без жодного наявного vitest-конфіга. Експортовано — переюз у
+`adopt/main.mjs` (генерація лише для повністю відсутніх файлів).
+- buildStrykerConfig — Генерує ізольований `vitest.stryker.config.*` (той самий basename/ext що
+й основний vitest-конфіг пакета) з canonical baseline-шаблону. Експортовано —
+переюз у `adopt/main.mjs`.
+- patterns — повертає набір шаблонів, які використовуються для зіставлення й обробки відповідних випадків у коді
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

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

@@ -0,0 +1,10 @@
+---
+type: Directory Index
+title: plugins/lang-js/rules/storybook/vitest-config
+resource: plugins/lang-js/rules/storybook/vitest-config/
+---
+
+| Файл                                          | Тип       |
+| --------------------------------------------- | --------- |
+| [fix-vitest-config.mjs](fix-vitest-config.md) | JS Module |
+| [main.mjs](main.md)                           | JS Module |