@nitra/cursor 1.8.104 → 1.8.106

package/scripts/check-nginx-default-tpl.mjs

@@ -21,6 +21,16 @@ import { findDockerfilePaths } from './check-docker.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
+const LINE_SPLIT_RE = /\r?\n/u
+const INI_KEY_RE = /^([A-Za-z_]\w*)\s*=/u
+const RETURN_200_RE = /return\s+200/u
+const GZIP_STATIC_ON_RE = /gzip_static\s+on/gu
+const PROXY_LIKE_RE =
+  /\b(proxy_pass|proxy_redirect|proxy_set_header|proxy_http_version|fastcgi_pass|grpc_pass|uwsgi_pass)\b/u
+const FIND_CMD_RE = /\bfind\b/u
+const GZIP_CMD_RE = /\bgzip\b/u
+const GZIP_EXTENSION_RE = /\*\.(?:js|css)/u
+
 /**
  * Збирає абсолютні шляхи до **default.conf.template** у репозиторії; шлях `tests/fixtures` не обходиться як проєктний шаблон.
  * @param {string} root корінь cwd
@@ -82,10 +92,10 @@ export async function migrateDefaultTplConfFiles(root) {
 export function parseIniVariableNames(iniText) {
   /** @type {string[]} */
   const keys = []
-  for (const line of iniText.split(/\r?\n/u)) {
+  for (const line of iniText.split(LINE_SPLIT_RE)) {
     const t = line.trim()
     if (t !== '' && !t.startsWith('#') && !t.startsWith(';')) {
-      const m = t.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=/u)
+      const m = t.match(INI_KEY_RE)
       if (m) keys.push(m[1])
     }
   }
