@nitra/eslint-config 3.6.13 → 3.6.14

package/index.js

@@ -54,7 +54,7 @@ const VUE_SCRIPT_ESLINT_RECOMMENDED_GAP_RULES = {
 
 /** Пресет recommended `@e18e/eslint-plugin` (flat). */
 // @ts-expect-error типізація плагіна не гарантує `configs.recommended`; у runtime поле є.
-const e18eRecommendedFlat = /** @type {import('eslint').Linter.FlatConfig} */ (e18ePlugin.configs.recommended)
+const e18eRecommendedFlat = /** @type {import('eslint').Linter.Config} */ (e18ePlugin.configs.recommended)
 
 /**
  * Лише віртуальні GraphQL-документи з процесора (gql у `.js`/`.vue`): шляхи виду
@@ -194,9 +194,9 @@ const vueGraphqlMergedProcessor = mergeProcessors([
 
 /**
  * Обмежує масив flat-конфігів ESLint заданими `files` (копія кожного елемента).
- * @param {import('eslint').Linter.FlatConfig[]} configs вхідні конфіги
+ * @param {import('eslint').Linter.Config[]} configs вхідні конфіги
  * @param {string[]} files glob-патерни файлів
- * @returns {import('eslint').Linter.FlatConfig[]} новий масив flat-конфігів з полем `files`
+ * @returns {import('eslint').Linter.Config[]} новий масив flat-конфігів з полем `files`
  */
 function flatConfigsWithFiles(configs, files) {
   return configs.map(config => ({ ...config, files }))
@@ -324,21 +324,46 @@ const all = [
 /* Друга частина SDL node: лише правила microsoft-sdl; перший блок upstream дублює реєстрацію eslint-plugin-n. */
 const microsoftSdlNodeConfigsWithoutN = microsoftSdl.configs.node.slice(1)
 
-const node = [
-  nodePlugin.configs['flat/recommended-module'],
-  {
-    rules: {
-      'n/no-missing-import': 'off', // покривається oxlint https://github.com/oxc-project/oxc/issues/481#issuecomment-3135766557
-      'n/no-deprecated-api': 'error' // як перший блок `configs.node` у @microsoft/eslint-plugin-sdl
-    },
-    languageOptions: {
-      globals: {
-        ...globals.node,
-        Bun: 'readonly'
-      }
+/**
+ * Додаткові правила та глобалі Bun поверх пресетів eslint-plugin-n для кожного шару під `params.node`.
+ */
+const NODE_ESLINT_PLUGIN_N_EXTRA = {
+  rules: {
+    'n/no-missing-import': 'off', // покривається oxlint https://github.com/oxc-project/oxc/issues/481#issuecomment-3135766557
+    'n/no-deprecated-api': 'error' // як перший блок `configs.node` у @microsoft/eslint-plugin-sdl
+  },
+  languageOptions: {
+    globals: {
+      ...globals.node,
+      Bun: 'readonly'
     }
   }
-]
+}
+
+/** Три шари: `.js` (рекомендований пресет за `type` у package.json), `.mjs` (ESM), `.cjs` (CommonJS). */
+const NODE_PLUGIN_N_MIXED = nodePlugin.configs['flat/mixed-esm-and-cjs']
+
+/**
+ * Flat-конфіги eslint-plugin-n для заданих кореневих директорій Node-коду (узгоджено з `flat/mixed-esm-and-cjs`).
+ * @param {string[]} dirNames елементи `params.node`
+ * @returns {import('eslint').Linter.Config[]} шість flat-конфігів (три від пресету плагіна n × два шари з NODE_ESLINT_PLUGIN_N_EXTRA)
+ */
+function flatConfigsNodePluginNForDirectories(dirNames) {
+  const filesByKind = [
+    dirNames.map(name => `${name}/**/*.js`),
+    dirNames.map(name => `${name}/**/*.mjs`),
+    dirNames.map(name => `${name}/**/*.cjs`)
+  ]
+  /** @type {import('eslint').Linter.Config[]} */
+  const out = []
+  for (let i = 0; i < 3; i++) {
+    out.push(
+      { ...NODE_PLUGIN_N_MIXED[i], files: filesByKind[i] },
+      { ...NODE_ESLINT_PLUGIN_N_EXTRA, files: filesByKind[i] }
+    )
+  }
+  return out
+}
 
 // Тільки для Vue проектів
 // files: ['**/vite.config.js']
@@ -505,7 +530,7 @@ const vue2 = [
 
 /**
  * Увімкнути graphql-eslint processor лише для .js (gql у коді).
- * @param {import('eslint').Linter.FlatConfig[]} result масив конфігів
+ * @param {import('eslint').Linter.Config[]} result масив конфігів
  * @param {string[]} dirs кореневі директорії
  */
 function pushGraphqlJsProcessors(result, dirs) {
@@ -521,7 +546,7 @@ function pushGraphqlJsProcessors(result, dirs) {
 /**
  * Merge processor для .vue (vue + vue-blocks + graphql) — має бути останнім серед конфігів для `*.vue`,
  * інакше пресет eslint-plugin-vue (`processor: "vue/vue"`) перезапише його.
- * @param {import('eslint').Linter.FlatConfig[]} result масив конфігів
+ * @param {import('eslint').Linter.Config[]} result масив конфігів
  * @param {string[]} dirs кореневі директорії Vue-пакетів
  */
 function pushGraphqlVueMergedProcessorLast(result, dirs) {
@@ -537,7 +562,7 @@ function pushGraphqlVueMergedProcessorLast(result, dirs) {
 /**
  * Після oxlint додає для `.vue` правила з `eslint:recommended`, які не делегує `eslint-plugin-oxlint` і які
  * не ввімкнені в oxlint за `.oxlintrc.json` (див. `VUE_SCRIPT_ESLINT_RECOMMENDED_GAP_RULES`).
- * @param {import('eslint').Linter.FlatConfig[]} result масив конфігів
+ * @param {import('eslint').Linter.Config[]} result масив конфігів
  * @param {string[]} dirs кореневі директорії Vue-пакетів (ті самі аргументи dirs, що й у pushVueConfigs)
  */
 function pushVueScriptEslintRecommendedGapsAfterOxlint(result, dirs) {
@@ -556,9 +581,9 @@ function pushVueScriptEslintRecommendedGapsAfterOxlint(result, dirs) {
 
 /**
  * Додає до result конфіги для Vue-проєктів (vite, .vue, .js).
- * @param {import('eslint').Linter.FlatConfig[]} result масив конфігів
+ * @param {import('eslint').Linter.Config[]} result масив конфігів
  * @param {string[]} dirs директорії Vue-проєктів
- * @param {{ includeVite?: boolean, extraVueConfigs?: import('eslint').Linter.FlatConfig[] }} [options] опції: includeVite, extraVueConfigs
+ * @param {{ includeVite?: boolean, extraVueConfigs?: import('eslint').Linter.Config[] }} [options] опції: includeVite, extraVueConfigs
  */
 function pushVueConfigs(result, dirs, options = {}) {
   const { includeVite = false, extraVueConfigs = [] } = options
@@ -584,10 +609,12 @@ function pushVueConfigs(result, dirs, options = {}) {
 /**
  * ESLint flat config для проєктів на Vue та Node.
  * @param {object} [params] — список директорій для застосування правил
- * @param {string[]} [params.node] — шляхи до Node.js коду
+ * @param {string[]} [params.node] — шляхи до Node.js коду; правила та `globals.node` застосовуються до файлів
+ *   `.js`, `.mjs` та `.cjs` у дереві кожної директорії (eslint-plugin-n `flat/mixed-esm-and-cjs`: для `.cjs` —
+ *   script/CommonJS, для `.mjs` — module, для `.js` — за полем `type` у package.json проєкту).
  * @param {string[]} [params.vue] — шляхи до Vue 3
  * @param {string[]} [params.vue2] — шляхи до Vue 2
- * @returns {import('eslint').Linter.FlatConfig[]} масив конфігурацій ESLint
+ * @returns {import('eslint').Linter.Config[]} масив конфігурацій ESLint
  */
 // oxlint-disable-next-line unicorn/no-object-as-default-parameter
 export function getConfig(params = { node: [], vue: [], vue2: [] }) {
@@ -597,9 +624,9 @@ export function getConfig(params = { node: [], vue: [], vue2: [] }) {
   const graphqlVueDirsLast = []
 
   if (params.node?.length) {
-    const files = params.node.map(name => `${name}/**/*.js`)
+    const files = params.node.flatMap(name => [`${name}/**/*.js`, `${name}/**/*.mjs`, `${name}/**/*.cjs`])
     result.push(
-      ...node.map(configObject => ({ files, ...configObject })),
+      ...flatConfigsNodePluginNForDirectories(params.node),
       ...flatConfigsWithFiles(microsoftSdlNodeConfigsWithoutN, files)
     )
     // Каталог `npm` пакета конфігу зазвичай без graphql-config; перший preprocess інакше кешує null і ламає демо/vue.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/eslint-config",
-  "version": "3.6.13",
+  "version": "3.6.14",
   "description": "An ESLint shareable config for projects using Vue and Node",
   "keywords": [
     "eslint",
@@ -21,6 +21,9 @@
   "type": "module",
   "types": "./types/index.d.ts",
   "exports": "./index.js",
+  "scripts": {
+    "test": "bun test"
+  },
   "dependencies": {
     "@e18e/eslint-plugin": "^0.3.0",
     "@eslint/compat": "^2.0.5",

package/types/index.d.ts

@@ -2,7 +2,10 @@
  * Параметри для getConfig — список директорій для застосування правил.
  */
 export interface GetConfigParams {
-  /** Шляхи до Node.js коду */
+  /**
+   * Шляхи до Node.js коду — правила та node globals для `**/*.js`, `**/*.mjs`, `**/*.cjs` у кожній директорії
+   * (у т.ч. окремий пресет для `.cjs` через eslint-plugin-n mixed ESM/CJS).
+   */
   node?: string[]
   /** Шляхи до Vue 3 */
   vue?: string[]
@@ -11,14 +14,14 @@ export interface GetConfigParams {
 }
 
 /**
- * Один елемент ESLint flat config (сумісний з Linter.FlatConfig).
+ * Один елемент flat config ESLint (те саме, що `Linter.Config`; колишня назва типу `FlatConfig` у ESLint застаріла).
  * У проєктах з встановленим eslint типи будуть зв’язані автоматично.
  */
-export type FlatConfig = Record<string, unknown>
+export type FlatConfig = import('eslint').Linter.Config
 
 /**
  * ESLint flat config для проєктів на Vue та Node.
  * @param params — список директорій для застосування правил
  * @returns масив конфігурацій ESLint (flat config)
  */
-export function getConfig(params?: GetConfigParams): FlatConfig[]
+export function getConfig(params?: GetConfigParams): import('eslint').Linter.Config[]