@7n/rules-lang-js 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.8.0] - 2026-07-20
+
+### Added
+
+- doc-files: Vue SFC-екстрактор (`<script setup>`) — extractFactsVue/extractUnitsVue через optional peer vue/compiler-sfc; props/emits/expose/слоти як публічний контракт, юніти зі span-корекцією (ADR 260719-2155)
+
+## [0.7.1] - 2026-07-20
+
+### Fixed
+
+- style/lint: stylelint — задекларована залежність плагіна (раніше резолвилась лише транзитивно у цьому монорепо через @nitra/stylelint-config); відсутність тула тепер дає видимий warn-diagnostic замість мовчазного no-op (незалежний консюмер бачив би 'зелений' style-лінт, який насправді нічого не перевіряв)
+
 ## [0.7.0] - 2026-07-19
 
 ### Added

package/doc-files/docs/extractors.md

@@ -3,9 +3,8 @@ type: JS Module
 title: extractors.mjs
 resource: plugins/lang-js/doc-files/extractors.mjs
 docgen:
-  crc: 5ba406e8
+  crc: 0519b5be
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/doc-files/docs/index.md

@@ -8,3 +8,4 @@ resource: plugins/lang-js/doc-files/
 | ------------------------------- | --------- |
 | [extractors.mjs](extractors.md) | JS Module |
 | [units-js.mjs](units-js.md)     | JS Module |
+| [vue.mjs](vue.md)               | JS Module |

package/doc-files/docs/vue.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: vue.mjs
+resource: plugins/lang-js/doc-files/vue.mjs
+docgen:
+  crc: 8651a381
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`vueScriptBlock`, `extractFactsVue` і `extractUnitsVue` працюють із Vue SFC як з джерелом для подальшого витягування фактів і юнітів у координатах оригінального `.vue`. Вони підтримують fail-safe поведінку: перехоплюють помилки, не кидають винятків назовні та за окремих збоїв повертають порожнє значення, зокрема `null`, замість помилки.
+
+## Поведінка
+
+- `vueScriptBlock` — розбирає `.vue` як SFC і повертає `script setup` або `script` блок із дескриптором; якщо peer `vue` відсутній, SFC битий або script-блоку немає, повертає порожній результат замість помилки.
+- `extractFactsVue` — формує факт-лист для Vue SFC на основі `script`-блоку: виділяє публічний контракт компонента через props, emits, expose і slots, а також додає JS-факти з `script`; якщо `vue` недоступний, SFC битий або script-блоку немає, повертає `unsupported`.
+- `extractUnitsVue` — витягує JS/TS-юніти зі `script`-блоку Vue-файла і переносить їхні span-позиції в координати оригінального `.vue`; якщо `vue` недоступний, SFC битий або script-блоку немає, повертає порожній результат.
+
+## Публічний API
+
+- vueScriptBlock — Дістає script-блок із SFC, віддаючи пріоритет `<script setup>`, разом із дескриптором.
+- extractFactsVue — Збирає публічний контракт Vue SFC: props, emits, expose і slots, а також повторно використовує JS-хелпери для header, imports і markers із тексту script-блоку; `<template>` і `<style>` у факти не потрапляють. Без peer `vue` або на битому SFC чи без script-блоку повертає `unsupported` у whole-file режимі, як до впровадження.
+- extractUnitsVue — Будує JS-юніти з script-блоку `.vue` і зсуває span-и на позиції в оригінальному `.vue` файлі, щоб anchors і CRC вказували саме на вихідний SFC, а не на вирізаний фрагмент.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/doc-files/extractors.mjs

@@ -1,5 +1,6 @@
 /** @see ./docs/extractors.md */
 import { extractUnitsJs } from './units-js.mjs'
