@diplodoc/lint 1.9.0 → 1.9.2

package/.eslintignore

@@ -14,8 +14,14 @@ node_modules
 test/
 # Scripts use Node.js globals
 scripts/
+# Bin scripts use Node.js globals
+bin/
 
 .lintstagedrc.js
 .eslintrc.js
 .prettierrc.js
-.stylelintrc.js
+.stylelintrc.js
+build/
+build/**
+esbuild/
+esbuild/**/*.mjs

package/.eslintrc.js

@@ -1,3 +1,8 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize ESLint configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = {
     root: true,
     extends: require.resolve('@diplodoc/lint/eslint-config'),
@@ -10,6 +15,31 @@ module.exports = {
             files: ['*.mjs', '*.cjs'],
             parserOptions: {
                 project: null,
+                ecmaVersion: 'latest',
+                sourceType: 'module',
+            },
+            env: {
+                node: true,
+                es2022: true,
+            },
+        },
+        {
+            files: ['test/**/*.{js,jsx,ts,tsx}'],
+            env: {
+                jest: true,
+                node: true,
+            },
+        },
+        {
+            files: ['scripts/**/*.{js,jsx,ts,tsx}'],
+            env: {
+                node: true,
+            },
+        },
+        {
+            files: ['bin/**/*.{js,jsx,ts,tsx}', 'bin/*.{js,jsx,ts,tsx}'],
+            env: {
+                node: true,
             },
         },
     ],

package/.gitattributes

@@ -30,3 +30,5 @@
 *.ttf binary
 *.eot binary
 
+
+

package/.lintstagedrc.js

