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

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.12.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-артефактів
+
 ## [0.11.0] - 2026-07-21
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.11.0",
+  "version": "0.12.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/bun/package_json/package_json.rego

@@ -71,9 +71,15 @@ deny contains msg if {
 # окремо для змістовних E2E-сценаріїв (n-vue.mdc).
 # @storybook/addon-vitest — постачає `storybookTest` для vitest-плагіна в канонічному
 # vitest.config named-проекту "storybook" (той самий канон Storybook кластер 5); версія
-# з лінійки Storybook 9.x (узгоджена з `storybook`@9.1.10, запіненим у
+# з лінійки Storybook 10.x (узгоджена з `storybook`@^10.5.3, запіненим у
 # npm_package_json.rego) — allowlist тут за іменем, точний пінінг версії root-tooling
 # не робимо (на відміну від Storybook-identity-пакетів у npm/package.json).
+# @storybook/builder-vite/@vitejs/plugin-vue/@quasar/vite-plugin — root-only build-tooling
+# для канонічного `.storybook/main.js` (storybook.mdc scaffold: `core.builder`,
+# `viteFinal`-плагіни `vue()`/`quasar()`); @quasar/extras — постачає material-icons
+# CSS/fallback-набір для `.storybook/preview.js` (iconMapFn). Усі чотири звірено з
+# реальним root package.json пілотного консюмера (components) — раніше були відсутні
+# в allowlist, хоча канонічний скафолд Storybook уже на них покладався (реальний gap).
 allowed_root_test_deps := {
 	"vitest",
 	"@vitest/coverage-v8",
@@ -84,6 +90,10 @@ allowed_root_test_deps := {
 	"@playwright/test",
 	"playwright",
 	"@storybook/addon-vitest",
+	"@storybook/builder-vite",
+	"@vitejs/plugin-vue",
+	"@quasar/vite-plugin",
+	"@quasar/extras",
 	"@7n/test",
 }
 

package/rules/npm-module/npm_package_json/npm_package_json.mdc

@@ -62,7 +62,7 @@ FS-перевірки (наявність файлу зі шляху `types`, с
 ✓ Правильно — канонічний Storybook-devDep із зафіксованою версією (канон Storybook):
 
 ```json
-{ "devDependencies": { "storybook": "9.1.10" } }
+{ "devDependencies": { "storybook": "^10.5.3" } }
 ```
 
 ✗ Неправильно — Storybook-devDep присутній, але версія не збігається з каноном:

package/rules/npm-module/npm_package_json/npm_package_json.rego

@@ -41,12 +41,21 @@ storybook_version_template := concat(" ", [
 ])
 
 # Канонічні Storybook-devDeps (isStorybookRoot()-маркери, канон Storybook кластер 7):
-# зафіксована точна версія — єдина дозволена версія для кожного пакета. Оновлення —
-# ручна правка цієї map.
+# зафіксований точний РЯДОК версії, як він має бути записаний у package.json (включно з
+# `^`, якщо канон його використовує) — єдине дозволене значення для кожного пакета.
+# Оновлення — ручна правка цієї map, після емпіричної верифікації (звірка з реальним
+# консюмером, що пройшов повний прогін storybook build + тести на цих версіях).
+#
+# storybook/@storybook/vue3-vite піднято з 9.1.10 (exact) на ^10.5.3 — пілотний консюмер
+# (components/npm/package.json) реально пройшов storybook build + 58/58 тестів саме на
+# 10.5.3 з caret-діапазоном, а не на exact-пінованій 9.1.10 (яка на практиці ніде вже не
+# встановлюється). @storybook/vue3 — не окремий devDep пілота (транзитивна залежність
+# @storybook/vue3-vite), версія вирівняна до тієї самої лінійки про запас (allowlist за
+# іменем, presence не обов'язковий).
 storybook_canon_dev_deps := {
-	"storybook": "9.1.10",
-	"@storybook/vue3-vite": "9.1.10",
-	"@storybook/vue3": "9.1.10",
+	"storybook": "^10.5.3",
+	"@storybook/vue3-vite": "^10.5.3",
+	"@storybook/vue3": "^10.5.3",
 	"msw": "2.11.3",
 	"msw-storybook-addon": "2.0.5",
 }

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/storybook/adopt/main.mjs
 docgen:
-  crc: c8e6e421
+  crc: 986ffd02
   model: openai-codex/gpt-5.4-mini
   score: 90
   issues: anchor-miss:(mocking.mdc),anchor-miss:(vitest-config.mdc),judge:inaccurate:0.99

package/rules/storybook/adopt/main.mjs

@@ -2,8 +2,8 @@
  * Adopt-режим канону Storybook (ADR канон-storybook-для-vue-компонентних-бібліотек,
  * Кластер 8; main.mdc). Для пакетів, де ВЖЕ є ручний `.storybook/`, що не збігається з
  * каноном, — діагностика diff по секціях проти канонічних `template/` (main.js,
- * preview.js, mocks/gql-sse.js, package.json#scripts.storybook, vitest test.projects,
- * vitest.stryker.config), БЕЗ сліпого перезапису розбіжних файлів. Автофікс
+ * preview.js, empty-vite.config.js, mocks/gql-sse.js, package.json#scripts.storybook,
+ * vitest test.projects, vitest.stryker.config), БЕЗ сліпого перезапису розбіжних файлів. Автофікс
  * (`--fix-missing`) — лише для секцій, яких немає ВЗАГАЛІ (той самий рендер, що й
  * T0-фікс concern-ів `scaffold`/`vitest-config` — переюз, не дублювання шаблонування).
  *
@@ -21,7 +21,7 @@ import { isRunAsCli } from '@7n/rules/scripts/cli-entry.mjs'
 
 import { collectInScopeVuePackages } from '../scope/main.mjs'
 import { MAIN_JS_MARKERS, missingMarkers, PREVIEW_JS_MARKERS, STORYBOOK_SCRIPT } from '../scaffold/main.mjs'
-import { renderMainJs, renderMocksGqlSse, renderPreviewJs } from '../scaffold/fix-scaffold.mjs'
+import { renderEmptyViteConfig, renderMainJs, renderMocksGqlSse, renderPreviewJs } from '../scaffold/fix-scaffold.mjs'
 import { buildFreshVitestConfig, buildStrykerConfig } from '../vitest-config/fix-vitest-config.mjs'
 import {
   BROWSER_KEY_RE,
@@ -43,6 +43,7 @@ export const STATUS = Object.freeze({ MATCH: 'match', DIFFER: 'differ', MISSING:
 export const SECTION = Object.freeze({
   MAIN_JS: 'main.js',
   PREVIEW_JS: 'preview.js',
+  EMPTY_VITE_CONFIG: 'empty-vite.config.js',
   MOCKS_GQL_SSE: 'mocks/gql-sse.js',
   PACKAGE_SCRIPT: 'package.json#scripts.storybook',
   VITEST_PROJECTS: 'vitest test.projects (unit+storybook)',
@@ -104,6 +105,30 @@ function diagnoseMocksSection(entry) {
   }
 }
 
+/**
+ * Діагностика `.storybook/empty-vite.config.js` — verbatim-порівняння з канонічним
+ * стенд-ін файлом (не залежить від пакета, як і `mocks/gql-sse.js`): `main.js` посилається
+ * на нього напряму через `core.builder.options.viteConfigPath`, тому розбіжність тут
+ * ламає обхід autodiscovery `@storybook/builder-vite`, навіть якщо `main.js` канонічний.
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @returns {{ name: string, file: string, status: string, detail?: string }} секція діагностики
+ */
+function diagnoseEmptyViteConfigSection(entry) {
+  const relPath = '.storybook/empty-vite.config.js'
+  const file = relFileFor(entry, relPath)
+  const abs = join(entry.absDir, relPath)
+  if (!existsSync(abs)) return { name: SECTION.EMPTY_VITE_CONFIG, file, status: STATUS.MISSING }
+  const actual = readFileSync(abs, 'utf8')
+  const canonical = renderEmptyViteConfig()
+  if (actual === canonical) return { name: SECTION.EMPTY_VITE_CONFIG, file, status: STATUS.MATCH }
+  return {
+    name: SECTION.EMPTY_VITE_CONFIG,
+    file,
+    status: STATUS.DIFFER,
+    detail: 'вміст відрізняється від канонічного стенд-іна (storybook.mdc) — має лишатись порожнім defineConfig({})'
+  }
+}
+
 /**
  * Діагностика `package.json#scripts.storybook`.
  * @param {{ pkg: Record<string, unknown>, rootDir: string }} entry запис пакета
@@ -219,6 +244,7 @@ export async function diagnosePackage(entry) {
   const sections = [
     diagnoseMarkerFile(entry, '.storybook/main.js', SECTION.MAIN_JS, MAIN_JS_MARKERS),
     diagnoseMarkerFile(entry, '.storybook/preview.js', SECTION.PREVIEW_JS, PREVIEW_JS_MARKERS),
+    diagnoseEmptyViteConfigSection(entry),
     diagnoseMocksSection(entry),
     diagnoseScriptSection(entry),
     diagnoseVitestProjectsSection(entry),
@@ -255,6 +281,9 @@ export async function fixMissingSections(entry, sections) {
   if (byName.get(SECTION.PREVIEW_JS)?.status === STATUS.MISSING) {
     writeFileEnsureDir(join(entry.absDir, '.storybook/preview.js'), renderPreviewJs())
   }
+  if (byName.get(SECTION.EMPTY_VITE_CONFIG)?.status === STATUS.MISSING) {
+    writeFileEnsureDir(join(entry.absDir, '.storybook/empty-vite.config.js'), renderEmptyViteConfig())
+  }
   if (byName.get(SECTION.MOCKS_GQL_SSE)?.status === STATUS.MISSING) {
     writeFileEnsureDir(join(entry.absDir, '.storybook/mocks/gql-sse.js'), renderMocksGqlSse())
   }

package/rules/storybook/ci/concern.json

@@ -5,9 +5,9 @@
   "lint": {
     "scope": "full",
     "glob": [
-      "package.json",
+      "**/package.json",
       "**/*.vue",
-      ".storybook/**",
+      "**/.storybook/**",
       ".github/actions/setup-playwright-chromium/action.yml",
       ".github/workflows/lint-storybook.yml"
     ]

package/rules/storybook/ci/template/lint-storybook.yml.snippet.yml

@@ -7,7 +7,7 @@ on:
       - main
     paths:
       - '**/*.stories.@(js|ts)'
-      - '.storybook/**'
+      - '**/.storybook/**'
   pull_request:
     branches:
       - dev

package/rules/storybook/hygiene/concern.json

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

package/rules/storybook/main.json

@@ -1 +1 @@
-{ "auto": { "glob": ["package.json", "**/*.vue", ".storybook/**"] } }
+{ "auto": { "glob": ["**/package.json", "**/*.vue", "**/.storybook/**"] } }

package/rules/storybook/main.mdc

@@ -1,7 +1,7 @@
 ---
 description: Канонічний Storybook для Vue-компонентних бібліотек — скафолд, vitest/Stryker, гігієна залежностей, рецепти мокання
 version: '1.0'
-globs: ["package.json", "**/*.vue", ".storybook/**"]
+globs: ["**/package.json", "**/*.vue", "**/.storybook/**"]
 alwaysApply: false
 ---
 
@@ -32,13 +32,26 @@ alwaysApply: false
 - **Порядок Vite-плагінів фіксований**: `@vitejs/plugin-vue` **перед** `quasar()` — інакше Quasar-плагін не бачить SFC, уже скомпільований `plugin-vue`.
 - **Layout-детекція**: `src/components/` присутній → stories-glob звужується до нього; пласка структура (`src/` без `components/`) — ширший glob по всьому `src/`.
 - **`viteFinal`** зчитує `vite.config` самого пакета (той самий, що й для звичайного білду) і мерджить його плагіни в конфіг Storybook, **знімаючи** роутинг-плагіни файлової маршрутизації додатка-споживача (`vite-plugin-pages`, `unplugin-vue-router`, `vite-plugin-vue-layouts`, `vite-plugin-vue-layouts-next`) — вони не мають сенсу в ізольованому рендері компонента. Плагіни `plugins`-масиву можуть бути `Promise`/вкладеними масивами (`VueMacros({ plugins: { vue: Vue() } })` — реальний стек пілотного консюмера повертає `Promise`, що резолвиться в масив плагінів) — фільтр спершу resolve/flatten-ить їх, інакше порівняння імені з `Promise`, що ще не резолвився, мовчки пропускає дублікат `@vitejs/plugin-vue`-трансформу (подвійна SFC-трансформація). Vue-трансформери фільтруються за сімейством імені (`vite:vue`-префікс або підрядок `vue-macros`), не лише буквальним `@vitejs/plugin-vue` — деталі й обґрунтування коментарем у `scaffold/template/main.js`.
+- **`core.builder.options.viteConfigPath` на `.storybook/empty-vite.config.js` — ОБОВ'ЯЗКОВИЙ, не опційний.** Емпірично підтверджено (лише через `storybook build`, `dev --smoke-test` не ловить): без явного `viteConfigPath` `@storybook/builder-vite` сам через `loadConfigFromFile` знаходить `../vite.config.js` пакета ЩЕ ДО виклику `viteFinal` і домерджує його НЕФІЛЬТРОВАНІ плагіни в `storybookConfig` — фільтр у `viteFinal` тоді лише ДОДАЄ ще один `@vitejs/plugin-vue`, а не прибирає вже змерджений builder-vite дублікат (подвійна SFC-трансформація, `storybook build` падає на кожному `.vue`). `empty-vite.config.js` — канонічний порожній `defineConfig({})`-стенд-ін, генерується скафолдом поряд з `main.js`; окрема секція перевірки/adopt-діагностики (не частина `MAIN_JS_MARKERS` — main.js може бути канонічним, а сусідній файл видалено окремо).
 - **`staticDirs`** покриває `.storybook/public` — статичний asset для msw service worker (`preview.js`).
-- **`preview.js`**: повний `Quasar`-install (не тільки окремі компоненти) + `iconSet`+`iconMapFn`-комбо — без цієї пари внутрішні Quasar-компоненти (напр. стрілка `QSelect`) не резолвлять вбудовані іконки поза full CLI build. `msw-storybook-addon` ініціалізується з `onUnhandledRequest`-фільтром: **same-origin GET мовчки пропускається** (Vite HMR/asset-шум), решта — попередження (не білд-помилка — навмисно м'яко для хвилі 1).
+- **`preview.js`**: повний `Quasar`-install (не тільки окремі компоненти) + `iconSet`+`iconMapFn`-комбо — без цієї пари внутрішні Quasar-компоненти (напр. стрілка `QSelect`) не резолвлять вбудовані іконки поза full CLI build. Обидва `iconSet` — підшляховий default-імпорт (`quasar/icon-set/svg-material-icons`, `quasar/icon-set/material-icons`), **НЕ** named-import `iconSet` напряму з пакета `quasar` — quasar 2.18.x не має такого runtime-binding (лише компонент `IconSet` з великої літери), `@quasar/vite-plugin`-transform падає на такому специфікаторі. `msw-storybook-addon` ініціалізується з `onUnhandledRequest`-фільтром: **same-origin GET мовчки пропускається** (Vite HMR/asset-шум), решта — попередження (не білд-помилка — навмисно м'яко для хвилі 1). Мережевий мок підключається через `loaders: [mswLoader]`, **не** `decorators: [mswDecorator]` — `mswDecorator` deprecated у `msw-storybook-addon` 2.x (буде видалений у наступному релізі), `mswLoader` виконується per-story до рендеру.
 - **`.storybook/mocks/gql-sse.js`**: єдиний канонічний хелпер `sseSubscription` для MSW-мокання Apollo-підписок через wire-протокол `graphql-sse` (`event: next\ndata: …`, distinct-connection mode) — переносити цю логіку в кожен пакет окремо заборонено, є одне джерело істини.
 - **`package.json#scripts.storybook`** — уніфікований скрипт, однаковий для всіх пакетів у скоупі (значення — `scaffold/main.mjs`, не дублюється тут).
 
 Перевірка присутності й ключових маркерів канону — `scaffold/main.mjs`; детерміноване відтворення відсутніх файлів із `scaffold/template/` — `scaffold/fix-scaffold.mjs` (fixability: `config` — канонічна форма одна, LLM у ланцюжку фіксу не потрібен).
 
+### knip-виключення для `.storybook/`-артефактів
+
+Кожен adopt цього канону наступає на ту саму knip-проблему: `empty-vite.config.js` (динамічний шлях через `join(dirName, …)` у `main.js` — knip не резолвить `join`-конструйовані шляхи), `mocks/apollo.js` (точковий alias-мок, `mocking.mdc` — не кожен пакет його використовує) і `mocks/gql-sse.js` (helper, статично імпортується лише зі story-файлів, яких у щойно заскафолженому пакеті може ще не бути) регулярно фолсяться knip-ом як orphan-files. Канонічний фікс — **docs-only** сніпет, не автофікс: механізм `js/check` copy-once канону `knip.json` (`n-js.mdc`) свідомо **не ревалідує** вміст після першого створення (консюмер вільно кастомізує), тож програмний patch наявного `knip.json` консюмера конфліктував би з цим дизайн-рішенням і вимагав би нового merge-механізму замість наявного copy-if-missing. Додай вручну в `knip.json` консюмера (root або поряд з першим `.storybook/`):
+
+```json
+{
+  "ignore": ["**/.storybook/empty-vite.config.js", "**/.storybook/mocks/apollo.js", "**/.storybook/mocks/gql-sse.js"]
+}
+```
+
+(домердж у наявний масив `ignore`, не заміна). Звірено з реальним `knip.json` пілотного консюмера.
+
 ## 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`, не дублюється тут.
@@ -47,6 +60,8 @@ alwaysApply: false
 
 `ci/main.mjs` + `ci/fix-ci.mjs` (fixability: `config`, `requires.capability: ci:github` — спить у репозиторіях без плагіна `@7n/rules-ci-github`): для кожного репозиторію з бодай одним пакетом у скоупі — канонічний composite action `.github/actions/setup-playwright-chromium/action.yml` (кеш `~/.cache/ms-playwright`/`~/Library/Caches/ms-playwright` за версією playwright з `bun.lock`, install **лише** `chromium --with-deps` при cache miss) і `.github/workflows/lint-storybook.yml` (матриця `strategy.matrix.package` — фактичні пакети у скоупі, `checkout` → `setup-bun-deps` → `setup-playwright-chromium` → `vitest run --project=storybook`). Композитний action і workflow — репо-рівневі файли (не per-package), перевірка й автофікс не per-package.
 
+`workflow.on.push.paths` — **`**/.storybook/**`** (не `.storybook/**` без префіксу): пакет у скоупі майже завжди лежить не в корені репозиторію (`npm/.storybook/**` тощо), а GitHub Actions `paths`-глоб без `**/`-префіксу анкорить збіг до кореня репо й мовчки не спрацьовує на push у вкладений пакет. Той самий анкоринг-баг був і в усіх `concern.json#lint.glob`/`main.json#auto.glob`-патернах цього правила (`package.json`, `.storybook/**`, `vitest.config.*` без префіксу) — виправлено разом, звірено емпірично на пілотному консюмері (`components/.github/workflows/lint-storybook.yml`).
+
 Nightly-only `@7n/test coverage` (mutation testing) — свідомо поза цим concern-ом: ADR розділяє швидкий PR-шлях (`--project=storybook`, цей concern) і nightly mutation-прогін, який лишається окремою інфраструктурою (`test/stryker_config`) і не дублюється тут.
 
 ## Гігієна сторонніх залежностей (Кластер 6)

package/rules/storybook/scaffold/concern.json

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

package/rules/storybook/scaffold/docs/fix-scaffold.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-scaffold.mjs
 resource: plugins/lang-js/rules/storybook/scaffold/fix-scaffold.mjs
 docgen:
-  crc: 31a867f5
+  crc: 10336699
   model: openai-codex/gpt-5.4-mini
   score: 90
   issues: internal-name:detectStoriesGlob,judge:inaccurate:0.95

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/storybook/scaffold/main.mjs
 docgen:
-  crc: 2cad0405
+  crc: 0505810e
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98

package/rules/storybook/scaffold/fix-scaffold.mjs

@@ -49,6 +49,17 @@ export function renderMocksGqlSse(templateDir = TEMPLATE_DIR) {
   return readFileSync(join(templateDir, 'mocks/gql-sse.js'), 'utf8')
 }
 
+/**
+ * Вміст канонічного `.storybook/empty-vite.config.js` — verbatim з template (порожній
+ * стенд-ін для `core.builder.options.viteConfigPath` у `main.js`, не залежить від пакета).
+ * Експортовано — переюз у `adopt/main.mjs`.
+ * @param {string} [templateDir] каталог template/ (за замовчуванням — цього concern-а)
+ * @returns {string} вміст `empty-vite.config.js`
+ */
+export function renderEmptyViteConfig(templateDir = TEMPLATE_DIR) {
+  return readFileSync(join(templateDir, 'empty-vite.config.js'), 'utf8')
+}
+
 /**
  * Записує файл, створюючи батьківські каталоги й реєструючи запис для rollback.
  * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').FixContext} ctx fix-контекст рунга
@@ -83,6 +94,7 @@ export const patterns = [
 
       const templateDir = join(ctx.concernDir, 'template')
       const mocksTemplate = renderMocksGqlSse(templateDir)
+      const emptyViteConfigTemplate = renderEmptyViteConfig(templateDir)
 
       const touchedFiles = []
       for (const v of targets) {
@@ -98,10 +110,48 @@ export const patterns = [
           writeScaffoldFile(ctx, mocksAbs, mocksTemplate)
           touchedFiles.push(mocksAbs)
         }
+
+        // empty-vite.config.js — main.js посилається на нього напряму (viteConfigPath),
+        // без нього щойно відтворений main.js неробочий; генерується разом (belt-and-suspenders
+        // з окремим 'storybook-scaffold-empty-vite-config' нижче, який покриває випадок, коли
+        // ЛИШЕ цей файл видалено, а main.js лишається канонічним).
+        const emptyViteConfigAbs = join(absPkgDir, '.storybook/empty-vite.config.js')
+        if (!existsSync(emptyViteConfigAbs)) {
+          writeScaffoldFile(ctx, emptyViteConfigAbs, emptyViteConfigTemplate)
+          touchedFiles.push(emptyViteConfigAbs)
+        }
       }
       return { touchedFiles, message: `.storybook/main.js: створено для ${targets.length} пакет(ів)` }
     }
   },
+  {
+    id: 'storybook-scaffold-empty-vite-config',
+    test: violations => violations.some(v => v.reason === 'missing-empty-vite-config'),
+    apply: (violations, ctx) => {
+      const targets = violations.filter(
+        v => v.reason === 'missing-empty-vite-config' && typeof v.data?.rootDir === 'string'
+      )
+      if (targets.length === 0 || !ctx.concernDir) return { touchedFiles: [] }
+
+      const emptyViteConfigTemplate = renderEmptyViteConfig(join(ctx.concernDir, 'template'))
+
+      const touchedFiles = []
+      for (const v of targets) {
+        const absPkgDir = resolvePkgDir(ctx.cwd, v.data.rootDir)
+        const abs = join(absPkgDir, '.storybook/empty-vite.config.js')
+        if (existsSync(abs)) continue
+        writeScaffoldFile(ctx, abs, emptyViteConfigTemplate)
+        touchedFiles.push(abs)
+      }
+      return {
+        touchedFiles,
+        message:
+          touchedFiles.length > 0
+            ? `.storybook/empty-vite.config.js: створено для ${touchedFiles.length} пакет(ів)`
+            : undefined
+      }
+    }
+  },
   {
     id: 'storybook-scaffold-preview-js',
     test: violations => violations.some(v => v.reason === 'missing-preview-js'),

package/rules/storybook/scaffold/main.mjs

@@ -26,6 +26,10 @@ export const MAIN_JS_MARKERS = [
   {
     token: 'resolvePluginEntry',
     hint: 'resolve/flatten Promise/масиву плагінів перед фільтрацією (VueMacros повертає Promise)'
+  },
+  {
+    token: 'viteConfigPath',
+    hint: 'core.builder.options.viteConfigPath на empty-vite.config.js (блокує builder-vite autodiscovery vite.config пакета — інакше подвійна SFC-трансформація на storybook build)'
   }
 ]
 
@@ -35,7 +39,17 @@ export const PREVIEW_JS_MARKERS = [
   { token: 'iconSet', hint: 'iconSet' },
   { token: 'iconMapFn', hint: 'iconMapFn (без нього внутрішні Quasar-іконки недоступні)' },
   { token: 'msw-storybook-addon', hint: 'msw-storybook-addon' },
-  { token: 'onUnhandledRequest', hint: 'onUnhandledRequest-фільтр' }
+  { token: 'onUnhandledRequest', hint: 'onUnhandledRequest-фільтр' },
+  { token: 'mswLoader', hint: 'mswLoader (не mswDecorator — deprecated у msw-storybook-addon 2.x)' }
+]
+
+/**
+ * Маркери канону `.storybook/empty-vite.config.js` (сусідній файл main.js — стенд-ін для
+ * `core.builder.options.viteConfigPath`, блокує autodiscovery `vite.config` пакета
+ * `@storybook/builder-vite`-ом). Експортовано — переюз у `adopt/main.mjs`.
+ */
+export const EMPTY_VITE_CONFIG_MARKERS = [
+  { token: 'defineConfig', hint: 'порожній defineConfig({}) — стенд-ін для viteConfigPath' }
 ]
 
 /**
@@ -162,6 +176,22 @@ async function checkPackageScaffold({ rootDir, absDir, pkg }, reporter) {
     reporter
   )
 
+  // empty-vite.config.js — сусідній файл, на який main.js посилається через
+  // core.builder.options.viteConfigPath; без нього посилання в main.js "розбите" навіть
+  // якщо сам main.js канонічний (маркер viteConfigPath присутній), тому перевіряється
+  // окремо, а не лише як частина MAIN_JS_MARKERS.
+  await checkCanonFile(
+    absDir,
+    '.storybook/empty-vite.config.js',
+    EMPTY_VITE_CONFIG_MARKERS,
+    'missing-empty-vite-config',
+    'empty-vite-config-marker-missing',
+    label,
+    rootDir,
+    `${relPrefix}.storybook/empty-vite.config.js`,
+    reporter
+  )
+
   const scriptValue = pkg?.scripts?.storybook
   if (scriptValue !== STORYBOOK_SCRIPT) {
     const pkgJsonRel = `${relPrefix}package.json`

package/rules/storybook/scaffold/template/docs/empty-vite.config.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: empty-vite.config.js
+resource: plugins/lang-js/rules/storybook/scaffold/template/empty-vite.config.js
+docgen:
+  crc: 5c9f8904
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Канонічний порожній `Vite`-конфіг як стенд-ін для `core.builder.options.viteConfigPath` у `.storybook/main.js`. Його відсутність або поломка змушує `@storybook/builder-vite` через `loadConfigFromFile` знайти пакетний `vite.config.js` і додатково змішати нефільтровані плагіни ще до `viteFinal`; `mergeConfig` конкатенує масиви `plugins`, тож фільтр у `viteFinal` не прибирає вже доданий дублікат `@vitejs/plugin-vue`, а лише додає ще один. Без цього файлу `storybook build` падає на кожному `.vue` з `At least one <template> or <script> is required` через подвійну SFC-трансформацію; `dev --smoke-test` цього не виявляє, це підтверджує лише повний `build`. `npx @7n/rules fix storybook` відтворює цей файл, якщо він видалений або зламаний канон.
+
+## Поведінка
+
+1. Файл виступає канонічним порожнім `Vite`-конфігом для `storybook` і використовується як явна точка підключення в `core.builder.options.viteConfigPath`.
+2. Якщо канон пошкоджено або файл зник, `npx @7n/rules fix storybook` відтворює його, щоб зберегти узгоджений режим збірки.
+3. Файл не додає власної поведінки до `Vite`-збірки; його роль — заблокувати неявне підхоплення пакетного `vite.config.js` з боку `@storybook/builder-vite`.
+4. Це прибирає ризик домішування сторонніх `Vite`-плагінів у `storybook build`, які інакше можуть бути обʼєднані до `viteFinal` і спричинити подвійну обробку `Vue`-компонентів.
+5. Завдяки цьому `storybook build` поводиться стабільно на `.vue`-файлах у бібліотеках компонентів; без такого стенд-іну повний build може падати, тоді як `dev --smoke-test` цього не виявляє.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -4,7 +4,8 @@ title: plugins/lang-js/rules/storybook/scaffold/template
 resource: plugins/lang-js/rules/storybook/scaffold/template/
 ---
 
-| Файл                     | Тип       |
-| ------------------------ | --------- |
-| [main.js](main.md)       | JS Module |
-| [preview.js](preview.md) | JS Module |
+| Файл                                         | Тип       |
+| -------------------------------------------- | --------- |
+| [empty-vite.config.js](empty-vite.config.md) | JS Module |
+| [main.js](main.md)                           | JS Module |
+| [preview.js](preview.md)                     | JS Module |

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.js
 resource: plugins/lang-js/rules/storybook/scaffold/template/main.js
 docgen:
-  crc: 74cf3397
+  crc: 18fbef4b
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.96

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

@@ -3,9 +3,8 @@ type: JS Module
 title: preview.js
 resource: plugins/lang-js/rules/storybook/scaffold/template/preview.js
 docgen:
-  crc: 5590ef55
+  crc: 445c773b
   model: openai-codex/gpt-5.5
-  tier: cloud-avg
   score: 100
   issues: judge:inaccurate:0.96
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/storybook/scaffold/template/empty-vite.config.js

@@ -0,0 +1,18 @@
+/**
+ * Канонічний ПОРОЖНІЙ Vite-конфіг — стенд-ін для `core.builder.options.viteConfigPath` у
+ * `.storybook/main.js` (storybook.mdc, ADR канон-storybook-для-vue-компонентних-бібліотек).
+ * `npx @7n/rules fix storybook` відтворює цей файл, якщо його видалено чи зламано канон.
+ *
+ * Навіщо: `@storybook/builder-vite` без явного `viteConfigPath` сам через
+ * `loadConfigFromFile` знаходить `vite.config.js` ПАКЕТА і домерджує його НЕФІЛЬТРОВАНІ
+ * плагіни (той самий `vue()`, обгорнутий VueMacros/unplugin-auto-import) ще ДО виклику
+ * `viteFinal` у `main.js` — `mergeConfig` конкатенує масиви `plugins`, тож фільтр у
+ * `viteFinal` лише ДОДАЄ ще один `@vitejs/plugin-vue`, а не прибирає вже змерджений
+ * дублікат від builder-vite. Наслідок без цього файлу: `storybook build` (саме `build`,
+ * не `dev`!) падає на кожному `.vue` з "At least one <template> or <script> is required" —
+ * подвійна SFC-трансформація. `dev --smoke-test` цю різницю НЕ ловить (лінива
+ * трансформація), лише повний `build`. Перевірено емпірично на пілотному консюмері.
+ */
+import { defineConfig } from 'vite'
+
+export default defineConfig({})

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

@@ -3,10 +3,17 @@
  * канон-storybook-для-vue-компонентних-бібліотек). Згенеровано правилом `storybook` —
  * `npx @7n/rules fix storybook` відтворює цей файл, якщо його видалено чи зламано канон.
  */
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
 import { loadConfigFromFile, mergeConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import { quasar, transformAssetUrls } from '@quasar/vite-plugin'
 
+// Абсолютний каталог `.storybook/` (де лежить сам main.js) — потрібен нижче для
+// `core.builder.options.viteConfigPath` (порожній стенд-ін лежить поруч).
+const dirName = dirname(fileURLToPath(import.meta.url))
+
 // Плагіни власного Vite-збирача Storybook — порядок ФІКСОВАНИЙ: @vitejs/plugin-vue
 // ПЕРЕД quasar() (інакше Quasar-плагін не бачить SFC, уже скомпільований plugin-vue).
 const OWN_PLUGINS = [vue({ template: { transformAssetUrls } }), quasar({ sassVariables: true })]
@@ -69,6 +76,22 @@ const config = {
   },
   // Публічний asset для msw service worker, який ініціалізує preview.js.
   staticDirs: ['./public'],
+  core: {
+    builder: {
+      name: '@storybook/builder-vite',
+      // ОБОВ'ЯЗКОВИЙ обхід (емпірично підтверджено — лише через `storybook build`, dev
+      // smoke-test не ловить): без цього `@storybook/builder-vite` сам через
+      // `loadConfigFromFile` знаходить `../vite.config.js` пакета ще ДО виклику
+      // `viteFinal` нижче й домерджує його НЕФІЛЬТРОВАНІ плагіни (VueMacros-обгорнутий
+      // `vue()`, layout-роутинг тощо) у storybookConfig. `mergeConfig` конкатенує масиви
+      // `plugins`, тож фільтр у `viteFinal` лише ДОДАЄ ще один `@vitejs/plugin-vue`, а НЕ
+      // прибирає вже змерджений builder-vite дублікат — подвійна SFC-трансформація,
+      // `storybook build` падає на кожному `.vue` з "At least one <template> or <script>
+      // is required". `viteConfigPath` на порожній стенд-ін (`empty-vite.config.js`,
+      // канонічний сусідній файл цього скафолда) блокує це autodiscovery повністю.
+      options: { viteConfigPath: join(dirName, 'empty-vite.config.js') }
+    }
+  },
   async viteFinal(storybookConfig) {
     const loaded = await loadConfigFromFile({ command: 'serve', mode: 'development' }, undefined, process.cwd())
     const rawPlugins = loaded?.config?.plugins ?? []

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

@@ -3,10 +3,15 @@
  * канон-storybook-для-vue-компонентних-бібліотек). Згенеровано правилом `storybook` —
  * `npx @7n/rules fix storybook` відтворює цей файл, якщо його видалено чи зламано канон.
  */
-import { setup } from '@storybook/vue3'
-import { Dialog, iconSet as quasarBuiltinIconSet, Notify, Quasar } from 'quasar'
+import { setup } from '@storybook/vue3-vite'
+import { Dialog, Notify, Quasar } from 'quasar'
 import iconSet from 'quasar/icon-set/svg-material-icons'
-import { initialize, mswDecorator } from 'msw-storybook-addon'
+// Імпорт через підшлях пакета — НЕ named-import `iconSet` напряму з `quasar`: quasar
+// 2.18.x не має цього імені як runtime-binding (лише компонент `IconSet` з великої
+// літери), і `@quasar/vite-plugin`-transform падає з "Unknown import from Quasar" на
+// такому специфікаторі. Підшлях (як і кастомний `iconSet` вище) обходить transform повністю.
+import quasarBuiltinIconSet from 'quasar/icon-set/material-icons'
+import { initialize, mswLoader } from 'msw-storybook-addon'
 
 import 'quasar/dist/quasar.css'
 
@@ -36,9 +41,12 @@ setup(app => {
   })
 })
 
-/** @type {import('@storybook/vue3').Preview} */
+/** @type {import('@storybook/vue3-vite').Preview} */
 const preview = {
-  decorators: [mswDecorator],
+  // mswLoader (не mswDecorator — deprecated у msw-storybook-addon 2.x, буде видалений
+  // у наступному релізі): loaders виконуються per-story ДО рендеру й інтегруються з
+  // async story-рендерингом Storybook, на відміну від декоратора.
+  loaders: [mswLoader],
   parameters: {
     controls: { matchers: { color: /(background|color)$/iu, date: /Date$/u } }
   }

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

@@ -3,6 +3,6 @@
   "fixability": "config",
   "lint": {
     "scope": "full",
-    "glob": ["package.json", "**/*.vue", ".storybook/**", "vitest.config.*", "vitest.stryker.config.*"]
+    "glob": ["**/package.json", "**/*.vue", "**/.storybook/**", "**/vitest.config.*", "**/vitest.stryker.config.*"]
   }
 }