+import { extractFactsVue, extractUnitsVue } from './vue.mjs'
 
 /**
  * Мовний doc-files-екстрактор JS-екосистеми для конвеєра `@7n/rules`
@@ -249,6 +250,17 @@ function extractMarkers(src) {
     skips: [...skips]
   }
 }
+/** JS-хелпери, які Vue-екстрактор переюзає над текстом script-блоку SFC. */
+const VUE_HELPERS = {
+  extractFileHeader,
+  extractExports,
+  extractImports,
+  extractInternalSymbols,
+  extractLocalSymbols,
+  extractMarkers,
+  parseJsDoc
+}
+
 /**
  * Головний екстрактор: код файлу → факт-лист.
  * @param {string} src вміст файлу
@@ -257,6 +269,7 @@ function extractMarkers(src) {
  */
 export function extractFacts(src, relPath) {
   const lang = relPath.split('.').pop()
+  if (lang === 'vue') return extractFactsVue(src, relPath, VUE_HELPERS)
   if (!['js', 'mjs', 'ts'].includes(lang)) {
     return { relPath, lang, unsupported: true, header: '', exports: [], imports: {}, markers: {} }
   }
@@ -272,17 +285,29 @@ export function extractFacts(src, relPath) {
   }
 }
 
+/**
+ * Юніти: `.vue` — зі script-блоку SFC (span-и в координатах файлу), решта — oxc AST.
+ * @param {string} src вміст файлу
+ * @param {string} relPath шлях (вибір мови)
+ * @returns {Array<object>|null} юніти або null
+ */
+function extractUnits(src, relPath) {
+  if (relPath.toLowerCase().endsWith('.vue')) return extractUnitsVue(src, relPath, extractUnitsJs)
+  return extractUnitsJs(src, relPath)
+}
+
 /**
  * Default-експорт для handler-модуля extension-point `doc-files`.
- * `.vue` у списку розширень (файл — кандидат на доку), але `extractFacts` для нього
- * повертає `unsupported` — генерація йде whole-file шляхом, як і до винесення.
- * @type {{ id: string, extensions: string[], extractFacts: typeof extractFacts, extractUnits: typeof extractUnitsJs }}
+ * `.vue` (SFC зі `<script setup>`) парситься через optional peer `vue/compiler-sfc`
+ * (ADR 260719-2155): props/emits/expose/слоти → факт-лист; без peer чи script-блоку —
+ * fallback `unsupported` (whole-file шлях, як до впровадження).
+ * @type {{ id: string, extensions: string[], extractFacts: typeof extractFacts, extractUnits: typeof extractUnits }}
  */
 const jsDocFilesExtractor = {
   id: 'js',
   extensions: ['.js', '.mjs', '.ts', '.vue'],
   extractFacts,
-  extractUnits: extractUnitsJs
+  extractUnits
 }
 
 export default jsDocFilesExtractor

package/doc-files/vue.mjs

