@utoo/lint 0.3.5 → 0.3.7

package/README.md

@@ -248,6 +248,26 @@ Raw reports include active diagnostics, suppressed diagnostics, fixed outputs,
 and an exit code. The compatibility layer also exports `Linter`, `CLIEngine`,
 `RuleTester`, and `SourceCode` APIs.
 
+Native JSON diagnostics and ESLint-compatible messages include one-based `line`,
+`column`, `endLine`, and `endColumn` positions for source spans. Columns count
+UTF-16 code units, and the end position is exclusive. Suppressed diagnostics keep
+the same range. I/O errors without a source span omit the end positions; messages
+from older native binaries may also omit them.
+
+`ESLint` and `CLIEngine` also discover classic `.eslintrc.*` files (or
+`eslintConfig` in `package.json`) when no native config applies. Legacy
+`extends`, directory cascades, `root`, `overrides`, and ignore patterns are
+resolved per source filename. Precedence is `baseConfig`, project config,
+then `overrideConfig`; `useEslintrc: false` disables discovery. Native config
+files still take priority. The lower-level `lintFiles`, `lintText`, and native
+CLI keep their native-only discovery behavior.
+
+Legacy configuration resolution uses `@eslint/eslintrc`. If the project has
+ESLint 8 installed, its configuration resolver is used instead to support
+shared configs that patch ESLint's module resolution. Neither path uses ESLint
+to parse or lint source files: rules still run in utoo-lint. Enabled rules that
+utoo-lint does not support remain errors, not silently skipped checks.
+
 The Node wrapper captures up to 64 MiB from each native stdout and stderr
 stream by default. Programmatic `run`, `runCli`, and `runFishlint` calls can set
 `maxBuffer` to another positive byte count. Set `UTOO_LINT_MAX_BUFFER` to apply

package/index.cjs

@@ -5,6 +5,7 @@ const { tmpdir } = require("node:os");
 const { dirname, extname, isAbsolute, join, relative, resolve: resolvePath } = require("node:path");
 
 const { platformPackageName, resolveBinary } = require("./lib/binary.cjs");
+const { createLegacyConfigResolver } = require("./lib/legacy-config.cjs");
 const {
   findConfigPath: findConfigPathFromDirectory,
   readConfig
@@ -15,6 +16,8 @@ const version = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8")
 const LINTABLE_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".mts", ".cts"]);
 const MAX_AUTOFIX_PASSES = 10;
 const CONFIG_DISCOVERY_CACHE = Symbol("configDiscoveryCache");
