@alexlit/config-eslint 161.4.0 → 162.1.0

package/plugins/import-x.js

@@ -18,44 +18,57 @@ const EXTENSIONS = [
   '.json',
 ];
 
-/** @see [eslint-plugin-import-x](https://github.com/un-ts/eslint-plugin-import-x) */
-export const importX = defineConfig([
-  { ...plugin.flatConfigs.recommended, files: FILES, ignores: DATA_FILES },
+/**
+ * Правила для импортов и модулей.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-import-x](https://github.com/un-ts/eslint-plugin-import-x)
+ */
+export const importX = () =>
+  defineConfig([
+    { ...plugin.flatConfigs.recommended, files: FILES, ignores: DATA_FILES },
 
-  {
-    files: FILES,
-    languageOptions: { parserOptions: { ecmaFeatures: { jsx: true } } },
-    plugins: { 'import-x': plugin },
-    rules: {
-      'import-x/consistent-type-specifier-style': ['error', 'prefer-top-level'],
-      'import-x/first': 'error',
-      'import-x/newline-after-import': 'warn',
-      'import-x/no-absolute-path': 'error',
-      'import-x/no-cycle': 'error',
-      'import-x/no-extraneous-dependencies': 'error',
-      'import-x/no-named-as-default': 'off',
-      'import-x/no-named-as-default-member': 'off',
-      'import-x/no-nodejs-modules': 'off',
-      'import-x/no-self-import': 'error',
-      'import-x/no-unresolved': 'off',
-      'import-x/no-useless-path-segments': ['error', { noUselessIndex: true }],
-      'import-x/unambiguous': 'error',
+    {
+      files: FILES,
+      languageOptions: { parserOptions: { ecmaFeatures: { jsx: true } } },
+      plugins: { 'import-x': plugin },
+      rules: {
+        'import-x/consistent-type-specifier-style': [
+          'error',
+          'prefer-top-level',
+        ],
+        'import-x/first': 'error',
+        'import-x/newline-after-import': 'warn',
+        'import-x/no-absolute-path': 'error',
+        'import-x/no-cycle': 'error',
+        'import-x/no-extraneous-dependencies': 'error',
+        'import-x/no-named-as-default': 'off',
+        'import-x/no-named-as-default-member': 'off',
+        'import-x/no-nodejs-modules': 'off',
+        'import-x/no-self-import': 'error',
+        'import-x/no-unresolved': 'off',
+        'import-x/no-useless-path-segments': [
+          'error',
+          { noUselessIndex: true },
+        ],
+        'import-x/unambiguous': 'error',
+      },
+      settings: {
+        'import-x/extensions': EXTENSIONS,
+        'import-x/ignore': ['node_modules', String.raw`\.vue$`],
+        'import-x/parsers': { '.vue': [vueParser] },
+        'import-x/resolver-next': [
+          createNodeResolver({ extensions: EXTENSIONS, tsconfig: 'auto' }),
+        ],
+      },
     },
-    settings: {
-      'import-x/extensions': EXTENSIONS,
-      'import-x/ignore': ['node_modules', String.raw`\.vue$`],
-      'import-x/parsers': { '.vue': [vueParser] },
-      'import-x/resolver-next': [
-        createNodeResolver({ extensions: EXTENSIONS, tsconfig: 'auto' }),
-      ],
-    },
-  },
 
-  {
-    files: VUE_FILES,
-    rules: {
-      'import-x/no-useless-path-segments': 'off',
-      'import-x/unambiguous': 'off',
+    {
+      files: VUE_FILES,
+      rules: {
+        'import-x/no-useless-path-segments': 'off',
+        'import-x/unambiguous': 'off',
+      },
     },
-  },
-]);
+  ]);

package/plugins/javascript.js

@@ -5,90 +5,101 @@ import { FILES, TEST_FILES } from '../base.js';
 import { NO_RESTRICTED_SYNTAX } from '../rules/restricted-syntax.js';
 import { STYLE_RULES } from '../rules/style.js';
 
-/** @see [eslint](https://eslint.org) */
-export const javascript = defineConfig([
-  { files: FILES, ...plugin.configs.recommended },
-  {
-    files: FILES,
-    rules: {
-      'arrow-body-style': ['error', 'as-needed'],
-      ...STYLE_RULES,
-      'default-case-last': 'error',
-      'dot-notation': ['error'],
-      'grouped-accessor-pairs': ['error', 'getBeforeSet'],
-      'no-alert': 'error',
-      'no-console': 'warn',
-      'no-duplicate-imports': [
-        'error',
-        { allowSeparateTypeImports: true, includeExports: false },
-      ],
-      'no-else-return': 'error',
-      'no-implicit-coercion': 'error',
-      'no-param-reassign': ['error', { props: false }],
-      'no-restricted-exports': [
-        'error',
-        {
-          restrictedNamedExports: ['then'],
-          restrictedNamedExportsPattern: '^_',
-        },
-      ],
-      'no-restricted-globals': [
-        'error',
-        // `event`, `top` and `parent` are global browser properties.
-        // Reach for `window.event` / `window.top` / `window.parent` instead.
-        { message: 'Use `window.event` instead.', name: 'event' },
-        { message: 'Use `window.parent` instead.', name: 'parent' },
-        { message: 'Use `window.top` instead.', name: 'top' },
-      ],
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            // Алиасы
-            { group: ['~/', '~~/'], message: 'Используйте "@" вместо "~".' },
-            // Расширения
-            {
-              message: 'Не указывайте расширения .ts или .js в путях импорта.',
-              regex: String.raw`\.[jt]sx?$`,
-            },
-            // Относительные импорты
-            { group: ['..', '*/..'], message: 'Используйте абсолютный путь.' },
-            {
-              message: 'Не используйте индексный импорт.',
-              regex: String.raw`^\.$`,
-            },
-            {
-              group: ['**/index'],
-              message: 'Не используйте индексный импорт.',
-            },
-            // Внешние локальные ресурсы
-            {
-              group: ['@/**/_*', '@@/**/_*', '~/**/_*', '~~/**/_*'],
-              message: 'Этот локальный ресурс не преднаназначен для импорта.',
-            },
-            // Устаревший функционал
-            {
-              message: 'Этот функционал устарел.',
-              regex: '(_deprecated|_legacy)',
-            },
-          ],
-        },
-      ],
-      'no-restricted-syntax': ['error', ...NO_RESTRICTED_SYNTAX],
-      'no-useless-rename': 'error',
-      'prefer-arrow-callback': [
-        'error',
-        { allowNamedFunctions: false, allowUnboundThis: false },
-      ],
-      'prefer-const': 'warn',
-      'prefer-template': 'warn',
-      'require-await': 'error',
+/**
+ * Базовые правила JavaScript.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint](https://eslint.org)
+ */
+export const javascript = () =>
+  defineConfig([
+    { files: FILES, ...plugin.configs.recommended },
+    {
+      files: FILES,
+      rules: {
+        'arrow-body-style': ['error', 'as-needed'],
+        ...STYLE_RULES,
+        'default-case-last': 'error',
+        'dot-notation': ['error'],
+        'grouped-accessor-pairs': ['error', 'getBeforeSet'],
+        'no-alert': 'error',
+        'no-console': 'warn',
+        'no-duplicate-imports': [
+          'error',
+          { allowSeparateTypeImports: true, includeExports: false },
+        ],
+        'no-else-return': 'error',
+        'no-implicit-coercion': 'error',
+        'no-param-reassign': ['error', { props: false }],
+        'no-restricted-exports': [
+          'error',
+          {
+            restrictedNamedExports: ['then'],
+            restrictedNamedExportsPattern: '^_',
+          },
+        ],
+        'no-restricted-globals': [
+          'error',
+          // `event`, `top` and `parent` are global browser properties.
+          // Reach for `window.event` / `window.top` / `window.parent` instead.
+          { message: 'Use `window.event` instead.', name: 'event' },
+          { message: 'Use `window.parent` instead.', name: 'parent' },
+          { message: 'Use `window.top` instead.', name: 'top' },
+        ],
+        'no-restricted-imports': [
+          'error',
+          {
+            patterns: [
+              // Алиасы
+              { group: ['~/', '~~/'], message: 'Используйте "@" вместо "~".' },
+              // Расширения
+              {
+                message:
+                  'Не указывайте расширения .ts или .js в путях импорта.',
+                regex: String.raw`\.[jt]sx?$`,
+              },
+              // Относительные импорты
+              {
+                group: ['..', '*/..'],
+                message: 'Используйте абсолютный путь.',
+              },
+              {
+                message: 'Не используйте индексный импорт.',
+                regex: String.raw`^\.$`,
+              },
+              {
+                group: ['**/index'],
+                message: 'Не используйте индексный импорт.',
+              },
+              // Внешние локальные ресурсы
+              {
+                group: ['@/**/_*', '@@/**/_*', '~/**/_*', '~~/**/_*'],
+                message: 'Этот локальный ресурс не преднаназначен для импорта.',
+              },
+              // Устаревший функционал
+              {
+                message: 'Этот функционал устарел.',
+                regex: '(_deprecated|_legacy)',
+              },
+            ],
+          },
+        ],
+        'no-restricted-syntax': ['error', ...NO_RESTRICTED_SYNTAX],
+        'no-useless-rename': 'error',
+        'prefer-arrow-callback': [
+          'error',
+          { allowNamedFunctions: false, allowUnboundThis: false },
+        ],
+        'prefer-const': 'warn',
+        'prefer-template': 'warn',
+        'require-await': 'error',
+      },
     },
-  },
 
-  {
-    // Tests are allowed to log and to alert
-    files: TEST_FILES,
-    rules: { 'no-alert': 'off', 'no-console': 'off' },
-  },
-]);
+    {
+      // Tests are allowed to log and to alert
+      files: TEST_FILES,
+      rules: { 'no-alert': 'off', 'no-console': 'off' },
+    },
+  ]);

