@7n/rules-lang-js 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.13.0] - 2026-07-21
+
+### Added
+
+- storybook: новий concern `ci` (ADR Кластер 5, CI-частина) — канонічний composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише chromium) і `.github/workflows/lint-storybook.yml` (швидкий PR-прогін `vitest --project=storybook`), гейтований `requires.capability: ci:github`
+
+### Fixed
+
+- storybook: viteFinal-фільтр стійкий до VueMacros-стека (Promise/масив-резолв, сімейний фільтр vite:*/vue-macros), vitest@^4 provider-factory (@vitest/browser-playwright) замість застарілого рядка `'playwright'`, flat-root layout у detectStoriesGlob (components без src/), точковий alias-мок одного модуля в mocking.mdc, і STORIES_RE false positive на `storybookTest({ configDir })` без явного include — усе за результатами пілота adopt-діагностики на nitra/components. Заодно governance package_json.rego: allowlist доповнено `@vitest/browser-playwright`.
+- canon Storybook: viteConfigPath-обхід (empty-vite.config.js), валідний iconSet-імпорт, mswLoader замість mswDecorator, повний .storybook/**-glob у CI/lint, вирівняні governance-піни (storybook ^10.5.3, root Vite build-tooling deps), knip-виключення для .storybook-артефактів
+- storybook: скоуп-детекція більше не вимагає vite.config.* пакета (source-only Vue-бібліотеки, tauri-components/npm rollout) — hasStandardBuild прибрано, vitest-config fix толерує відсутній vite.config
+
 ## [0.12.0] - 2026-07-21
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Плагін @7n/rules: JS/npm/bun-екосистема — lint-правила (js/bun/vue/js-run/npm-module/db), taze-провайдер (package.json, bunx taze) і doc-files-екстрактори (oxc AST)",
   "keywords": [
     "javascript",

package/rules/storybook/main.mdc

@@ -15,13 +15,17 @@ alwaysApply: false
 
 ## Скоуп
 
-Тільки Vue-компонентні бібліотеки — пакет із `vue` у `peerDependencies` (маркер `isVueComponentLibraryPkg`, той самий що й у `vue.mdc`, не дублюється) і не менше **3** `.vue`-файлів. Поріг відсікає пакети з одним-двома допоміжними компонентами, для яких повний Storybook-скафолд — зайві накладні витрати. Пакети без розпізнаваного `vite.config.{js,ts,mjs}` (нестандартний build) пропускаються мовчки — автоматичний скафолд спирається на `viteConfigPath` пакета.
+Тільки Vue-компонентні бібліотеки — пакет із `vue` у `peerDependencies` (маркер `isVueComponentLibraryPkg`, той самий що й у `vue.mdc`, не дублюється) і не менше **3** `.vue`-файлів. Поріг відсікає пакети з одним-двома допоміжними компонентами, для яких повний Storybook-скафолд — зайві накладні витрати.
+
+**Наявність `vite.config.{js,ts,mjs}` пакета — НЕ умова скоупу** (хвиля 1.4, фікс за результатами rollout-у на `tauri-components/npm`). До хвилі 1.4 тут була функція `hasStandardBuild` — вона мовчки виключала зі скоупу пакети без власного `vite.config.*` ("skip нестандартного build", ADR Кластер 1). На практиці це виключало легітимні source-only Vue-бібліотеки (peerDependencies.vue + достатньо `.vue`-файлів, просто без окремого Vite-білду) — а канонічний скафолд для них працює без жодних змін: `viteConfigPath` у `.storybook/main.js` завжди вказує на власний `empty-vite.config.js` скафолда (не на `vite.config.*` пакета), а `viteFinal` викликає `loadConfigFromFile`, який толерує відсутній конфіг пакета (повертає `null`, `viteFinal` мерджить порожній список плагінів). Емпірично перевірено на `tauri-components/npm`: `storybook build` + повний прогін тестів у реальному chromium — без жодного `vite.config.*` у пакеті. `hasStandardBuild` прибрано з `scope/main.mjs` разом з усіма згадками; для пакета, де канонічний скафолд дійсно не підходить (справжня екзотика білду — не сам факт відсутності Vite-конфіга), власник додає його у `storybook.optOut` вручну — окрема автоматична детекція "нестандартного build" дублювала б наявний opt-out і давала б хибні спрацювання.
 
 Опційно (вимкнено за замовчуванням) — app-проєкти (`vue` у `dependencies`, не бібліотека, + `src/pages/`). Детекція реалізована в `scope/main.mjs`, але не викликається доки в `.n-rules.json` не задано прапорець хвилі 2 — рішення розширювати скоуп на app-проєкти залишається відкритим питанням ADR.
 
 **Opt-out:** окремий пакет можна виключити зі скоупу через `.n-rules.json` → `storybook.optOut: string[]` (root dir пакета, той самий формат що й у виводі workspace-роутингу — `.` для кореня, `packages/ui` тощо). Виняток — намір, не помилка: якщо в `optOut` вказано неіснуючий workspace-пакет, `scope`-концерн репортує це як застаріле налаштування.
 
-Логіка детекції (поріг, opt-out, нестандартний build, app-проєкти) — у `scope/main.mjs`, не дублюється тут.
+Логіка детекції (поріг, opt-out, app-проєкти) — у `scope/main.mjs`, не дублюється тут.
+
+`vitest-config`-концерн (Кластер 5, нижче) генерує baseline `vitest.config.mjs`/`vitest.stryker.config.mjs` з `import viteConfig from './<vite.config.*>'` — для source-only пакета без `vite.config.*` це зламало б import неіснуючого файлу; `vitest-config/fix-vitest-config.mjs#applyViteConfigImport` підставляє замість import-у порожній локальний `const viteConfig = {}` (еквівалент для `mergeConfig`), решта baseline-структури не змінюється.
 
 ## Канонічний скафолд
 
@@ -52,6 +56,8 @@ alwaysApply: false
 
 (домердж у наявний масив `ignore`, не заміна). Звірено з реальним `knip.json` пілотного консюмера.
 
+Симетрична ручна правка для `oxfmt`: `.storybook/public/mockServiceWorker.js` (згенерований пакетом `msw` файл, `npx msw init` — той самий service worker, на який вказує `staticDirs` у `main.js`) слід додати в `.oxfmtrc.json` консюмера в `ignorePatterns: ["**/mockServiceWorker.js"]` — реформатування псує pristine-стан цього файлу (той самий принцип, що й `**/adr/**`-виняток `oxfmt`/`cspell`, `docs/adr/adr-виключення-oxfmt-cspell.md`).
+
 ## Vitest-конфіг і Stryker-ізоляція (Кластер 5)
 
 Канонічний `test.projects` (`unit`+`storybook`, browser-mode лише chromium) і ізольований `vitest.stryker.config` (той самий unit-набір, без browser-mode — `@stryker-mutator/vitest-runner` крашиться на browser-mode `projects`) — `vitest-config/main.mjs` (перевірка, AST через `oxc-parser`) і `vitest-config/fix-vitest-config.mjs` (точкові insert-only правки наявного конфіга, fixability: `config`). Деталі канону, чому саме chromium і межі автофіксу — `vitest-config/vitest-config.mdc`, не дублюється тут.

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

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/storybook/scope/main.mjs
 docgen:
