@nitra/cursor 1.8.161 → 1.8.163

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.163] - 2026-05-01
+
+### Changed
+
+- `check-js-lint.mjs`: `ignorePatterns` у `.oxlintrc.json` тепер звіряється як `rules` — канонічні патерни мають бути присутні, додаткові локальні glob-и дозволені (раніше була строга рівність — будь-який зайвий запис зламував перевірку).
+- `check-text.mjs`: `OXFMT_REQUIRED_IGNORE_PATTERNS` доповнено `**/auto-imports.d.ts` (узгоджено з каноном oxlint); перевірка `.oxfmtrc.json` уже працює як subset, тому локальні розширення не падають.
+- `js-lint.mdc` / `n-js-lint.mdc`, `text.mdc` / `n-text.mdc`: документовано, що канон задає мінімум `ignorePatterns`, локальне розширення дозволене.
+
+## [1.8.162] - 2026-05-01
+
+### Changed
+
+- `oxlint-canonical-skeleton.json` (та перебудований `oxlint-canonical.json`): `ignorePatterns` тепер містить `["**/schema.graphql", "**/auto-imports.d.ts"]` (узгоджено з `.oxfmtrc.json`). Споживачі мають синхронізувати корінь `.oxlintrc.json` із каноном — `check-js-lint` падатиме, поки масив не збігається.
+
 ## [1.8.161] - 2026-05-01
 
 ### Added

package/mdc/js-lint.mdc

