@nitra/cursor 12.13.0 → 12.14.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.14.0] - 2026-06-26
+
+### Changed
+
+- Заміна picomatch на ignore для обробки glob-ів у docgen та resolve-target-files
+
 ## [12.13.0] - 2026-06-26
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.13.0",
+  "version": "12.14.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -55,6 +55,7 @@
   "dependencies": {
     "@7n/mt": "^0.5.1",
     "globby": "^16.0.0",
+    "ignore": "^7.0.5",
     "oxc-parser": "^0.137.0",
     "picomatch": "^4.0.4",
     "smol-toml": "^1.7.0",

package/rules/doc-files/js/docgen-ignore.mjs

@@ -1,5 +1,5 @@
 /** @see ./docs/docgen-ignore.md */
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 /** Базовий список glob-ів для `docgen` ignore. */
 export const DOCGEN_IGNORE_GLOBS = Object.freeze([
@@ -22,7 +22,7 @@ export const DOCGEN_IGNORE_GLOBS = Object.freeze([
   'npm/rules/k8s/js/manifests.mjs'
 ])
 
-const IGNORE_MATCHERS = DOCGEN_IGNORE_GLOBS.map(glob => picomatch(glob, { dot: true }))
+const ig = ignore().add(DOCGEN_IGNORE_GLOBS)
 
 /**
  * Нормалізує відносний шлях до posix-формату для glob-matching.
@@ -36,7 +36,7 @@ function toPosixRelPath(relPath) {
 /**
  * Перевіряє, чи шлях має бути пропущений `docgen`.
  * Для `kind = 'dir'` це працює і на піддерево каталогу, тож glob на кшталт
- * `**\\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
+ * `**\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
  * @param {string} relPath відносний шлях від кореня проєкту
  * @param {'path'|'dir'} [kind] тип перевірки (за замовчуванням `'path'`)
  * @returns {boolean} `true`, якщо шлях ігнорується
@@ -47,7 +47,8 @@ export function isDocgenIgnored(relPath, kind = 'path') {
   }
   const posixRelPath = toPosixRelPath(relPath)
   if (kind === 'dir') {
-    return IGNORE_MATCHERS.some(match => match(posixRelPath) || match(`${posixRelPath}/__docgen__`))
+    // `**/demo/**` не матчить `demo` напряму — перевіряємо фіктивний файл всередині
+    return ig.ignores(posixRelPath) || ig.ignores(`${posixRelPath}/__docgen__`)
   }
-  return IGNORE_MATCHERS.some(match => match(posixRelPath))
+  return ig.ignores(posixRelPath)
 }

package/rules/doc-files/js/docs/docgen-ignore.md

@@ -3,7 +3,7 @@ type: JS Module
 title: docgen-ignore.mjs
 resource: npm/rules/doc-files/js/docgen-ignore.mjs
 docgen:
-  crc: c17cd785
+  crc: 00687334
   score: 100
 ---
 

package/scripts/lib/docs/resolve-target-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-target-files.mjs
 resource: npm/scripts/lib/resolve-target-files.mjs
 docgen:
-  crc: a3b361d9
+  crc: 4d3546e6
 ---
 
 Цей файл відповідає за перевірку наявності файлів, що відповідають певним правилам, вказаним у файлах `policy/<name>/target.json`. Він створює список файлів для подальшого використання, використовуючи або конкретні відносні шляхи, або обхід каталогу з використанням шаблонів та ігнорування файлів. Це забезпечує узгодженість та контроль над файлами, які потрібно обробити, відповідно до заданих політик.
@@ -16,7 +16,7 @@ docgen:
 4.  **Завантаження ігнорування:** Завантажує список абсолютних шляхів, які слід ігнорувати, з конфігурації `.n-cursor.json:ignore`.
 5.  **Кешування обходу:** Використовує кеш обходу дерева (Map) для запобігання повторному обходу одного й того ж набору ігнорування. Якщо обхід вже виконано для заданого набору ігнорування, повертає результат з кешу.
 6.  **Обхід дерева:** Якщо обхід не кешований або кеш порожній, виконує обхід дерева файлів від заданого кореня, використовуючи `walkDir`. Під час обходу генерує відносні шляхи файлів від кореня.
-7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `picomatch`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
+7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `ignore`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
 8.  **Збіг з ігноруванням:** Перевіряє, чи файл не входить до списку ігнорування.
 9.  **Збіг шляху:** Перетворює відносні шляхи файлів у абсолютні шляхи, додавши корень.
 10. **Повернення результатів:** Повертає масив абсолют
@@ -29,7 +29,7 @@ resolveTargetFiles — Знаходить файли, що вказані в `ta
 
 - **Контракт на поліси:** Зчитуються лише файли з репозиторію.
 - **`single`:** Якщо `existsSync`, повертається список файлів, що відповідають `single`. Інакше, повертається порожній список.
-- **`walkGlob`:** Використовується picomatch для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
+- **`walkGlob`:** Використовується ignore для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
 - **Ігнорування:** Підтримується ігнорування файлів за допомогою `.n-cursor.json:ignore` та кешування шляхів ігнорування у `walkCache`.
 - **Кешування:** Результати обходу кешуються для повторного використання при однаковому наборі ігнорувань.
 - **Path-traversal:** При розв'язанні шляхів у формі `single` виникає помилка.

package/scripts/lib/resolve-target-files.mjs

@@ -4,7 +4,7 @@
  * Дві форми у `target.json:files`:
  *   - `{ "single": "<rel>" }` — конкретний відносний шлях. Якщо `existsSync(root/single)` → `[single]`;
  *     інакше `[]` (caller сам вирішує fail vs silent skip за `required`).
- *   - `{ "walkGlob": <glob | glob[]> }` — picomatch проти posix-відносних шляхів, отриманих обходом
+ *   - `{ "walkGlob": <glob | glob[]> }` — `ignore` проти posix-відносних шляхів, отриманих обходом
  *     `walkDir` від `root` із загальними skip-ами та `.n-cursor.json:ignore`. Обхід кешований у
  *     `walkCache` (Map ключ — підпис ignorePaths) — повторні таргети з тим самим набором ignore
  *     перевикористовують список без нового readdir.
@@ -15,7 +15,7 @@
 import { existsSync } from 'node:fs'
 import { isAbsolute, join, normalize, relative, sep } from 'node:path'
 
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 import { loadCursorIgnorePaths } from './load-cursor-config.mjs'
 import { walkDir } from '../utils/walkDir.mjs'
@@ -96,14 +96,8 @@ export async function resolveTargetFiles(filesSpec, root, walkCache) {
     const ignorePaths = await loadCursorIgnorePaths(root)
     const all = await getAllFilesCached(root, ignorePaths, walkCache)
     const globs = Array.isArray(filesSpec.walkGlob) ? filesSpec.walkGlob : [filesSpec.walkGlob]
-    // picomatch у масиві трактує `!neg` як ОКРЕМИЙ позитивний матчер «не-neg» (some-OR логіка),
-    // тож наївне `picomatch(['pos','!neg'])` повертає true майже на всьому. Розділяємо вручну:
-    // позитиви join-имо через picomatch(...), негативні фільтруємо окремим isExcluded.
-    const positives = globs.filter(g => !g.startsWith('!'))
-    const negatives = globs.filter(g => g.startsWith('!')).map(g => g.slice(1))
-    const isMatch = positives.length > 0 ? picomatch(positives, { dot: false }) : () => false
-    const isExcluded = negatives.length > 0 ? picomatch(negatives, { dot: false }) : () => false
-    return all.filter(rel => isMatch(rel) && !isExcluded(rel)).map(rel => join(root, rel))
+    const ig = ignore().add(globs)
+    return all.filter(rel => ig.ignores(rel)).map(rel => join(root, rel))
   }
   throw new Error(`target.json: files має містити single або walkGlob (отримано: ${JSON.stringify(filesSpec)})`)
 }