@angular-eslint/builder 21.4.1-alpha.7 → 22.0.0

package/README.md

@@ -14,8 +14,6 @@ You can profile rule execution times by enabling ESLint's stats output:
 ng lint --stats
 ```
 
-This option requires a flat ESLint configuration (`eslint.config.js/ts/mjs`). Using `--stats` with legacy `.eslintrc.*` files will cause an error.
-
 ## Bulk suppressions
 
 ESLint introduced bulk suppressions in v9.24. This allows you to enable new lint rules without having to fix every existing violation first. For details, see https://eslint.org/docs/latest/use/suppressions. In ESLint v10.1 a subset of the suppressions functionality was added to the Node.js API (https://eslint.org/blog/2026/03/eslint-v10.1.0-released/#api-support-for-bulk-suppressions).

package/dist/lint.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.impl.d.ts","sourceRoot":"","sources":["../src/lint.impl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;;AAMvC,wBA6OE"}
+{"version":3,"file":"lint.impl.d.ts","sourceRoot":"","sources":["../src/lint.impl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;;AAMvC,wBA0NE"}

package/dist/lint.impl.js

@@ -38,20 +38,7 @@ exports.default = (0, architect_1.createBuilder)(async (options, context) => {
         options.suppressionsLocation = options.suppressionsLocation
             ? (0, path_1.resolve)(systemRoot, options.suppressionsLocation)
             : null;
-        /**
-         * Until ESLint v9 is released and the new so called flat config is the default
-         * we only want to support it if the user has explicitly opted into it by converting
-         * their root ESLint config to use a supported flat config file name.
-         */
-        const useFlatConfig = eslint_utils_1.supportedFlatConfigNames.some((name) => (0, fs_1.existsSync)((0, path_1.join)(systemRoot, name)));
-        const { eslint, ESLint } = await (0, eslint_utils_1.resolveAndInstantiateESLint)(eslintConfigPath, options, useFlatConfig);
-        const version = ESLint?.version?.split('.');
-        if (!version ||
-            version.length < 2 ||
-            Number(version[0]) < 7 ||
-            (Number(version[0]) === 7 && Number(version[1]) < 6)) {
-            throw new Error('ESLint must be version 7.6 or higher.');
-        }
+        const { eslint, ESLint } = await (0, eslint_utils_1.resolveAndInstantiateESLint)(eslintConfigPath, options);
         let lintResults = [];
         try {
             lintResults = await eslint.lintFiles(options.lintFilePatterns);
@@ -65,9 +52,9 @@ exports.default = (0, architect_1.createBuilder)(async (options, context) => {
                         resolveESLintConfigPath(projectRoot) ?? '';
                 }
                 console.error(`
-Error: You have attempted to use a lint rule which requires the full TypeScript type-checker to be available, but you do not have \`parserOptions.project\` configured to point at your project tsconfig.json files in the relevant TypeScript file "overrides" block of your project ESLint config ${eslintConfigPath || eslintConfigPathForError}
+Error: You have attempted to use a lint rule which requires the full TypeScript type-checker to be available, but you have not configured type information for the TypeScript files in your project ESLint config ${eslintConfigPath || eslintConfigPathForError}
 
-For full guidance on how to resolve this issue, please see https://github.com/angular-eslint/angular-eslint/blob/main/docs/RULES_REQUIRING_TYPE_INFORMATION.md
+The simplest way to enable type information is to set \`languageOptions.parserOptions.projectService\` to \`true\` for your TypeScript files. For full guidance on how to resolve this issue, please see https://github.com/angular-eslint/angular-eslint/blob/main/docs/RULES_REQUIRING_TYPE_INFORMATION.md
 `);
                 return {
                     success: false,
@@ -81,7 +68,7 @@ For full guidance on how to resolve this issue, please see https://github.com/an
                 .filter((pattern) => !!pattern)
                 .map((pattern) => `- '${pattern}'`);
             if (ignoredPatterns.length) {
-                throw new Error(`All files matching the following patterns are ignored:\n${ignoredPatterns.join('\n')}\n\nPlease check your '.eslintignore' file.`);
+                throw new Error(`All files matching the following patterns are ignored:\n${ignoredPatterns.join('\n')}\n\nPlease check the 'ignores' configuration in your ESLint flat config.`);
             }
             throw new Error('Invalid lint configuration. Nothing to lint. Please check your lint target pattern(s).');
         }