@@ -1,8 +1,26 @@
 /* eslint-env node */
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize lint-staged configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
+const {readFileSync} = require('node:fs');
+const {join} = require('node:path');
+
+// Check if this is the @diplodoc/lint package itself
+const isLintPkg = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
+        return pkg.name === '@diplodoc/lint';
+    } catch {
+        return false;
+    }
+})();
+
 module.exports = {
-    // Exclude config files and scripts from linting (they use CommonJS)
+    // Exclude config files from linting (they use CommonJS)
     '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}': (filenames) => {
-        // Filter out config files and scripts
+        // Filter out config files
         const configFiles = [
             '.lintstagedrc.js',
             '.eslintrc.js',
@@ -13,15 +31,17 @@ module.exports = {
         const filtered = filenames.filter(
             (f) =>
                 !configFiles.some((config) => f.includes(config)) &&
-                !f.includes('scripts/') &&
-                !f.includes('test/'),
+                // For @diplodoc/lint package itself: exclude bin/ and scripts/ (in .eslintignore)
+                !(isLintPkg && (f.includes('bin/') || f.includes('scripts/'))),
         );
         if (filtered.length === 0) {
             return [];
         }
         return [
             ...filtered.map((f) => `prettier --write ${f}`),
-            ...filtered.map((f) => `eslint --max-warnings=0 --fix ${f}`),
+            ...filtered.map(
+                (f) => `env ESLINT_USE_FLAT_CONFIG=false npx eslint --max-warnings=0 --fix ${f}`,
+            ),
         ];
     },
     // Handle .lintstagedrc.js separately (only prettier, no eslint)

package/.prettierrc.js

@@ -1 +1,6 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize Prettier configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = require('@diplodoc/lint/prettier-config');

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.9.0"
+  ".": "1.9.2"
 }

package/.stylelintrc.js

@@ -1,3 +1,8 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize Stylelint configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = {
     extends: require.resolve('@diplodoc/lint/stylelint-config'),
 };

package/AGENTS.md

@@ -248,18 +248,20 @@ The `bin/` directory contains executable scripts that are made available via npm
 **Default mode** (`lint`):
 
 - Runs ESLint on all JS/TS files (check only)
-  - Uses glob pattern `**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}`
-  - ESLint automatically respects `.eslintignore` file
-  - No manual file filtering needed
+  - Uses `ESLINT_USE_FLAT_CONFIG=false` to force legacy (ESLint 8-style) config resolution
+  - Calls ESLint with `.` и `--ext .js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx`, позволяя самому ESLint искать файлы
+  - ESLint автоматически читает `.eslintrc.js` и `.eslintignore` из корня пакета
+  - **Никакой** дополнительной фильтрации файлов в `bin/lint.js` не выполняется
 - Runs Prettier in check mode on all JS/TS files
 - Runs Stylelint on CSS/SCSS files (if found and not ignored)
 
 **Fix mode** (`lint fix`):
 
 - Runs ESLint with `--fix` flag (auto-fixes issues)
-  - Uses glob pattern `**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}`
-  - ESLint automatically respects `.eslintignore` file
-  - No manual file filtering needed
+  - Использует те же настройки, что и в check-режиме:
+    - `ESLINT_USE_FLAT_CONFIG=false`
+    - таргет `.` и расширения через `--ext`
+  - Игнорирование файлов полностью делегировано ESLint и `.eslintignore`
 - Runs Prettier with `--write` flag (formats files)
 - Runs Stylelint with `--fix` flag (auto-fixes CSS issues)
 
@@ -420,6 +422,29 @@ Files in `scaffolding/` are copied to packages during `init`/`update`:
   - System files: `.idea`, `.vscode`, `.history`, `.env`, `.DS_Store`
   - Build artifacts: `/lib`, `/dist`, `/build`, `/cache`, `/coverage`, `/external`
   - Dependencies: `node_modules`
+  - Additional ESLint-specific ignores: `esbuild/**/*.mjs` и конфигурационные файлы (`.lintstagedrc.js`, `.eslintrc.js`, `.prettierrc.js`, `.stylelintrc.js`)
+- **Важно**:
+  - `test/` и `scripts/` **не** добавляются в `.eslintignore` автоматически, чтобы тесты и скрипты линтились
+  - Пакеты могут добавлять свои пути в `.eslintignore` при необходимости — это считается частью инфраструктуры конкретного пакета, а не `@diplodoc/lint`
+
+### Auto-generated configuration files
+
+Часть конфигурации, которую поставляет `@diplodoc/lint`, считается **авто‑генерируемой** и не должна правиться руками в потребителях:
+
+- `.eslintrc.js`
+- `.prettierrc.js`
+- `.stylelintrc.js`
+- `.lintstagedrc.js`
+
+Общие правила:
+
+- Эти файлы копируются из `scaffolding/` при `lint init` / `lint update`
+- Любые ручные правки в пакетах будут перезатираться при следующем `lint update`
+- Изменять поведение нужно через:
+  - обновление шаблонов в `devops/lint/scaffolding/`
+  - явные локальные конфиги в пакетах (например, `src/.eslintrc.js`), если это допускается
+
+Для деталей см. раздел **“⚠️ Important: Auto-Generated Files”** в `README.md` этого пакета.
 
 ## Testing
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.9.2](https://github.com/diplodoc-platform/lint/compare/v1.9.1...v1.9.2) (2025-12-29)
+
+
+### Bug Fixes
+
+* use ESLINT_USE_FLAT_CONFIG=false in lint-staged ([88a17b6](https://github.com/diplodoc-platform/lint/commit/88a17b62a791cc491f195ed66b69f63964f89f9b))
+
+## [1.9.1](https://github.com/diplodoc-platform/lint/compare/v1.9.0...v1.9.1) (2025-12-29)
+
+
+### Bug Fixes
+
+* remove test/ and scripts/ exclusion from lint-staged ([b52804b](https://github.com/diplodoc-platform/lint/commit/b52804be7efd9833f4b17a4779c22c2df24bc9cb))
+
 ## [1.9.0](https://github.com/diplodoc-platform/lint/compare/v1.8.0...v1.9.0) (2025-12-29)
 
 

package/README.md

@@ -111,6 +111,29 @@ Automatically fixes found issues:
 
 ## Configuration
 
+### ⚠️ Important: Auto-Generated Files
+
+The following configuration files are **automatically generated and updated** by `@diplodoc/lint`:
+
+- `.eslintrc.js`
+- `.prettierrc.js`
+- `.stylelintrc.js`
+- `.lintstagedrc.js`
+- `.eslintignore`
+- `.prettierignore`
+- `.stylelintignore`
+- `.gitignore` (patterns are added automatically)
+
+**⚠️ DO NOT EDIT THESE FILES MANUALLY** — any changes will be overwritten on the next `lint update` (which runs automatically before each `lint` command).
+
+If you need to customize configuration:
+
+1. Check if the customization can be done via package-level overrides (see below)
+2. If not, consider opening an issue or PR to `@diplodoc/lint` to add the feature
+3. For ignore patterns, they are managed automatically — if you need additional patterns, they should be added to `@diplodoc/lint`'s `modify-ignore.js` script
+
+### Configuration Files
+
 After initialization, the following files are created in the package root:
 
 ### `.eslintrc.js`
@@ -220,11 +243,13 @@ After `lint init`, the following scripts are added to `package.json`:
 The package automatically updates the following ignore files:
 
 - `.gitignore` — system files, dependencies, artifacts
-- `.eslintignore` — system files, dependencies, artifacts, `test/`, `scripts/`
+- `.eslintignore` — system files, dependencies, artifacts, `test/`, `scripts/`, `build/`, `esbuild/`
 - `.prettierignore` — system files, dependencies, artifacts
 - `.stylelintignore` — system files, dependencies, artifacts
 
-Patterns are added automatically on `init` and `update`, duplicates are not created.
+**⚠️ These files are auto-generated** — patterns are added automatically on `init` and `update`, duplicates are not created. Manual edits will be overwritten.
+
+If you need additional ignore patterns, they should be added to `@diplodoc/lint`'s `modify-ignore.js` script.
 
 ## Testing
 

package/bin/lint.js

@@ -58,6 +58,7 @@ function hasStyleFiles() {
     }
 }
 
+
 if (init || update) {
     if (init) {
         console.log('[@diplodoc/lint] Extend package.json configuration');
@@ -81,7 +82,17 @@ if (init || update) {
 if (fix) {
     console.log('Run linters in fix mode');
 
-    execCommand(`"${join(binDir, 'eslint')}" '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}' --fix`);
+    // Включаем legacy-режим ESLint (ESLint 8-style), чтобы:
+    // - читался .eslintrc.js
+    // - учитывался .eslintignore
+    // Флаг ESLINT_USE_FLAT_CONFIG=false документирован в ESLint 9
+    // как способ вернуться к старому поведению CLI.
+    execCommand(
+        `ESLINT_USE_FLAT_CONFIG=false "${join(
+            binDir,
+            'eslint',
+        )}" . --ext .js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx --fix`,
+    );
     execCommand(`"${join(binDir, 'prettier')}" --write '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'`);
 
     if (hasStyleFiles()) {
@@ -89,13 +100,21 @@ if (fix) {
     }
 
     process.exit(0);
-}
-
-console.log('Run linters');
-
-execCommand(`"${join(binDir, 'eslint')}" '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'`);
-execCommand(`"${join(binDir, 'prettier')}" --check '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'`);
+} else {
+    console.log('Run linters');
+
+    // То же самое для check-режима: используем legacy-режим ESLint,
+    // передаём точку и расширения — ESLint сам находит файлы и
+    // применяет .eslintignore.
+    execCommand(
+        `ESLINT_USE_FLAT_CONFIG=false "${join(
+            binDir,
+            'eslint',
+        )}" . --ext .js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx`,
+    );
+    execCommand(`"${join(binDir, 'prettier')}" --check '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'`);
 
-if (hasStyleFiles()) {
-    execCommand(`"${join(binDir, 'stylelint')}" '**/*.{css,scss}'`);
-}
+    if (hasStyleFiles()) {
+        execCommand(`"${join(binDir, 'stylelint')}" '**/*.{css,scss}'`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diplodoc/lint",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "Diplodoc platform internal utility set for linting",
   "bin": {
     "lint": "./bin/lint.js",

package/scaffolding/.eslintrc.js

@@ -1,3 +1,8 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize ESLint configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = {
     root: true,
     extends: require.resolve('@diplodoc/lint/eslint-config'),
@@ -10,6 +15,31 @@ module.exports = {
             files: ['*.mjs', '*.cjs'],
             parserOptions: {
                 project: null,
+                ecmaVersion: 'latest',
+                sourceType: 'module',
+            },
+            env: {
+                node: true,
+                es2022: true,
+            },
+        },
+        {
+            files: ['test/**/*.{js,jsx,ts,tsx}'],
+            env: {
+                jest: true,
+                node: true,
+            },
+        },
+        {
+            files: ['scripts/**/*.{js,jsx,ts,tsx}'],
+            env: {
+                node: true,
+            },
+        },
+        {
+            files: ['bin/**/*.{js,jsx,ts,tsx}', 'bin/*.{js,jsx,ts,tsx}'],
+            env: {
+                node: true,
             },
         },
     ],

package/scaffolding/.gitattributes

@@ -30,3 +30,5 @@
 *.ttf binary
 *.eot binary
 
+
+

package/scaffolding/.lintstagedrc.js

@@ -1,8 +1,26 @@
 /* eslint-env node */
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize lint-staged configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
+const {readFileSync} = require('node:fs');
+const {join} = require('node:path');
+
+// Check if this is the @diplodoc/lint package itself
+const isLintPkg = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
+        return pkg.name === '@diplodoc/lint';
+    } catch {
+        return false;
+    }
+})();
+
 module.exports = {
-    // Exclude config files and scripts from linting (they use CommonJS)
+    // Exclude config files from linting (they use CommonJS)
     '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}': (filenames) => {
-        // Filter out config files and scripts
+        // Filter out config files
         const configFiles = [
             '.lintstagedrc.js',
             '.eslintrc.js',
@@ -13,15 +31,17 @@ module.exports = {
         const filtered = filenames.filter(
             (f) =>
                 !configFiles.some((config) => f.includes(config)) &&
-                !f.includes('scripts/') &&
-                !f.includes('test/'),
+                // For @diplodoc/lint package itself: exclude bin/ and scripts/ (in .eslintignore)
+                !(isLintPkg && (f.includes('bin/') || f.includes('scripts/'))),
         );
         if (filtered.length === 0) {
             return [];
         }
         return [
             ...filtered.map((f) => `prettier --write ${f}`),
-            ...filtered.map((f) => `eslint --max-warnings=0 --fix ${f}`),
+            ...filtered.map(
+                (f) => `env ESLINT_USE_FLAT_CONFIG=false npx eslint --max-warnings=0 --fix ${f}`,
+            ),
         ];
     },
     // Handle .lintstagedrc.js separately (only prettier, no eslint)

package/scaffolding/.prettierrc.js

@@ -1 +1,6 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize Prettier configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = require('@diplodoc/lint/prettier-config');

package/scaffolding/.stylelintrc.js

@@ -1,3 +1,8 @@
+// ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+// This file is automatically generated and updated by `@diplodoc/lint update`
+// Any manual changes will be overwritten on the next update
+// To customize Stylelint configuration, see: https://github.com/diplodoc-platform/lint#configuration
+
 module.exports = {
     extends: require.resolve('@diplodoc/lint/stylelint-config'),
 };

package/scripts/modify-ignore.js

@@ -1,5 +1,5 @@
 const {join} = require('node:path');
-const {readFileSync, writeFileSync} = require('node:fs');
+const {readFileSync, writeFileSync, existsSync} = require('node:fs');
 
 const SYSTEM = [
     '.idea',
@@ -30,14 +30,13 @@ const ignores = {
         ...SYSTEM,
         ...INSTALL,
         ...ARTIFACTS,
-        // Test files and scripts use Node.js globals
-        'test/',
-        'scripts/',
         // Config files use CommonJS
         '.lintstagedrc.js',
         '.eslintrc.js',
         '.prettierrc.js',
         '.stylelintrc.js',
+        // Build scripts that use newer syntax not yet supported by ESLint parser
+        'esbuild/**/*.mjs',
     ],
     '.prettierignore': [
         ...SYSTEM,

package/scripts/modify-release-please.js

@@ -32,27 +32,18 @@ const configContent = configTemplate
 
 const manifestContent = manifestTemplate
     .replace(/\{\{PACKAGE_VERSION\}\}/g, packageVersion)
-    .trimEnd(); // Remove trailing whitespace/newlines
+    .trimEnd() + '\n'; // Remove trailing whitespace/newlines
 
 // Write files
 const configOutputPath = join(process.cwd(), '.release-please-config.json');
 const manifestOutputPath = join(process.cwd(), '.release-please-manifest.json');
 
-// Only create if they don't exist (preserve existing configs)
 if (!existsSync(configOutputPath)) {
-    writeFileSync(configOutputPath, configContent, 'utf8');
     console.log('[@diplodoc/lint]', '=> Create .release-please-config.json');
-} else {
-    console.log('[@diplodoc/lint]', '=> .release-please-config.json already exists, skipping');
+    writeFileSync(configOutputPath, configContent, 'utf8');
 }
 
-if (!existsSync(manifestOutputPath)) {
-    writeFileSync(manifestOutputPath, manifestContent, 'utf8');
-    console.log('[@diplodoc/lint]', '=> Create .release-please-manifest.json');
-} else {
-    // Always update manifest with current version
-    writeFileSync(manifestOutputPath, manifestContent, 'utf8');
-    console.log('[@diplodoc/lint]', '=> Update .release-please-manifest.json');
-}
+console.log('[@diplodoc/lint]', '=> Update .release-please-manifest.json');
+writeFileSync(manifestOutputPath, manifestContent, 'utf8');