-  crc: 04c71162
+  crc: e6dab761
   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

package/rules/storybook/scope/main.mjs

@@ -11,7 +11,6 @@ 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
@@ -86,18 +85,6 @@ export async function countVueFiles(absPkgDir, 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`) і не бібліотека компонентів. Реалізовано зараз (щоб не переписувати
@@ -129,7 +116,6 @@ async function evaluateCandidate(rootDir, cwd, matches, ignorePaths) {
     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 }
@@ -138,8 +124,11 @@ async function evaluateCandidate(rootDir, cwd, matches, ignorePaths) {
 /**
  * Збирає workspace-пакети у скоупі канону Storybook хвилі 1: Vue-компонентна бібліотека
  * (`vue` у `peerDependencies`, маркер `isVueComponentLibraryPkg` — той самий, що й `vue.mdc`)
- * з не менше {@link VUE_FILE_THRESHOLD} `.vue`-файлами, без `storybook.optOut`, зі
- * стандартним build (`vite.config.*`). Хвиля 2 (app-проєкти) додається лише за явного
+ * з не менше {@link VUE_FILE_THRESHOLD} `.vue`-файлами, без `storybook.optOut`. Наявність
+ * `vite.config.*` пакета — НЕ умова скоупу (rollout tauri-components/npm, хвиля 1.4):
+ * канонічний скафолд (`viteConfigPath` на `empty-vite.config.js`, `loadConfigFromFile`
+ * толерує відсутній конфіг) працює й для source-only Vue-бібліотек без власного Vite-білду
+ * — див. секцію "Скоуп" у `main.mdc`. Хвиля 2 (app-проєкти) додається лише за явного
  * прапорця `storybook.detectApps` у `.n-rules.json`.
  * @param {string} cwd абсолютний корінь репозиторію
  * @returns {Promise<InScopePackage[]>} пакети у скоупі
@@ -173,7 +162,7 @@ export async function collectInScopeVuePackages(cwd) {
 /**
  * Self-check конфігурації: `.n-rules.json` → `storybook.optOut` не має посилатись на
  * неіснуючі workspace-пакети (застаріле налаштування — пакет перейменували/видалили, а
- * opt-out лишився). Сама детекція скоупу (поріг, build, app-проєкти) — pure-функції вище,
+ * opt-out лишився). Сама детекція скоупу (поріг, 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>} результат лінту

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

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-vitest-config.mjs
 resource: plugins/lang-js/rules/storybook/vitest-config/fix-vitest-config.mjs
 docgen:
-  crc: 35b10da8
+  crc: f00f073b
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/storybook/vitest-config/main.mjs
 docgen:
-  crc: 543716c9
+  crc: ae5f59a0
   model: openai-codex/gpt-5.4-mini
   score: 85
   issues: internal-name:detectStoriesGlob,anchor-miss:(vitest-config.mdc),judge:inaccurate:0.99

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

@@ -38,6 +38,10 @@ const HERE = dirname(fileURLToPath(import.meta.url))
 const TEMPLATE_DIR = join(HERE, 'template')
 const STORIES_GLOB_TOKEN = '__STORYBOOK_STORIES_GLOB__'
 const VITE_CONFIG_IMPORT_TOKEN = '__VITE_CONFIG_IMPORT__'
+// Рядок import-у як він буквально лежить у baseline-шаблонах (до token-підстановки) —
+// для source-only пакета (без власного vite.config.*, хвиля 1.4) замінюється на порожній
+// placeholder, а не на import неіснуючого файлу.
+const VITE_CONFIG_IMPORT_LINE = `import viteConfig from './${VITE_CONFIG_IMPORT_TOKEN}'\n`
 
 const TRIGGER_REASONS = new Set([
   REASON_VITEST_CONFIG_MISSING,
@@ -254,6 +258,22 @@ async function computeVitestConfigAugment(absPkgDir, vitestConfigPath) {
   return next === src ? null : next
 }
 
+/**
+ * Підставляє в baseline-шаблон або import наявного `vite.config.*` пакета (звичайний
+ * шлях), або — для source-only пакета без жодного `vite.config.*` (хвиля 1.4,
+ * `resolveViteConfigName` повертає `null`) — порожній локальний placeholder замість
+ * import-у неіснуючого файлу. `mergeConfig({}, defineConfig({...}))` еквівалентний
+ * самому `defineConfig({...})`, тож решта структури шаблону (сама `mergeConfig`-обгортка)
+ * лишається незмінною — не потрібен окремий "плоский" варіант шаблону.
+ * @param {string} template вихідний текст baseline-шаблону (з токеном `__VITE_CONFIG_IMPORT__`)
+ * @param {string | null} viteConfigName ім'я `vite.config.*` пакета або `null`
+ * @returns {string} текст з підставленим import-ом чи placeholder-ом
+ */
+function applyViteConfigImport(template, viteConfigName) {
+  if (viteConfigName) return template.split(VITE_CONFIG_IMPORT_TOKEN).join(viteConfigName)
+  return template.replace(VITE_CONFIG_IMPORT_LINE, 'const viteConfig = {}\n')
+}
+
 /**
  * Генерує повністю новий `vitest.config.mjs` (unit+storybook projects) для
  * пакета без жодного наявного vitest-конфіга. Експортовано — переюз у
@@ -265,11 +285,8 @@ export async function buildFreshVitestConfig(absPkgDir) {
   const template = await readFile(join(TEMPLATE_DIR, 'vitest.config.baseline.mjs'), 'utf8')
   const storiesGlob = storiesGlobForVitestConfig(absPkgDir)
   const viteConfigName = resolveViteConfigName(absPkgDir)
-  const content = template
-    .split(STORIES_GLOB_TOKEN)
-    .join(storiesGlob)
-    .split(VITE_CONFIG_IMPORT_TOKEN)
-    .join(viteConfigName)
+  const withStories = template.split(STORIES_GLOB_TOKEN).join(storiesGlob)
+  const content = applyViteConfigImport(withStories, viteConfigName)
   return { path: join(absPkgDir, 'vitest.config.mjs'), content }
 }
 
@@ -283,7 +300,7 @@ export async function buildFreshVitestConfig(absPkgDir) {
 export async function buildStrykerConfig(absPkgDir) {
   const template = await readFile(join(TEMPLATE_DIR, 'vitest.stryker.config.baseline.mjs'), 'utf8')
   const viteConfigName = resolveViteConfigName(absPkgDir)
-  return template.split(VITE_CONFIG_IMPORT_TOKEN).join(viteConfigName)
+  return applyViteConfigImport(template, viteConfigName)
 }
 
 /**

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

@@ -66,12 +66,16 @@ export function resolveVitestConfigPath(absPkgDir) {
 /**
  * Резолвить ім'я `vite.config.*` пакета для import-шляху в baseline-шаблонах
  * (той самий файл, що й `viteFinal` у `.storybook/main.js`). Пакет у скоупі
- * гарантовано має один із них (`scope/main.mjs#hasStandardBuild`).
+ * Storybook НЕ гарантовано має власний `vite.config.*` (хвиля 1.4 — вимогу
+ * `hasStandardBuild` прибрано зі скоуп-детекції, `scope/main.mjs`) — source-only
+ * Vue-бібліотека (напр. tauri-components/npm) законно потрапляє у скоуп без
+ * жодного `vite.config.*`. `null` — сигнал викликачу (`fix-vitest-config.mjs`)
+ * підставити порожній placeholder замість імпорту неіснуючого файлу.
  * @param {string} absPkgDir абсолютний шлях кореня пакета
- * @returns {string} ім'я файлу vite-конфіга (дефолт `vite.config.js`)
+ * @returns {string | null} ім'я файлу vite-конфіга або `null`, якщо жодного немає
  */
 export function resolveViteConfigName(absPkgDir) {
-  return VITE_CONFIG_NAMES.find(n => existsSync(join(absPkgDir, n))) ?? 'vite.config.js'
+  return VITE_CONFIG_NAMES.find(n => existsSync(join(absPkgDir, n))) ?? null
 }
 
 /**