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

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.11.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`.
+
+## [0.10.0] - 2026-07-21
+
+### Added
+
+- storybook: канон Storybook хвилі 1 для Vue-компонентних бібліотек — детекція скоупу (isVueComponentLibraryPkg, поріг ≥3 .vue, opt-out), канонічний скафолд .storybook/main.js+preview.js+mocks/gql-sse.js, package.json#scripts.storybook (ADR канон-storybook-для-vue-компонентних-бібліотек)
+- npm-module/bun: governance-виняток канону Storybook (кластер 7 ADR канон-storybook-для-vue-компонентних-бібліотек) — npm_package_json.rego дозволяє канонічні Storybook-devDeps (storybook, @storybook/vue3-vite, @storybook/vue3, msw, msw-storybook-addon) у npm/package.json із зафіксованою точною версією (deny на неканонічний пакет або неканонічну версію); bun/package_json.rego розширює root-only test peers на @vitest/browser + playwright (browser-mode provider для named vitest project "storybook", лише chromium) та @storybook/addon-vitest (storybookTest-плагін того самого vitest-конфіга) — Storybook-identity-пакети у корінь свідомо не додаються
+- storybook: vitest-config-концерн хвилі 1 (ADR Кластер 5) — canonical test.projects unit+storybook (browser-mode, лише chromium, stories-glob) дописується поверх наявного vitest-конфіга, ізольований vitest.stryker.config генерується поруч (Stryker крашиться на browser-mode projects)
+- storybook: концерни mocking (docs-only рецепти router/tfm/Apollo-MSW/Pinia/page-story) і hygiene (undeclared third-party imports у .vue, auto-detect sassVariables) — ADR Кластер 3/6
+
+### Fixed
+
+- storybook: підключено concern-и scope/scaffold/vitest-config до unified lint-рушія (lint-блок у concern.json — check:true без lint мовчки ігнорувався run-detectors.mjs), додано --adopt-режим (adopt/main.mjs) і скіл n-storybook
+
 ## [0.9.0] - 2026-07-20
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.9.0",
+  "version": "0.11.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.mdc

@@ -9,6 +9,8 @@ Rego-пакет: `bun.package_json`
 Gate виносить два класи deny:
 
 1. **Заборонені top-level поля** — будь-яке поле з `package.json.deny.json` присутнє у файлі (навіть із порожнім значенням `{}`).
-2. **devDependencies не з білого списку** — дозволені лише `@nitra/*`/`@7n/*` та root-only тестові peer/tools (`vitest`, `@vitest/coverage-v8`, `@stryker-mutator/vitest-runner`, `@playwright/test`). Будь-який інший пакет → deny. CLI-тули, які `n-rules lint` спавнить через `bunx` (oxlint, jscpd, v8r, github-actionlint тощо), у root не пінуються — вони приїжджають як `dependencies` пакета `@7n/rules` (npm-module.mdc).
+2. **devDependencies не з білого списку** — дозволені лише `@nitra/*`/`@7n/*` та root-only тестові peer/tools (`vitest`, `@vitest/coverage-v8`, `@vitest/browser`, `@vitest/browser-playwright`, `@stryker-mutator/vitest-runner`, `@stryker-mutator/core`, `@playwright/test`, `playwright`, `@storybook/addon-vitest`, `@7n/test`). Будь-який інший пакет → deny. CLI-тули, які `n-rules lint` спавнить через `bunx` (oxlint, jscpd, v8r, github-actionlint тощо), у root не пінуються — вони приїжджають як `dependencies` пакета `@7n/rules` (npm-module.mdc).
+
+`@vitest/browser`/`@vitest/browser-playwright`/`playwright`/`@storybook/addon-vitest` — додані для named vitest project "storybook" (канон Storybook, кластер 5: browser-mode, лише chromium) — той самий root vitest.config, що й `unit`-проект; `@storybook/addon-vitest` постачає `storybookTest`-плагін для цього vitest-конфіга (канонічний template правила `storybook`). `@vitest/browser-playwright` — окремий npm-пакет: vitest@^4 прибрав рядкове API browser-провайдера (`provider: 'playwright'`), потрібна factory `import { playwright } from '@vitest/browser-playwright'` → `provider: playwright()` (звірено з реальним `bun.lock` пілотного консюмера — усі три `@vitest/*`/`playwright`-пакети встановлені поруч). **Межа з `npm-module.mdc`**: Storybook-специфічні identity-пакети (`storybook`, `@storybook/vue3-vite`, `@storybook/vue3`, `msw`, `msw-storybook-addon`) у цей allowlist **не** додаються — вони живуть у `npm/package.json` консюмер-пакета (канон Storybook, кластер 7 Governance), бо `isStorybookRoot()` у `@7n/test` детектує Storybook-скоуп саме за тим файлом, не кореневим. `@storybook/addon-vitest` — виняток із цієї межі: він test-tooling (vitest-плагін), а не identity-маркер, тож root, як і решта vitest-peer'ів.
 
 Перевірки, що потребують FS або cross-file контексту (наприклад наявність `yarn.lock`), лишаються у JS-шарі.

package/rules/bun/package_json/package_json.rego

@@ -8,6 +8,16 @@
 #  - `devDependencies` лише `@nitra/*` + root-only тестові peer/tools для `@7n/test coverage`
 #    (правило `test` enabled завжди — див. `test/auto.md`; published workspace-и не мають
 #     `devDependencies` за `npm-module.mdc`)
+#  - `@vitest/browser`/`@vitest/browser-playwright`/`playwright`/`@storybook/addon-vitest`
+#    (browser-mode provider factory + `storybookTest`-плагін для named vitest project
+#    "storybook", лише chromium — канон Storybook кластер 5) теж root-only test peers:
+#    той самий vitest.config, що й `unit`-проект, живе в корені монорепо-споживача.
+#    Storybook-специфічні
+#    identity-пакети (`storybook`, `@storybook/vue3*`, `msw*`) НЕ сюди — вони живуть у
+#    `npm/package.json` (канон Storybook кластер 7, `npm-module.mdc`), бо
+#    `isStorybookRoot()` @7n/test читає саме той файл, не кореневий package.json.
+#    `@storybook/addon-vitest` — виняток із цього правила: це test-tooling (плагін
+#    vitest-конфіга), а не Storybook-identity-маркер, тож root, а не npm/package.json.
 #
 # Перевірки, які потребують FS / cross-file контексту, лишаються у JS.
 package bun.package_json
@@ -50,7 +60,32 @@ deny contains msg if {
 # @stryker-mutator/core — обов'язковий exact-pin peer vitest-runner@9+ (раніше тягнувся транзитивно)
 # @7n/test — оркестратор `coverage` (npx @7n/test coverage); devDependency, щоб npx резолвив
 # локально без мережевого fetch щоразу.
-allowed_root_test_deps := {"vitest", "@vitest/coverage-v8", "@stryker-mutator/vitest-runner", "@stryker-mutator/core", "@playwright/test", "@7n/test"}
+# @vitest/browser + @vitest/browser-playwright + playwright — провайдер browser-mode для
+# named vitest project "storybook" (канон Storybook кластер 5: лише chromium, PR —
+# швидкий --project=storybook). vitest@^4 прибрав рядкове API провайдера
+# (`provider: 'playwright'`) — `@vitest/browser-playwright` постачає factory
+# `import { playwright } from '@vitest/browser-playwright'` → `provider: playwright()`,
+# окремий npm-пакет, не входить у `@vitest/browser` (звірено з реальним bun.lock пілота —
+# усі три пакети встановлені поруч). `playwright` (не `@playwright/test`) — сирий driver,
+# який `@vitest/browser-playwright` використовує як provider; `@playwright/test` лишається
+# окремо для змістовних E2E-сценаріїв (n-vue.mdc).
+# @storybook/addon-vitest — постачає `storybookTest` для vitest-плагіна в канонічному
+# vitest.config named-проекту "storybook" (той самий канон Storybook кластер 5); версія
+# з лінійки Storybook 9.x (узгоджена з `storybook`@9.1.10, запіненим у
+# npm_package_json.rego) — allowlist тут за іменем, точний пінінг версії root-tooling
+# не робимо (на відміну від Storybook-identity-пакетів у npm/package.json).
+allowed_root_test_deps := {
+	"vitest",
+	"@vitest/coverage-v8",
+	"@vitest/browser",
+	"@vitest/browser-playwright",
+	"@stryker-mutator/vitest-runner",
+	"@stryker-mutator/core",
+	"@playwright/test",
+	"playwright",
+	"@storybook/addon-vitest",
+	"@7n/test",
+}
 
 allowed_root_dev_dependency(name) if {
 	startswith(name, "@nitra/")

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

@@ -16,10 +16,13 @@ Rego-пакет: `npm-module.npm_package_json`
 - Обовʼязкове, має бути непорожнім масивом.
 - Subset-of перевірка: кожне значення з канонічного сніпету має бути присутнє у `files`. За замовчуванням — `"types"` обовʼязковий.
 
-**Поле `devDependencies`** (inverse-pattern, логіка в rego):
+**Поле `devDependencies`** (inverse-pattern + Storybook-виняток, логіка в rego):
 
 - Не публікуються користувачам пакета — має бути відсутнє або порожнє `{}`.
-- Наявність будь-яких devDeps → deny з переліком залежностей. Dev-інструментарій переноситься у кореневий `package.json`; CLI-тули, які пакет спавнить через `bunx` у репозиторіях-споживачах (пінінг версій), — у `dependencies` (кореневе bun-правило `package_json` такі пакети в root devDeps не пускає).
+- **Виняток — канонічні Storybook-пакети** (канон Storybook, кластер 7 Governance: `docs/adr/канон-storybook-для-vue-компонентних-бібліотек.md`): `storybook`, `@storybook/vue3-vite`, `@storybook/vue3`, `msw`, `msw-storybook-addon` дозволені як devDeps саме тут, у `npm/package.json` консюмер-пакета — **не** в кореневому `package.json`. Обґрунтування: майбутній `isStorybookRoot()` у `@7n/test` читає саме цей файл, щоб визначити Storybook-скоуп workspace-пакета, тож маркер-пакети мають бути видимі тут, а не в кореневих tooling-deps. Версія кожного канонічного пакета зафіксована точно (map `storybook_canon_dev_deps` у rego) — присутність пакета з іншою версією теж deny (окреме повідомлення, не плутати з allowlist-забороною).
+- Будь-який інший devDep (не з канонічного Storybook-списку) → deny з переліком імен. Dev-інструментарій переноситься у кореневий `package.json`; CLI-тули, які пакет спавнить через `bunx` у репозиторіях-споживачах (пінінг версій), — у `dependencies` (кореневе bun-правило `package_json` такі пакети в root devDeps не пускає).
+
+Канон Storybook-devDeps та їхні версії — static map у `npm_package_json.rego` (не template-driven: це опційний allowlist, а не mandatory-presence дані, тож генеричний T0-fix-writer цього concern-а їх у кожен `package.json` не мерджить — див. коментар на початку rego-файлу).
 
 Канонічний сніпет `files`: [package.json.snippet.json](./template/package.json.snippet.json)
 
@@ -50,8 +53,20 @@ FS-перевірки (наявність файлу зі шляху `types`, с
 { "files": ["bin", "mdc"] }
 ```
 
-✗ Неправильно — наявні `devDependencies`:
+✗ Неправильно — наявні `devDependencies`, не з канонічного Storybook-списку:
 
 ```json
 { "devDependencies": { "@7n/rules": "^1.0.0" } }
 ```
+
+✓ Правильно — канонічний Storybook-devDep із зафіксованою версією (канон Storybook):
+
+```json
+{ "devDependencies": { "storybook": "9.1.10" } }
+```
+
+✗ Неправильно — Storybook-devDep присутній, але версія не збігається з каноном:
+
+```json
+{ "devDependencies": { "storybook": "8.0.0" } }
+```

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

@@ -6,7 +6,17 @@
 #
 # Логіка, що ЛИШАЄТЬСЯ у rego (inverse-patterns, не виносяться у template):
 #  - форма поля `types` (regex pattern: `./types/index.d.ts` або `./types/<…>.d.ts|.d.mts`);
-#  - `devDependencies` мають бути відсутні або порожні (inverse-pattern — заборона будь-яких).
+#  - `devDependencies` мають бути відсутні/порожні АБО належати канонічному
+#    Storybook-allowlist із зафіксованою точною версією (канон Storybook, кластер 7
+#    Governance: `docs/adr/канон-storybook-для-vue-компонентних-бібліотек.md`).
+#    Storybook-devDeps живуть саме у `npm/package.json` консюмер-пакета
+#    (а не в кореневому package.json), бо майбутній `isStorybookRoot()` у
+#    `@7n/test` читає саме цей файл, щоб визначити Storybook-скоуп пакета.
+#    Канон — static map (той самий підхід, що й `allowed_root_test_deps` у
+#    `bun.package_json`), НЕ template: це не mandatory-presence дані (більшість
+#    npm-пакетів Storybook не має), тож генеричний T0-fix-writer цього
+#    concern-а (`createTemplateFixPattern`, deep-merge усього `template.snippet`
+#    у target) канонічні devDeps у кожен package.json не домерджує.
 #
 # FS-перевірки (наявність файлу зі шляху `types`, скан tarball на тест-патерни) — у JS.
 package npm_module.npm_package_json
@@ -20,10 +30,27 @@ types_field_template := concat(" ", [
 
 dev_deps_template := concat(" ", [
 	"npm/package.json: \"devDependencies\" не публікуються користувачам пакета —",
+	"дозволені лише канонічні Storybook-пакети (isStorybookRoot(), канон Storybook);",
 	"dev-інструментарій перенеси у кореневий package.json, а CLI-тули, які пакет",
 	"спавнить через bunx у споживачів, — у \"dependencies\": %v (npm-module.mdc)",
 ])
 
+storybook_version_template := concat(" ", [
+	"npm/package.json: devDependencies.%v = %q не відповідає зафіксованій версії",
+	"Storybook-канону %q — вирівняй версію пакета до канону (npm-module.mdc, канон Storybook)",
+])
+
+# Канонічні Storybook-devDeps (isStorybookRoot()-маркери, канон Storybook кластер 7):
+# зафіксована точна версія — єдина дозволена версія для кожного пакета. Оновлення —
+# ручна правка цієї map.
+storybook_canon_dev_deps := {
+	"storybook": "9.1.10",
+	"@storybook/vue3-vite": "9.1.10",
+	"@storybook/vue3": "9.1.10",
+	"msw": "2.11.3",
+	"msw-storybook-addon": "2.0.5",
+}
+
 # ── deny: types (regex — лишається в rego) ───────────────────────────────
 
 deny contains msg if {
@@ -57,13 +84,23 @@ deny contains msg if {
 	msg := sprintf("npm/package.json: масив \"%s\" має містити %q (npm-module.mdc)", [field, required])
 }
 
-# ── deny: devDependencies (inverse-pattern, лишається в rego) ────────────
+# ── deny: devDependencies (inverse-pattern + Storybook-allowlist виняток) ─
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	forbidden_names := [n | some n, _ in dev; not n in object.keys(storybook_canon_dev_deps)]
+	count(forbidden_names) > 0
+	msg := sprintf(dev_deps_template, [concat(", ", sort(forbidden_names))])
+}
+
+# ── deny: Storybook-devDep присутній, але версія розходиться з каноном ──
 
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
-	count(dev) > 0
-	names := concat(", ", sort([n | some n, _ in dev]))
-	msg := sprintf(dev_deps_template, [names])
+	some name, version in dev
+	canonical := storybook_canon_dev_deps[name]
+	version != canonical
+	msg := sprintf(storybook_version_template, [name, version, canonical])
 }
 
 # ── helpers ────────────────────────────────────────────────────────────────

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

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

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

@@ -0,0 +1,45 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/storybook/adopt/main.mjs
+docgen:
+  crc: c8e6e421
+  model: openai-codex/gpt-5.4-mini
+  score: 90
+  issues: anchor-miss:(mocking.mdc),anchor-miss:(vitest-config.mdc),judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Режим adopt для канону Storybook у Vue-бібліотеках: звіряє пакети з канонічними секціями `main.js`, `preview.js`, `mocks/gql-sse.js`, `package.json#scripts.storybook`, `vitest test.projects` і `vitest.stryker.config`, а для вже наявних ручних `.storybook/` без сліпого перезапису показує діагностику diff по секціях. Автофікс (`--fix-missing`) додає лише повністю відсутні секції, з тим самим рендером, що й T0-фікс concern-ів `scaffold`/`vitest-config`, без втручання в наявні розбіжні файли. Дає CLI-звіт по кожному пакету зі станом `status` і секціями `SECTION`, окремо фіксуючи `diagnosePackage`, `fixMissingSections`, `runAdopt` і `formatReport`; помилки перехоплює fail-safe, тому збій або діагностики, або фіксу для одного пакета переводить лише його в `status: 'broken'`, а решта пакетів продовжують оброблятися.
+## Поведінка
+
+- `STATUS` — задає фіксовані стани діагностики секцій Storybook: збіг, розбіжність або відсутність.
+- `SECTION` — задає стабільні назви секцій звіту, щоб adopt-перевірка й `--fix-missing` узгоджено посилалися на ті самі частини конфігурації.
+- `diagnosePackage` — перевіряє пакет по секціях і повертає підсумок: канонічний, з відсутніми файлами або з відмінностями; помилки окремих секцій не валять увесь пакет.
+- `fixMissingSections` — створює лише ті канонічні секції, яких у пакеті немає взагалі, і не перезаписує наявні розбіжні файли.
+- `runAdopt` — проганяє adopt-перевірку по всіх або вибраних пакетах у скоупі, із fail-safe поведінкою: збій одного пакета переходить у `broken`, але інші обробляються далі.
+- `formatReport` — перетворює результати adopt-прогону на лаконічний український звіт для CLI, включно з переліком згенерованого або повідомленням про відсутність пакетів у скоупі.
+
+## Публічний API
+
+- STATUS — Статуси однієї секції діагностики (діагностика ≠ lint-violation — тут завжди 4 значення).
+- SECTION — Канонічні назви секцій (стабільні — на них зав'язаний `--fix-missing`-switch).
+- diagnosePackage — Діагностика одного пакета в скоупі по секціях. Ніколи не кидає — збій окремої
+секції (парсинг/IO) відображається як секція `differ`, а не виняток, що впав
+би на весь пакет; лишається на розсуд `diagnosePackage` (circuit breaker рівня
+пакета — тут не потрібен, бо секції вже ізольовані одна від одної).
+- fixMissingSections — Генерує канонічний вміст лише для секцій зі статусом `missing` одного пакета
+(adopt-автофікс НІКОЛИ не чіпає секції зі статусом `differ` — інструкція
+для агента/людини, не сліпий перезапис). Кожна секція фіксується незалежно;
+збій однієї не блокує решту (той самий circuit-breaker принцип, лише на дрібнішому рівні).
+- runAdopt — Adopt-прогін усіх (чи обраних) пакетів у скоупі. Circuit breaker (ADR Кластер 8):
+збій діагностики/фіксу ОДНОГО пакета деградує до `status: 'broken'` для нього —
+решта пакетів обробляються далі, весь прогін ніколи не падає через один зламаний.
+  відсутні секції; `rootDirs` — звузити прогін до цих коренів пакетів (порожньо/відсутнє → усі в скоупі)
+- formatReport — Форматує людський звіт по результатах `runAdopt` (українською, для виводу скіла в CLI).
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).