@@ -30,7 +30,7 @@ version: '1.16'
 }
 ```
 
-У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/scripts/utils/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**, **`ignorePatterns`**). Оновити можна з репозиторію пакета або скопіювавши файл після **`bun ./scripts/utils/rebuild-oxlint-canonical.mjs`** (джерело правил — **`oxlint-rules.tsv`** + скелет **`oxlint-canonical-skeleton.json`**). Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
+У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/scripts/utils/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Оновити канон можна з репозиторію пакета або скопіювавши файл після **`bun ./scripts/utils/rebuild-oxlint-canonical.mjs`** (джерело правил — **`oxlint-rules.tsv`** + скелет **`oxlint-canonical-skeleton.json`**). Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
 
 Мінімум для розуміння структури (реальний корінь конфігу має збігатися з каноном повністю):
 

package/mdc/text.mdc

@@ -82,7 +82,7 @@ version: '1.25'
 
 ```json title=".oxfmtrc.json"
 {
-  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql"],
+  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql", "**/auto-imports.d.ts"],
   "arrowParens": "avoid",
   "printWidth": 120,
   "bracketSpacing": true,
@@ -104,7 +104,7 @@ version: '1.25'
 }
 ```
 
-Поле **`ignorePatterns`** обовʼязкове: у масиві мають бути **`**/hasura/metadata/**`** та **`**/schema.graphql`**; інші glob-и додавай за потреби (згенеровані каталоги тощо).
+Поле **`ignorePatterns`** обовʼязкове: у масиві мають бути **`**/hasura/metadata/**`**, **`**/schema.graphql`** і **`**/auto-imports.d.ts`**; інші glob-и додавай за потреби (згенеровані каталоги тощо) — канон задає мінімум, локальні розширення дозволені.
 
 Також потрібно прибрати, якщо є в проєкті, модуль **`@nitra/prettier-config`**, **prettier** та всі виклики prettier і налаштування для нього.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.161",
+  "version": "1.8.163",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -47,5 +47,8 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
+  },
+  "devDependencies": {
+    "@nitra/cursor": "^1.8.163"
   }
 }

package/scripts/check-js-lint.mjs

@@ -133,6 +133,30 @@ function compareOxlintRules(expected, actual, failures) {
   }
 }
 
+/**
+ * Звіряє блок `ignorePatterns`: кожен патерн із канону має бути присутній в actual; додаткові локальні
+ * патерни дозволені (канон задає мінімум, проєкт може розширити).
+ * @param {unknown} expected канонічний масив `ignorePatterns`
+ * @param {unknown} actual поточний `ignorePatterns` із `.oxlintrc.json`
+ * @param {string[]} failures буфер для помилок
+ */
+function compareOxlintIgnorePatterns(expected, actual, failures) {
+  if (!Array.isArray(expected)) {
+    return
+  }
+  if (!Array.isArray(actual)) {
+    failures.push('.oxlintrc.json: поле "ignorePatterns" має бути масивом (канон задає мінімум, додаткові патерни дозволені)')
+    return
+  }
+  const set = new Set(actual)
+  const missing = expected.filter(p => !set.has(p))
+  if (missing.length > 0) {
+    failures.push(
+      `.oxlintrc.json: ignorePatterns має містити канонічні патерни — додай: ${missing.map(p => JSON.stringify(p)).join(', ')}`
+    )
+  }
+}
+
 /**
  * Перевіряє `.oxlintrc.json` проти канону пакета `@nitra/cursor` (усі правила з канону та інші поля з `oxlint-canonical.json`).
  * Додаткові ключі лише в `rules` дозволені; інші поля мають збігатися з каноном.
@@ -160,6 +184,11 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
       continue
     }
 
+    if (key === 'ignorePatterns') {
+      compareOxlintIgnorePatterns(expected, actual, failures)
+      continue
+    }
+
     if (!deepEqualOxlintCanonical(actual, expected)) {
       failures.push(
         `.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/scripts/utils/oxlint-canonical.json)`

package/scripts/check-text.mjs

@@ -29,8 +29,8 @@ const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)/
 /** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
 const UK_APOSTROPHE_HEADING = '**Український апостроф:**'
 
-/** Мінімальні glob-и в `ignorePatterns` у `.oxfmtrc.json` (text.mdc). */
-const OXFMT_REQUIRED_IGNORE_PATTERNS = ['**/hasura/metadata/**', '**/schema.graphql']
+/** Мінімальні glob-и в `ignorePatterns` у `.oxfmtrc.json` (text.mdc) — додаткові патерни локально дозволені. */
+const OXFMT_REQUIRED_IGNORE_PATTERNS = ['**/hasura/metadata/**', '**/schema.graphql', '**/auto-imports.d.ts']
 
 /** Канонічні записи `ignorePaths` у `.cspell.json` (text.mdc) — кожен має бути присутнім. */
 const CSPELL_REQUIRED_IGNORE_PATHS = [
@@ -211,7 +211,7 @@ async function checkOxfmtRc(passFn, failFn) {
     const set = new Set(cfg.ignorePatterns)
     const missingPatterns = OXFMT_REQUIRED_IGNORE_PATTERNS.filter(p => !set.has(p))
     if (missingPatterns.length === 0) {
-      passFn('.oxfmtrc.json: ignorePatterns містить hasura/metadata та schema.graphql')
+      passFn('.oxfmtrc.json: ignorePatterns містить hasura/metadata, schema.graphql і auto-imports.d.ts')
     } else {
       failFn(
         `.oxfmtrc.json ignorePatterns: додай відсутні елементи: ${missingPatterns.join(', ')} (канонічний приклад у text.mdc)`

package/scripts/utils/oxlint-canonical-skeleton.json

@@ -23,5 +23,5 @@
     "builtin": true
   },
   "globals": {},
-  "ignorePatterns": []
+  "ignorePatterns": ["**/schema.graphql", "**/auto-imports.d.ts"]
 }

package/scripts/utils/oxlint-canonical.json

@@ -1,7 +1,17 @@
 {
   "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "plugins": ["unicorn", "oxc", "import", "jsdoc", "promise", "node", "vue"],
-  "jsPlugins": ["@e18e/eslint-plugin"],
+  "plugins": [
+    "unicorn",
+    "oxc",
+    "import",
+    "jsdoc",
+    "promise",
+    "node",
+    "vue"
+  ],
+  "jsPlugins": [
+    "@e18e/eslint-plugin"
+  ],
   "categories": {},
   "rules": {
     "e18e/prefer-includes": "error",
@@ -383,5 +393,8 @@
     "builtin": true
   },
   "globals": {},
-  "ignorePatterns": []
+  "ignorePatterns": [
+    "**/schema.graphql",
+    "**/auto-imports.d.ts"
+  ]
 }