arui-presets-lint 10.1.0 → 10.2.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 10.2.0
+
+### Minor Changes
+
+- [#136](https://github.com/core-ds/arui-presets-lint/pull/136) [`3612e03`](https://github.com/core-ds/arui-presets-lint/commit/3612e0386142053b43a800d8e7f9cf7e7b41205e) Thanks [@kiskv](https://github.com/kiskv)! - ## New Features
+
+        - Подключены плагины [`@eslint/json`](https://github.com/eslint/json) и [`@eslint/markdown`](https://github.com/eslint/markdown).
+        - `.json` файлы проверяются как строгий JSON, `.jsonc` и `tsconfig*.json` - как JSONC, `.json5` — как JSON5. Правила: `json/no-duplicate-keys`, `json/no-empty-keys`, `json/no-unnormalized-keys`, `json/no-unsafe-values` (как error).
+        - `.md` файлы проверяются по CommonMark (как warning). Подключены все рекомендованные правила `@eslint/markdown` (контроль уровней заголовков, отсутствие пустых ссылок/изображений, alt-текст и т.д.). `**/CHANGELOG.md` игнорируется по умолчанию.
+        - Добавлены константы для удобного прописывания области видимости правил на уровне проекта
+
+    ## Bug fixes
+
+        - Исправлены скоупы files, все плагины определены глобально, для того чтобы корректно срабатывало переопределение.
+
+### Patch Changes
+
+- Updated dependencies []:
+    - @alfalab/stylelint-core-vars@3.0.0
+
 ## 10.1.0
 
 ### Minor Changes

package/{V9_MIGRATION_GUIDE.md → MIGRATION_GUIDE.md}

@@ -1,4 +1,6 @@
-# Гид по миграции на arui-presets-lint@9
+# Гид по миграции на arui-presets-lint@9/10 с 8
+
+[Обновляетесь с 7 и более ранних на 8?](https://github.com/core-ds/arui-presets-lint/blob/v8.8.1/V8_MIGRATION_GUIDE.md)
 
 ## Введение
 
@@ -13,8 +15,7 @@ yarn add arui-presets-lint@latest
 1. Удалить свойство `eslintConfig` из package.json, и создать в корне проекта файл `eslint.config.mts` со следующим содержимым:
 
 ```typescript
-import { defineConfig } from 'arui-presets-lint/eslint/config';
-import { eslintConfig } from 'arui-presets-lint/eslint';
+import { defineConfig, eslintConfig, CYPRESS_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig);
 ```
@@ -23,23 +24,40 @@ export default defineConfig(eslintConfig);
 
 ```typescript
 import pluginCypress from 'eslint-plugin-cypress';
-import { defineConfig } from 'arui-presets-lint/eslint/config';
-import { eslintConfig } from 'arui-presets-lint/eslint';
+import { defineConfig, eslintConfig } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig, [
     pluginCypress.configs.recommended,
     {
+        // Константы появились в arui-presets-lint@10.2.0, если у вас более ранняя - укажите текстом:
+        // files: ['cypress/**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}']
+        files: [CYPRESS_SCOPE],
         rules: {
-            'cypress/no-unnecessary-waiting': 'off',
+            'cypress/no-unnecessary-waiting': 'warn',
         },
     },
-    // Тут лежат glob-паттерны файлов, которые нужно игнорировать в проекте. Возможно он вам не понадобится, так как глобальный игнор на основные файлы и папки уже настроен на уровне arui-presets-lint
-    ignores: []
 ]);
 ```
 
 ^^ Тут мы добавляем eslint-plugin-cypress, и определяем кастомные правила на уровне проекта. Про новый формат конфига - подробности [тут](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects)
 
+Не забывайте про директиву files, её нужно указывать, если правило переопределяется (не выключается). Константы можно импортировать из arui-presets-lint, например:
+
+```typescript
+import { defineConfig, eslintConfig, TYPESCRIPT_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint'
+
+export default defineConfig(eslintConfig, [
+    {
+        rules: {
+            '@typescript-eslint/consistent-type-assertions': 'warning',
+        }
+        // Константы появились в arui-presets-lint@10.2.0, если у вас более ранняя - укажите текстом:
+        // files: '**/*.{ts,tsx,mts,cts,mtsx,ctsx}',
+        files: [TYPESCRIPT_SCRIPTS_SCOPE],
+    },
+]);
+```
+
 > если нужно использовать плагины и правила, которые не поддерживают eslint 9, можно использовать для их подключения утилиты из пакета [@eslint/compat](https://www.npmjs.com/package/@eslint/compat)
 
 1. `tsconfig.eslint.json` и правила игнорирования
@@ -47,8 +65,7 @@ export default defineConfig(eslintConfig, [
     Ранее мы использовали кастомный tsconfig.eslint.json, например для того чтобы включить eslint для файлов в корневой директории - с переходом на [typescript-eslint projectService](https://typescript-eslint.io/blog/project-service/#introducing-the-project-service) он больше не нужен. Используйте основной tsconfig.json, а те файлы которые туда нельзя добавить, добавьте с помощью опции languageOptions.parserOptions.projectService.allowDefaultProject. Учтите что папки добавлять нельзя, так как это аффектит на производительность. Пример такого конфига:
 
 ```typescript
-import { eslintConfig } from 'arui-presets-lint/eslint';
-import { defineConfig } from 'arui-presets-lint/eslint/config';
+import { defineConfig, eslintConfig, TYPESCRIPT_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig, [
     {
@@ -63,7 +80,7 @@ export default defineConfig(eslintConfig, [
                 },
             },
         },
-        files: ['**/*.{ts,tsx,mts,cts,mtsx,ctsx}'],
+        files: [TYPESCRIPT_SCRIPTS_SCOPE],
     },
 ]);
 ```
@@ -84,6 +101,8 @@ export default defineConfig(eslintConfig, [
     Если необходима проверка без ограничения глубины или другое значение, то переопределите правило в своём `eslint.config.mts`:
 
     ```typescript
+    import { GLOBAL_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint'
+
     {
         rules: {
             'import-x/no-cycle': ['error', { ignoreExternal: true, maxDepth: 50 }],
@@ -92,6 +111,8 @@ export default defineConfig(eslintConfig, [
             // или отключить правило:
             // 'import-x/no-cycle': 'off',
         },
+        // files: ['**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}']
+        files: [GLOBAL_SCRIPTS_SCOPE]
     },
     ```
 

package/README.md

@@ -14,7 +14,7 @@
 
 [Как я могу внести изменения?](./CONTRIBUTING.md)
 
-🚀 [Миграция на версию 9](./V9_MIGRATION_GUIDE.md)
+🚀 [Миграция на версию 9/10 c 8](./MIGRATION_GUIDE.md)
 
 ## Установка и обновление
 
@@ -41,8 +41,7 @@
 Для настройки eslint нужно создать в корне проекта файл `eslint.config.mts` со следующим содержанием:
 
 ```typescript
-import { defineConfig } from 'arui-presets-lint/eslint/config';
-import { eslintConfig } from 'arui-presets-lint/eslint';
+import { defineConfig, eslintConfig } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig);
 ```
@@ -51,8 +50,7 @@ export default defineConfig(eslintConfig);
 
 ```typescript
 import pluginCypress from 'eslint-plugin-cypress';
-import { defineConfig } from 'arui-presets-lint/eslint/config';
-import { eslintConfig } from 'arui-presets-lint/eslint';
+import { defineConfig, eslintConfig, CYPRESS_SCOPE } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig, [
     {
@@ -63,20 +61,35 @@ export default defineConfig(eslintConfig, [
     },
     pluginCypress.configs.recommended,
     {
+        files: [CYPRESS_SCOPE],
         rules: {
-            'cypress/no-unnecessary-waiting': 'off',
+            'cypress/no-unnecessary-waiting': 'warn',
         },
     },
 ]);
 ```
 
+Не забывайте про директиву files, её нужно указывать, если правило переопределяется (не выключается). Константы можно импортировать из arui-presets-lint, например:
+
+```typescript
+import { defineConfig, eslintConfig, TYPESCRIPT_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint'
+
+export default defineConfig(eslintConfig, [
+    {
+        rules: {
+            '@typescript-eslint/consistent-type-assertions': 'warning',
+        }
+        files: [TYPESCRIPT_SCRIPTS_SCOPE],
+    },
+]);
+```
+
 Если в проекте есть файлы typescript, которые не добавлены в `tsconfig.json`, или исключены из него принудительно, то eslint выдаст ошибку `<filename> was not found by the project service. Consider either including it in the tsconfig.json or including it in allowDefaultProject`. Есть несколько способов решения этой проблемы:
 
 - (Рекомендуется) Добавить нужные файлы через опцию allowDefaultProject:
 
 ```typescript
-import { eslintConfig } from 'arui-presets-lint/eslint';
-import { defineConfig } from 'arui-presets-lint/eslint/config';
+import { defineConfig, eslintConfig, TYPESCRIPT_SCRIPTS_SCOPE } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig, [
     {
@@ -91,7 +104,7 @@ export default defineConfig(eslintConfig, [
                 },
             },
         },
-        files: ['**/*.{ts,tsx,mts,cts,mtsx,ctsx}'],
+        files: [TYPESCRIPT_SCRIPTS_SCOPE],
     },
 ]);
 ```
@@ -99,8 +112,7 @@ export default defineConfig(eslintConfig, [
 - (НЕ рекомендуется) Добавить файлы в globalIgnores. В этом случае eslint не будет его проверять:
 
 ```typescript
-import { eslintConfig } from 'arui-presets-lint/eslint';
-import { defineConfig, globalIgnores } from 'arui-presets-lint/eslint/config';
+import { defineConfig, globalIgnores, eslintConfig } from 'arui-presets-lint/eslint';
 
 export default defineConfig(eslintConfig, [
     {
@@ -129,7 +141,7 @@ export default defineConfig(eslintConfig, [
 > Вместо файла .eslintignore рекомендуется использовать globalIgnores в конфиге eslint ([подробнее](https://eslint.org/docs/latest/use/configure/ignore)). Импортируем функцию globalIgnores из `arui-presets-lint` вот так:
 
 ```typescript
-import { defineConfig, globalIgnores } from 'arui-presets-lint/eslint/config';
+import { defineConfig, globalIgnores } from 'arui-presets-lint/eslint';
 ...
 ```
 

package/eslint/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const GLOBAL_SCRIPTS_SCOPE = "**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const NODEJS_SCRIPTS_SCOPE = "**/server/**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const TYPESCRIPT_SCRIPTS_SCOPE = "**/*.{ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const REACT_SCRIPTS_SCOPE = "**/*.{jsx,mjsx,tsx,mtsx,ctsx}";
+export declare const TESTS_SCRIPTS_SCOPE = "**/*.{test,tests,spec}.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const CYPRESS_SCOPE = "cypress/**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const PLAYWRIGHT_SCOPE = "playwright/**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}";
+export declare const MARKDOWN_SCOPE = "**/*.md";
+export declare const JSON_SCOPE = "**/*.{json,json5,jsonc}";
+export declare const ANOTHER_FILES_SCOPE = "**/*.{yaml,yml,css,jpeg,jpg,png,webp,gif,avif,heic,svg,ico,wasm,html,woff,woff2,ttf,otf,eot,graphql,gql}";

package/eslint/constants.js

@@ -0,0 +1,12 @@
+const scriptsExtentionsPattern = '{js,mjs,cjs,jsx,mjsx,ts,tsx,mts,cts,mtsx,ctsx}';
+export const GLOBAL_SCRIPTS_SCOPE = `**/*.${scriptsExtentionsPattern}`;
+export const NODEJS_SCRIPTS_SCOPE = `**/server/**/*.${scriptsExtentionsPattern}`;
+export const TYPESCRIPT_SCRIPTS_SCOPE = '**/*.{ts,tsx,mts,cts,mtsx,ctsx}';
+export const REACT_SCRIPTS_SCOPE = '**/*.{jsx,mjsx,tsx,mtsx,ctsx}';
+export const TESTS_SCRIPTS_SCOPE = `**/*.{test,tests,spec}.${scriptsExtentionsPattern}`;
+export const CYPRESS_SCOPE = `cypress/**/*.${scriptsExtentionsPattern}`;
+export const PLAYWRIGHT_SCOPE = `playwright/**/*.${scriptsExtentionsPattern}`;
+export const MARKDOWN_SCOPE = '**/*.md';
+export const JSON_SCOPE = '**/*.{json,json5,jsonc}';
+// Не должен пересекаться с остальными
+export const ANOTHER_FILES_SCOPE = '**/*.{yaml,yml,css,jpeg,jpg,png,webp,gif,avif,heic,svg,ico,wasm,html,woff,woff2,ttf,otf,eot,graphql,gql}';

package/eslint/index.d.ts

@@ -1,5 +1,6 @@
 import { type Linter } from 'eslint';
 export declare const eslintConfig: Linter.Config;
 export { defineConfig, globalIgnores, globals } from './config.js';
+export * from './constants.js';
 export { type Linter } from 'eslint';
 export { type TSESLint } from '@typescript-eslint/utils';

package/eslint/index.js

@@ -1,10 +1,23 @@
 import eslintJS from '@eslint/js';
+import jsonPlugin from '@eslint/json';
+import markdownPlugin from '@eslint/markdown';
 import {} from 'eslint';
 import gitignore from 'eslint-config-flat-gitignore';
+import checkFilePlugin from 'eslint-plugin-check-file';
+import deMorgan from 'eslint-plugin-de-morgan';
+import { importX } from 'eslint-plugin-import-x';
+import jsxA11yPlugin from 'eslint-plugin-jsx-a11y';
+import nodePlugin from 'eslint-plugin-n';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import simpleImportSortPlugin from 'eslint-plugin-simple-import-sort';
+import unicornPlugin from 'eslint-plugin-unicorn';
 import globals from 'globals';
-import { disableCommentsConfig } from './plugins/index.js';
+import tseslint from 'typescript-eslint';
+import { disableCommentsConfig, disableCommentsPlugin } from './plugins/index.js';
 import { globalIgnores } from './config.js';
-import { bestPracticesConfig, importsConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, } from './rules.js';
+import { GLOBAL_SCRIPTS_SCOPE } from './constants.js';
+import { bestPracticesConfig, checkFileConfig, importsConfig, jsonConfig, markdownConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, } from './rules.js';
 export const eslintConfig = [
     gitignore({
         files: ['.gitignore', '.eslintignore'],
@@ -25,21 +38,42 @@ export const eslintConfig = [
     ]),
     {
         languageOptions: {
-            ecmaVersion: 2022,
+            ecmaVersion: 'latest',
             sourceType: 'module',
             parserOptions: {
                 ecmaFeatures: { jsx: true },
             },
             globals: {
-                ...globals.es2023,
+                ...globals.es2026,
                 ...globals.browser,
-                ...globals.node,
             },
         },
-        files: ['**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mtsx}'],
+        files: [GLOBAL_SCRIPTS_SCOPE],
+        rules: {
+            // https://github.com/eslint/eslint/blob/main/packages/js/src/configs/eslint-recommended.js
+            ...eslintJS.configs.recommended.rules,
+        },
+    },
+    // ВСЕ плагины должны регистрироваться глобально
+    // Иначе будут проблемы с переопределением
+    {
+        name: 'arui-presets-lint/plugins',
+        plugins: {
+            'import-x': importX,
+            'simple-import-sort': simpleImportSortPlugin,
+            'check-file': checkFilePlugin,
+            react: reactPlugin,
+            'react-hooks': reactHooksPlugin,
+            'jsx-a11y': jsxA11yPlugin,
+            unicorn: unicornPlugin,
+            'disable-comments': disableCommentsPlugin,
+            '@typescript-eslint': tseslint.plugin,
+            'de-morgan': deMorgan,
+            n: nodePlugin,
+            json: jsonPlugin,
+            markdown: markdownPlugin,
+        },
     },
-    // https://github.com/eslint/eslint/blob/main/packages/js/src/configs/eslint-recommended.js
-    eslintJS.configs.recommended,
     /*
         ☭ Наши наборы правил ☭
     */
@@ -52,16 +86,14 @@ export const eslintConfig = [
     typescriptConfig,
     importsConfig,
     disableCommentsConfig,
+    jsonConfig,
+    markdownConfig,
+    checkFileConfig,
     /*
         ☭.
     */
-    {
-        // Включаем проверку других расширений файлов в eslint-plugin-check-file
-        // ⚠️ НЕ ДОЛЖНО ПЕРЕСЕКАТЬСЯ С ПАТТЕРНОМ, УКАЗАННЫМ ВЫШЕ
-        files: ['**/*.{yaml,yml,json,css}'],
-        processor: 'check-file/eslint-processor-check-file',
-    },
 ];
 export { defineConfig, globalIgnores, globals } from './config.js';
+export * from './constants.js';
 export {} from 'eslint';
 export {} from '@typescript-eslint/utils';

package/eslint/plugins/disable-comments/README.md

@@ -109,7 +109,7 @@ export default [
 | `missingDescription` | Директива ESLint без описания. Добавьте описание после -- или комментарий над директивой. |
 | `invalidDescription` | Описание слишком общее или неинформативное. Укажите конкретную причину. |
 | `suggestDebug` | 	Добавить комментарий — "Используется временно для отладки" |
-| `suggestAboveComment` | Добавить задачу — "TODO: [ссылка на задачу] Описание" |
+| `suggestAboveComment` | Добавить задачу — "TODO: \[ссылка на задачу\] Описание" |
 
 #### Автоматические исправления
 - `createSuggestionFix` – добавляет описание после разделителя --.

package/eslint/plugins/disable-comments/config/config.js

@@ -1,4 +1,5 @@
 import {} from '@typescript-eslint/utils';
+import { GLOBAL_SCRIPTS_SCOPE } from '../../../constants.js';
 import { disableCommentsPlugin } from './plugin.js';
 /**
  * Config, который подключает плагин
@@ -6,6 +7,7 @@ import { disableCommentsPlugin } from './plugin.js';
  */
 export const disableCommentsConfig = {
     name: 'arui-presets-lint/disable-comments',
+    files: [GLOBAL_SCRIPTS_SCOPE],
     plugins: {
         'disable-comments': disableCommentsPlugin,
     },

package/eslint/rules/best-practices.js

@@ -1,9 +1,11 @@
 import {} from 'eslint';
 import deMorgan from 'eslint-plugin-de-morgan';
 import unicornPlugin from 'eslint-plugin-unicorn';
+import { GLOBAL_SCRIPTS_SCOPE } from '../constants.js';
 export const bestPracticesConfig = {
     ...unicornPlugin.configs.unopinionated,
     name: 'arui-presets-lint/best-practices',
+    files: [GLOBAL_SCRIPTS_SCOPE],
     plugins: {
         unicorn: unicornPlugin,
         'de-morgan': deMorgan,

package/eslint/rules/check-file.d.ts

@@ -0,0 +1,2 @@
+import { type Linter } from 'eslint';
+export declare const checkFileConfig: Linter.Config[];

package/eslint/rules/check-file.js

@@ -0,0 +1,47 @@
+import {} from 'eslint';
+import checkFilePlugin from 'eslint-plugin-check-file';
+import { ANOTHER_FILES_SCOPE, GLOBAL_SCRIPTS_SCOPE, JSON_SCOPE } from '../constants.js';
+export const checkFileConfig = [
+    {
+        name: 'arui-presets-lint/check-file',
+        plugins: {
+            'check-file': checkFilePlugin,
+        },
+        rules: {
+            // Все названия папок должны быть в kebab-case
+            // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/filename-naming-convention.md
+            'check-file/folder-naming-convention': [
+                'error',
+                { '**/*.*': 'KEBAB_CASE' },
+                { ignoreMiddleExtensions: true },
+            ],
+            // Все названия файлов должны быть в kebab-case
+            // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/folder-naming-convention.md
+            'check-file/filename-naming-convention': [
+                'error',
+                {
+                    [GLOBAL_SCRIPTS_SCOPE]: 'KEBAB_CASE',
+                    [ANOTHER_FILES_SCOPE]: 'KEBAB_CASE',
+                    [JSON_SCOPE]: 'KEBAB_CASE',
+                },
+                { ignoreMiddleExtensions: true },
+            ],
+            // Список запрещенных названий файлов
+            // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/filename-blocklist.md
+            'check-file/filename-blocklist': [
+                'error',
+                { '**/tsconfig.eslint.json': '*tsconfig.json' },
+                {
+                    errorMessage: 'Вместо tsconfig.eslint.json используйте languageOptions.parserOptions.projectService.allowDefaultProject в конфиге eslint',
+                },
+            ],
+        },
+    },
+    {
+        // Включаем проверку других расширений файлов в eslint-plugin-check-file (которые процессор eslint не поддерживает).
+        // Для JSON и Markdown полноценный парсинг подключён через @eslint/json и @eslint/markdown, поэтому здесь они не нужны.
+        // Не должен пересекаться с остальными расширениями, см. constants.ts
+        files: [ANOTHER_FILES_SCOPE],
+        processor: 'check-file/eslint-processor-check-file',
+    },
+];

package/eslint/rules/imports.js

@@ -1,15 +1,15 @@
 import {} from 'eslint';
-import checkFilePlugin from 'eslint-plugin-check-file';
 import { importX } from 'eslint-plugin-import-x';
 import simpleImportSortPlugin from 'eslint-plugin-simple-import-sort';
+import { GLOBAL_SCRIPTS_SCOPE } from '../constants.js';
 export const importsConfig = {
     // https://github.com/un-ts/eslint-plugin-import-x/blob/master/src/config/flat/typescript.ts
     ...importX.flatConfigs.typescript,
     name: 'arui-presets-lint/imports',
+    files: [GLOBAL_SCRIPTS_SCOPE],
     plugins: {
         'import-x': importX,
         'simple-import-sort': simpleImportSortPlugin,
-        'check-file': checkFilePlugin,
     },
     settings: {
         ...importX.flatConfigs.typescript.settings,
@@ -246,28 +246,5 @@ export const importsConfig = {
         // Сортировка импортов
         // https://eslint.org/docs/rules/sort-imports
         'sort-imports': 'off',
-        // Все названия файлов должны быть в kebab-case
-        // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/filename-naming-convention.md
-        'check-file/folder-naming-convention': [
-            'error',
-            { '**/*.*': 'KEBAB_CASE' },
-            { ignoreMiddleExtensions: true },
-        ],
-        // Все названия папок должны быть в kebab-case
-        // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/folder-naming-convention.md
-        'check-file/filename-naming-convention': [
-            'error',
-            { '**/*.*': 'KEBAB_CASE' },
-            { ignoreMiddleExtensions: true },
-        ],
-        // Список запрещенных названий файлов
-        // https://github.com/dukeluo/eslint-plugin-check-file/blob/main/docs/rules/filename-blocklist.md
-        'check-file/filename-blocklist': [
-            'error',
-            { '**/tsconfig.eslint.json': '*tsconfig.json' },
-            {
-                errorMessage: 'Вместо tsconfig.eslint.json используйте languageOptions.parserOptions.projectService.allowDefaultProject в конфиге eslint',
-            },
-        ],
     },
 };

package/eslint/rules/index.d.ts

@@ -1,8 +1,11 @@
 export { bestPracticesConfig } from './best-practices.js';
 export { importsConfig } from './imports.js';
+export { jsonConfig } from './json.js';
+export { markdownConfig } from './markdown.js';
 export { nodeRulesConfig } from './node.js';
 export { reactA11yConfig } from './react-a11y.js';
 export { reactConfig } from './react.js';
 export { testsConfig } from './tests.js';
 export { typescriptConfig } from './typescript.js';
 export { variablesConfig } from './variables.js';
+export { checkFileConfig } from './check-file.js';

package/eslint/rules/index.js

@@ -1,8 +1,11 @@
 export { bestPracticesConfig } from './best-practices.js';
 export { importsConfig } from './imports.js';
+export { jsonConfig } from './json.js';
+export { markdownConfig } from './markdown.js';
 export { nodeRulesConfig } from './node.js';
 export { reactA11yConfig } from './react-a11y.js';
 export { reactConfig } from './react.js';
 export { testsConfig } from './tests.js';
 export { typescriptConfig } from './typescript.js';
 export { variablesConfig } from './variables.js';
+export { checkFileConfig } from './check-file.js';

package/eslint/rules/json.d.ts

@@ -0,0 +1,2 @@
+import { type Linter } from 'eslint';
+export declare const jsonConfig: Linter.Config[];

package/eslint/rules/json.js

@@ -0,0 +1,46 @@
+import jsonPlugin from '@eslint/json';
+import {} from 'eslint';
+const jsonRules = {
+    // Запрещает дублирование ключей в JSON-объектах
+    // https://github.com/eslint/json/blob/main/docs/rules/no-duplicate-keys.md
+    'json/no-duplicate-keys': 'error',
+    // Запрещает пустые ключи в JSON-объектах
+    // https://github.com/eslint/json/blob/main/docs/rules/no-empty-keys.md
+    'json/no-empty-keys': 'error',
+    // Запрещает ключи, не приведённые к нормальной юникод-форме (NFC)
+    // https://github.com/eslint/json/blob/main/docs/rules/no-unnormalized-keys.md
+    'json/no-unnormalized-keys': 'error',
+    // Запрещает числа выходящие за пределы безопасного диапазона Number
+    // https://github.com/eslint/json/blob/main/docs/rules/no-unsafe-values.md
+    'json/no-unsafe-values': 'error',
+};
+const plugins = { json: jsonPlugin };
+export const jsonConfig = [
+    {
+        name: 'arui-presets-lint/json',
+        files: ['**/*.json'],
+        // Файлы с трейлинг-комментариями или огромным размером, которые JSON-парсер не сможет обработать
+        ignores: ['**/package-lock.json', '**/tsconfig*.json'],
+        plugins,
+        language: 'json/json',
+        rules: jsonRules,
+    },
+    {
+        name: 'arui-presets-lint/jsonc',
+        // tsconfig*.json по соглашению поддерживает комментарии и трейлинг-запятые
+        files: ['**/*.jsonc', '**/tsconfig*.json'],
+        plugins,
+        language: 'json/jsonc',
+        languageOptions: {
+            allowTrailingCommas: true,
+        },
+        rules: jsonRules,
+    },
+    {
+        name: 'arui-presets-lint/json5',
+        files: ['**/*.json5'],
+        plugins,
+        language: 'json/json5',
+        rules: jsonRules,
+    },
+];

package/eslint/rules/markdown.d.ts

@@ -0,0 +1,2 @@
+import { type Linter } from 'eslint';
+export declare const markdownConfig: Linter.Config;

package/eslint/rules/markdown.js

@@ -0,0 +1,67 @@
+import markdownPlugin from '@eslint/markdown';
+import {} from 'eslint';
+import { MARKDOWN_SCOPE } from '../constants.js';
+export const markdownConfig = {
+    name: 'arui-presets-lint/markdown',
+    files: [MARKDOWN_SCOPE],
+    // CHANGELOG.md обычно генерируется автоматически (например, changesets/lerna)
+    // и не соответствует строгим правилам CommonMark
+    ignores: ['**/CHANGELOG.md'],
+    plugins: {
+        markdown: markdownPlugin,
+    },
+    language: 'markdown/commonmark',
+    rules: {
+        // Требует указывать язык для блоков кода с тройными бэктиками
+        // https://github.com/eslint/markdown/blob/main/docs/rules/fenced-code-language.md
+        'markdown/fenced-code-language': 'warn',
+        // Уровни заголовков должны увеличиваться строго на единицу
+        // https://github.com/eslint/markdown/blob/main/docs/rules/heading-increment.md
+        'markdown/heading-increment': 'warn',
+        // Запрещает дублирование definitions для ссылок и изображений
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-duplicate-definitions.md
+        'markdown/no-duplicate-definitions': 'warn',
+        // Запрещает definitions без URL
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-empty-definitions.md
+        'markdown/no-empty-definitions': 'warn',
+        // Запрещает изображения с пустым src
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-empty-images.md
+        'markdown/no-empty-images': 'warn',
+        // Запрещает ссылки с пустым URL
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-empty-links.md
+        'markdown/no-empty-links': 'warn',
+        // Запрещает невалидный синтаксис меток-ссылок
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-invalid-label-refs.md
+        'markdown/no-invalid-label-refs': 'warn',
+        // Требует пробел после решёток в ATX-заголовках (# Заголовок, а не #Заголовок)
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-missing-atx-heading-space.md
+        'markdown/no-missing-atx-heading-space': 'warn',
+        // Запрещает ссылаться на несуществующие метки
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-missing-label-refs.md
+        'markdown/no-missing-label-refs': 'warn',
+        // Запрещает ссылки на несуществующие якоря/заголовки в текущем документе
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-missing-link-fragments.md
+        'markdown/no-missing-link-fragments': 'warn',
+        // Запрещает несколько H1 в одном документе
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-multiple-h1.md
+        'markdown/no-multiple-h1': 'warn',
+        // Запрещает URL, по форме совпадающие с reference-метками
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-reference-like-urls.md
+        'markdown/no-reference-like-urls': 'warn',
+        // Запрещает перевёрнутый синтаксис ссылок/изображений ((text)[url] вместо [text](url))
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-reversed-media-syntax.md
+        'markdown/no-reversed-media-syntax': 'warn',
+        // Запрещает пробелы вокруг маркеров выделения (* _)
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-space-in-emphasis.md
+        'markdown/no-space-in-emphasis': 'warn',
+        // Запрещает неиспользуемые definitions
+        // https://github.com/eslint/markdown/blob/main/docs/rules/no-unused-definitions.md
+        'markdown/no-unused-definitions': 'warn',
+        // Требует alt-текст для изображений
+        // https://github.com/eslint/markdown/blob/main/docs/rules/require-alt-text.md
+        'markdown/require-alt-text': 'warn',
+        // Количество ячеек в строке таблицы должно совпадать с количеством колонок в заголовке
+        // https://github.com/eslint/markdown/blob/main/docs/rules/table-column-count.md
+        'markdown/table-column-count': 'warn',
+    },
+};

package/eslint/rules/node.js

@@ -1,6 +1,7 @@
 import {} from 'eslint';
 import nodePlugin from 'eslint-plugin-n';
 import globals from 'globals';
+import { NODEJS_SCRIPTS_SCOPE } from '../constants.js';
 export const nodeRulesConfig = {
     ...nodePlugin.configs['flat/recommended'],
     name: 'arui-presets-lint/node',
@@ -12,7 +13,7 @@ export const nodeRulesConfig = {
     plugins: {
         n: nodePlugin,
     },
-    files: ['**/server/**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mtsx}'],
+    files: [NODEJS_SCRIPTS_SCOPE],
     rules: {
         // https://github.com/eslint-community/eslint-plugin-n?tab=readme-ov-file#-rules
         ...nodePlugin.configs['flat/recommended'].rules,

package/eslint/rules/react-a11y.js

@@ -1,8 +1,10 @@
 import {} from 'eslint';
 import jsxA11yPlugin from 'eslint-plugin-jsx-a11y';
+import { REACT_SCRIPTS_SCOPE } from '../constants.js';
 export const reactA11yConfig = {
     ...jsxA11yPlugin.flatConfigs.recommended,
     name: 'arui-presets-lint/react-a11y',
+    files: [REACT_SCRIPTS_SCOPE],
     plugins: {
         'jsx-a11y': jsxA11yPlugin,
     },

package/eslint/rules/react.js

@@ -1,10 +1,12 @@
 import {} from 'eslint';
 import reactPlugin from 'eslint-plugin-react';
 import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import { REACT_SCRIPTS_SCOPE } from '../constants.js';
 export const reactConfig = {
     ...reactPlugin.configs.flat.recommended,
     ...reactHooksPlugin.configs['recommended-latest'],
     name: 'arui-presets-lint/react',
+    files: [REACT_SCRIPTS_SCOPE],
     plugins: {
         react: reactPlugin,
         'react-hooks': reactHooksPlugin,

package/eslint/rules/tests.js

@@ -1,11 +1,13 @@
 import {} from 'eslint';
 import globals from 'globals';
+import { TESTS_SCRIPTS_SCOPE } from '../constants.js';
 export const testsConfig = {
     name: 'arui-presets-lint/tests',
-    files: ['**/*.{test,tests,spec}.{js,jsx,ts,tsx,cjs,cts,mjs,mts}'],
+    files: [TESTS_SCRIPTS_SCOPE],
     languageOptions: {
         globals: {
             ...globals.jest,
+            ...globals.vitest,
         },
     },
     rules: {

package/eslint/rules/typescript.js

@@ -2,6 +2,7 @@ import {} from '@typescript-eslint/utils';
 import {} from 'eslint';
 import globals from 'globals';
 import tseslint from 'typescript-eslint';
+import { TYPESCRIPT_SCRIPTS_SCOPE } from '../constants.js';
 import { bestPracticesConfig } from './best-practices.js';
 import { importsConfig } from './imports.js';
 import { variablesConfig } from './variables.js';
@@ -10,17 +11,17 @@ const importsRules = importsConfig.rules;
 const variablesRules = variablesConfig.rules;
 export const typescriptConfig = {
     name: 'arui-presets-lint/typescript',
-    files: ['**/*.{ts,tsx,mts,cts,mtsx,ctsx}'],
+    files: [TYPESCRIPT_SCRIPTS_SCOPE],
     languageOptions: {
         parser: tseslint.parser,
-        ecmaVersion: 2022,
+        ecmaVersion: 'latest',
         sourceType: 'module',
         parserOptions: {
             projectService: true,
             ecmaFeatures: { jsx: true },
         },
         globals: {
-            ...globals.es2023,
+            ...globals.es2026,
             ...globals.browser,
             ...globals.node,
         },

package/eslint/rules/variables.js

@@ -1,6 +1,8 @@
 import {} from 'eslint';
+import { GLOBAL_SCRIPTS_SCOPE } from '../constants.js';
 export const variablesConfig = {
     name: 'arui-presets-lint/variables',
+    files: [GLOBAL_SCRIPTS_SCOPE],
     rules: {
         // Требует/запрещает инициализацию переменных при объявлении
         // https://eslint.org/docs/rules/init-declarations

package/eslint/rules.d.ts

@@ -1 +1 @@
-export { bestPracticesConfig, importsConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, } from './rules/index.js';
+export { bestPracticesConfig, importsConfig, jsonConfig, markdownConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, checkFileConfig, } from './rules/index.js';

package/eslint/rules.js

@@ -1 +1 @@
-export { bestPracticesConfig, importsConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, } from './rules/index.js';
+export { bestPracticesConfig, importsConfig, jsonConfig, markdownConfig, nodeRulesConfig, reactA11yConfig, reactConfig, testsConfig, typescriptConfig, variablesConfig, checkFileConfig, } from './rules/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "arui-presets-lint",
-    "version": "10.1.0",
+    "version": "10.2.0",
     "description": "Config files for arui-apps",
     "author": "core-ds contributors",
     "license": "MIT",
@@ -15,8 +15,10 @@
         "@commitlint/cli": "20.5.3",
         "@commitlint/config-conventional": "20.5.3",
         "@eslint/js": "9.39.4",
+        "@eslint/json": "1.2.0",
+        "@eslint/markdown": "8.0.2",
         "@types/eslint-plugin-jsx-a11y": "6.10.1",
-        "@typescript-eslint/utils": "8.59.2",
+        "@typescript-eslint/utils": "8.59.4",
         "eslint": "9.39.4",
         "eslint-config-flat-gitignore": "2.3.0",
         "eslint-import-resolver-typescript": "4.4.4",
@@ -32,19 +34,19 @@
         "execa": "^9.6.1",
         "globals": "^17.0.0",
         "jiti": "^2.6.1",
-        "lefthook": "2.1.6",
+        "lefthook": "2.1.8",
         "prettier": "3.8.3",
-        "stylelint": "17.11.0",
+        "stylelint": "17.12.0",
         "stylelint-order": "8.1.1",
-        "typescript-eslint": "8.59.2"
+        "typescript-eslint": "8.59.4"
     },
     "engines": {
         "node": ">=20.19.0"
     },
     "devDependencies": {},
     "scripts": {
-        "build": "rimraf dist && tsc -p tsconfig.build.json && copyfiles 'lefthook/*.yml' '**/*.md' dist && tsx cli/build-dist-package.ts",
-        "test": "tsc --noEmit && eslint-config-prettier ./eslint/index.ts && tsx ./cli/duplicates-checker.ts && yarn lint && yarn test:unit",
+        "build": "rimraf dist && tsc -p tsconfig.build.json && copyfiles 'lefthook/*.yml' '**/*.md' dist && tsx _internal/build-dist-package.ts",
+        "test": "tsc --noEmit && eslint-config-prettier ./eslint/index.ts && tsx _internal/duplicates-checker.ts && yarn lint && yarn test:unit",
         "test:unit": "vitest --run --coverage",
         "lint": "yarn lint:styles && yarn lint:scripts && yarn format:check",
         "lint:fix": "yarn lint:styles --fix && yarn lint:scripts --fix && yarn format",

package/test/md-input.md

@@ -0,0 +1,19 @@
+# Заголовок верхнего уровня
+
+Корректный markdown-файл для проверки правил CommonMark.
+
+## Подзаголовок
+
+Текст с *выделением* и **сильным выделением**.
+
+```ts
+const value = 42;
+
+```
+
+- Пункт списка один
+- Пункт списка два
+
+[Ссылка на ESLint](https://eslint.org)
+
+![Альт-текст изображения](https://example.com/image.png)