@alexlit/config-eslint 161.4.0 → 162.0.0

package/plugins/tailwindcss.js

@@ -3,20 +3,32 @@ import { defineConfig } from 'eslint/config';
 
 import { FILES } from '../base.js';
 
+const DEFAULT_CSS_CONFIG_PATH = './styles/tailwind.css';
+
 /**
+ * Правила для Tailwind CSS.
+ *
+ * Опция `cssConfigPath` - путь к CSS-файлу с Tailwind-конфигурацией. Остальные
+ * опции - произвольные flat-опции ESLint, они добавляются отдельным блоком.
+ *
  * @example
  *   import path from 'node:path';
  *
- *   tailwindcss({
+ *   plugins.tailwindcss({
  *     cssConfigPath: path.resolve(import.meta.dirname, 'src/tailwind.css'),
  *   });
  *
- * @param settings {import('eslint-plugin-tailwindcss').PluginSettings}
+ * @param {import('eslint').Linter.Config & { cssConfigPath?: string }} [options]
+ *   - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
  *
  * @see [eslint-plugin-tailwindcss](https://github.com/francoismassart/eslint-plugin-tailwindcss)
  */
-export const tailwindcss = (settings) =>
-  defineConfig([
+export const tailwindcss = (options = {}) => {
+  const { cssConfigPath, ...flat } = options;
+
+  return defineConfig([
     {
       files: FILES,
       plugins: { tailwindcss: plugin },
@@ -27,7 +39,13 @@ export const tailwindcss = (settings) =>
       },
       settings: {
         /** @type {import('eslint-plugin-tailwindcss').PluginSettings} */
-        tailwindcss: { cssConfigPath: './styles/tailwind.css', ...settings },
+        tailwindcss: {
+          cssConfigPath: DEFAULT_CSS_CONFIG_PATH,
+          ...(cssConfigPath !== undefined && { cssConfigPath }),
+        },
       },
     },
+
+    ...(Object.keys(flat).length > 0 ? [flat] : []),
   ]);
+};

package/plugins/tanstack-query.js

@@ -1,14 +1,24 @@
 import plugin from '@tanstack/eslint-plugin-query';
 import { defineConfig } from 'eslint/config';
 
-import { DATA_FILES } from '../base.js';
+import { createPlugin, DATA_FILES } from '../base.js';
 
-/** @see [@tanstack/query](https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query) */
-export const tanstackQuery = defineConfig([
-  // The shipped config has no `files` key, so it would also cover data files.
-  ...plugin.configs['flat/recommended'].map((config) => ({
-    ...config,
-    ignores: [...(config.ignores ?? []), ...DATA_FILES],
-  })),
-  { rules: { '@tanstack/query/infinite-query-property-order': 'off' } },
-]);
+/**
+ * Правила для TanStack Query.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [@tanstack/query](https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query)
+ */
+export const tanstackQuery = createPlugin(() =>
+  defineConfig([
+    // The shipped config has no `files` key, so it would also cover data files.
+    ...plugin.configs['flat/recommended'].map((config) => ({
+      ...config,
+      ignores: [...(config.ignores ?? []), ...DATA_FILES],
+    })),
+    { rules: { '@tanstack/query/infinite-query-property-order': 'off' } },
+  ]),
+);

package/plugins/typescript-type-checked.js

@@ -1,50 +1,64 @@
 import { defineConfig } from 'eslint/config';
 import plugin from 'typescript-eslint';
 
-import { DATA_FILES, FILES, TEST_FILES, TS_FILES } from '../base.js';
+import {
+  createPlugin,
+  DATA_FILES,
+  FILES,
+  TEST_FILES,
+  TS_FILES,
+} from '../base.js';
 import { TS_RULES } from '../rules/typescript.js';
 
 /**
- * Type-aware TypeScript config.
+ * Type-aware правила TypeScript.
  *
  * Opt-in: requires a `tsconfig.json` in the project and needs type information,
  * which makes linting slower. Use it instead of `typescript`, not alongside
  * it.
  *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
  * @see [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint)
  */
-export const typescriptTypeChecked = defineConfig([
-  // The parser is needed for every JS/TS/Vue file, not only for TypeScript ones,
-  // otherwise `.js` files fall back to the default parser and modern syntax
-  // (`import.meta`, top-level await) breaks.
-  { ...plugin.configs.base, files: FILES },
+export const typescriptTypeChecked = createPlugin(() =>
+  defineConfig([
+    // The parser is needed for every JS/TS/Vue file, not only for TypeScript ones,
+    // otherwise `.js` files fall back to the default parser and modern syntax
+    // (`import.meta`, top-level await) breaks.
+    { ...plugin.configs.base, files: FILES },
 
-  // Non type-aware rules — the same scope as the regular `typescript` plugin,
-  // so `.js`/`.vue` files keep the TypeScript versions of the rules.
-  // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
-  // so they would also land on data files that are not JavaScript at all.
-  ...[...plugin.configs.strict, ...plugin.configs.stylistic].map((config) => ({
-    ...config,
-    ignores: [...(config.ignores ?? []), ...DATA_FILES],
-  })),
+    // Non type-aware rules - the same scope as the regular `typescript` plugin,
+    // so `.js`/`.vue` files keep the TypeScript versions of the rules.
+    // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
+    // so they would also land on data files that are not JavaScript at all.
+    ...[...plugin.configs.strict, ...plugin.configs.stylistic].map(
+      (config) => ({
+        ...config,
+        ignores: [...(config.ignores ?? []), ...DATA_FILES],
+      }),
+    ),
 
-  // Type-aware rules only make sense where the type information is available.
-  ...plugin.configs.strictTypeChecked.map((config) => ({
-    ...config,
-    files: TS_FILES,
-  })),
-  ...plugin.configs.stylisticTypeChecked.map((config) => ({
-    ...config,
-    files: TS_FILES,
-  })),
+    // Type-aware rules only make sense where the type information is available.
+    ...plugin.configs.strictTypeChecked.map((config) => ({
+      ...config,
+      files: TS_FILES,
+    })),
+    ...plugin.configs.stylisticTypeChecked.map((config) => ({
+      ...config,
+      files: TS_FILES,
+    })),
 
-  {
-    files: TS_FILES,
-    languageOptions: { parserOptions: { projectService: true } },
-    rules: TS_RULES,
-  },
-  {
-    files: TEST_FILES,
-    rules: { '@typescript-eslint/no-empty-function': 'off' },
-  },
-]);
+    {
+      files: TS_FILES,
+      languageOptions: { parserOptions: { projectService: true } },
+      rules: TS_RULES,
+    },
+    {
+      files: TEST_FILES,
+      rules: { '@typescript-eslint/no-empty-function': 'off' },
+    },
+  ]),
+);

package/plugins/typescript.js

@@ -1,21 +1,33 @@
 import { defineConfig } from 'eslint/config';
 import plugin from 'typescript-eslint';
 
-import { DATA_FILES, FILES, TEST_FILES } from '../base.js';
+import { createPlugin, DATA_FILES, FILES, TEST_FILES } from '../base.js';
 import { TS_RULES } from '../rules/typescript.js';
 
-/** @see [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint) */
-export const typescript = defineConfig([
-  // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
-  // so they would also land on data files that are not JavaScript at all.
-  ...[...plugin.configs.strict, ...plugin.configs.stylistic].map((config) => ({
-    ...config,
-    ignores: [...(config.ignores ?? []), ...DATA_FILES],
-  })),
+/**
+ * Правила TypeScript без анализа типов.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint)
+ */
+export const typescript = createPlugin(() =>
+  defineConfig([
+    // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
+    // so they would also land on data files that are not JavaScript at all.
+    ...[...plugin.configs.strict, ...plugin.configs.stylistic].map(
+      (config) => ({
+        ...config,
+        ignores: [...(config.ignores ?? []), ...DATA_FILES],
+      }),
+    ),
 
-  { files: FILES, rules: TS_RULES },
-  {
-    files: TEST_FILES,
-    rules: { '@typescript-eslint/no-empty-function': 'off' },
-  },
-]);
+    { files: FILES, rules: TS_RULES },
+    {
+      files: TEST_FILES,
+      rules: { '@typescript-eslint/no-empty-function': 'off' },
+    },
+  ]),
+);

package/plugins/unicorn.js

@@ -1,72 +1,84 @@
 import plugin from 'eslint-plugin-unicorn';
 import { defineConfig } from 'eslint/config';
 
-import { DTS_FILES, FILES, VUE_FILES } from '../base.js';
+import { createPlugin, DTS_FILES, FILES, VUE_FILES } from '../base.js';
 
-/** @see [eslint-plugin-unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn) */
-export const unicorn = defineConfig([
-  { ...plugin.configs.recommended, files: FILES },
-  {
-    files: FILES,
-    rules: {
-      'unicorn/comment-content': ['warn'],
-      'unicorn/consistent-function-scoping': [
-        'error',
-        { checkArrowFunctions: false },
-      ],
-      'unicorn/consistent-function-style': [
-        'error',
-        { default: 'arrow-function' },
+/**
+ * Правила unicorn.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn)
+ */
+export const unicorn = createPlugin(() =>
+  defineConfig([
+    { ...plugin.configs.recommended, files: FILES },
+    {
+      files: FILES,
+      rules: {
+        'unicorn/comment-content': ['warn'],
+        'unicorn/consistent-function-scoping': [
+          'error',
+          { checkArrowFunctions: false },
+        ],
+        'unicorn/consistent-function-style': [
+          'error',
+          { default: 'arrow-function' },
+        ],
+        // Explicit: the default happens to be kebab case, but the intent is
+        // worth pinning down. Applies to `.vue` components too, which is why
+        // `vue/match-component-file-name` is kept in sync with it in `vue.js`.
+        'unicorn/filename-case': ['error', { case: 'kebabCase' }],
+        'unicorn/iteration-fallback-style': ['error', 'guard'],
+        'unicorn/name-replacements': 'off',
+        'unicorn/no-array-reduce': ['error', { allowSimpleOperations: true }],
+        'unicorn/no-asterisk-prefix-in-documentation-comments': 'off',
+        'unicorn/no-empty-file': 'off',
+        'unicorn/no-for-each': 'off',
+        'unicorn/no-this-outside-of-class': 'off', // used in setters/getters
+        'unicorn/no-top-level-side-effects': 'off', // Vue.js specific
+        'unicorn/no-unused-properties': 'off', // don't respect local keys
+        'unicorn/prefer-dom-node-html-methods': 'off', // Safari not supports setHTML()
+        'unicorn/prefer-export-from': ['error', { checkUsedVariables: true }],
+        'unicorn/prefer-https': 'off', // SVG need HTTP
+        'unicorn/prefer-import-meta-properties': 'warn',
+        'unicorn/prefer-iterator-concat': 'off', // ES2026 only
+        'unicorn/prefer-json-import': 'warn',
+        'unicorn/prefer-module': 'warn',
+        'unicorn/prefer-node-protocol': 'warn',
+        'unicorn/prefer-temporal': 'off', // ES2026 only
+        'unicorn/prefer-type-literal-last': 'off', // perfectionist/sort-intersection-types
+        'unicorn/prefer-uint8array-hex': 'warn',
+        'unicorn/relative-url-style': ['error', 'always'],
+        'unicorn/single-line-block-comment-style': 'off',
+      },
+    },
+    { files: ['**/.*'], rules: { 'unicorn/no-null': 'off' } },
+    { files: DTS_FILES, rules: { 'unicorn/prefer-export-from': 'off' } },
+    {
+      // `null` is part of the type contract in Vue.js SFC:
+      // `ref<Type | null>(null)` is the idiomatic way to declare an initially
+      // empty reactive value. Everywhere else `null` remains an error.
+      files: VUE_FILES,
+      rules: { 'unicorn/no-null': 'off' },
+    },
+    {
+      files: [
+        '**/*.{api,endpoints,fixtures,schemas,service,spec,test}.{js,ts}',
       ],
-      // Explicit: the default happens to be kebab case, but the intent is
-      // worth pinning down. Applies to `.vue` components too, which is why
-      // `vue/match-component-file-name` is kept in sync with it in `vue.js`.
-      'unicorn/filename-case': ['error', { case: 'kebabCase' }],
-      'unicorn/iteration-fallback-style': ['error', 'guard'],
-      'unicorn/name-replacements': 'off',
-      'unicorn/no-array-reduce': ['error', { allowSimpleOperations: true }],
-      'unicorn/no-asterisk-prefix-in-documentation-comments': 'off',
-      'unicorn/no-empty-file': 'off',
-      'unicorn/no-for-each': 'off',
-      'unicorn/no-this-outside-of-class': 'off', // used in setters/getters
-      'unicorn/no-top-level-side-effects': 'off', // Vue.js specific
-      'unicorn/no-unused-properties': 'off', // don't respect local keys
-      'unicorn/prefer-dom-node-html-methods': 'off', // Safari not supports setHTML()
-      'unicorn/prefer-export-from': ['error', { checkUsedVariables: true }],
-      'unicorn/prefer-https': 'off', // SVG need HTTP
-      'unicorn/prefer-import-meta-properties': 'warn',
-      'unicorn/prefer-iterator-concat': 'off', // ES2026 only
-      'unicorn/prefer-json-import': 'warn',
-      'unicorn/prefer-module': 'warn',
-      'unicorn/prefer-node-protocol': 'warn',
-      'unicorn/prefer-temporal': 'off', // ES2026 only
-      'unicorn/prefer-type-literal-last': 'off', // perfectionist/sort-intersection-types
-      'unicorn/prefer-uint8array-hex': 'warn',
-      'unicorn/relative-url-style': ['error', 'always'],
-      'unicorn/single-line-block-comment-style': 'off',
+      rules: {
+        'unicorn/max-nested-calls': 'off',
+        'unicorn/no-keyword-prefix': 'off',
+        'unicorn/no-null': 'off',
+        'unicorn/no-object-as-default-parameter': 'off',
+        'unicorn/no-useless-undefined': 'off',
+      },
     },
-  },
-  { files: ['**/.*'], rules: { 'unicorn/no-null': 'off' } },
-  { files: DTS_FILES, rules: { 'unicorn/prefer-export-from': 'off' } },
-  {
-    // `null` is part of the type contract in Vue.js SFC:
-    // `ref<Type | null>(null)` is the idiomatic way to declare an initially
-    // empty reactive value. Everywhere else `null` remains an error.
-    files: VUE_FILES,
-    rules: { 'unicorn/no-null': 'off' },
-  },
-  {
-    files: ['**/*.{api,endpoints,fixtures,schemas,service,spec,test}.{js,ts}'],
-    rules: {
-      'unicorn/max-nested-calls': 'off',
-      'unicorn/no-keyword-prefix': 'off',
-      'unicorn/no-null': 'off',
-      'unicorn/no-object-as-default-parameter': 'off',
-      'unicorn/no-useless-undefined': 'off',
+    {
+      files: ['**/temp/**/*.vue'],
+      rules: { 'unicorn/name-replacements': 'off' },
     },
-  },
-  {
-    files: ['**/temp/**/*.vue'],
-    rules: { 'unicorn/name-replacements': 'off' },
-  },
-]);
+  ]),
+);

package/plugins/unocss.js

@@ -1,10 +1,20 @@
 import plugin from '@unocss/eslint-config/flat';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../base.js';
+import { createPlugin, FILES } from '../base.js';
 
-/** @see [@unocss/eslint-config](https://unocss.dev/integrations/eslint) */
-export const unocss = defineConfig([
-  { files: FILES, ...plugin },
-  { files: FILES, rules: { 'unocss/order-attributify': 'off' } },
-]);
+/**
+ * Правила для UnoCSS.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [@unocss/eslint-config](https://unocss.dev/integrations/eslint)
+ */
+export const unocss = createPlugin(() =>
+  defineConfig([
+    { files: FILES, ...plugin },
+    { files: FILES, rules: { 'unocss/order-attributify': 'off' } },
+  ]),
+);

package/plugins/vitest.js

@@ -1,20 +1,30 @@
 import plugin from '@vitest/eslint-plugin';
 import { defineConfig } from 'eslint/config';
 
-import { TEST_FILES } from '../base.js';
+import { createPlugin, TEST_FILES } from '../base.js';
 
-/** @see [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest) */
-export const vitest = defineConfig([
-  {
-    files: TEST_FILES,
-    plugins: { vitest: plugin },
-    rules: {
-      ...plugin.configs.recommended.rules,
+/**
+ * Правила для тестов Vitest.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest)
+ */
+export const vitest = createPlugin(() =>
+  defineConfig([
+    {
+      files: TEST_FILES,
+      plugins: { vitest: plugin },
+      rules: {
+        ...plugin.configs.recommended.rules,
 
-      'vitest/no-conditional-in-test': 'off',
-      'vitest/no-conditional-tests': 'off',
-      'vitest/no-hooks': 'off',
-      'vitest/require-to-throw-message': 'off',
+        'vitest/no-conditional-in-test': 'off',
+        'vitest/no-conditional-tests': 'off',
+        'vitest/no-hooks': 'off',
+        'vitest/require-to-throw-message': 'off',
+      },
     },
-  },
-]);
+  ]),
+);

package/plugins/vue-accessibility.js

@@ -1,18 +1,30 @@
 import plugin from 'eslint-plugin-vuejs-accessibility';
 import { defineConfig } from 'eslint/config';
 
-/** @see [eslint-plugin-vuejs-accessibility](https://vue-a11y.github.io/eslint-plugin-vuejs-accessibility/) */
-export const vueAccessibility = defineConfig([
-  ...plugin.configs['flat/recommended'],
+import { createPlugin, VUE_FILES } from '../base.js';
 
-  {
-    files: ['**/*.vue'],
-    rules: {
-      'vuejs-accessibility/label-has-for': [
-        'warn',
-        { allowChildren: true, required: { some: ['nesting', 'id'] } },
-      ],
-      'vuejs-accessibility/no-autofocus': ['warn', { ignoreNonDOM: true }],
+/**
+ * Правила доступности Vue.js-компонентов.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-vuejs-accessibility](https://vue-a11y.github.io/eslint-plugin-vuejs-accessibility/)
+ */
+export const vueAccessibility = createPlugin(() =>
+  defineConfig([
+    ...plugin.configs['flat/recommended'],
+
+    {
+      files: VUE_FILES,
+      rules: {
+        'vuejs-accessibility/label-has-for': [
+          'warn',
+          { allowChildren: true, required: { some: ['nesting', 'id'] } },
+        ],
+        'vuejs-accessibility/no-autofocus': ['warn', { ignoreNonDOM: true }],
+      },
     },
-  },
-]);
+  ]),
+);

package/plugins/vue-i18n.js

@@ -1,39 +1,49 @@
 import plugin from '@intlify/eslint-plugin-vue-i18n';
 import { defineConfig } from 'eslint/config';
 
-import { DATA_FILES } from '../base.js';
+import { createPlugin, DATA_FILES, VUE_FILES } from '../base.js';
 
-/** @see [eslint-plugin-vue-i18n](https://eslint-plugin-vue-i18n.intlify.dev/) */
-export const vueI18n = defineConfig([
-  ...plugin.configs['flat/recommended'].map((config) => ({
-    ...config,
-    ignores: [...(config.ignores ?? []), ...DATA_FILES],
-  })),
+/**
+ * Правила для Vue.js I18n.
+ *
+ * @param {import('eslint').Linter.Config} [options] - Дополнительные flat-опции
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-vue-i18n](https://eslint-plugin-vue-i18n.intlify.dev/)
+ */
+export const vueI18n = createPlugin(() =>
+  defineConfig([
+    ...plugin.configs['flat/recommended'].map((config) => ({
+      ...config,
+      ignores: [...(config.ignores ?? []), ...DATA_FILES],
+    })),
 
-  {
-    files: ['**/*.vue'],
-    rules: {
-      '@intlify/vue-i18n/key-format-style': [
-        'error',
-        'snake_case',
-        { allowArray: false },
-      ],
-      '@intlify/vue-i18n/no-duplicate-keys-in-locale': [
-        'error',
-        { ignoreI18nBlock: false },
-      ],
-      '@intlify/vue-i18n/no-dynamic-keys': 'warn',
-      '@intlify/vue-i18n/no-raw-text': 'off',
-      '@intlify/vue-i18n/no-unused-keys': 'warn',
-      '@intlify/vue-i18n/prefer-sfc-lang-attr': 'error',
+    {
+      files: VUE_FILES,
+      rules: {
+        '@intlify/vue-i18n/key-format-style': [
+          'error',
+          'snake_case',
+          { allowArray: false },
+        ],
+        '@intlify/vue-i18n/no-duplicate-keys-in-locale': [
+          'error',
+          { ignoreI18nBlock: false },
+        ],
+        '@intlify/vue-i18n/no-dynamic-keys': 'warn',
+        '@intlify/vue-i18n/no-raw-text': 'off',
+        '@intlify/vue-i18n/no-unused-keys': 'warn',
+        '@intlify/vue-i18n/prefer-sfc-lang-attr': 'error',
+      },
     },
-  },
-  {
-    settings: {
-      'vue-i18n': {
-        localeDir: './**/locales/*.{json,json5,yaml,yml}',
-        messageSyntaxVersion: '^9.0.0',
+    {
+      settings: {
+        'vue-i18n': {
+          localeDir: './**/locales/*.{json,json5,yaml,yml}',
+          messageSyntaxVersion: '^9.0.0',
+        },
       },
     },
-  },
-]);
+  ]),
+);