@@ -111,7 +121,7 @@ export function nginxTemplateViolations(content) {
     { msg: 'відсутнє root /usr/share/nginx/html', ok: c => c.includes('root /usr/share/nginx/html') },
     {
       msg: 'location /healthz має повертати healthy (див. nginx-default-tpl.mdc)',
-      ok: c => c.includes('/healthz') && (c.includes('healthy') || /return\s+200/u.test(c))
+      ok: c => c.includes('/healthz') && (c.includes('healthy') || RETURN_200_RE.test(c))
     },
     {
       msg: 'відсутній location для статики без gzip (gif|jpeg|png|ico|woff2|xlsx) з Cache-Control 31536000',
@@ -126,7 +136,7 @@ export function nginxTemplateViolations(content) {
     },
     {
       msg: 'gzip_static on має бути принаймні двічі (два location зі стисненням)',
-      ok: c => (c.match(/gzip_static\s+on/gu) ?? []).length >= 2
+      ok: c => (c.match(GZIP_STATIC_ON_RE) ?? []).length >= 2
     },
     { msg: 'відсутнє використання $PUBLIC_PATH у location', ok: c => c.includes('$PUBLIC_PATH') },
     {
@@ -144,9 +154,7 @@ export function nginxTemplateViolations(content) {
   }
 
   // cspell:ignore fastcgi uwsgi
-  const proxyLike =
-    /\b(proxy_pass|proxy_redirect|proxy_set_header|proxy_http_version|fastcgi_pass|grpc_pass|uwsgi_pass)\b/u
-  if (proxyLike.test(content)) {
+  if (PROXY_LIKE_RE.test(content)) {
     return 'знайдено proxy, gRPC або інший *_pass до бекенду — прибери з шаблону, логіку винеси в HTTPRoute (k8s) (див. nginx-default-tpl.mdc)'
   }
 
@@ -242,11 +250,11 @@ export function iniKeysMissingInTemplate(keys, template) {
 function dockerfileHasGzipStaticPipeline(dockerfileContent) {
   const c = dockerfileContent
   return (
-    /\bfind\b/u.test(c) &&
+    FIND_CMD_RE.test(c) &&
     c.includes('/usr/share/nginx/html') &&
-    /\bgzip\b/u.test(c) &&
+    GZIP_CMD_RE.test(c) &&
     c.includes('-k') &&
-    /\*\.(?:js|css)/u.test(c)
+    GZIP_EXTENSION_RE.test(c)
   )
 }
 
@@ -259,6 +267,110 @@ function dockerfileHasEnvsSubstTemplate(dockerfileContent) {
   return dockerfileContent.includes('envsubst') && dockerfileContent.includes('default.conf.template')
 }
 
+/**
+ * Перевіряє один template-файл і поруч *.ini.
+ * @param {string} abs абсолютний шлях до template
+ * @param {string} root cwd
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkTemplateFile(abs, root, passFn, failFn) {
+  const rel = relative(root, abs) || abs
+  const content = await readFile(abs, 'utf8')
+  const v = nginxTemplateViolations(content)
+  if (v) {
+    failFn(`${rel}: ${v}`)
+  } else {
+    passFn(`${rel}: структура шаблону узгоджена з nginx-default-tpl.mdc`)
+  }
+
+  const dir = dirname(abs)
+  let iniNames = []
+  try {
+    const dirEntries = await readdir(dir)
+    iniNames = dirEntries.filter(n => n.endsWith('.ini'))
+  } catch {
+    iniNames = []
+  }
+  if (iniNames.length === 0) {
+    failFn(`${rel}: поруч немає жодного *.ini — додай values-*.ini для середовищ (див. nginx-default-tpl.mdc)`)
+    return
+  }
+  passFn(`${rel}: поруч є *.ini (${iniNames.length})`)
+  for (const iniName of iniNames) {
+    const iniPath = `${dir}/${iniName}`
+    const iniRel = relative(root, iniPath) || iniPath
+    try {
+      const iniRaw = await readFile(iniPath, 'utf8')
+      const miss = iniKeysMissingInTemplate(parseIniVariableNames(iniRaw), content)
+      if (miss) failFn(`${iniRel}: ${miss}`)
+    } catch (error) {
+      failFn(`${iniRel}: не вдалося прочитати (${error instanceof Error ? error.message : String(error)})`)
+    }
+  }
+}
+
+/**
+ * Перевіряє Dockerfile на наявність gzip та envsubst.
+ * @param {string} root корінь репозиторію
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkDockerfiles(root, passFn, failFn) {
+  const dockerPaths = await findDockerfilePaths(root)
+  if (dockerPaths.length === 0) {
+    failFn(
+      'Є default.conf.template, але немає Dockerfile / Containerfile — додай gzip для статики та envsubst (див. nginx-default-tpl.mdc)'
+    )
+    return
+  }
+  const bodies = await Promise.all(dockerPaths.map(p => readFile(p, 'utf8')))
+  if (bodies.some(body => dockerfileHasGzipStaticPipeline(body))) {
+    passFn('Dockerfile: знайдено крок стиснення статики (find + gzip -k)')
+  } else {
+    failFn('Dockerfile: потрібен RUN find … /usr/share/nginx/html … gzip -k (див. nginx-default-tpl.mdc)')
+  }
+  if (bodies.some(body => dockerfileHasEnvsSubstTemplate(body))) {
+    passFn('Dockerfile: знайдено envsubst для default.conf.template')
+  } else {
+    failFn('Dockerfile: потрібен envsubst з default.conf.template (див. nginx-default-tpl.mdc)')
+  }
+}
+
+/**
+ * Перевіряє VSCode extensions.json та settings.json для nginx.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkVscodeNginx(passFn, failFn) {
+  if (existsSync('.vscode/extensions.json')) {
+    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+    if (ext.recommendations?.includes('ahmadalli.vscode-nginx-conf')) {
+      passFn('extensions.json містить ahmadalli.vscode-nginx-conf')
+    } else {
+      failFn('extensions.json не містить ahmadalli.vscode-nginx-conf')
+    }
+  } else {
+    failFn('Очікується .vscode/extensions.json з ahmadalli.vscode-nginx-conf (див. nginx-default-tpl.mdc)')
+  }
+
+  if (!existsSync('.vscode/settings.json')) {
+    failFn('Очікується .vscode/settings.json з форматером nginx і formatOnSave (див. nginx-default-tpl.mdc)')
+    return
+  }
+  const s = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
+  if (s['editor.formatOnSave'] === true) {
+    passFn('settings.json: editor.formatOnSave увімкнено')
+  } else {
+    failFn('settings.json: увімкни editor.formatOnSave: true (див. nginx-default-tpl.mdc)')
+  }
+  if (s['[nginx]']?.['editor.defaultFormatter'] === 'ahmadalli.vscode-nginx-conf') {
+    passFn('settings.json: [nginx] defaultFormatter налаштовано')
+  } else {
+    failFn('settings.json: [nginx].editor.defaultFormatter має бути ahmadalli.vscode-nginx-conf')
+  }
+}
+
 /**
  * Перевіряє відповідність проєкту правилам nginx-default-tpl.mdc
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
@@ -287,98 +399,11 @@ export async function check() {
   pass(`Знайдено default.conf.template: ${templates.length}`)
 
   for (const abs of templates) {
-    const rel = relative(root, abs) || abs
-    const content = await readFile(abs, 'utf8')
-    const v = nginxTemplateViolations(content)
-    if (v) {
-      fail(`${rel}: ${v}`)
-    } else {
-      pass(`${rel}: структура шаблону узгоджена з nginx-default-tpl.mdc`)
-    }
-
-    const dir = dirname(abs)
-    let iniNames = []
-    try {
-      const dirEntries = await readdir(dir)
-      iniNames = dirEntries.filter(n => n.endsWith('.ini'))
-    } catch {
-      iniNames = []
-    }
-    if (iniNames.length === 0) {
-      fail(`${rel}: поруч немає жодного *.ini — додай values-*.ini для середовищ (див. nginx-default-tpl.mdc)`)
-    } else {
-      pass(`${rel}: поруч є *.ini (${iniNames.length})`)
-    }
-
-    for (const iniName of iniNames) {
-      const iniPath = `${dir}/${iniName}`
-      const iniRel = relative(root, iniPath) || iniPath
-      let iniRaw
-      try {
-        iniRaw = await readFile(iniPath, 'utf8')
-      } catch (error) {
-        fail(`${iniRel}: не вдалося прочитати (${error instanceof Error ? error.message : String(error)})`)
-        iniRaw = null
-      }
-      if (iniRaw !== null) {
-        const keys = parseIniVariableNames(iniRaw)
-        const miss = iniKeysMissingInTemplate(keys, content)
-        if (miss) {
-          fail(`${iniRel}: ${miss}`)
-        }
-      }
-    }
+    await checkTemplateFile(abs, root, pass, fail)
   }
 
-  const dockerPaths = await findDockerfilePaths(root)
-  if (dockerPaths.length === 0) {
-    fail(
-      'Є default.conf.template, але немає Dockerfile / Containerfile — додай gzip для статики та envsubst (див. nginx-default-tpl.mdc)'
-    )
-  } else {
-    const bodies = await Promise.all(dockerPaths.map(p => readFile(p, 'utf8')))
-    const gzipOk = bodies.some(body => dockerfileHasGzipStaticPipeline(body))
-    const envOk = bodies.some(body => dockerfileHasEnvsSubstTemplate(body))
-    if (gzipOk) {
-      pass('Dockerfile: знайдено крок стиснення статики (find + gzip -k)')
-    } else {
-      fail('Dockerfile: потрібен RUN find … /usr/share/nginx/html … gzip -k (див. nginx-default-tpl.mdc)')
-    }
-    if (envOk) {
-      pass('Dockerfile: знайдено envsubst для default.conf.template')
-    } else {
-      fail('Dockerfile: потрібен envsubst з default.conf.template (див. nginx-default-tpl.mdc)')
-    }
-  }
-
-  if (existsSync('.vscode/extensions.json')) {
-    const extRaw = await readFile('.vscode/extensions.json', 'utf8')
-    const ext = JSON.parse(extRaw)
-    if (ext.recommendations?.includes('ahmadalli.vscode-nginx-conf')) {
-      pass('extensions.json містить ahmadalli.vscode-nginx-conf')
-    } else {
-      fail('extensions.json не містить ahmadalli.vscode-nginx-conf')
-    }
-  } else {
-    fail('Очікується .vscode/extensions.json з ahmadalli.vscode-nginx-conf (див. nginx-default-tpl.mdc)')
-  }
-
-  if (existsSync('.vscode/settings.json')) {
-    const settingsRaw = await readFile('.vscode/settings.json', 'utf8')
-    const s = JSON.parse(settingsRaw)
-    if (s['editor.formatOnSave'] === true) {
-      pass('settings.json: editor.formatOnSave увімкнено')
-    } else {
-      fail('settings.json: увімкни editor.formatOnSave: true (див. nginx-default-tpl.mdc)')
-    }
-    if (s['[nginx]']?.['editor.defaultFormatter'] === 'ahmadalli.vscode-nginx-conf') {
-      pass('settings.json: [nginx] defaultFormatter налаштовано')
-    } else {
-      fail('settings.json: [nginx].editor.defaultFormatter має бути ahmadalli.vscode-nginx-conf')
-    }
-  } else {
-    fail('Очікується .vscode/settings.json з форматером nginx і formatOnSave (див. nginx-default-tpl.mdc)')
-  }
+  await checkDockerfiles(root, pass, fail)
+  await checkVscodeNginx(pass, fail)
 
   return reporter.getExitCode()
 }

package/scripts/check-npm-module.mjs

@@ -16,8 +16,6 @@ import { readFile, stat } from 'node:fs/promises'
 import { join } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
-
-const TYPES_FILE_RE = /^\.\/types\/.+\.d\.(ts|mts)$/
 import {
   hasIdTokenWritePermission,
   hasNpmPublishStepWithPackage,
@@ -27,6 +25,8 @@ import {
 } from './utils/gha-workflow.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
+const TYPES_FILE_RE = /^\.\/types\/.+\.d\.(ts|mts)$/
+
 /** Канонічний entrypoint типів для пакетів із вихідним `.js` під каталогом `npm/src` */
 const TYPES_INDEX = './types/index.d.ts'
 
@@ -142,13 +142,155 @@ function npmTypesFileFromPackageField(typesField) {
 }
 
 /**
- * Перевіряє відповідність проєкту правилам npm-module.mdc
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ * Перевіряє поле types у npm/package.json.
+ * @param {unknown} typesField значення поля types
+ * @param {boolean} useSrcJsLayout чи використовується layout з npm/src
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
  */
-export async function check() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
+function checkNpmTypesField(typesField, useSrcJsLayout, passFn, failFn) {
+  if (useSrcJsLayout) {
+    if (typesField === TYPES_INDEX) {
+      passFn(`npm/package.json: "types": "${TYPES_INDEX}" (layout npm/src + .js)`)
+    } else {
+      failFn(`npm/package.json: при наявності .js під npm/src очікується "types": "${TYPES_INDEX}"`)
+    }
+  } else if (typeof typesField === 'string' && TYPES_FILE_RE.test(typesField)) {
+    passFn(`npm/package.json: "types" вказує на файл під ./types/… (${typesField})`)
+  } else {
+    failFn(
+      'npm/package.json: без .js під npm/src поле types має бути рядком виду ./types/….d.ts або .d.mts (див. npm-module.mdc)'
+    )
+  }
+}
+
+/**
+ * Перевіряє npm/package.json на типи та files.
+ * @param {boolean} useSrcJsLayout чи використовується layout з npm/src
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkNpmPackageJson(useSrcJsLayout, passFn, failFn) {
+  if (!existsSync('npm/package.json')) return
+  const npmPkg = JSON.parse(await readFile('npm/package.json', 'utf8'))
+  const typesField = npmPkg.types
+
+  checkNpmTypesField(typesField, useSrcJsLayout, passFn, failFn)
 
+  if (Array.isArray(npmPkg.files) && npmPkg.files.includes('types')) {
+    passFn('npm/package.json: files містить "types"')
+  } else {
+    failFn('npm/package.json: масив files має містити "types"')
+  }
+
+  const typesPath = useSrcJsLayout ? join('npm', 'types', 'index.d.ts') : npmTypesFileFromPackageField(typesField)
+  const missingTypesMsg = useSrcJsLayout
+    ? `Відсутній ${join('npm', 'types', 'index.d.ts')} (згенеруй tsc з npm-module.mdc)`
+    : `Файл для поля types не знайдено або шлях не під ./types/ — ${String(typesField)}`
+  if (typesPath && existsSync(typesPath)) {
+    passFn(`${typesPath} існує`)
+  } else {
+    failFn(missingTypesMsg)
+  }
+}
+
+/**
+ * Перевіряє npm/tsconfig.emit-types.json.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkEmitTypesConfig(passFn, failFn) {
+  if (!existsSync(EMIT_TYPES_CONFIG)) {
+    failFn(
+      `Без .js під npm/src потрібен ${EMIT_TYPES_CONFIG} (див. npm-module.mdc: emit через tsconfig, без штучного src/index.js)`
+    )
+    return
+  }
+  passFn(`${EMIT_TYPES_CONFIG} існує`)
+  let raw
+  try {
+    raw = JSON.parse(await readFile(EMIT_TYPES_CONFIG, 'utf8'))
+  } catch {
+    failFn(`${EMIT_TYPES_CONFIG}: некоректний JSON`)
+    return
+  }
+  const issues = emitTypesConfigIssues(raw)
+  if (issues.length === 0) {
+    passFn(`${EMIT_TYPES_CONFIG}: compilerOptions придатні для emitDeclarationOnly → types/`)
+  } else {
+    failFn(`${EMIT_TYPES_CONFIG}: ${issues.join('; ')}`)
+  }
+}
+
+/**
+ * Перевіряє npm-publish.yml workflow.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkPublishWorkflow(passFn, failFn) {
+  const publishWf = '.github/workflows/npm-publish.yml'
+  if (!existsSync(publishWf)) {
+    failFn(`Відсутній ${publishWf} (npm-module.mdc: npm publish)`)
+    return
+  }
+  passFn(`${publishWf} існує`)
+  const pub = await readFile(publishWf, 'utf8')
+  const root = parseWorkflowYaml(pub)
+  if (root) {
+    const checks = [
+      {
+        ok: pushPathsIncludeNpmGlob(root),
+        pass: `${publishWf}: on.push.paths містить npm/**`,
+        fail: `${publishWf}: у on.push.paths має бути npm/**`
+      },
+      {
+        ok: pushHasMainBranch(root),
+        pass: `${publishWf}: очікується branch main`,
+        fail: `${publishWf}: очікується branch main`
+      },
+      {
+        ok: hasIdTokenWritePermission(root),
+        pass: `${publishWf}: permissions містить id-token: write (OIDC)`,
+        fail: `${publishWf}: permissions має містити id-token: write (OIDC)`
+      },
+      {
+        ok: hasNpmPublishStepWithPackage(root),
+        pass: `${publishWf}: uses JS-DevTools/npm-publish та with.package npm/package.json`,
+        fail: `${publishWf}: очікується uses: JS-DevTools/npm-publish та with.package: npm/package.json`
+      }
+    ]
+    for (const c of checks) {
+      if (c.ok) {
+        passFn(c.pass)
+      } else {
+        failFn(c.fail)
+      }
+    }
+    return
+  }
+  const need = [
+    { sub: 'npm/**', msg: `${publishWf}: у on.push.paths має бути npm/**` },
+    { sub: 'branches:', msg: `${publishWf}: очікується on.push.branches` },
+    { sub: 'main', msg: `${publishWf}: очікується branch main` },
+    { sub: 'id-token: write', msg: `${publishWf}: permissions має містити id-token: write (OIDC)` },
+    { sub: 'JS-DevTools/npm-publish', msg: `${publishWf}: очікується uses: JS-DevTools/npm-publish` },
+    { sub: 'package: npm/package.json', msg: `${publishWf}: with.package має бути npm/package.json` }
+  ]
+  for (const { sub, msg } of need) {
+    if (pub.includes(sub)) {
+      passFn(`${publishWf} містить «${sub}»`)
+    } else {
+      failFn(msg)
+    }
+  }
+}
+
+/**
+ * Перевіряє базову структуру монорепо (package.json, npm/, workspaces, npm/package.json).
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ */
+async function checkNpmModuleBasicStructure(pass, fail) {
   if (existsSync('package.json')) {
     pass('package.json існує')
   } else {
@@ -168,8 +310,7 @@ export async function check() {
 
   if (existsSync('package.json')) {
     const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-    const ws = pkg.workspaces
-    if (Array.isArray(ws) && ws.includes('npm')) {
+    if (Array.isArray(pkg.workspaces) && pkg.workspaces.includes('npm')) {
       pass('package.json workspaces містить "npm"')
     } else {
       fail('package.json workspaces має містити "npm"')
@@ -181,81 +322,33 @@ export async function check() {
   } else {
     fail('npm/package.json не існує — створи package.json для npm модуля')
   }
+}
 
-  const useSrcJsLayout = await npmSrcTreeHasJsFile()
-
-  if (existsSync('npm/package.json')) {
-    const npmPkg = JSON.parse(await readFile('npm/package.json', 'utf8'))
-    const typesField = npmPkg.types
+/**
+ * Перевіряє відповідність проєкту правилам npm-module.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
 
-    if (useSrcJsLayout) {
-      if (typesField === TYPES_INDEX) {
-        pass(`npm/package.json: "types": "${TYPES_INDEX}" (layout npm/src + .js)`)
-      } else {
-        fail(`npm/package.json: при наявності .js під npm/src очікується "types": "${TYPES_INDEX}"`)
-      }
-    } else {
-      if (typeof typesField === 'string' && /^\.\/types\/.+\.d\.(ts|mts)$/.test(typesField)) {
-        pass(`npm/package.json: "types" вказує на файл під ./types/… (${typesField})`)
-      } else {
-        fail(
-          'npm/package.json: без .js під npm/src поле types має бути рядком виду ./types/….d.ts або .d.mts (див. npm-module.mdc)'
-        )
-      }
-    }
+  await checkNpmModuleBasicStructure(pass, fail)
 
-    const files = npmPkg.files
-    if (Array.isArray(files) && files.includes('types')) {
-      pass('npm/package.json: files містить "types"')
-    } else {
-      fail('npm/package.json: масив files має містити "types"')
-    }
+  const useSrcJsLayout = await npmSrcTreeHasJsFile()
 
-    const typesPath = useSrcJsLayout ? join('npm', 'types', 'index.d.ts') : npmTypesFileFromPackageField(typesField)
-    if (typesPath && existsSync(typesPath)) {
-      pass(`${typesPath} існує`)
-    } else {
-      fail(
-        useSrcJsLayout
-          ? `Відсутній ${join('npm', 'types', 'index.d.ts')} (згенеруй tsc з npm-module.mdc)`
-          : `Файл для поля types не знайдено або шлях не під ./types/ — ${String(typesField)}`
-      )
-    }
-  }
+  await checkNpmPackageJson(useSrcJsLayout, pass, fail)
 
   if (!useSrcJsLayout) {
-    if (existsSync(EMIT_TYPES_CONFIG)) {
-      pass(`${EMIT_TYPES_CONFIG} існує`)
-      let raw
-      try {
-        raw = JSON.parse(await readFile(EMIT_TYPES_CONFIG, 'utf8'))
-      } catch {
-        fail(`${EMIT_TYPES_CONFIG}: некоректний JSON`)
-        raw = null
-      }
-      if (raw) {
-        const issues = emitTypesConfigIssues(raw)
-        if (issues.length === 0) {
-          pass(`${EMIT_TYPES_CONFIG}: compilerOptions придатні для emitDeclarationOnly → types/`)
-        } else {
-          fail(`${EMIT_TYPES_CONFIG}: ${issues.join('; ')}`)
-        }
-      }
-    } else {
-      fail(
-        `Без .js під npm/src потрібен ${EMIT_TYPES_CONFIG} (див. npm-module.mdc: emit через tsconfig, без штучного src/index.js)`
-      )
-    }
+    await checkEmitTypesConfig(pass, fail)
   }
 
+  const layoutLabel = useSrcJsLayout ? 'layout src' : 'tsconfig emit-types'
   const hk = await readHkConfig()
   if (hk) {
     pass(`${hk.path} існує`)
     const missing = useSrcJsLayout ? missingHkSrcLayoutFragments(hk.text) : missingHkEmitTypesConfigFragments(hk.text)
     if (missing.length === 0) {
-      pass(
-        `${hk.path}: pre-commit містить очікуваний виклик tsc (${useSrcJsLayout ? 'layout src' : 'tsconfig emit-types'})`
-      )
+      pass(`${hk.path}: pre-commit містить очікуваний виклик tsc (${layoutLabel})`)
     } else {
       fail(`${hk.path}: онови pre-commit крок (npm-module.mdc); не знайдено: ${missing.join(', ')}`)
     }
@@ -269,53 +362,7 @@ export async function check() {
     fail('.github/workflows/ не існує')
   }
 
-  const publishWf = '.github/workflows/npm-publish.yml'
-  if (existsSync(publishWf)) {
-    pass(`${publishWf} існує`)
-    const pub = await readFile(publishWf, 'utf8')
-    const root = parseWorkflowYaml(pub)
-
-    if (root) {
-      if (pushPathsIncludeNpmGlob(root)) {
-        pass(`${publishWf}: on.push.paths містить npm/**`)
-      } else {
-        fail(`${publishWf}: у on.push.paths має бути npm/**`)
-      }
-      if (pushHasMainBranch(root)) {
-        pass(`${publishWf}: очікується branch main`)
-      } else {
-        fail(`${publishWf}: очікується branch main`)
-      }
-      if (hasIdTokenWritePermission(root)) {
-        pass(`${publishWf}: permissions містить id-token: write (OIDC)`)
-      } else {
-        fail(`${publishWf}: permissions має містити id-token: write (OIDC)`)
-      }
-      if (hasNpmPublishStepWithPackage(root)) {
-        pass(`${publishWf}: uses JS-DevTools/npm-publish та with.package npm/package.json`)
-      } else {
-        fail(`${publishWf}: очікується uses: JS-DevTools/npm-publish та with.package: npm/package.json`)
-      }
-    } else {
-      const need = [
-        { sub: 'npm/**', msg: `${publishWf}: у on.push.paths має бути npm/**` },
-        { sub: 'branches:', msg: `${publishWf}: очікується on.push.branches` },
-        { sub: 'main', msg: `${publishWf}: очікується branch main` },
-        { sub: 'id-token: write', msg: `${publishWf}: permissions має містити id-token: write (OIDC)` },
-        { sub: 'JS-DevTools/npm-publish', msg: `${publishWf}: очікується uses: JS-DevTools/npm-publish` },
-        { sub: 'package: npm/package.json', msg: `${publishWf}: with.package має бути npm/package.json` }
-      ]
-      for (const { sub, msg } of need) {
-        if (pub.includes(sub)) {
-          pass(`${publishWf} містить «${sub}»`)
-        } else {
-          fail(msg)
-        }
-      }
-    }
-  } else {
-    fail(`Відсутній ${publishWf} (npm-module.mdc: npm publish)`)
-  }
+  await checkPublishWorkflow(pass, fail)
 
   return reporter.getExitCode()
 }