@@ -173,21 +160,11 @@ For full guidance on how to resolve this issue, please see https://github.com/an
     }
 });
 function resolveESLintConfigPath(projectRoot) {
-    const rcPath = (0, path_1.join)(projectRoot, '.eslintrc.json');
-    if ((0, fs_1.existsSync)(rcPath)) {
-        return rcPath;
-    }
-    const jsPath = (0, path_1.join)(projectRoot, 'eslint.config.js');
-    if ((0, fs_1.existsSync)(jsPath)) {
-        return jsPath;
-    }
-    const mjsPath = (0, path_1.join)(projectRoot, 'eslint.config.mjs');
-    if ((0, fs_1.existsSync)(mjsPath)) {
-        return mjsPath;
-    }
-    const cjsPath = (0, path_1.join)(projectRoot, 'eslint.config.cjs');
-    if ((0, fs_1.existsSync)(cjsPath)) {
-        return cjsPath;
+    for (const name of eslint_utils_1.defaultFlatConfigNames) {
+        const candidate = (0, path_1.join)(projectRoot, name);
+        if ((0, fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
     }
     return null;
 }

package/dist/schema.json

@@ -90,37 +90,11 @@
         { "minLength": 1 }
       ]
     },
-    "ignorePath": {
-      "type": "string",
-      "description": "The path of the `.eslintignore` file."
-    },
-    "noEslintrc": {
-      "type": "boolean",
-      "description": "NOTE: eslintrc config only. The equivalent of the `--no-eslintrc` flag on the ESLint CLI, it is false by default",
-      "default": false
-    },
     "noConfigLookup": {
       "type": "boolean",
-      "description": "NOTE: flat config only. The equivalent of the `--no-config-lookup` flag on the ESLint CLI, it is false by default",
+      "description": "The equivalent of the `--no-config-lookup` flag on the ESLint CLI, it is false by default",
       "default": false
     },
-    "rulesdir": {
-      "type": "array",
-      "description": "The equivalent of the `--rulesdir` flag on the ESLint CLI, it is an empty array by default",
-      "default": [],
-      "items": {
-        "type": "string"
-      }
-    },
-    "resolvePluginsRelativeTo": {
-      "type": "string",
-      "description": "The equivalent of the `--resolve-plugins-relative-to` flag on the ESLint CLI"
-    },
-    "reportUnusedDisableDirectives": {
-      "type": "string",
-      "enum": ["off", "warn", "error"],
-      "description": "The equivalent of the `--report-unused-disable-directives` flag on the ESLint CLI."
-    },
     "concurrency": {
       "oneOf": [
         { "type": "string", "enum": ["auto", "off"] },

package/dist/utils/eslint-utils.d.ts

@@ -1,7 +1,17 @@
 import type { ESLint } from 'eslint';
 import type { Schema } from '../schema';
-export declare const supportedFlatConfigNames: string[];
-export declare function resolveAndInstantiateESLint(eslintConfigPath: string | undefined, options: Schema, useFlatConfig?: boolean): Promise<{
+/**
+ * The conventional flat config file names that ESLint resolves automatically.
+ *
+ * NOTE: this is NOT a restriction on what an explicitly provided config file may
+ * be named. ESLint's own `--config`/`overrideConfigFile` accepts a flat config
+ * file with any name, and so does this builder (see the legacy eslintrc denylist
+ * below). This list only mirrors the names ESLint discovers on its own when no
+ * explicit config is given, so we can reconstruct a likely config path for
+ * diagnostic messages.
+ */
+export declare const defaultFlatConfigNames: string[];
+export declare function resolveAndInstantiateESLint(eslintConfigPath: string | undefined, options: Schema): Promise<{
     ESLint: typeof import("eslint").ESLint;
     eslint: ESLint;
 }>;

package/dist/utils/eslint-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-utils.d.ts","sourceRoot":"","sources":["../../src/utils/eslint-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,wBAAwB,UAOpC,CAAC;AAiDF,wBAAsB,2BAA2B,CAC/C,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,EACf,aAAa,UAAQ;;;GAuHtB"}
+{"version":3,"file":"eslint-utils.d.ts","sourceRoot":"","sources":["../../src/utils/eslint-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,UAOlC,CAAC;AAyCF,wBAAsB,2BAA2B,CAC/C,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM;;;GAqEhB"}

package/dist/utils/eslint-utils.js

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportedFlatConfigNames = void 0;
+exports.defaultFlatConfigNames = void 0;
 exports.resolveAndInstantiateESLint = resolveAndInstantiateESLint;
-exports.supportedFlatConfigNames = [
+/**
+ * The conventional flat config file names that ESLint resolves automatically.
+ *
+ * NOTE: this is NOT a restriction on what an explicitly provided config file may
+ * be named. ESLint's own `--config`/`overrideConfigFile` accepts a flat config
+ * file with any name, and so does this builder (see the legacy eslintrc denylist
+ * below). This list only mirrors the names ESLint discovers on its own when no
+ * explicit config is given, so we can reconstruct a likely config path for
+ * diagnostic messages.
+ */
+exports.defaultFlatConfigNames = [
     'eslint.config.js',
     'eslint.config.mjs',
     'eslint.config.cjs',
@@ -10,19 +20,22 @@ exports.supportedFlatConfigNames = [
     'eslint.config.mts',
     'eslint.config.cts',
 ];
-async function resolveESLintClass(useFlatConfig = false) {
+/**
+ * Legacy "eslintrc" config file names (e.g. `.eslintrc`, `.eslintrc.json`,
+ * `.eslintrc.js`, `.eslintrc.yml`). ESLint removed support for this format in
+ * v10 and angular-eslint no longer supports it.
+ *
+ * We detect these names explicitly so we can surface a helpful error message.
+ * Any other file name is passed straight through to ESLint - exactly like
+ * ESLint's own `--config`/`overrideConfigFile`, a flat config file can have
+ * any name, so we deliberately do NOT require the `eslint.config.*` naming
+ * convention for an explicitly provided config file.
+ */
+const legacyEslintrcConfigFilePattern = /(^|[\\/])\.eslintrc(\.(c?js|ya?ml|json))?$/;
+async function resolveESLintClass() {
     try {
-        // In eslint 8.57.0 (the final v8 minor version), a dedicated API was added for resolving the correct ESLint class.
         const eslint = await import('eslint');
-        if (typeof eslint.loadESLint === 'function') {
-            return await eslint.loadESLint({ useFlatConfig });
-        }
-        // If that API is not available (an older version of v8), we need to use the old way of resolving the ESLint class.
-        if (!useFlatConfig) {
-            return eslint.ESLint;
-        }
-        const { FlatESLint } = (await import('eslint/use-at-your-own-risk'));
-        return FlatESLint;
+        return eslint.ESLint;
     }
     catch {
         throw new Error('Unable to find ESLint. Ensure ESLint is installed.');
@@ -39,22 +52,12 @@ function validateConcurrency(concurrency) {
     }
     throw new Error('The --concurrency option must be auto, off or a positive integer');
 }
-async function resolveAndInstantiateESLint(eslintConfigPath, options, useFlatConfig = false) {
-    if (options.stats && !useFlatConfig) {
-        throw new Error('The --stats option requires ESLint Flat Config');
-    }
-    if (options.applySuppressions && !useFlatConfig) {
-        throw new Error('The --apply-suppressions option requires ESLint Flat Config');
-    }
-    if (options.suppressionsLocation && !useFlatConfig) {
-        throw new Error('The --suppressions-location option requires ESLint Flat Config');
-    }
-    if (useFlatConfig &&
-        eslintConfigPath &&
-        !exports.supportedFlatConfigNames.some((name) => eslintConfigPath.endsWith(name))) {
-        throw new Error(`When using the new Flat Config with ESLint, all configs must be named ${exports.supportedFlatConfigNames.join(' or ')}, and .eslintrc files may not be used. See https://eslint.org/docs/latest/use/configure/configuration-files`);
+async function resolveAndInstantiateESLint(eslintConfigPath, options) {
+    if (eslintConfigPath &&
+        legacyEslintrcConfigFilePattern.test(eslintConfigPath)) {
+        throw new Error(`The ESLint config file "${eslintConfigPath}" uses the legacy "eslintrc" format, which is no longer supported. Please use an ESLint flat config file (it can have any name, e.g. eslint.config.js). See https://eslint.org/docs/latest/use/configure/configuration-files`);
     }
-    const ESLint = await resolveESLintClass(useFlatConfig);
+    const ESLint = await resolveESLintClass();
     const eslintOptions = {
         fix: !!options.fix,
         cache: !!options.cache,
@@ -77,55 +80,26 @@ async function resolveAndInstantiateESLint(eslintConfigPath, options, useFlatCon
         validateConcurrency(concurrency);
         eslintOptions.concurrency = concurrency;
     }
-    if (useFlatConfig) {
-        eslintOptions.stats = !!options.stats;
-        if (options.applySuppressions) {
-            eslintOptions.applySuppressions = true;
-        }
-        if (options.suppressionsLocation) {
-            eslintOptions.suppressionsLocation = options.suppressionsLocation;
-        }
-        if (typeof options.useEslintrc !== 'undefined') {
-            throw new Error('For Flat Config, the `useEslintrc` option is not applicable. See https://eslint.org/docs/latest/use/configure/configuration-files-new');
-        }
-        if (options.resolvePluginsRelativeTo !== undefined) {
-            throw new Error('For Flat Config, ESLint removed `resolvePluginsRelativeTo` and so it is not supported as an option. See https://eslint.org/docs/latest/use/configure/configuration-files-new');
-        }
-        if (options.ignorePath !== undefined) {
-            throw new Error('For Flat Config, ESLint removed `ignorePath` and so it is not supported as an option. See https://eslint.org/docs/latest/use/configure/configuration-files-new');
-        }
-        if (options.reportUnusedDisableDirectives) {
-            throw new Error('For Flat Config, ESLint removed `reportUnusedDisableDirectives` and so it is not supported as an option. See https://eslint.org/docs/latest/use/configure/configuration-files-new');
-        }
-        /**
-         * Adapted from https://github.com/eslint/eslint/blob/50f03a119e6827c03b1d6c86d3aa1f4820b609e8/lib/cli.js#L144
-         */
-        if (typeof options.noConfigLookup !== 'undefined') {
-            const configLookup = !options.noConfigLookup;
-            let overrideConfigFile = typeof eslintConfigPath === 'string' ? eslintConfigPath : !configLookup;
-            if (overrideConfigFile === false) {
-                overrideConfigFile = undefined;
-            }
-            eslintOptions.overrideConfigFile = overrideConfigFile;
-        }
-        else {
-            eslintOptions.overrideConfigFile = eslintConfigPath;
+    eslintOptions.stats = !!options.stats;
+    if (options.applySuppressions) {
+        eslintOptions.applySuppressions = true;
+    }
+    if (options.suppressionsLocation) {
+        eslintOptions.suppressionsLocation = options.suppressionsLocation;
+    }
+    /**
+     * Adapted from https://github.com/eslint/eslint/blob/50f03a119e6827c03b1d6c86d3aa1f4820b609e8/lib/cli.js#L144
+     */
+    if (typeof options.noConfigLookup !== 'undefined') {
+        const configLookup = !options.noConfigLookup;
+        let overrideConfigFile = typeof eslintConfigPath === 'string' ? eslintConfigPath : !configLookup;
+        if (overrideConfigFile === false) {
+            overrideConfigFile = undefined;
         }
+        eslintOptions.overrideConfigFile = overrideConfigFile;
     }
     else {
         eslintOptions.overrideConfigFile = eslintConfigPath;
-        const legacyOptions = eslintOptions;
-        legacyOptions.rulePaths = options.rulesdir || [];
-        legacyOptions.resolvePluginsRelativeTo =
-            options.resolvePluginsRelativeTo || undefined;
-        legacyOptions.ignorePath = options.ignorePath || undefined;
-        /**
-         * If "noEslintrc" is set to `true` (and therefore here "useEslintrc" will be `false`), then ESLint will not
-         * merge the provided config with others it finds automatically.
-         */
-        legacyOptions.useEslintrc = !options.noEslintrc;
-        legacyOptions.reportUnusedDisableDirectives =
-            options.reportUnusedDisableDirectives || undefined;
     }
     const eslint = new ESLint(eslintOptions);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-eslint/builder",
-  "version": "21.4.1-alpha.7",
+  "version": "22.0.0",
   "description": "Angular CLI builder for ESLint",
   "license": "MIT",
   "main": "dist/index.js",
@@ -19,12 +19,12 @@
     "builders.json"
   ],
   "dependencies": {
-    "@angular-devkit/architect": ">= 0.2100.0 < 0.2200.0",
-    "@angular-devkit/core": ">= 21.0.0 < 22.0.0"
+    "@angular-devkit/architect": ">= 0.2200.0 < 0.2300.0",
+    "@angular-devkit/core": ">= 22.0.0 < 23.0.0"
   },
   "peerDependencies": {
-    "@angular/cli": ">= 21.0.0 < 22.0.0",
-    "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+    "@angular/cli": ">= 22.0.0 < 23.0.0",
+    "eslint": "^9.0.0 || ^10.0.0",
     "typescript": "*"
   },
   "builders": "./builders.json",