@nitra/cursor 1.8.105 → 1.8.108

package/scripts/check-vue.mjs

@@ -52,99 +52,94 @@ function ukFilesCountPhrase(n) {
 }
 
 /**
- * Перевіряє залежності та vite.config одного Vue-пакета.
- * @param {string} rootDir відносний шлях до пакета
- * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
- * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
- * @returns {Promise<void>} завершується після перевірок залежностей, `vite.config` і сканування джерел на імпорти з `vue`
+ * Перевіряє наявність залежності в об'єкті deps.
+ * @param {Record<string,string>} deps об'єкт залежностей
+ * @param {string} name ім'я пакета
+ * @param {string} prefix префікс повідомлення
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @param {string} hint підказка при відсутності
  */
-async function checkVuePackage(rootDir, fail, passFn) {
-  const label = packageLabel(rootDir)
-  const prefix = `[${label}] `
-
-  const pkgPath = join(rootDir, 'package.json')
-  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  const deps = pkg.dependencies || {}
-  const devDeps = pkg.devDependencies || {}
-  const allDeps = { ...deps, ...devDeps }
-
-  if (deps.vue) {
-    passFn(`${prefix}vue в dependencies: ${deps.vue}`)
+function checkRequiredDep(deps, name, prefix, passFn, fail, hint = `${name} відсутній`) {
+  if (deps[name]) {
+    passFn(`${prefix}${name}: ${deps[name]}`)
   } else {
-    fail(`${prefix}vue відсутній в dependencies`)
+    fail(`${prefix}${hint}`)
   }
+}
 
-  if (devDeps.vite) {
-    const match = devDeps.vite.match(MAJOR_VERSION_RE)
-    if (match && Number(match[1]) >= 8) {
-      passFn(`${prefix}vite >= 8: ${devDeps.vite}`)
-    } else {
-      fail(`${prefix}vite має бути >= 8, знайдено: ${devDeps.vite}`)
-    }
-  } else {
+/**
+ * Перевіряє версію vite у devDependencies.
+ * @param {Record<string,string>} devDeps devDependencies з package.json
+ * @param {string} prefix параметр prefix
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ */
+function checkViteVersion(devDeps, prefix, passFn, fail) {
+  const v = devDeps.vite
+  if (!v) {
     fail(`${prefix}vite відсутній в devDependencies`)
+    return
   }
-
-  if (devDeps['@vitejs/plugin-vue']) {
-    passFn(`${prefix}@vitejs/plugin-vue: ${devDeps['@vitejs/plugin-vue']}`)
-  } else {
-    fail(`${prefix}@vitejs/plugin-vue відсутній в devDependencies`)
-  }
-
-  if (allDeps['vue-macros']) {
-    passFn(`${prefix}vue-macros: ${allDeps['vue-macros']}`)
-  } else {
-    fail(`${prefix}vue-macros відсутній — bun add -d vue-macros`)
-  }
-
-  if (allDeps['unplugin-auto-import']) {
-    passFn(`${prefix}unplugin-auto-import присутній`)
-  } else {
-    fail(`${prefix}unplugin-auto-import відсутній — bun add -d unplugin-auto-import`)
-  }
-
-  if (allDeps['vite-plugin-vue-layouts-next']) {
-    passFn(`${prefix}vite-plugin-vue-layouts-next присутній`)
+  const match = v.match(MAJOR_VERSION_RE)
+  if (match && Number(match[1]) >= 8) {
+    passFn(`${prefix}vite >= 8: ${v}`)
   } else {
-    fail(`${prefix}vite-plugin-vue-layouts-next відсутній — bun add -d vite-plugin-vue-layouts-next`)
+    fail(`${prefix}vite має бути >= 8, знайдено: ${v}`)
   }
+}
 
+/**
+ * Перевіряє vite.config на наявність VueMacros і AutoImport.
+ * @param {string} rootDir параметр rootDir
+ * @param {string} prefix параметр prefix
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ */
+async function checkViteConfig(rootDir, prefix, passFn, fail) {
   const configFiles = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']
   const viteConfig = configFiles.find(f => existsSync(join(rootDir, f)))
-  if (viteConfig) {
-    const relConfig = join(rootDir, viteConfig)
-    const content = await readFile(relConfig, 'utf8')
-    if (content.includes('VueMacros')) {
-      passFn(`${prefix}${viteConfig} використовує VueMacros`)
-    } else {
-      fail(`${prefix}${viteConfig} не містить VueMacros`)
-    }
-    if (content.includes('AutoImport')) {
-      passFn(`${prefix}${viteConfig} використовує AutoImport`)
+  if (!viteConfig) {
+    fail(`${prefix}немає vite.config.js|ts|mjs у каталозі пакета`)
+    return
+  }
+  const content = await readFile(join(rootDir, viteConfig), 'utf8')
+  const checks = [
+    { token: 'VueMacros', ok: `${viteConfig} використовує VueMacros`, err: `${viteConfig} не містить VueMacros` },
+    { token: 'AutoImport', ok: `${viteConfig} використовує AutoImport`, err: `${viteConfig} не містить AutoImport` }
+  ]
+  for (const { token, ok, err } of checks) {
+    if (content.includes(token)) {
+      passFn(`${prefix}${ok}`)
     } else {
-      fail(`${prefix}${viteConfig} не містить AutoImport`)
+      fail(`${prefix}${err}`)
     }
-  } else {
-    fail(`${prefix}немає vite.config.js|ts|mjs у каталозі пакета`)
   }
+}
 
-  const absPackageRoot = join(process.cwd(), rootDir)
+/**
+ * Сканує джерела пакета на заборонені value-імпорти з vue.
+ * @param {string} rootDir параметр rootDir
+ * @param {string} absPackageRoot параметр absPackageRoot
+ * @param {string} prefix параметр prefix
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ */
+async function checkVueImportViolations(rootDir, absPackageRoot, prefix, passFn, fail) {
   /** @type {string[]} */
   const sourcePaths = []
   await walkDir(absPackageRoot, absPath => {
     const rel = relative(absPackageRoot, absPath).split('\\').join('/')
-    if (shouldSkipFileForVueImportScan(rel) || !isVueImportScanSourceFile(rel)) {
-      return
+    if (!shouldSkipFileForVueImportScan(rel) && isVueImportScanSourceFile(rel)) {
+      sourcePaths.push(absPath)
     }
-    sourcePaths.push(absPath)
   })
 
   let importViolations = 0
   for (const absPath of sourcePaths) {
     const rel = relative(absPackageRoot, absPath).split('\\').join('/')
     const content = await readFile(absPath, 'utf8')
-    const hits = findForbiddenVueImportsInSourceFile(content, rel)
-    for (const v of hits) {
+    for (const v of findForbiddenVueImportsInSourceFile(content, rel)) {
       importViolations++
       fail(`${prefix}${rel}:${v.line} — прибери явний value-імпорт з 'vue' (unplugin-auto-import): ${v.snippet}`)
     }
@@ -156,6 +151,52 @@ async function checkVuePackage(rootDir, fail, passFn) {
   }
 }
 
+/**
+ * Перевіряє залежності та vite.config одного Vue-пакета.
+ * @param {string} rootDir відносний шлях до пакета
+ * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
+ * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
+ * @returns {Promise<void>} завершується після перевірок залежностей, `vite.config` і сканування джерел на імпорти з `vue`
+ */
+async function checkVuePackage(rootDir, fail, passFn) {
+  const prefix = `[${packageLabel(rootDir)}] `
+  const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf8'))
+  const deps = pkg.dependencies || {}
+  const devDeps = pkg.devDependencies || {}
+  const allDeps = { ...deps, ...devDeps }
+
+  checkRequiredDep(deps, 'vue', prefix, passFn, fail, 'vue відсутній в dependencies')
+  checkViteVersion(devDeps, prefix, passFn, fail)
+  checkRequiredDep(
+    devDeps,
+    '@vitejs/plugin-vue',
+    prefix,
+    passFn,
+    fail,
+    '@vitejs/plugin-vue відсутній в devDependencies'
+  )
+  checkRequiredDep(allDeps, 'vue-macros', prefix, passFn, fail, 'vue-macros відсутній — bun add -d vue-macros')
+  checkRequiredDep(
+    allDeps,
+    'unplugin-auto-import',
+    prefix,
+    passFn,
+    fail,
+    'unplugin-auto-import відсутній — bun add -d unplugin-auto-import'
+  )
+  checkRequiredDep(
+    allDeps,
+    'vite-plugin-vue-layouts-next',
+    prefix,
+    passFn,
+    fail,
+    'vite-plugin-vue-layouts-next відсутній — bun add -d vite-plugin-vue-layouts-next'
+  )
+
+  await checkViteConfig(rootDir, prefix, passFn, fail)
+  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), prefix, passFn, fail)
+}
+
 /**
  * Перевіряє відповідність проєкту правилам vue.mdc (корінь і всі workspace-пакети з `vue` у dependencies).
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми

package/scripts/utils/bunyan-imports.mjs

@@ -0,0 +1,182 @@
+/**
+ * Знаходить імпорти з `@nitra/bunyan` (і застарілого `bunyan`) у джерелах — їх треба замінити
+ * на `@nitra/pino` згідно з js-pino.mdc.
+ *
+ * Семантика береться з **oxc-parser** (`module.staticImports`) — без regex по тілу файлу.
+ * Додатково по AST програми ловимо `require('@nitra/bunyan')` і динамічний `import('@nitra/bunyan')`,
+ * щоб правило працювало й у CommonJS/інлайн-завантаженні.
+ *
+ * Сканер не вимагає, щоб файл компілювався: при синтаксичних помилках повертається порожній
+ * результат — спочатку треба полагодити синтаксис, потім перезапустити перевірку.
+ */
+import { parseSync } from 'oxc-parser'
+
+const SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/
+const FORBIDDEN_MODULES = new Set(['@nitra/bunyan', 'bunyan'])
+
+/**
+ * Мова для Oxc за шляхом файлу (розширення).
+ * @param {string} filePath віртуальний або реальний шлях до файлу
+ * @returns {'js' | 'jsx' | 'ts' | 'tsx'} значення опції `lang` для `parseSync`
+ */
+function langFromPath(filePath) {
+  const lower = filePath.toLowerCase()
+  if (lower.endsWith('.tsx')) {
+    return 'tsx'
+  }
+  if (lower.endsWith('.ts') || lower.endsWith('.mts') || lower.endsWith('.cts')) {
+    return 'ts'
+  }
+  if (lower.endsWith('.jsx')) {
+    return 'jsx'
+  }
+  return 'js'
+}
+
+/**
+ * Номер рядка (1-based) за зміщенням у буфері.
+ * @param {string} content повний текст файлу
+ * @param {number} offset байтове зміщення початку фрагмента
+ * @returns {number} номер рядка від 1
+ */
+function offsetToLine(content, offset) {
+  let line = 1
+  const n = Math.min(offset, content.length)
+  for (let i = 0; i < n; i++) {
+    if (content.codePointAt(i) === 10) {
+      line++
+    }
+  }
+  return line
+}
+
+/**
+ * Стискає пробіли для повідомлення про порушення.
+ * @param {string} s фрагмент коду
+ * @returns {string} скорочений однорядковий рядок
+ */
+function normalizeSnippet(s) {
+  return s.replaceAll(/\s+/g, ' ').trim().slice(0, 160)
+}
+
+/**
+ * Перевіряє, чи це виклик `require('<module>')` з рядковим аргументом.
+ * @param {any} node вузол AST
+ * @returns {string | null} ім'я модуля з аргументу, інакше `null`
+ */
+function requireCallModule(node) {
+  if (!node || node.type !== 'CallExpression') return null
+  const callee = node.callee
+  if (!callee || callee.type !== 'Identifier' || callee.name !== 'require') return null
+  const arg = node.arguments?.[0]
+  if (!arg || arg.type !== 'Literal' || typeof arg.value !== 'string') return null
+  return arg.value
+}
+
+/**
+ * Перевіряє, чи це динамічний `import('<module>')` з рядковим аргументом.
+ * @param {any} node вузол AST
+ * @returns {string | null} ім'я модуля, інакше `null`
+ */
+function dynamicImportModule(node) {
+  if (!node || node.type !== 'ImportExpression') return null
+  const src = node.source
+  if (!src || src.type !== 'Literal' || typeof src.value !== 'string') return null
+  return src.value
+}
+
+/**
+ * Простий рекурсивний обхід AST: заходимо в усі об'єкти/масиви, щоб знайти require/import-вузли.
+ * @param {any} node корінь або під-вузол AST
+ * @param {(n: any) => void} visit виклик для кожного об'єкта-вузла
+ * @returns {void}
+ */
+function walkAst(node, visit) {
+  if (!node || typeof node !== 'object') return
+  if (Array.isArray(node)) {
+    for (const item of node) walkAst(item, visit)
+    return
+  }
+  if (typeof node.type === 'string') {
+    visit(node)
+  }
+  for (const key of Object.keys(node)) {
+    if (key === 'parent') continue
+    const v = node[key]
+    if (v && typeof v === 'object') walkAst(v, visit)
+  }
+}
+
+/**
+ * Знаходить заборонені імпорти/require з `@nitra/bunyan` у тексті.
+ * @param {string} content вихідний код
+ * @param {string} [virtualPath] шлях для вибору `lang` (наприклад `pkg/src/foo.ts`)
+ * @returns {{ line: number, snippet: string, module: string }[]} список порушень
+ */
+export function findBunyanImportsInText(content, virtualPath = 'scan.ts') {
+  const pathForLang = virtualPath || 'scan.ts'
+  const lang = langFromPath(pathForLang)
+  let result
+  try {
+    result = parseSync(pathForLang, content, { lang, sourceType: 'module' })
+  } catch {
+    return []
+  }
+  if (result.errors?.length) {
+    return []
+  }
+
+  /** @type {{ line: number, snippet: string, module: string }[]} */
+  const out = []
+
+  for (const imp of result.module?.staticImports ?? []) {
+    const mod = imp.moduleRequest?.value
+    if (mod && FORBIDDEN_MODULES.has(mod)) {
+      out.push({
+        line: offsetToLine(content, imp.start),
+        snippet: normalizeSnippet(content.slice(imp.start, imp.end)),
+        module: mod
+      })
+    }
+  }
+
+  walkAst(result.program, node => {
+    const reqMod = requireCallModule(node)
+    if (reqMod && FORBIDDEN_MODULES.has(reqMod)) {
+      out.push({
+        line: offsetToLine(content, node.start),
+        snippet: normalizeSnippet(content.slice(node.start, node.end)),
+        module: reqMod
+      })
+      return
+    }
+    const dynMod = dynamicImportModule(node)
+    if (dynMod && FORBIDDEN_MODULES.has(dynMod)) {
+      out.push({
+        line: offsetToLine(content, node.start),
+        snippet: normalizeSnippet(content.slice(node.start, node.end)),
+        module: dynMod
+      })
+    }
+  })
+
+  return out
+}
+
+/**
+ * Чи сканувати цей файл за розширенням (JS/TS-сім'я).
+ * @param {string} relativePath відносний шлях до файлу
+ * @returns {boolean} `true`, якщо розширення підходить для пошуку імпорту
+ */
+export function isBunyanScanSourceFile(relativePath) {
+  return SOURCE_FILE_RE.test(relativePath)
+}
+
+/**
+ * Чи слід пропустити файл під час обходу пакета (декларації типів).
+ * @param {string} relativePosix шлях з posix-слешами
+ * @returns {boolean} `true`, якщо файл не сканувати
+ */
+export function shouldSkipFileForBunyanScan(relativePosix) {
+  return relativePosix.endsWith('.d.ts')
+}

package/scripts/utils/gha-workflow.mjs

@@ -324,7 +324,9 @@ function workflowJobSteps(job) {
   if (!Array.isArray(steps)) {
     return []
   }
-  return steps.flatMap(step => (step && typeof step === 'object' ? [/** @type {Record<string, unknown>} */ (step)] : []))
+  return steps.flatMap(step =>
+    step && typeof step === 'object' ? [/** @type {Record<string, unknown>} */ (step)] : []
+  )
 }
 
 /**