@7n/rules-lang-js 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.4.1] - 2026-07-19
+
+### Fixed
+
+- js/knip: вбудований ігнор unused-dependency на пакети екосистеми n-rules (@7n/rules і @7n/rules-* плагіни — їх ставить сам npx @7n/rules, код споживача не імпортує) + канон knip ignoreDependencies з тим самим патерном
+
 ## [0.4.0] - 2026-07-19
 
 ### Added

package/package.json

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

package/rules/js/knip/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/js/knip/main.mjs
 docgen:
-  crc: 7506fcd8
+  crc: e46cd90b
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98
@@ -12,21 +12,20 @@ docgen:
 
 ## Огляд
 
-Аналізує проєкт на предмет невикористаних залежностей та експортів. Виконує операцію лише для читання, не змінюючи файлову систему чи базу даних. Публічна функція `lint` надає звіт про виявлені проблеми, який визначається за кодом виходу.
+Lint-поверхня `js/knip`: read-only detector невикористаних залежностей, експортів і файлів через programmatic API knip. Кожен knip-issue стає одним порушенням (`reason` = тип issue, `file`/`line` де доступні); звіт рендерить runner, сам детектор нічого не друкує і не мутує (без `--fix`).
 
 ## Поведінка
 
-1. Викликається функція `lint`.
-2. Система аналізує проект на предмет невикористаних залежностей та експортів.
-3. На основі збору виявлених проблем, система генерує звіт.
-4. Якщо знайдено хоча б одну проблему, функція повертає значення 1; інакше — 0.
+- `lint(ctx)` будує опції knip (`createOptions` з dist-каталогу пакета — внутрішній util не експортується через `exports`), глушить TTY-прогрес поза `ctx.verbose` і жене `knipMain`.
+- Кожен issue з `results.issues` нормалізується у violation: `message` = `knip: <тип> \`<символ>\` — <файл:рядок>`, `severity` warn/error за knip.
+- Вбудований ігнор пакетів екосистеми n-rules: unused dependency/devDependency-issue на `@7n/rules` та `@7n/rules-*` (lang-/ci-плагіни) відкидається — їх ставить і веде сам `npx @7n/rules`, код споживача їх не імпортує, тож у кожному consumer-репо це було б хибне спрацювання. Інші типи issue (files, exports) на ці пакети НЕ ігноруються.
 
 ## Публічний API
 
-Я розумію завдання. Мені потрібно перетворити технічний опис на лаконічну, поведінкову документацію українською мовою у форматі маркерів, дотримуючись усіх зазначених обмежень.
-
-Будь ласка, надайте список, який потрібно переписати.
+- lint — детектор js/knip: повертає `{ violations }` з нормалізованими knip-issue.
+- isNRulesPackageIssue — чи є issue хибним спрацюванням на пакет екосистеми n-rules (експортовано для тестів).
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
+- Read-only: knip запускається без `--fix`, жодних мутацій ФС/БД.
+- Не друкує звіт — рендеринг на боці runner-а.

package/rules/js/knip/main.mjs

@@ -9,6 +9,25 @@ import { pathToFileURL } from 'node:url'
 
 import { main as knipMain } from 'knip'
 
+// Пакети екосистеми n-rules (ядро і lang-/ci-плагіни): їх ставить і веде сам
+// `npx @7n/rules` як devDependency, код споживача їх не імпортує — knip завжди
+// вважав би їх unused. Вбудований ігнор знімає хибне спрацювання у ВСІХ consumer-репо без
+// правки їхніх knip.json (канон ignoreDependencies покриває лише свіжі копії).
+const N_RULES_PKG_RE = /^@7n\/rules(-.+)?$/u
+
+/**
+ * Чи є issue хибним спрацюванням на пакет екосистеми n-rules (unused dependency/devDependency).
+ * @param {{ type: string, symbol?: string }} issue knip-issue
+ * @returns {boolean} true — ігноруємо
+ */
+export function isNRulesPackageIssue(issue) {
+  return (
+    (issue.type === 'dependencies' || issue.type === 'devDependencies') &&
+    typeof issue.symbol === 'string' &&
+    N_RULES_PKG_RE.test(issue.symbol)
+  )
+}
+
 /**
  * Один knip-issue → LintViolation.
  * @param {{ type: string, filePath?: string, symbol?: string, symbolType?: string, line?: number, col?: number, severity?: string }} issue knip-issue
@@ -60,7 +79,9 @@ export async function lint(ctx) {
   for (const byFile of Object.values(results.issues)) {
     for (const byKey of Object.values(byFile)) {
       for (const issue of Object.values(byKey)) {
-        violations.push(issueToViolation(/** @type {Parameters<typeof issueToViolation>[0]} */ (issue), cwd))
+        const typed = /** @type {Parameters<typeof issueToViolation>[0]} */ (issue)
+        if (isNRulesPackageIssue(typed)) continue
+        violations.push(issueToViolation(typed, cwd))
       }
     }
   }

package/rules/js/tooling/data/tooling/knip-canonical.json

@@ -12,7 +12,7 @@
   ],
   "project": ["**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts}"],
   "ignore": ["**/__fixtures__/**"],
-  "ignoreDependencies": ["@nitra/cspell-dict", "/@cspell\\/dict-.+/", "graphql"],
+  "ignoreDependencies": ["@nitra/cspell-dict", "/@cspell\\/dict-.+/", "/@7n\\/rules(-.+)?/", "graphql"],
   "ignoreBinaries": [
     "actionlint",
     "cspell",