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

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "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,7 +58,8 @@
     "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"

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