+const LEGACY_CONFIG_ENABLED = Symbol("legacyConfigEnabled");
+const LEGACY_CONFIG_RESOLVER = Symbol("legacyConfigResolver");
 const JS_KEYWORDS = new Set([
   "await", "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete",
   "do", "else", "export", "extends", "finally", "for", "function", "if", "import", "in",
@@ -415,6 +418,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-duplicate-enum-values",
   "@typescript-eslint/no-extra-semi",
   "@typescript-eslint/no-extra-non-null-assertion",
+  "@typescript-eslint/no-explicit-any",
   "@typescript-eslint/no-inferrable-types",
   "@typescript-eslint/no-invalid-void-type",
   "@typescript-eslint/no-loop-func",
@@ -472,6 +476,7 @@ const NATIVE_ONLY_RULE_IDS = [
 ];
 const NATIVE_RULE_IDS = [...BUILTIN_RULE_IDS, ...NATIVE_ONLY_RULE_IDS];
 const FIXABLE_BUILTIN_RULE_IDS = new Set([
+  "@typescript-eslint/no-explicit-any",
   "jest/no-deprecated-functions",
   "jest/no-jasmine-globals",
   "no-extra-semi",
@@ -479,6 +484,7 @@ const FIXABLE_BUILTIN_RULE_IDS = new Set([
   "unused-imports/no-unused-imports"
 ]);
 const SUGGESTION_BUILTIN_RULE_IDS = new Set([
+  "@typescript-eslint/no-explicit-any",
   "jest/no-focused-tests"
 ]);
 const BUILTIN_RULES = new Map(BUILTIN_RULE_IDS.map((ruleId) => [ruleId, createBuiltinRule(ruleId)]));
@@ -579,6 +585,9 @@ class UtooLint {
 
   async findConfigFile(filePath) {
     const options = withConfigCache(eslintConstructorOptions(this.options));
+    if (options.legacyConfigFile) {
+      return resolvePath(options.cwd ?? process.cwd(), options.legacyConfigFile);
+    }
     if (options.noConfig) {
       return undefined;
     }
@@ -1207,6 +1216,9 @@ function lintFiles(paths, options = {}) {
   if (usesDefaultTargets) {
     lintPaths = filterDefaultConfigLintPaths(lintPaths, options);
   }
+  if (options[LEGACY_CONFIG_ENABLED] && (!options.noConfig || options.legacyConfigFile) && !options.deferDiagnosticConfigFiltering) {
+    lintPaths = expandNativeConfigRunPaths(lintPaths, options).filter((filePath) => !isPathIgnored(filePath, options));
+  }
   if (lintPaths.length === 0) {
     return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, suppressedDiagnostics: [], exitCode: exitCodeForDiagnostics(ignoredDiagnostics) };
   }
@@ -1230,6 +1242,10 @@ function lintFiles(paths, options = {}) {
 }
 
 function nativeFlatConfigOptions(options) {
+  if (defersLegacyIgnores(options)) {
+    // A legacy config may cascade from a nested directory even with baseConfig.
+    return undefined;
+  }
   if (options.rules || options.extraArgs?.some((arg) => arg.startsWith("--") && arg !== "--fix" && arg !== "--fix-dry-run")) {
     return undefined;
   }
@@ -1301,7 +1317,7 @@ function nativeSerializableConfig(config) {
 
 function expandNativeConfigRunPaths(paths, options) {
   const cwd = options.cwd ?? process.cwd();
-  const patterns = ignoreDisabled(options) ? [] : ignorePatternsForOptions(options, cwd);
+  const patterns = ignoreDisabled(options) || defersLegacyIgnores(options) ? [] : ignorePatternsForOptions(options, cwd);
   return paths.flatMap((path) => expandLintTarget(path, cwd, patterns) ?? [path]);
 }
 
@@ -1359,7 +1375,7 @@ function finalizeLintReport(report, ignoredDiagnostics, options) {
 }
 
 function nativeConfigRunsForFiles(paths, options) {
-  if (options.noConfig && !options.baseConfig && !options.overrideConfig) {
+  if (options.noConfig && !options.legacyConfigFile && !options.baseConfig && !options.overrideConfig) {
     return undefined;
   }
 
@@ -1370,7 +1386,7 @@ function nativeConfigRunsForFiles(paths, options) {
       ? options.filePath ?? options.filename ?? filePath
       : filePath;
     const fileConfigPath = options.noConfig ? undefined : configPathForFile(options, matchPath);
-    const configured = Boolean(options.baseConfig || options.overrideConfig || fileConfigPath);
+    const configured = Boolean(options.baseConfig || options.overrideConfig || fileConfigPath || legacyConfigForFile(options, matchPath));
     hasConfigSource ||= configured;
     const calculated = configured ? calculatedConfig({ ...options, rules: undefined }, matchPath) : {};
     let rules = calculated.rules;
@@ -1473,7 +1489,9 @@ function isPureRuleSeverity(config) {
 function allDisabledNativeRules(rules) {
   return {
     ...Object.fromEntries(NATIVE_RULE_IDS.map((rule) => [rule, "off"])),
-    ...rules
+    ...Object.fromEntries(Object.entries(rules ?? {}).filter(
+      ([rule, value]) => NATIVE_RULE_IDS.includes(rule) || ruleConfigSeverity(value) > 0
+    ))
   };
 }
 
@@ -1657,12 +1675,14 @@ function withConfigCache(options) {
 
 function eslintConstructorOptions(options) {
   const mapped = {
+    [LEGACY_CONFIG_ENABLED]: true,
     cwd: options.cwd,
     threads: options.threads,
     binary: options.binary,
     env: options.env,
     extraArgs: options.extraArgs,
-    config: options.config ?? options.configFile,
+    config: options.config,
+    legacyConfigFile: options.config == null ? options.configFile : undefined,
     ignorePath: options.ignorePath,
     ignorePatterns: options.ignorePatterns,
     noIgnore: options.noIgnore ?? options.ignore === false,
@@ -1679,14 +1699,14 @@ function eslintConstructorOptions(options) {
   }
   if (typeof options.overrideConfigFile === "string") {
     mapped.config = options.overrideConfigFile;
+    mapped.legacyConfigFile = undefined;
+  }
+  if (mapped.config && /(?:^|[/\\\\])\.eslintrc(?:\.(?:js|cjs|json|yaml|yml))?$/.test(mapped.config)) {
+    mapped.legacyConfigFile = mapped.config;
+    mapped.config = undefined;
   }
   if (options.overrideConfig) {
     mapped.overrideConfig = Array.isArray(options.overrideConfig) ? options.overrideConfig : { ...options.overrideConfig };
-    if (!Array.isArray(mapped.overrideConfig) && !mapped.overrideConfig.rules && options.baseConfig?.rules) {
-      mapped.overrideConfig.rules = options.baseConfig.rules;
-    }
-  } else if (options.baseConfig?.rules) {
-    mapped.overrideConfig = { rules: options.baseConfig.rules };
   }
   return mapped;
 }
@@ -1818,13 +1838,13 @@ function rulesFromConfig(config, filePath, cwd) {
 }
 
 function rulesFromFileConfig(options, filePath) {
-  if (options.noConfig) {
+  if (options.noConfig && !options.legacyConfigFile) {
     return {};
   }
 
   const configPath = filePath ? configPathForFile(options, filePath) : configPathForOptions(options);
   if (!configPath) {
-    return {};
+    return legacyConfigForFile(options, filePath)?.rules ?? {};
   }
 
   const config = readConfig(configPath, options.cwd, options.configCache);
@@ -1832,19 +1852,40 @@ function rulesFromFileConfig(options, filePath) {
 }
 
 function configDataFromFileConfig(options, filePath) {
-  if (options.noConfig) {
+  if (options.noConfig && !options.legacyConfigFile) {
     return {};
   }
 
   const configPath = filePath ? configPathForFile(options, filePath) : configPathForOptions(options);
   if (!configPath) {
-    return {};
+    return configDataFromConfig(legacyConfigForFile(options, filePath), filePath, options.cwd);
   }
 
   const config = readConfig(configPath, options.cwd, options.configCache);
   return configDataFromConfig(config, filePath, dirname(configPath));
 }
 
+function legacyConfigForFile(options, filePath) {
+  if (!options[LEGACY_CONFIG_ENABLED] || (options.noConfig && !options.legacyConfigFile)) return undefined;
+  if (filePath ? configPathForFile(options, filePath) : configPathForOptions(options)) return undefined;
+  const cwd = resolvePath(options.cwd ?? process.cwd());
+  let resolver = options.configCache?.get(LEGACY_CONFIG_RESOLVER);
+  if (!resolver) {
+    resolver = createLegacyConfigResolver(cwd, {
+      configFile: options.legacyConfigFile,
+      useEslintrc: !options.noConfig,
+      ignorePath: options.ignorePath,
+      ignorePatterns: [
+        ...ignorePatternsFromConfig(options.baseConfig),
+        ...normalizeIgnorePatterns(options.ignorePatterns),
+        ...ignorePatternsFromConfig(options.overrideConfig)
+      ]
+    });
+    options.configCache?.set(LEGACY_CONFIG_RESOLVER, resolver);
+  }
+  return resolver(normalizeESLintFilePath(filePath ?? options.filePath ?? options.filename ?? "__placeholder__.js", cwd));
+}
+
 function lintTargetsForInput(paths, options = {}) {
   if (paths == null) {
     return defaultLintTargets(options);
@@ -1988,6 +2029,7 @@ function normalizeConfigPatterns(patterns) {
 }
 
 function configPathForOptions(options) {
+  if (options.legacyConfigFile) return undefined;
   if (options.config) {
     return resolvePath(options.cwd ?? process.cwd(), options.config);
   }
@@ -1997,6 +2039,7 @@ function configPathForOptions(options) {
 }
 
 function configPathForFile(options, filePath) {
+  if (options.legacyConfigFile) return undefined;
   if (options.noConfig) {
     return undefined;
   }
@@ -4286,7 +4329,7 @@ function isLintableFilePath(filePath) {
 function filteredLintPaths(paths, options = {}) {
   const values = normalizeStringArray(Array.isArray(paths) ? paths : [paths], "paths");
   const cwd = options.cwd ?? process.cwd();
-  const patterns = ignoreDisabled(options) ? [] : ignorePatternsForOptions(options, cwd);
+  const patterns = ignoreDisabled(options) || defersLegacyIgnores(options) ? [] : ignorePatternsForOptions(options, cwd);
   if (patterns.length === 0 && options.errorOnUnmatchedPattern !== false && !values.some(hasGlobMagic)) {
     return values;
   }
@@ -4405,7 +4448,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
 
   const cwd = options.cwd ?? process.cwd();
   const patterns = ignorePatternsForOptions(options, cwd);
-  if (patterns.length === 0) {
+  if (patterns.length === 0 && !options[LEGACY_CONFIG_ENABLED]) {
     return [];
   }
 
@@ -4422,7 +4465,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
       continue;
     }
 
-    if (pathIgnoredByPatterns(normalizeIgnoredPath(target, cwd), patterns)) {
+    if (isPathIgnored(filePath, options)) {
       diagnostics.push(ignoredFileDiagnostic(filePath));
     }
   }
@@ -4494,11 +4537,19 @@ function isPathIgnored(filePath, options = {}) {
   }
 
   const cwd = options.cwd ?? process.cwd();
+  const legacyConfig = legacyConfigForFile(options, filePath);
+  if (legacyConfig) {
+    return Boolean(legacyConfig.isIgnored?.(normalizeESLintFilePath(filePath, cwd)));
+  }
   const normalized = normalizeIgnoredPath(filePath, cwd);
   const patterns = ignorePatternsForOptions(options, cwd, filePath);
   return pathIgnoredByPatterns(normalized, patterns);
 }
 
+function defersLegacyIgnores(options) {
+  return options[LEGACY_CONFIG_ENABLED] && (options.legacyConfigFile || (!options.noConfig && !configPathForOptions(options)));
+}
+
 function ignoreDisabled(options = {}) {
   return options.noIgnore || options.ignore === false;
 }
@@ -4876,6 +4927,12 @@ function diagnosticToESLintMessage(diagnostic, ruleSeverities) {
     column: diagnostic.column,
     nodeType: null
   };
+  if (diagnostic.endLine != null) {
+    message.endLine = diagnostic.endLine;
+  }
+  if (diagnostic.endColumn != null) {
+    message.endColumn = diagnostic.endColumn;
+  }
   const fixes = (diagnostic.fixes ?? []).map((fix) => ({
     range: fix.range,
     text: fix.text

package/index.js

@@ -6,6 +6,7 @@ import { dirname, extname, isAbsolute, join, relative, resolve as resolvePath }
 import { fileURLToPath } from "node:url";
 
 import { resolveBinary } from "./lib/binary.js";
+import { createLegacyConfigResolver } from "./lib/legacy-config.cjs";
 import {
   findConfigPath as findConfigPathFromDirectory,
   readConfig
@@ -18,6 +19,8 @@ export const version = JSON.parse(readFileSync(new URL("./package.json", import.
 const LINTABLE_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".mts", ".cts"]);
 const MAX_AUTOFIX_PASSES = 10;
 const CONFIG_DISCOVERY_CACHE = Symbol("configDiscoveryCache");
+const LEGACY_CONFIG_ENABLED = Symbol("legacyConfigEnabled");
+const LEGACY_CONFIG_RESOLVER = Symbol("legacyConfigResolver");
 const JS_KEYWORDS = new Set([
   "await", "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete",
   "do", "else", "export", "extends", "finally", "for", "function", "if", "import", "in",
@@ -418,6 +421,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-duplicate-enum-values",
   "@typescript-eslint/no-extra-semi",
   "@typescript-eslint/no-extra-non-null-assertion",
+  "@typescript-eslint/no-explicit-any",
   "@typescript-eslint/no-inferrable-types",
   "@typescript-eslint/no-invalid-void-type",
   "@typescript-eslint/no-loop-func",
@@ -475,6 +479,7 @@ const NATIVE_ONLY_RULE_IDS = [
 ];
 const NATIVE_RULE_IDS = [...BUILTIN_RULE_IDS, ...NATIVE_ONLY_RULE_IDS];
 const FIXABLE_BUILTIN_RULE_IDS = new Set([
+  "@typescript-eslint/no-explicit-any",
   "jest/no-deprecated-functions",
   "jest/no-jasmine-globals",
   "no-extra-semi",
@@ -482,6 +487,7 @@ const FIXABLE_BUILTIN_RULE_IDS = new Set([
   "unused-imports/no-unused-imports"
 ]);
 const SUGGESTION_BUILTIN_RULE_IDS = new Set([
+  "@typescript-eslint/no-explicit-any",
   "jest/no-focused-tests"
 ]);
 const BUILTIN_RULES = new Map(BUILTIN_RULE_IDS.map((ruleId) => [ruleId, createBuiltinRule(ruleId)]));
@@ -582,6 +588,9 @@ export class UtooLint {
 
   async findConfigFile(filePath) {
     const options = withConfigCache(eslintConstructorOptions(this.options));
+    if (options.legacyConfigFile) {
+      return resolvePath(options.cwd ?? process.cwd(), options.legacyConfigFile);
+    }
     if (options.noConfig) {
       return undefined;
     }
@@ -3106,6 +3115,9 @@ export function lintFiles(paths, options = {}) {
   if (usesDefaultTargets) {
     lintPaths = filterDefaultConfigLintPaths(lintPaths, options);
   }
+  if (options[LEGACY_CONFIG_ENABLED] && (!options.noConfig || options.legacyConfigFile) && !options.deferDiagnosticConfigFiltering) {
+    lintPaths = expandNativeConfigRunPaths(lintPaths, options).filter((filePath) => !isPathIgnored(filePath, options));
+  }
   if (lintPaths.length === 0) {
     return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, suppressedDiagnostics: [], exitCode: exitCodeForDiagnostics(ignoredDiagnostics) };
   }
@@ -3129,6 +3141,10 @@ export function lintFiles(paths, options = {}) {
 }
 
 function nativeFlatConfigOptions(options) {
+  if (defersLegacyIgnores(options)) {
+    // A legacy config may cascade from a nested directory even with baseConfig.
+    return undefined;
+  }
   if (options.rules || options.extraArgs?.some((arg) => arg.startsWith("--") && arg !== "--fix" && arg !== "--fix-dry-run")) {
     return undefined;
   }
@@ -3200,7 +3216,7 @@ function nativeSerializableConfig(config) {
 
 function expandNativeConfigRunPaths(paths, options) {
   const cwd = options.cwd ?? process.cwd();
-  const patterns = ignoreDisabled(options) ? [] : ignorePatternsForOptions(options, cwd);
+  const patterns = ignoreDisabled(options) || defersLegacyIgnores(options) ? [] : ignorePatternsForOptions(options, cwd);
   return paths.flatMap((path) => expandLintTarget(path, cwd, patterns) ?? [path]);
 }
 
@@ -3258,7 +3274,7 @@ function finalizeLintReport(report, ignoredDiagnostics, options) {
 }
 
 function nativeConfigRunsForFiles(paths, options) {
-  if (options.noConfig && !options.baseConfig && !options.overrideConfig) {
+  if (options.noConfig && !options.legacyConfigFile && !options.baseConfig && !options.overrideConfig) {
     return undefined;
   }
 
@@ -3269,7 +3285,7 @@ function nativeConfigRunsForFiles(paths, options) {
       ? options.filePath ?? options.filename ?? filePath
       : filePath;
     const fileConfigPath = options.noConfig ? undefined : configPathForFile(options, matchPath);
-    const configured = Boolean(options.baseConfig || options.overrideConfig || fileConfigPath);
+    const configured = Boolean(options.baseConfig || options.overrideConfig || fileConfigPath || legacyConfigForFile(options, matchPath));
     hasConfigSource ||= configured;
     const calculated = configured ? calculatedConfig({ ...options, rules: undefined }, matchPath) : {};
     let rules = calculated.rules;
@@ -3372,7 +3388,9 @@ function isPureRuleSeverity(config) {
 function allDisabledNativeRules(rules) {
   return {
     ...Object.fromEntries(NATIVE_RULE_IDS.map((rule) => [rule, "off"])),
-    ...rules
+    ...Object.fromEntries(Object.entries(rules ?? {}).filter(
+      ([rule, value]) => NATIVE_RULE_IDS.includes(rule) || ruleConfigSeverity(value) > 0
+    ))
   };
 }
 
@@ -3556,12 +3574,14 @@ function withConfigCache(options) {
 
 function eslintConstructorOptions(options) {
   const mapped = {
+    [LEGACY_CONFIG_ENABLED]: true,
     cwd: options.cwd,
     threads: options.threads,
     binary: options.binary,
     env: options.env,
     extraArgs: options.extraArgs,
-    config: options.config ?? options.configFile,
+    config: options.config,
+    legacyConfigFile: options.config == null ? options.configFile : undefined,
     ignorePath: options.ignorePath,
     ignorePatterns: options.ignorePatterns,
     noIgnore: options.noIgnore ?? options.ignore === false,
@@ -3578,14 +3598,14 @@ function eslintConstructorOptions(options) {
   }
   if (typeof options.overrideConfigFile === "string") {
     mapped.config = options.overrideConfigFile;
+    mapped.legacyConfigFile = undefined;
+  }
+  if (mapped.config && /(?:^|[/\\\\])\.eslintrc(?:\.(?:js|cjs|json|yaml|yml))?$/.test(mapped.config)) {
+    mapped.legacyConfigFile = mapped.config;
+    mapped.config = undefined;
   }
   if (options.overrideConfig) {
     mapped.overrideConfig = Array.isArray(options.overrideConfig) ? options.overrideConfig : { ...options.overrideConfig };
-    if (!Array.isArray(mapped.overrideConfig) && !mapped.overrideConfig.rules && options.baseConfig?.rules) {
-      mapped.overrideConfig.rules = options.baseConfig.rules;
-    }
-  } else if (options.baseConfig?.rules) {
-    mapped.overrideConfig = { rules: options.baseConfig.rules };
   }
   return mapped;
 }
@@ -3717,13 +3737,13 @@ function rulesFromConfig(config, filePath, cwd) {
 }
 
 function rulesFromFileConfig(options, filePath) {
-  if (options.noConfig) {
+  if (options.noConfig && !options.legacyConfigFile) {
     return {};
   }
 
   const configPath = filePath ? configPathForFile(options, filePath) : configPathForOptions(options);
   if (!configPath) {
-    return {};
+    return legacyConfigForFile(options, filePath)?.rules ?? {};
   }
 
   const config = readConfig(configPath, options.cwd, options.configCache);
@@ -3731,19 +3751,40 @@ function rulesFromFileConfig(options, filePath) {
 }
 
 function configDataFromFileConfig(options, filePath) {
-  if (options.noConfig) {
+  if (options.noConfig && !options.legacyConfigFile) {
     return {};
   }
 
   const configPath = filePath ? configPathForFile(options, filePath) : configPathForOptions(options);
   if (!configPath) {
-    return {};
+    return configDataFromConfig(legacyConfigForFile(options, filePath), filePath, options.cwd);
   }
 
   const config = readConfig(configPath, options.cwd, options.configCache);
   return configDataFromConfig(config, filePath, dirname(configPath));
 }
 
+function legacyConfigForFile(options, filePath) {
+  if (!options[LEGACY_CONFIG_ENABLED] || (options.noConfig && !options.legacyConfigFile)) return undefined;
+  if (filePath ? configPathForFile(options, filePath) : configPathForOptions(options)) return undefined;
+  const cwd = resolvePath(options.cwd ?? process.cwd());
+  let resolver = options.configCache?.get(LEGACY_CONFIG_RESOLVER);
+  if (!resolver) {
+    resolver = createLegacyConfigResolver(cwd, {
+      configFile: options.legacyConfigFile,
+      useEslintrc: !options.noConfig,
+      ignorePath: options.ignorePath,
+      ignorePatterns: [
+        ...ignorePatternsFromConfig(options.baseConfig),
+        ...normalizeIgnorePatterns(options.ignorePatterns),
+        ...ignorePatternsFromConfig(options.overrideConfig)
+      ]
+    });
+    options.configCache?.set(LEGACY_CONFIG_RESOLVER, resolver);
+  }
+  return resolver(normalizeESLintFilePath(filePath ?? options.filePath ?? options.filename ?? "__placeholder__.js", cwd));
+}
+
 function lintTargetsForInput(paths, options = {}) {
   if (paths == null) {
     return defaultLintTargets(options);
@@ -3887,6 +3928,7 @@ function normalizeConfigPatterns(patterns) {
 }
 
 function configPathForOptions(options) {
+  if (options.legacyConfigFile) return undefined;
   if (options.config) {
     return resolvePath(options.cwd ?? process.cwd(), options.config);
   }
@@ -3896,6 +3938,7 @@ function configPathForOptions(options) {
 }
 
 function configPathForFile(options, filePath) {
+  if (options.legacyConfigFile) return undefined;
   if (options.noConfig) {
     return undefined;
   }
@@ -4289,7 +4332,7 @@ function isLintableFilePath(filePath) {
 function filteredLintPaths(paths, options = {}) {
   const values = normalizeStringArray(Array.isArray(paths) ? paths : [paths], "paths");
   const cwd = options.cwd ?? process.cwd();
-  const patterns = ignoreDisabled(options) ? [] : ignorePatternsForOptions(options, cwd);
+  const patterns = ignoreDisabled(options) || defersLegacyIgnores(options) ? [] : ignorePatternsForOptions(options, cwd);
   if (patterns.length === 0 && options.errorOnUnmatchedPattern !== false && !values.some(hasGlobMagic)) {
     return values;
   }
@@ -4408,7 +4451,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
 
   const cwd = options.cwd ?? process.cwd();
   const patterns = ignorePatternsForOptions(options, cwd);
-  if (patterns.length === 0) {
+  if (patterns.length === 0 && !options[LEGACY_CONFIG_ENABLED]) {
     return [];
   }
 
@@ -4425,7 +4468,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
       continue;
     }
 
-    if (pathIgnoredByPatterns(normalizeIgnoredPath(target, cwd), patterns)) {
+    if (isPathIgnored(filePath, options)) {
       diagnostics.push(ignoredFileDiagnostic(filePath));
     }
   }
@@ -4497,11 +4540,19 @@ function isPathIgnored(filePath, options = {}) {
   }
 
   const cwd = options.cwd ?? process.cwd();
+  const legacyConfig = legacyConfigForFile(options, filePath);
+  if (legacyConfig) {
+    return Boolean(legacyConfig.isIgnored?.(normalizeESLintFilePath(filePath, cwd)));
+  }
   const normalized = normalizeIgnoredPath(filePath, cwd);
   const patterns = ignorePatternsForOptions(options, cwd, filePath);
   return pathIgnoredByPatterns(normalized, patterns);
 }
 
+function defersLegacyIgnores(options) {
+  return options[LEGACY_CONFIG_ENABLED] && (options.legacyConfigFile || (!options.noConfig && !configPathForOptions(options)));
+}
+
 function ignoreDisabled(options = {}) {
   return options.noIgnore || options.ignore === false;
 }
@@ -4879,6 +4930,12 @@ function diagnosticToESLintMessage(diagnostic, ruleSeverities) {
     column: diagnostic.column,
     nodeType: null
   };
+  if (diagnostic.endLine != null) {
+    message.endLine = diagnostic.endLine;
+  }
+  if (diagnostic.endColumn != null) {
+    message.endColumn = diagnostic.endColumn;
+  }
   const fixes = (diagnostic.fixes ?? []).map((fix) => ({
     range: fix.range,
     text: fix.text

package/lib/legacy-config.cjs

@@ -0,0 +1,76 @@
+const { createRequire } = require("node:module");
+const { dirname, join, resolve } = require("node:path");
+
+// The same reviewed aliases used by the ESLint config migrator.
+const RULE_ALIASES = new Map([
+  ["no-native-reassign", "no-global-assign"],
+  ["@typescript-eslint/no-invalid-this", "no-invalid-this"]
+]);
+
+// Resolve configuration only. Parsing, rule execution, and fixes stay native.
+function createLegacyConfigResolver(cwd, { ignorePath, ignorePatterns, configFile, useEslintrc = true } = {}) {
+  const resolvedIgnorePath = ignorePath ? resolve(cwd, ignorePath) : undefined;
+  const resolvedConfigFile = configFile ? resolve(cwd, configFile) : undefined;
+  const projectRequire = createRequire(join(cwd, "package.json"));
+  let eslintPackage;
+  try {
+    eslintPackage = projectRequire.resolve("eslint/package.json");
+  } catch (error) {
+    if (error.code !== "MODULE_NOT_FOUND") throw error;
+  }
+
+  let load;
+  if (eslintPackage) {
+    const manifest = projectRequire(eslintPackage);
+    // Some shared configs patch ESLint's module-resolution internals. Use their
+    // own ESLint 8 config resolver when installed, and never recurse into an
+    // eslint package alias that points back to @utoo/lint.
+    const major = Number(manifest.version.split(".")[0]);
+    if (manifest.name === "eslint" && major === 8) {
+      const { CLIEngine } = projectRequire(join(dirname(eslintPackage), "lib/cli-engine/cli-engine.js"));
+      const engine = new CLIEngine({ cwd, ignorePath: resolvedIgnorePath, ignorePattern: ignorePatterns, configFile: resolvedConfigFile, useEslintrc });
+      load = (filePath) => {
+        try {
+          return { ...engine.getConfigForFile(filePath), isIgnored: (path) => engine.isPathIgnored(path) };
+        } catch (error) {
+          if (error.messageTemplate === "no-config-found") return undefined;
+          throw error;
+        }
+      };
+    }
+  }
+
+  if (!load) {
+    const { Legacy } = require("@eslint/eslintrc");
+    const eslintJs = require("@eslint/js");
+    const factory = new Legacy.CascadingConfigArrayFactory({
+      cwd,
+      specificConfigPath: resolvedConfigFile,
+      useEslintrc,
+      ignorePath: resolvedIgnorePath,
+      cliConfig: ignorePatterns?.length ? { ignorePatterns } : undefined,
+      getEslintRecommendedConfig: () => eslintJs.configs.recommended,
+      getEslintAllConfig: () => eslintJs.configs.all
+    });
+    load = (filePath) => {
+      const configs = factory.getConfigArrayForFile(filePath, { ignoreNotFoundError: true });
+      if (!configs.some((entry) => entry.type === "config" && entry.filePath)) return undefined;
+      const config = configs.extractConfig(filePath);
+      return { ...config.toCompatibleObjectAsConfigFileContent(), isIgnored: config.ignores };
+    };
+  }
+
+  const configs = new Map();
+  return (filePath) => {
+    if (!configs.has(filePath)) {
+      const config = load(filePath);
+      if (config) {
+        config.rules = Object.fromEntries(Object.entries(config.rules).map(([rule, value]) => [RULE_ALIASES.get(rule) ?? rule, value]));
+      }
+      configs.set(filePath, config);
+    }
+    return configs.get(filePath);
+  };
+}
+
+module.exports = { createLegacyConfigResolver };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/lint",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "High-performance JavaScript and TypeScript linter powered by Yuku",
   "license": "MIT",
   "repository": {
@@ -76,11 +76,11 @@
     "use-at-your-own-risk.js"
   ],
   "optionalDependencies": {
-    "@utoo/lint-darwin-arm64": "0.3.5",
-    "@utoo/lint-darwin-x64": "0.3.5",
-    "@utoo/lint-linux-arm64": "0.3.5",
-    "@utoo/lint-linux-x64": "0.3.5",
-    "@utoo/lint-win32-x64": "0.3.5"
+    "@utoo/lint-darwin-arm64": "0.3.7",
+    "@utoo/lint-darwin-x64": "0.3.7",
+    "@utoo/lint-linux-arm64": "0.3.7",
+    "@utoo/lint-linux-x64": "0.3.7",
+    "@utoo/lint-win32-x64": "0.3.7"
   },
   "dependencies": {
     "@eslint/eslintrc": "2.1.4",