package/plugins/jsdoc.js

@@ -3,21 +3,28 @@ import { defineConfig } from 'eslint/config';
 
 import { FILES } from '../base.js';
 
-/** @see [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) */
-export const jsdoc = defineConfig([
-  { files: FILES, ...plugin.configs['flat/recommended'] },
-  {
-    files: FILES,
-    rules: {
-      'jsdoc/lines-before-block': 'off',
-      'jsdoc/no-undefined-types': 'off',
-      'jsdoc/require-jsdoc': 'off',
-      'jsdoc/require-param-description': 'off',
-      'jsdoc/require-param-type': 'off',
-      'jsdoc/require-returns': 'off',
-      'jsdoc/require-returns-description': 'off',
-      'jsdoc/require-returns-type': 'off',
-      'jsdoc/tag-lines': 'off',
+/**
+ * Правила для JSDoc-комментариев.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc)
+ */
+export const jsdoc = () =>
+  defineConfig([
+    { files: FILES, ...plugin.configs['flat/recommended'] },
+    {
+      files: FILES,
+      rules: {
+        'jsdoc/lines-before-block': 'off',
+        'jsdoc/no-undefined-types': 'off',
+        'jsdoc/require-jsdoc': 'off',
+        'jsdoc/require-param-description': 'off',
+        'jsdoc/require-param-type': 'off',
+        'jsdoc/require-returns': 'off',
+        'jsdoc/require-returns-description': 'off',
+        'jsdoc/require-returns-type': 'off',
+        'jsdoc/tag-lines': 'off',
+      },
     },
-  },
-]);
+  ]);

package/plugins/json.js

@@ -4,30 +4,37 @@ import * as yamlParser from 'yaml-eslint-parser';
 
 import { YAML_FILES } from '../base.js';
 
-/** @see [ESLint/JSON](https://github.com/eslint/json) */
-export const json = defineConfig([
-  {
-    extends: ['json/recommended'],
-    files: ['**/*.json'],
-    ignores: ['**/package-lock.json'],
-    language: 'json/json',
-    plugins: { json: plugin },
-  },
+/**
+ * Правила для JSON, JSONC, JSON5 и YAML-файлов.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [ESLint/JSON](https://github.com/eslint/json)
+ */
+export const json = () =>
+  defineConfig([
+    {
+      extends: ['json/recommended'],
+      files: ['**/*.json'],
+      ignores: ['**/package-lock.json'],
+      language: 'json/json',
+      plugins: { json: plugin },
+    },
 
-  {
-    extends: ['json/recommended'],
-    files: ['**/*.jsonc'],
-    language: 'json/jsonc',
-    languageOptions: { allowTrailingCommas: true },
-    plugins: { json: plugin },
-  },
+    {
+      extends: ['json/recommended'],
+      files: ['**/*.jsonc'],
+      language: 'json/jsonc',
+      languageOptions: { allowTrailingCommas: true },
+      plugins: { json: plugin },
+    },
 
-  {
-    extends: ['json/recommended'],
-    files: ['**/*.json5'],
-    language: 'json/json5',
-    plugins: { json: plugin },
-  },
+    {
+      extends: ['json/recommended'],
+      files: ['**/*.json5'],
+      language: 'json/json5',
+      plugins: { json: plugin },
+    },
 
-  { files: YAML_FILES, languageOptions: { parser: yamlParser } },
-]);
+    { files: YAML_FILES, languageOptions: { parser: yamlParser } },
+  ]);

package/plugins/perfectionist.js

@@ -3,107 +3,120 @@ import { defineConfig } from 'eslint/config';
 
 import { FILES } from '../base.js';
 
-/** @see [eslint-plugin-perfectionist](https://perfectionist.dev) */
-export const perfectionist = defineConfig([
-  { ...plugin.configs['recommended-natural'], files: FILES },
-  {
-    files: FILES,
-    rules: {
-      'perfectionist/sort-imports': [
-        'warn',
-        {
-          customGroups: [
-            // hash (nuxt)
-            { elementNamePattern: ['^#'], groupName: 'hash' },
+/**
+ * Правила сортировки импортов, объектов, интерфейсов и типов.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-perfectionist](https://perfectionist.dev)
+ */
+export const perfectionist = () =>
+  defineConfig([
+    { ...plugin.configs['recommended-natural'], files: FILES },
+    {
+      files: FILES,
+      rules: {
+        'perfectionist/sort-imports': [
+          'warn',
+          {
+            customGroups: [
+              // hash (nuxt)
+              { elementNamePattern: ['^#'], groupName: 'hash' },
 
-            // @@/
-            { elementNamePattern: ['^@@/'], groupName: 'double-at' },
+              // @@/
+              { elementNamePattern: ['^@@/'], groupName: 'double-at' },
 
-            // universal
-            { elementNamePattern: ['^@/api'], groupName: 'universal-api' },
-            {
-              elementNamePattern: ['^@/assets'],
-              groupName: 'universal-assets',
-            },
-            {
-              elementNamePattern: ['^@/components'],
-              groupName: 'universal-components',
-            },
-            {
-              elementNamePattern: ['^@/composables'],
-              groupName: 'universal-composables',
-            },
-            {
-              elementNamePattern: ['^@/constants'],
-              groupName: 'universal-constants',
-            },
-            {
-              elementNamePattern: ['^@/directives'],
-              groupName: 'universal-directives',
-            },
-            {
-              elementNamePattern: ['^@/layouts'],
-              groupName: 'universal-layouts',
-            },
-            { elementNamePattern: ['^@/pages'], groupName: 'universal-pages' },
-            {
-              elementNamePattern: ['^@/plugins'],
-              groupName: 'universal-plugins',
-            },
-            {
-              elementNamePattern: ['^@/stores'],
-              groupName: 'universal-stores',
-            },
-            { elementNamePattern: ['^@/utils'], groupName: 'universal-utils' },
-          ],
-          groups: [
-            'type-import',
-            ['value-builtin', 'value-external'],
+              // universal
+              { elementNamePattern: ['^@/api'], groupName: 'universal-api' },
+              {
+                elementNamePattern: ['^@/assets'],
+                groupName: 'universal-assets',
+              },
+              {
+                elementNamePattern: ['^@/components'],
+                groupName: 'universal-components',
+              },
+              {
+                elementNamePattern: ['^@/composables'],
+                groupName: 'universal-composables',
+              },
+              {
+                elementNamePattern: ['^@/constants'],
+                groupName: 'universal-constants',
+              },
+              {
+                elementNamePattern: ['^@/directives'],
+                groupName: 'universal-directives',
+              },
+              {
+                elementNamePattern: ['^@/layouts'],
+                groupName: 'universal-layouts',
+              },
+              {
+                elementNamePattern: ['^@/pages'],
+                groupName: 'universal-pages',
+              },
+              {
+                elementNamePattern: ['^@/plugins'],
+                groupName: 'universal-plugins',
+              },
+              {
+                elementNamePattern: ['^@/stores'],
+                groupName: 'universal-stores',
+              },
+              {
+                elementNamePattern: ['^@/utils'],
+                groupName: 'universal-utils',
+              },
+            ],
+            groups: [
+              'type-import',
+              ['value-builtin', 'value-external'],
 
-            // hash (nuxt)
-            'hash',
+              // hash (nuxt)
+              'hash',
 
-            // @@/
-            'double-at',
+              // @@/
+              'double-at',
 
-            // universal
-            'universal-api',
-            'universal-assets',
-            'universal-components',
-            'universal-composables',
-            'universal-constants',
-            'universal-directives',
-            'universal-layouts',
-            'universal-pages',
-            'universal-plugins',
-            'universal-stores',
-            'universal-utils',
+              // universal
+              'universal-api',
+              'universal-assets',
+              'universal-components',
+              'universal-composables',
+              'universal-constants',
+              'universal-directives',
+              'universal-layouts',
+              'universal-pages',
+              'universal-plugins',
+              'universal-stores',
+              'universal-utils',
 
-            'type-internal',
-            'value-internal',
+              'type-internal',
+              'value-internal',
 
-            ['type-parent', 'type-sibling', 'type-index'],
-            ['value-parent', 'value-sibling', 'value-index'],
+              ['type-parent', 'type-sibling', 'type-index'],
+              ['value-parent', 'value-sibling', 'value-index'],
 
-            'ts-equals-import',
-            'unknown',
-          ],
-          internalPattern: ['^@@/.*', '^@/.*'],
-          type: 'natural',
-        },
-      ],
-      'perfectionist/sort-interfaces': [
-        'warn',
-        { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
-      ],
-      'perfectionist/sort-object-types': [
-        'warn',
-        { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
-      ],
-      'perfectionist/sort-objects': [
-        'warn',
-        { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
-      ],
+              'ts-equals-import',
+              'unknown',
+            ],
+            internalPattern: ['^@@/.*', '^@/.*'],
+            type: 'natural',
+          },
+        ],
+        'perfectionist/sort-interfaces': [
+          'warn',
+          { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
+        ],
+        'perfectionist/sort-object-types': [
+          'warn',
+          { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
+        ],
+        'perfectionist/sort-objects': [
+          'warn',
+          { newlinesBetween: 0, partitionByComment: false, type: 'natural' },
+        ],
+      },
     },
-  },
-]);
+  ]);

package/plugins/pinia.js

@@ -3,14 +3,21 @@ import { defineConfig } from 'eslint/config';
 
 import { FILES } from '../base.js';
 
-/** @see [eslint-plugin-pinia](https://github.com/lisilinhart/eslint-plugin-pinia) */
-export const pinia = defineConfig([
-  {
-    ...plugin.configs['recommended-flat'],
-    files: FILES,
-    rules: {
-      ...plugin.configs['recommended-flat'].rules,
-      'pinia/prefer-single-store-per-file': 'error',
+/**
+ * Правила для Pinia-хранилищ.
+ *
+ * @returns {import('eslint').Linter.Config[]}
+ *
+ * @see [eslint-plugin-pinia](https://github.com/lisilinhart/eslint-plugin-pinia)
+ */
+export const pinia = () =>
+  defineConfig([
+    {
+      ...plugin.configs['recommended-flat'],
+      files: FILES,
+      rules: {
+        ...plugin.configs['recommended-flat'].rules,
+        'pinia/prefer-single-store-per-file': 'error',
+      },
     },
-  },
-]);
+  ]);