@@ -0,0 +1,215 @@
+/** @see ./docs/vue.md */
+
+// Optional peer `vue`: компілятор резолвиться один раз при завантаженні модуля.
+// Свідомо НЕ статичний import — без установленого peer модуль має лишитися
+// робочим (extractFactsVue → unsupported), а не завалити весь handler lang-js
+// (catch у loadDocFilesExtractors мовчки прибрав би і JS/TS-екстрактор).
+let compilerSfc = null
+try {
+  compilerSfc = await import('vue/compiler-sfc')
+} catch {
+  /* peer `vue` не встановлено — .vue лишається unsupported (whole-file шлях) */
+}
+
+const QUOTED_NAME_RE = /'([^']{1,80})'|"([^"]{1,80})"/g
+// Object-style defineEmits<{ save: [id: number] }> — ключ вимагає tuple-значення
+// (`:\s*[`), щоб не ловити label-и всередині tuple (`[id: number]`) як імена подій.
+const EMIT_OBJECT_KEY_RE = /([\w$-]{1,80})\s*:\s*\[/g
+const EMITS_GENERIC_RE = /defineEmits<([^>]{1,2000})>/
+const EMITS_ARRAY_RE = /defineEmits\(\s*\[([^\]]{0,2000})\]/
+const EXPOSE_CALL_RE = /defineExpose\s*\(\s*\{([^()]{0,2000})\}\s*\)/
+// Провідний ідентифікатор одного елемента defineExpose (`focus`, `...rest`, `b: c`).
+const EXPOSE_ITEM_RE = /^(?:\.{3})?([\w$]{1,80})/
+// HTML-коментар template: [^>] гарантує зупинку на першому `>` (кінець `-->`).
+const HTML_COMMENT_RE = /<!--([^>]{0,300})>/g
+const SLOT_NAME_RE = /^[\w-]{1,80}/
+const SLOT_LEAD_MARK_RE = /^[:—-]{1,3}/
+// Канонічний патерн JSDoc-блоку без зворотного перебору.
+const JSDOC_BLOCK_RE = /\/\*\*[^*]*(?:\*(?!\/)[^*]*)*\*\//g
+const WORD_RE = /[\w$-]{1,80}/g
+// Модифікатори/ключові слова, які стоять між JSDoc-блоком і власне іменем
+// (декларації, `(e: '…'`-префікс сигнатури emit-події).
+const SKIP_WORDS = new Set(['readonly', 'export', 'async', 'function', 'const', 'class', 'e'])
+
+/**
+ * Порожній факт-лист unsupported-фолбеку (peer відсутній / битий SFC / без script).
+ * @param {string} relPath шлях файлу
+ * @returns {object} факт-лист із `unsupported: true`
+ */
+function unsupportedFacts(relPath) {
+  return { relPath, lang: 'vue', unsupported: true, header: '', exports: [], imports: {}, markers: {} }
+}
+
+/**
+ * Розбирає SFC і повертає script-блок (`<script setup>` пріоритетно) з дескриптором.
+ * @param {string} src вміст `.vue` файлу
+ * @param {string} relPath шлях (filename для компілятора)
+ * @returns {{ block: object, descriptor: object }|null} блок+дескриптор або null (нема компілятора / битий SFC / нема script)
+ */
+export function vueScriptBlock(src, relPath) {
+  if (!compilerSfc) return null
+  let descriptor
+  try {
+    ;({ descriptor } = compilerSfc.parse(src, { filename: relPath }))
+  } catch {
+    return null
+  }
+  const block = descriptor.scriptSetup ?? descriptor.script
+  if (!block?.content?.trim()) return null
+  return { block, descriptor }
+}
+
+/**
+ * Мапа «імʼя → JSDoc-опис» для всього script-блоку: кожен JSDoc-блок
+ * привʼязується до першого ідентифікатора одразу після нього (interface-member,
+ * ключ обʼєкта, декларація function/const для defineExpose-shorthand, сигнатура
+ * emit-події). Одна статична регулярка замість динамічних per-name.
+ * @param {string} content текст script-блоку
+ * @param {(raw: string) => {desc: string}} parseJsDoc парсер JSDoc з extractors
+ * @returns {Map<string, string>} імʼя → опис
+ */
+function jsDocMap(content, parseJsDoc) {
+  const map = new Map()
+  for (const m of content.matchAll(JSDOC_BLOCK_RE)) {
+    const after = content.slice(m.index + m[0].length, m.index + m[0].length + 120)
+    for (const w of after.matchAll(WORD_RE)) {
+      if (SKIP_WORDS.has(w[0])) continue
+      if (!map.has(w[0])) map.set(w[0], parseJsDoc(m[0]).desc)
+      break
+    }
+  }
+  return map
+}
+
+/**
+ * Імена props через `compileScript().bindings` — канонічний резолв і обʼєктної
+ * форми, і generic `defineProps<Props>()` з interface у тому ж блоці. Якщо
+ * компіляція впала (битий TS/макрос) — props не витягуються (порожній список).
+ * @param {object} descriptor SFC-дескриптор
+ * @param {string} relPath шлях (id для compileScript)
+ * @returns {string[]} імена props
+ */
+function vuePropNames(descriptor, relPath) {
+  try {
+    const compiled = compilerSfc.compileScript(descriptor, { id: relPath })
+    return Object.entries(compiled.bindings ?? {})
+      .filter(([, type]) => type === 'props')
+      .map(([name]) => name)
+  } catch {
+    return []
+  }
+}
+
+/**
+ * Імена подій із defineEmits: масив-форма (`['save']`), function-signature
+ * generic (`(e: 'save'): void`) — лапковані літерали; object-style generic
+ * (`{ save: [id: number] }`) — ключі з tuple-значенням.
+ * @param {string} content текст script-блоку
+ * @returns {string[]} імена подій
+ */
+function vueEmitNames(content) {
+  const m = content.match(EMITS_GENERIC_RE) ?? content.match(EMITS_ARRAY_RE)
+  if (!m) return []
+  const body = m[1]
+  const quoted = Array.from(body.matchAll(QUOTED_NAME_RE), q => q[1] ?? q[2])
+  if (quoted.length) return [...new Set(quoted)]
+  return [...new Set(Array.from(body.matchAll(EMIT_OBJECT_KEY_RE), k => k[1]))]
+}
+
+/**
+ * Імена публічно виставлених через defineExpose полів (обʼєктна форма).
+ * @param {string} content текст script-блоку
+ * @returns {string[]} імена exposed-полів
+ */
+function vueExposeNames(content) {
+  const m = content.match(EXPOSE_CALL_RE)
+  if (!m) return []
+  const names = m[1]
+    .split(',')
+    .map(item => item.trim().match(EXPOSE_ITEM_RE)?.[1])
+    .filter(Boolean)
+  return [...new Set(names)]
+}
+
+/**
+ * Слоти з маркер-коментарів slot у template (імʼя + опційний опис).
+ * Розбір двокроковий: спершу HTML-коментарі однією простою регуляркою,
+ * далі — плоский JS-парсинг тексту (без складних патернів).
+ * @param {string} template текст template-блоку
+ * @returns {Array<{name: string, desc: string}>} слоти
+ */
+function vueSlots(template) {
+  const slots = []
+  for (const m of template.matchAll(HTML_COMMENT_RE)) {
+    // m[1] — вміст до першого `>`, тобто разом із хвостовим `--` від `-->`
+    const text = m[1].endsWith('--') ? m[1].slice(0, -2).trim() : m[1].trim()
+    if (!text.startsWith('@slot')) continue
+    const rest = text.slice('@slot'.length).trim()
+    const name = rest.match(SLOT_NAME_RE)?.[0]
+    if (!name) continue
+    const desc = rest.slice(name.length).trim().replace(SLOT_LEAD_MARK_RE, '').trim()
+    slots.push({ name, desc })
+  }
+  return slots
+}
+
+/**
+ * Факт-лист для Vue SFC (`<script setup>` пріоритетно): props/emits/expose/слоти
+ * як публічний контракт компонента + переюз JS-хелперів (header, imports,
+ * markers) над текстом script-блоку — `<template>`/`<style>` у факти не течуть.
+ * Без peer `vue`, на битому SFC чи без script-блоку — `unsupported` (whole-file
+ * шлях, як до впровадження).
+ * @param {string} src вміст `.vue` файлу
+ * @param {string} relPath шлях файлу
+ * @param {object} h JS-хелпери з extractors (extractFileHeader, extractExports, extractImports, extractInternalSymbols, extractLocalSymbols, extractMarkers, parseJsDoc)
+ * @returns {object} факт-лист (`lang: 'vue'`)
+ */
+export function extractFactsVue(src, relPath, h) {
+  const sb = vueScriptBlock(src, relPath)
+  if (!sb) return unsupportedFacts(relPath)
+  const { block, descriptor } = sb
+  const content = block.content
+  const docs = jsDocMap(content, h.parseJsDoc)
+  const entry = kind => name => ({ name, kind, desc: docs.get(name) ?? '', params: [], ret: '' })
+
+  return {
+    relPath,
+    lang: 'vue',
+    header: h.extractFileHeader(content),
+    exports: [
+      ...vuePropNames(descriptor, relPath).map(entry('prop')),
+      ...vueEmitNames(content).map(entry('emit')),
+      ...vueExposeNames(content).map(entry('expose')),
+      ...h.extractExports(content)
+    ],
+    slots: vueSlots(descriptor.template?.content ?? ''),
+    imports: h.extractImports(content),
+    internalSymbols: h.extractInternalSymbols(content),
+    localSymbols: h.extractLocalSymbols(content),
+    markers: h.extractMarkers(content)
+  }
+}
+
+/**
+ * Юніт-шар для `.vue`: JS-юніти зі script-блоку з корекцією span-ів на offset
+ * блоку в файлі — anchors/CRC мають вказувати на позиції ОРИГІНАЛЬНОГО `.vue`,
+ * а не script-фрагмента.
+ * @param {string} src вміст `.vue` файлу
+ * @param {string} relPath шлях файлу
+ * @param {(src: string, relPath: string) => Array<object>|null} unitsJs екстрактор юнітів js/ts
+ * @returns {Array<object>|null} юніти або null (нема компілятора / script / не парситься)
+ */
+export function extractUnitsVue(src, relPath, unitsJs) {
+  const sb = vueScriptBlock(src, relPath)
+  if (!sb) return null
+  const { block } = sb
+  // relPath завжди закінчується на .vue (диспетчер викликає лише для нього)
+  const pseudoPath = relPath.slice(0, -'.vue'.length) + (block.lang === 'ts' ? '.ts' : '.js')
+  const units = unitsJs(block.content, pseudoPath)
+  if (!units) return null
+  const offset = block.loc.start.offset
+  for (const u of units) {
+    u.span = { start: u.span.start + offset, end: u.span.end + offset }
+  }
+  return units
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.7.0",
+  "version": "0.8.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",
@@ -58,10 +58,12 @@
     "jscpd": "^5.0.11",
     "knip": "^6.22.0",
     "oxc-parser": "^0.137.0",
-    "oxlint": "^1.68.0"
+    "oxlint": "^1.68.0",
+    "stylelint": "^17.6.0"
   },
   "peerDependencies": {
-    "@7n/rules": ">=1.27.0"
+    "@7n/rules": ">=1.27.0",
+    "vue": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -69,5 +71,10 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=24"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
   }
 }

