@nitra/cursor 1.8.104 → 1.8.106

package/scripts/check-vue.mjs

@@ -12,8 +12,6 @@ import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
-
-const MAJOR_VERSION_RE = /(\d+)/
 import {
   findForbiddenVueImportsInSourceFile,
   isVueImportScanSourceFile,
@@ -22,6 +20,8 @@ import {
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
+const MAJOR_VERSION_RE = /(\d+)/
+
 /**
  * Формує зрозумілий для людини підпис пакета для повідомлень перевірки.
  * @param {string} rootDir відносний шлях (`'.'` або `site` тощо)
@@ -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/docker-hadolint.mjs

@@ -59,11 +59,15 @@ export function lintDockerfileWithHadolint(root, absPath) {
     }
   }
 
-  const docker = spawnSync(dockerPath, ['run', '--rm', '-v', `${root}:/workdir`, '-w', '/workdir', HADOLINT_IMAGE, rel], {
-    cwd: root,
-    encoding: 'utf8',
-    maxBuffer: 10 * 1024 * 1024
-  })
+  const docker = spawnSync(
+    dockerPath,
+    ['run', '--rm', '-v', `${root}:/workdir`, '-w', '/workdir', HADOLINT_IMAGE, rel],
+    {
+      cwd: root,
+      encoding: 'utf8',
+      maxBuffer: 10 * 1024 * 1024
+    }
+  )
   if (docker.error) {
     return {
       ok: false,

package/scripts/utils/gha-workflow.mjs

@@ -6,6 +6,11 @@
  */
 import { parse } from 'yaml'
 
+const CHECKOUT_USES_MARKER = 'actions/checkout@'
+const CHECKOUT_V6_USES = 'actions/checkout@v6'
+const LOCAL_SETUP_BUN_DEPS_MARKER = './.github/actions/setup-bun-deps'
+const BUNX_OXLINT_FIX_RE = /bunx\s+oxlint[^\n]*--fix/u
+
 /**
  * Парсить workflow YAML у звичайний об’єкт; при синтаксичній помилці — `null`.
  * @param {string} content вміст файлу
@@ -26,26 +31,12 @@ export function parseWorkflowYaml(content) {
  * @returns {{ jobId: string, stepIndex: number, step: Record<string, unknown> }[]} плоский список кроків з метаданими
  */
 export function flattenWorkflowSteps(root) {
-  const jobs = root?.jobs
-  if (!jobs || typeof jobs !== 'object') {
-    return []
-  }
   /** @type {{ jobId: string, stepIndex: number, step: Record<string, unknown> }[]} */
   const out = []
-  for (const [jobId, job] of Object.entries(jobs)) {
-    if (job && typeof job === 'object') {
-      const steps = /** @type {{ steps?: unknown }} */ (job).steps
-      if (Array.isArray(steps)) {
-        for (const [stepIndex, step] of steps.entries()) {
-          if (step && typeof step === 'object') {
-            out.push({
-              jobId,
-              stepIndex,
-              step: /** @type {Record<string, unknown>} */ (step)
-            })
-          }
-        }
-      }
+  for (const [jobId, job] of workflowJobsEntries(root)) {
+    const steps = workflowJobSteps(job)
+    for (const [stepIndex, step] of steps.entries()) {
+      out.push({ jobId, stepIndex, step })
     }
   }
   return out
@@ -100,37 +91,15 @@ export function hasAnyStepUsesContaining(root, substrings) {
  * @returns {boolean} `false`, якщо є setup без попереднього checkout
  */
 export function hasCheckoutBeforeLocalSetupBunDeps(root, setupPathSubstrings) {
-  const jobs = root?.jobs
-  if (!jobs || typeof jobs !== 'object') {
-    return true
-  }
-  for (const job of Object.values(jobs)) {
-    if (job && typeof job === 'object') {
-      const steps = /** @type {{ steps?: unknown }} */ (job).steps
-      if (Array.isArray(steps)) {
-        for (let i = 0; i < steps.length; i++) {
-          const step = steps[i]
-          if (step && typeof step === 'object') {
-            const uses = getStepUses(/** @type {Record<string, unknown>} */ (step))
-            const isSetup = setupPathSubstrings.some(s => uses.includes(s))
-            if (isSetup) {
-              let foundCheckout = false
-              for (let j = 0; j < i; j++) {
-                const prev = steps[j]
-                if (prev && typeof prev === 'object') {
-                  const u = getStepUses(/** @type {Record<string, unknown>} */ (prev))
-                  if (u.includes('actions/checkout@')) {
-                    foundCheckout = true
-                    break
-                  }
-                }
-              }
-              if (!foundCheckout) {
-                return false
-              }
-            }
-          }
-        }
+  for (const [, job] of workflowJobsEntries(root)) {
+    let hasCheckoutStep = false
+    for (const step of workflowJobSteps(job)) {
+      const uses = getStepUses(step)
+      if (uses.includes(CHECKOUT_USES_MARKER)) {
+        hasCheckoutStep = true
+      }
+      if (setupPathSubstrings.some(s => uses.includes(s)) && !hasCheckoutStep) {
+        return false
       }
     }
   }
@@ -279,26 +248,15 @@ export function verifyLintJsWorkflowStructure(root) {
   const usesList = steps.map(s => getStepUses(s.step))
   const runBlob = steps.map(s => getStepRun(s.step)).join('\n')
 
-  if (!usesList.some(u => u.includes('actions/checkout@v6'))) {
+  if (!usesList.some(u => u.includes(CHECKOUT_V6_USES))) {
     failures.push('немає кроку uses: actions/checkout@v6')
   }
 
-  let checkoutOk = false
-  for (const { step } of steps) {
-    const u = getStepUses(step)
-    if (u.includes('actions/checkout@v6')) {
-      const w = step.with
-      if (w && typeof w === 'object' && /** @type {Record<string, unknown>} */ (w)['persist-credentials'] === false) {
-        checkoutOk = true
-        break
-      }
-    }
-  }
-  if (!checkoutOk) {
+  if (!hasCheckoutWithPersistCredentialsFalse(steps)) {
     failures.push('checkout@v6 без with.persist-credentials: false')
   }
 
-  if (!usesList.some(u => u.includes('./.github/actions/setup-bun-deps'))) {
+  if (!usesList.some(u => u.includes(LOCAL_SETUP_BUN_DEPS_MARKER))) {
     failures.push('немає uses: ./.github/actions/setup-bun-deps')
   }
 
@@ -312,15 +270,7 @@ export function verifyLintJsWorkflowStructure(root) {
     failures.push('у run немає bunx jscpd .')
   }
 
-  for (const { step } of steps) {
-    const run = getStepRun(step)
-    if (/bunx\s+oxlint[^\n]*--fix/u.test(run)) {
-      failures.push('у run є oxlint з --fix (у CI заборонено)')
-    }
-    if (run.includes('eslint --fix')) {
-      failures.push('у run є eslint --fix (у CI заборонено)')
-    }
-  }
+  appendCiFixFlagFailures(failures, steps)
 
   return failures.length === 0 ? { ok: true, failures: [] } : { ok: false, failures }
 }
@@ -348,3 +298,73 @@ export function anyRunStepIncludes(root, needle) {
 export function anyRunStepIncludesStylelint(root) {
   return anyRunStepIncludes(root, 'npx stylelint')
 }
+
+/**
+ * Повертає jobs як список пар [jobId, job], якщо структура валідна.
+ * @param {Record<string, unknown>} root корінь workflow
+ * @returns {[string, Record<string, unknown>][]} список jobs
+ */
+function workflowJobsEntries(root) {
+  const jobs = root?.jobs
+  if (!jobs || typeof jobs !== 'object') {
+    return []
+  }
+  return Object.entries(jobs).flatMap(([jobId, job]) =>
+    job && typeof job === 'object' ? [[jobId, /** @type {Record<string, unknown>} */ (job)]] : []
+  )
+}
+
+/**
+ * Повертає валідні кроки job.
+ * @param {Record<string, unknown>} job job-об’єкт
+ * @returns {Record<string, unknown>[]} кроки job
+ */
+function workflowJobSteps(job) {
+  const steps = /** @type {{ steps?: unknown }} */ (job).steps
+  if (!Array.isArray(steps)) {
+    return []
+  }
+  return steps.flatMap(step =>
+    step && typeof step === 'object' ? [/** @type {Record<string, unknown>} */ (step)] : []
+  )
+}
+
+/**
+ * Чи є checkout@v6 з `persist-credentials: false`.
+ * @param {{ step: Record<string, unknown> }[]} steps кроки flattenWorkflowSteps
+ * @returns {boolean} true, якщо знайдено очікуваний checkout
+ */
+function hasCheckoutWithPersistCredentialsFalse(steps) {
+  for (const { step } of steps) {
+    const uses = getStepUses(step)
+    if (uses.includes(CHECKOUT_V6_USES)) {
+      const withObj = step.with
+      if (
+        withObj &&
+        typeof withObj === 'object' &&
+        /** @type {Record<string, unknown>} */ (withObj)['persist-credentials'] === false
+      ) {
+        return true
+      }
+    }
+  }
+  return false
+}
+
+/**
+ * Додає порушення для `--fix` у CI-кроках lint-js workflow.
+ * @param {string[]} failures акумулятор порушень
+ * @param {{ step: Record<string, unknown> }[]} steps кроки flattenWorkflowSteps
+ * @returns {void}
+ */
+function appendCiFixFlagFailures(failures, steps) {
+  for (const { step } of steps) {
+    const run = getStepRun(step)
+    if (BUNX_OXLINT_FIX_RE.test(run)) {
+      failures.push('у run є oxlint з --fix (у CI заборонено)')
+    }
+    if (run.includes('eslint --fix')) {
+      failures.push('у run є eslint --fix (у CI заборонено)')
+    }
+  }
+}

package/scripts/utils/workspaces.mjs

@@ -10,6 +10,43 @@ import { dirname, join, relative } from 'node:path'
 
 const TRAILING_SLASH_RE = /\/$/
 
+/**
+ * Нормалізує workspace-патерн до POSIX-формату і прибирає хвостові `/`.
+ * @param {string} pattern сирий workspace-патерн
+ * @returns {string} нормалізований патерн або `.`
+ */
+function normalizeWorkspacePattern(pattern) {
+  let normalized = pattern.replaceAll('\\', '/')
+  while (TRAILING_SLASH_RE.test(normalized)) {
+    normalized = normalized.slice(0, -1)
+  }
+  return normalized || '.'
+}
+
+/**
+ * Додає каталоги пакетів до set за workspace-патерном.
+ * @param {Set<string>} roots set коренів пакетів
+ * @param {string} repoRoot корінь репозиторію
+ * @param {string} workspacePattern нормалізований workspace-патерн
+ * @returns {Promise<void>}
+ */
+async function addWorkspaceRootsByPattern(roots, repoRoot, workspacePattern) {
+  if (workspacePattern.includes('*')) {
+    const globPat = `${workspacePattern}/package.json`
+    for await (const relPkgJsonPath of glob(globPat, { cwd: repoRoot })) {
+      const absPkgJsonPath = join(repoRoot, relPkgJsonPath)
+      const relRoot = relative(repoRoot, dirname(absPkgJsonPath))
+      roots.add(relRoot === '' ? '.' : relRoot)
+    }
+    return
+  }
+
+  const pkgJsonPath = join(repoRoot, workspacePattern, 'package.json')
+  if (existsSync(pkgJsonPath)) {
+    roots.add(workspacePattern)
+  }
+}
+
 /**
  * Нормалізує поле `workspaces` з package.json до масиву шляхів / glob-патернів.
  * @param {unknown} workspaces значення `workspaces` з кореневого package.json
@@ -37,22 +74,8 @@ export async function getMonorepoPackageRootDirs(repoRoot = '.') {
   }
   const pkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
   for (const raw of normalizeWorkspacePatterns(pkg.workspaces)) {
-    let w = raw.replaceAll('\\', '/')
-    while (TRAILING_SLASH_RE.test(w)) {
-      w = w.slice(0, -1)
-    }
-    w = w || '.'
-    if (w.includes('*')) {
-      const globPat = `${w}/package.json`
-      for await (const f of glob(globPat, { cwd: repoRoot })) {
-        const abs = join(repoRoot, f)
-        const rel = relative(repoRoot, dirname(abs))
-        roots.add(rel === '' ? '.' : rel)
-      }
-    } else {
-      const pkgJson = join(repoRoot, w, 'package.json')
-      if (existsSync(pkgJson)) roots.add(w)
-    }
+    const workspacePattern = normalizeWorkspacePattern(raw)
+    await addWorkspaceRootsByPattern(roots, repoRoot, workspacePattern)
   }
   const list = [...roots]
   list.sort((a, b) => {