@nitra/cursor 1.8.145 → 1.8.147

package/scripts/check-vue.mjs

@@ -69,6 +69,42 @@ function isEsbuildScanFile(relPosix) {
   )
 }
 
+/**
+ * Збирає `esbuild`-матчі по рядках одного файлу, поки буфер не досягне ліміту.
+ * @param {string} rel relative path
+ * @param {string} content вміст файлу
+ * @param {{ rel: string; line: number; snippet: string }[]} matches буфер для збору матчів
+ * @param {number} maxMatches максимум елементів у буфері
+ */
+function appendEsbuildLineMatches(rel, content, matches, maxMatches) {
+  const lines = content.split('\n')
+  for (const [i, line] of lines.entries()) {
+    if (matches.length >= maxMatches) return
+    if (ESBUILD_RE.test(line)) {
+      matches.push({ rel, line: i + 1, snippet: line.trim() })
+    }
+  }
+}
+
+/**
+ * Перебирає вибрані файли пакета і збирає до `maxMatches` згадок `esbuild`.
+ * @param {string} absPackageRoot абсолютний шлях до кореня пакета
+ * @param {{ rel: string }[]} files перелік відносних шляхів
+ * @param {number} maxMatches максимум знайдених матчів
+ * @returns {Promise<{ rel: string; line: number; snippet: string }[]>} зібрані матчі
+ */
+async function collectEsbuildMatchesInFiles(absPackageRoot, files, maxMatches) {
+  /** @type {{ rel: string; line: number; snippet: string }[]} */
+  const matches = []
+  for (const { rel } of files) {
+    if (matches.length >= maxMatches) break
+    const content = await readFile(join(absPackageRoot, rel), 'utf8')
+    if (!ESBUILD_RE.test(content)) continue
+    appendEsbuildLineMatches(rel, content, matches, maxMatches)
+  }
+  return matches
+}
+
 /**
  * Сканує дерево пакета на згадки `esbuild` і підказує заміну на `rolldown`.
  * @param {string} rootDir відносний шлях до пакета
@@ -78,31 +114,16 @@ function isEsbuildScanFile(relPosix) {
  * @param {(msg: string) => void} fail callback при помилці
  */
 async function checkEsbuildMentions(rootDir, absPackageRoot, prefix, passFn, fail) {
-  /** @type {{ rel: string; line: number; snippet: string }[]} */
-  const hits = []
-
+  /** @type {{ rel: string }[]} */
+  const candidates = []
   await walkDir(absPackageRoot, absPath => {
     const rel = relative(absPackageRoot, absPath).split('\\').join('/')
     if (!isEsbuildScanFile(rel)) return
-    hits.push({ rel, line: 0, snippet: '' })
+    candidates.push({ rel })
   })
 
-  // ми використали hits як буфер шляхів; зараз перетворимо на реальні співпадіння
-  /** @type {{ rel: string; line: number; snippet: string }[]} */
-  const matches = []
-  for (const { rel } of hits) {
-    const content = await readFile(join(absPackageRoot, rel), 'utf8')
-    if (!ESBUILD_RE.test(content)) continue
-
-    const lines = content.split('\n')
-    for (let i = 0; i < lines.length; i++) {
-      if (ESBUILD_RE.test(lines[i])) {
-        matches.push({ rel, line: i + 1, snippet: lines[i].trim() })
-        if (matches.length >= 30) break
-      }
-    }
-    if (matches.length >= 30) break
-  }
+  const maxMatches = 30
+  const matches = await collectEsbuildMatchesInFiles(absPackageRoot, candidates, maxMatches)
 
   if (matches.length === 0) {
     passFn(`${prefix}немає згадок 'esbuild' у джерелах пакета (очікується rolldown)`)
@@ -112,8 +133,8 @@ async function checkEsbuildMentions(rootDir, absPackageRoot, prefix, passFn, fai
   for (const m of matches) {
     fail(`${prefix}${m.rel}:${m.line} — знайдено 'esbuild'. Замінити на 'rolldown'. Фрагмент: ${m.snippet}`)
   }
-  if (matches.length >= 30) {
-    fail(`${prefix}показано перші 30 збігів 'esbuild' (замінити на 'rolldown')`)
+  if (matches.length >= maxMatches) {
+    fail(`${prefix}показано перші ${maxMatches} збігів 'esbuild' (замінити на 'rolldown')`)
   }
 }
 
@@ -308,44 +329,60 @@ async function checkVuePackage(rootDir, fail, passFn) {
 }
 
 /**
- * Перевіряє відповідність проєкту правилам vue.mdc (корінь і всі workspace-пакети з `vue` у dependencies).
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ * Збирає корені пакетів, у яких у `dependencies` є `vue`.
+ * @param {string[]} roots усі корені пакетів monorepo
+ * @returns {Promise<string[]>} перелік пакетів з vue у dependencies
  */
-export async function check() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
-
-  const roots = await getMonorepoPackageRootDirs()
+async function collectVueRoots(roots) {
   /** @type {string[]} */
   const vueRoots = []
   for (const r of roots) {
     const p = join(r, 'package.json')
-    if (existsSync(p)) {
-      const pkg = JSON.parse(await readFile(p, 'utf8'))
-      if (pkg.dependencies?.vue) vueRoots.push(r)
-    }
+    if (!existsSync(p)) continue
+    const pkg = JSON.parse(await readFile(p, 'utf8'))
+    if (pkg.dependencies?.vue) vueRoots.push(r)
   }
+  return vueRoots
+}
 
-  if (vueRoots.length > 0) {
-    if (existsSync('.vscode/extensions.json')) {
-      const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
-      if (ext.recommendations?.includes('Vue.volar')) {
-        pass('extensions.json містить Vue.volar')
-      } else {
-        fail('extensions.json не містить Vue.volar — додай до recommendations')
-      }
-    } else {
-      fail('.vscode/extensions.json не існує (для Vue-проєкту потрібна рекомендація Vue.volar)')
-    }
+/**
+ * Перевіряє наявність рекомендації `Vue.volar` у `.vscode/extensions.json`.
+ * @param {(msg: string) => void} pass pass callback
+ * @param {(msg: string) => void} fail fail callback
+ * @returns {Promise<void>}
+ */
+async function checkVueVolarRecommendation(pass, fail) {
+  if (!existsSync('.vscode/extensions.json')) {
+    fail('.vscode/extensions.json не існує (для Vue-проєкту потрібна рекомендація Vue.volar)')
+    return
+  }
+  const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+  if (ext.recommendations?.includes('Vue.volar')) {
+    pass('extensions.json містить Vue.volar')
   } else {
-    pass('Vue.volar: пропущено (у repo немає пакетів з vue у dependencies)')
+    fail('extensions.json не містить Vue.volar — додай до recommendations')
   }
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам vue.mdc (корінь і всі workspace-пакети з `vue` у dependencies).
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  const roots = await getMonorepoPackageRootDirs()
+  const vueRoots = await collectVueRoots(roots)
 
   if (vueRoots.length === 0) {
+    pass('Vue.volar: пропущено (у repo немає пакетів з vue у dependencies)')
     pass('vue не знайдено в dependencies жодного пакета (перевірка vue пропущена)')
     return reporter.getExitCode()
   }
 
+  await checkVueVolarRecommendation(pass, fail)
+
   for (const r of vueRoots) {
     await checkVuePackage(r, fail, pass)
   }

package/scripts/cli-entry.mjs

@@ -1,8 +1,8 @@
 /**
  * Визначення, чи виконується поточний ESM-модуль як точка входу CLI, а не як import у тестах чи інших модулях.
  *
- * У Bun використовується `import.meta.main`; у Node — порівняння `import.meta.url` з `process.argv[1]`
- * після `resolve`, щоб `bun path/to/script.mjs` і `node path/to/script.mjs` коректно вважалися прямим запуском.
+ * Порівняння `import.meta.url` з `process.argv[1]` після `resolve`, щоб `bun path/to/script.mjs`
+ * і `node path/to/script.mjs` коректно вважалися прямим запуском.
  */
 import { resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -12,9 +12,6 @@ import { fileURLToPath } from 'node:url'
  * @returns {boolean} `true`, якщо файл запущено напряму; інакше `false`.
  */
 export function isRunAsCli() {
-  if (import.meta.main === true) {
-    return true
-  }
   try {
     const entry = process.argv[1]
     if (!entry) {

package/scripts/upgrade-nitra-cursor-and-install.mjs

@@ -108,7 +108,7 @@ async function runBunInstall(projectRoot) {
   } catch (error) {
     const exitCode = typeof error?.code === 'number' ? error.code : null
     if (exitCode !== null && exitCode !== 0) {
-      throw new Error(`bun i завершився з кодом ${exitCode}`)
+      throw new Error(`bun i завершився з кодом ${exitCode}`, { cause: error })
     }
     throw error
   }

package/scripts/utils/bun-sql-scan.mjs

@@ -278,7 +278,7 @@ export function findUnsafeBunSqlDynamicSqlListInText(content, virtualPath = 'sca
  * Скан по сирому тексту — без AST, щоб бути дешевим: викликається на кожному
  * JS/TS-файлі при зборі ознак для авто-детекту правил.
  * @param {string} content вміст файлу
- * @returns {boolean}
+ * @returns {boolean} true, якщо є імпорт sql або SQL з модуля bun
  */
 export function textHasBunSqlImport(content) {
   return BUN_SQL_IMPORT_RE.test(content)

package/scripts/utils/mssql-pool-scan.mjs

@@ -307,7 +307,6 @@ export function findSharedMssqlRequestInText(content, virtualPath = 'scan.ts') {
  *
  * Цей патерн небезпечний навіть якщо зовні використовується tagged template, бо в запит
  * потрапляє “готовий шматок SQL”, а не параметризовані значення.
- *
  * @param {string} content вихідний код
  * @param {string} [virtualPath] шлях для вибору `lang`
  * @returns {{ line: number, snippet: string }[]} список порушень
@@ -371,6 +370,24 @@ function isLiteralNumericArrayExpression(node) {
   })
 }
 
+/**
+ * Чи це безпосередній виклик числового парсера (parseInt/parseFloat/Number/BigInt)
+ * або обʼєктний доступ до них (наприклад `Number.parseInt(...)`).
+ * @param {Record<string, unknown>} node AST CallExpression
+ * @returns {boolean} true, якщо callee — числовий парсер
+ */
+function isNumericParseCallExpression(node) {
+  if (node.type !== 'CallExpression') return false
+  const callee = node.callee
+  if (!callee) return false
+  if (callee.type === 'Identifier' && NUMERIC_PARSE_FN_NAMES.has(callee.name)) return true
+  if (callee.type === 'MemberExpression' && !callee.computed) {
+    const prop = callee.property
+    return !!prop && prop.type === 'Identifier' && NUMERIC_PARSE_FN_NAMES.has(prop.name)
+  }
+  return false
+}
+
 /**
  * Чи містить піддерево виклик числового парсера (parseInt/parseFloat/Number/BigInt)
  * або унарний `+` (приведення до Number). Це сигнал, що значення гарантовано числове
@@ -380,20 +397,9 @@ function isLiteralNumericArrayExpression(node) {
  */
 function subtreeHasNumericParseCall(node) {
   if (!node || typeof node !== 'object') return false
-  if (Array.isArray(node)) return node.some(subtreeHasNumericParseCall)
+  if (Array.isArray(node)) return node.some(item => subtreeHasNumericParseCall(item))
 
-  if (node.type === 'CallExpression') {
-    const callee = node.callee
-    if (callee && callee.type === 'Identifier' && NUMERIC_PARSE_FN_NAMES.has(callee.name)) {
-      return true
-    }
-    if (callee && callee.type === 'MemberExpression' && !callee.computed) {
-      const prop = callee.property
-      if (prop && prop.type === 'Identifier' && NUMERIC_PARSE_FN_NAMES.has(prop.name)) {
-        return true
-      }
-    }
-  }
+  if (isNumericParseCallExpression(node)) return true
   if (node.type === 'UnaryExpression' && node.operator === '+') return true
 
   for (const key of Object.keys(node)) {
@@ -426,7 +432,6 @@ function collectVariableDeclarators(programNode) {
  *
  * Якщо для Identifier немає видимого init (наприклад параметр функції чи import),
  * вираз вважається не парсованим — потрібен явний парсер на місці підстановки.
- *
  * @param {unknown} expr вираз з template.expressions
  * @param {Array<Record<string, unknown>>} declarators VariableDeclarator-и файлу
  * @param {Set<string>} [seen] іменa Identifier-ів, що вже трасуються (анти-цикл)
@@ -461,19 +466,52 @@ function isInListExpressionParsed(expr, declarators, seen = new Set()) {
 }
 
 /**
- * Знаходить підстановки `IN (${expr})` у TemplateLiteral, де `expr` не пройшов числовий парсер.
- *
- * Навіть у безпечному `pool.request().query\`...\`` краще явно парсити значення (parseInt/
- * Number/BigInt/parseFloat) та фільтрувати NaN — це гарантує, що жодний елемент не може
- * містити SQL-метасимволи, навіть якщо колись query-функція або обгортка зміняться. У
- * небезпечних контекстах (наприклад `pool.query(String.raw\`...\`)`) це єдиний бар'єр від SQL
- * injection.
- *
- * Випадки `${arr.join(',')}` свідомо ігноруються — їх ловить
- * {@link findUnsafeMssqlDynamicSqlListInText}.
+ * Сирий текст quasi-елемента TemplateLiteral на позиції перед expressions[i].
+ * @param {unknown} q quasi-елемент TemplateLiteral
+ * @returns {string} `q.value.raw` або порожній рядок, якщо структура не підходить
+ */
+function quasiRawText(q) {
+  return q && typeof q === 'object' && q.value && typeof q.value === 'object' && typeof q.value.raw === 'string'
+    ? q.value.raw
+    : ''
+}
+
+/**
+ * Збирає порушення для одного TemplateLiteral вузла: знаходить expressions, що
+ * стоять одразу після `IN (` без числового парсера значень.
+ * @param {Record<string, unknown>} node TemplateLiteral
+ * @param {string} content вихідний код
+ * @param {Array<Record<string, unknown>>} declarators VariableDeclarator-и для трасування
+ * @param {{ line: number, snippet: string }[]} out буфер результатів
+ */
+function collectInListUnparsedFromTemplate(node, content, declarators, out) {
+  if (node.type !== 'TemplateLiteral') return
+  const quasis = node.quasis
+  const expressions = node.expressions
+  if (!Array.isArray(quasis) || !Array.isArray(expressions) || expressions.length === 0) return
+
+  for (const [i, expr] of expressions.entries()) {
+    if (!IN_PLACEHOLDER_END_RE.test(quasiRawText(quasis[i]))) continue
+    if (!expr || typeof expr !== 'object') continue
+    if (isJoinCall(expr)) continue
+    if (isInListExpressionParsed(expr, declarators)) continue
+
+    const startOffset = typeof expr.start === 'number' ? expr.start : node.start
+    out.push({
+      line: offsetToLine(content, startOffset),
+      snippet: normalizeSnippet(content.slice(node.start, node.end))
+    })
+  }
+}
+
+/**
+ * Знаходить підстановки IN (вираз) у TemplateLiteral, де вираз не пройшов числовий парсер.
  *
+ * Навіть у безпечному tagged template pool.request().query краще явно парсити значення (parseInt,
+ * Number, BigInt, parseFloat) та фільтрувати NaN. Див. також findUnsafeMssqlDynamicSqlListInText для
+ * випадків arr.join у списках.
  * @param {string} content вихідний код
- * @param {string} [virtualPath] шлях для вибору `lang`
+ * @param {string} [virtualPath] шлях для вибору мови парсера (lang)
  * @returns {{ line: number, snippet: string }[]} список порушень
  */
 export function findUnsafeMssqlInListUnparsedInText(content, virtualPath = 'scan.ts') {
@@ -490,32 +528,7 @@ export function findUnsafeMssqlInListUnparsedInText(content, virtualPath = 'scan
 
   /** @type {{ line: number, snippet: string }[]} */
   const out = []
-  walkAstWithAncestors(result.program, [], node => {
-    if (node.type !== 'TemplateLiteral') return
-    const quasis = node.quasis
-    const expressions = node.expressions
-    if (!Array.isArray(quasis) || !Array.isArray(expressions) || expressions.length === 0) return
-
-    for (let i = 0; i < expressions.length; i++) {
-      const q = quasis[i]
-      const rawText =
-        q && typeof q === 'object' && q.value && typeof q.value === 'object' && typeof q.value.raw === 'string'
-          ? q.value.raw
-          : ''
-      if (!IN_PLACEHOLDER_END_RE.test(rawText)) continue
-
-      const expr = expressions[i]
-      if (!expr || typeof expr !== 'object') continue
-      if (isJoinCall(expr)) continue
-      if (isInListExpressionParsed(expr, declarators)) continue
-
-      const startOffset = typeof expr.start === 'number' ? expr.start : node.start
-      out.push({
-        line: offsetToLine(content, startOffset),
-        snippet: normalizeSnippet(content.slice(node.start, node.end))
-      })
-    }
-  })
+  walkAstWithAncestors(result.program, [], node => collectInListUnparsedFromTemplate(node, content, declarators, out))
 
   return out
 }

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["unicorn", "oxc", "import", "jsdoc", "promise", "node"],
+  "jsPlugins": ["@e18e/eslint-plugin"],
+  "categories": {},
+  "rules": {},
+  "settings": {
+    "next": {
+      "rootDir": []
+    },
+    "jsdoc": {
+      "ignorePrivate": false,
+      "ignoreInternal": false,
+      "ignoreReplacesDocs": true,
+      "overrideReplacesDocs": true,
+      "augmentsExtendsReplacesDocs": false,
+      "implementsReplacesDocs": false,
+      "exemptDestructuredRootsFromChecks": false,
+      "tagNamePreference": {}
+    }
+  },
+  "env": {
+    "builtin": true
+  },
+  "globals": {},
+  "ignorePatterns": []
+}