package/rules/js-bun-redis/lib/docs/redis-imports.md

@@ -122,7 +122,7 @@ export function findRedisImportsInText(
 
 ### Внутрішні (репозиторій)
 
-Імпорт із `'../../../scripts/utils/ast-scan-utils.mjs'` — спільні утиліти AST-сканера для всіх правил у `npm/rules/*/lib/`:
+Імпорт із `'@7n/rules/scripts/utils/ast-scan-utils.mjs'` (ядро) — спільні утиліти AST-сканера, які використовують правила з декількох плагінів:
 
 - `dynamicImportModule(node)` — якщо вузол AST є динамічним `import('mod')`, повертає рядок `'mod'`, інакше `null`/`undefined`.
 - `langFromPath(path)` — обчислює `lang` для `oxc-parser` за розширенням шляху.
@@ -198,7 +198,7 @@ import x from 'my-redis-helpers' // довільний сторонній пак
 Контрольний перелік, за яким можна **відтворити** функціонал модуля «з нуля»:
 
 1. Створити файл `redis-imports.mjs`, що імпортує `parseSync` з `oxc-parser`.
-2. Імпортувати з `'../../../scripts/utils/ast-scan-utils.mjs'` шість утиліт: `dynamicImportModule`, `langFromPath`, `normalizeSnippet`, `offsetToLine`, `requireCallModule`, `walkAstWithAncestors`.
+2. Імпортувати з `'@7n/rules/scripts/utils/ast-scan-utils.mjs'` шість утиліт: `dynamicImportModule`, `langFromPath`, `normalizeSnippet`, `offsetToLine`, `requireCallModule`, `walkAstWithAncestors`.
 3. Оголосити константу `SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/u`.
 4. Оголосити константу `FORBIDDEN_MODULE_NAMES` як `Set` із елементами: `'ioredis'`, `'node-redis'`, `'redis'`, `'@redis/client'`, `'@redis/json'`, `'@redis/search'`, `'@redis/time-series'`, `'@redis/bloom'`.
 5. Реалізувати приватну функцію `isForbiddenRedisModule(mod)`: повертає `true`, якщо `FORBIDDEN_MODULE_NAMES.has(mod)` **або** `mod.startsWith('ioredis/')` **або** `mod.startsWith('redis/')` **або** `mod.startsWith('@redis/')`.

package/rules/style/admin_table/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/admin_table/main.mjs
 docgen:
-  crc: 267496d1
+  crc: fb8f81a5
 ---
 
 ## Огляд

package/rules/style/admin_table/main.mjs

@@ -13,8 +13,8 @@ const DEFINITION_RE = /\.n-admin-table\b/u
  * клас `n-admin-table`, він має бути визначений хоч в одному `.scss`/`.css`/`.vue`
  * (guide: `admin_table.mdc`). Для усунення false positives — крос-файлова перевірка,
  * тож потребує whole-repo сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/gap/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/gap/main.mjs
 docgen:
-  crc: 23cd7951
+  crc: 5d9d76e7
 ---
 
 ## Огляд

package/rules/style/gap/main.mjs

@@ -13,8 +13,8 @@ const DEFINITION_RE = /\.n-gap-(xs|sm|md|lg)\b/gu
  * використаний у `.vue`, має бути визначений хоч в одному `.scss`/`.css`/`.vue`
  * (guide: `gap.mdc`). Крос-файлова перевірка usage↔definition — потребує whole-repo
  * сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/lint/docs/fix-lint.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-lint.mjs
 resource: plugins/lang-js/rules/style/lint/fix-lint.mjs
 docgen:
-  crc: a63dc24c
+  crc: a44c6b01
 ---
 
 ## Огляд

package/rules/style/lint/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/lint/main.mjs
 docgen:
-  crc: c9a94f80
+  crc: 25130f97
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/style/lint/fix-lint.mjs

@@ -40,7 +40,7 @@ async function listStyleFiles(cwd, ctxFiles) {
   return (r.stdout ?? '').split('\0').filter(Boolean)
 }
 
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
 export const patterns = [
   {
     id: 'style-stylelint-fix',

package/rules/style/lint/main.mjs

@@ -1,7 +1,9 @@
 /**
  * lint-поверхня style: read-only detector (stylelint без --fix) для css/scss/vue.
- * Per-file (ctx.files) або весь проєкт (ctx.files === undefined). Якщо stylelint
- * недоступний — крок пропускається (без npx-автовстановлення).
+ * Per-file (ctx.files) або весь проєкт (ctx.files === undefined). `stylelint` —
+ * задекларована залежність плагіна (справжній `npm install` завжди його ставить);
+ * якщо резолв все ж не вдався (побитий install, hoisting-аномалія) — крок
+ * пропускається з видимим warn-diagnostic, а не мовчки (без npx-автовстановлення).
  */
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
@@ -33,8 +35,8 @@ export function resolveStylelint(cwd) {
 
 /**
  * Detector style/lint (read-only).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
@@ -54,8 +56,18 @@ export async function lint(ctx) {
 
   const stylelint = resolveStylelint(cwd)
   if (!stylelint) {
-    // stylelint недоступний → крок пропущено (без автовстановлення)
-    return reporter.result()
+    // stylelint — задекларована залежність плагіна, тож відсутність тут аномальна
+    // (побитий install, hoisting) — крок пропущено з видимим warn, не мовчки.
+    const result = reporter.result()
+    result.diagnostics = [
+      {
+        level: 'warn',
+        message:
+          'lint-style: `stylelint` не резолвиться (ні node_modules/.bin, ні PATH) — CSS/SCSS/Vue-стилі НЕ перевірені ' +
+          'цим прогоном (style.mdc). `stylelint` — залежність @7n/rules-lang-js; переустанови плагін, якщо бачиш це.'
+      }
+    ]
+    return result
   }
 
   const r = await spawnAsync(stylelint, targets, { cwd, shell: false })

package/rules/style/quasar_fixes/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/quasar_fixes/main.mjs
 docgen:
-  crc: 0f9c4631
+  crc: dec47808
 ---
 
 ## Огляд

package/rules/style/quasar_fixes/main.mjs

@@ -21,8 +21,8 @@ const FIXES = [
  * `<q-scroll-area>` або `<q-tooltip>`, у `.scss`/`.css`/`.vue` має бути відповідний
  * CSS-фікс (guide: `quasar_fixes.mdc`). Крос-файлова перевірка usage↔definition —
  * потребує whole-repo сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/tooling/docs/fix-tooling.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-tooling.mjs
 resource: plugins/lang-js/rules/style/tooling/fix-tooling.mjs
 docgen:
-  crc: a25e47d2
+  crc: 033af5f9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/rules/style/tooling/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/tooling/main.mjs
 docgen:
-  crc: c96a4b01
+  crc: aeb36134
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
   issues: anchor-miss:extensions.json,anchor-miss:settings.json,judge:inaccurate:0.99

package/rules/style/tooling/fix-tooling.mjs

@@ -12,7 +12,7 @@ const STYLELINTIGNORE_MISSING_RE = /\.stylelintignore не існує/u
 const STYLELINTIGNORE_NO_DIST_RE = /\.stylelintignore не містить рядка dist\//u
 const NO_STYLELINT_CONFIG_RE = /Немає конфігу stylelint/u
 
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
 export const patterns = [
   {
     id: 'style-stylelintignore-create',

package/rules/style/tooling/main.mjs

@@ -45,8 +45,8 @@ async function checkStylelintConfigPresence(reporter, cwd) {
 
 /**
  * Перевіряє відповідність проєкту правилам style.mdc
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const cwd = ctx.cwd