@utoo/lint 0.3.6 → 0.3.8

package/README.md

@@ -244,10 +244,44 @@ const results = await eslint.lintFiles(["src"]);
 await ESLint.outputFixes(results);
 ```
 
+`await eslint.loadFormatter()` and `cliEngine.getFormatter()` default to an
+ESLint-style `stylish` report: aligned columns, blank lines between files,
+diagnostics sorted by line and column, and a summary of fixable errors and
+warnings. Rule messages (including punctuation), result arrays, and exit codes
+are unchanged. Only actual autofixes count toward the `--fix` hint, not editor
+suggestions; missing JSX keys still need a manually chosen stable, unique key.
+
+The stylish formatter detects color support on stdout. Pass `color: true` or
+`color: false` to the `ESLint` or `CLIEngine` constructor to override detection.
+Otherwise, `NO_COLOR` or `NODE_DISABLE_COLORS` disables color; `FORCE_COLOR`
+forces it (`0` disables), followed by `CLICOLOR_FORCE` and stdout TTY detection
+(`TERM=dumb` disables automatic color). Constructor `env` overrides also apply.
+JSON, JSON-with-metadata, compact, unix, and native CLI text formats are unchanged.
+
 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,8 @@ 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 { formatESLintResults } = require("./lib/stylish-formatter.cjs");
 const {
   findConfigPath: findConfigPathFromDirectory,
   readConfig
@@ -15,6 +17,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 +419,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 +477,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 +485,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 +586,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;
     }
@@ -617,7 +627,7 @@ class UtooLint {
       format(results) {
         return formatResultsByName(results, name, {
           rulesMeta: (results) => eslint.getRulesMetaForResults(results)
-        });
+        }, eslint.options);
       }
     };
   }
@@ -695,7 +705,7 @@ class CLIEngine {
 
   getFormatter(name = "stylish") {
     return (results) => {
-      return formatResultsByName(results, name);
+      return formatResultsByName(results, name, {}, this.options);
     };
   }
 
@@ -1207,6 +1217,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 +1243,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 +1318,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 +1376,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 +1387,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 +1490,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 +1676,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 +1700,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 +1839,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 +1853,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 +2030,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 +2040,7 @@ function configPathForOptions(options) {
 }
 
 function configPathForFile(options, filePath) {
+  if (options.legacyConfigFile) return undefined;
   if (options.noConfig) {
     return undefined;
   }
@@ -4286,7 +4330,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 +4449,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 +4466,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
       continue;
     }
 
-    if (pathIgnoredByPatterns(normalizeIgnoredPath(target, cwd), patterns)) {
+    if (isPathIgnored(filePath, options)) {
       diagnostics.push(ignoredFileDiagnostic(filePath));
     }
   }
@@ -4494,11 +4538,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 +4928,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
@@ -4947,31 +5005,7 @@ function maybeFilterQuietResults(results, options = {}) {
   return results;
 }
 
-function formatESLintResults(results) {
-  const lines = [];
-  let errorCount = 0;
-  let warningCount = 0;
-
-  for (const result of results) {
-    if (result.messages.length === 0) continue;
-    lines.push(result.filePath);
-    for (const message of result.messages) {
-      const severity = message.severity === 2 ? "error" : "warning";
-      lines.push(`  ${message.line}:${message.column}  ${severity}  ${message.message}  ${message.ruleId}`);
-    }
-    errorCount += result.errorCount;
-    warningCount += result.warningCount;
-  }
-
-  if (errorCount || warningCount) {
-    lines.push("");
-    lines.push(`x ${errorCount + warningCount} problem${errorCount + warningCount === 1 ? "" : "s"} (${errorCount} error${errorCount === 1 ? "" : "s"}, ${warningCount} warning${warningCount === 1 ? "" : "s"})`);
-  }
-
-  return lines.join("\n");
-}
-
-function formatResultsByName(input, name = "stylish", metadata = {}) {
+function formatResultsByName(input, name = "stylish", metadata = {}, options = {}) {
   const results = formatterResults(input);
   if (name === "json") {
     return JSON.stringify(input);
@@ -4990,7 +5024,7 @@ function formatResultsByName(input, name = "stylish", metadata = {}) {
   if (name === "unix") {
     return formatUnixResults(results);
   }
-  return formatESLintResults(results);
+  return formatESLintResults(results, options);
 }
 
 function formatterResults(input) {

package/index.js

@@ -6,6 +6,8 @@ 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 { formatESLintResults } from "./lib/stylish-formatter.cjs";
 import {
   findConfigPath as findConfigPathFromDirectory,
   readConfig
@@ -18,6 +20,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 +422,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 +480,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 +488,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 +589,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;
     }
@@ -620,7 +630,7 @@ export class UtooLint {
       format(results) {
         return formatResultsByName(results, name, {
           rulesMeta: (results) => eslint.getRulesMetaForResults(results)
-        });
+        }, eslint.options);
       }
     };
   }
@@ -2594,7 +2604,7 @@ export class CLIEngine {
 
   getFormatter(name = "stylish") {
     return (results) => {
-      return formatResultsByName(results, name);
+      return formatResultsByName(results, name, {}, this.options);
     };
   }
 
@@ -3106,6 +3116,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 +3142,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 +3217,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 +3275,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 +3286,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 +3389,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 +3575,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 +3599,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 +3738,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 +3752,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 +3929,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 +3939,7 @@ function configPathForOptions(options) {
 }
 
 function configPathForFile(options, filePath) {
+  if (options.legacyConfigFile) return undefined;
   if (options.noConfig) {
     return undefined;
   }
@@ -4289,7 +4333,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 +4452,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 +4469,7 @@ function ignoredLintPathDiagnostics(paths, options = {}) {
       continue;
     }
 
-    if (pathIgnoredByPatterns(normalizeIgnoredPath(target, cwd), patterns)) {
+    if (isPathIgnored(filePath, options)) {
       diagnostics.push(ignoredFileDiagnostic(filePath));
     }
   }
@@ -4497,11 +4541,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 +4931,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
@@ -4950,31 +5008,7 @@ function maybeFilterQuietResults(results, options = {}) {
   return results;
 }
 
-function formatESLintResults(results) {
-  const lines = [];
-  let errorCount = 0;
-  let warningCount = 0;
-
-  for (const result of results) {
-    if (result.messages.length === 0) continue;
-    lines.push(result.filePath);
-    for (const message of result.messages) {
-      const severity = message.severity === 2 ? "error" : "warning";
-      lines.push(`  ${message.line}:${message.column}  ${severity}  ${message.message}  ${message.ruleId}`);
-    }
-    errorCount += result.errorCount;
-    warningCount += result.warningCount;
-  }
-
-  if (errorCount || warningCount) {
-    lines.push("");
-    lines.push(`x ${errorCount + warningCount} problem${errorCount + warningCount === 1 ? "" : "s"} (${errorCount} error${errorCount === 1 ? "" : "s"}, ${warningCount} warning${warningCount === 1 ? "" : "s"})`);
-  }
-
-  return lines.join("\n");
-}
-
-function formatResultsByName(input, name = "stylish", metadata = {}) {
+function formatResultsByName(input, name = "stylish", metadata = {}, options = {}) {
   const results = formatterResults(input);
   if (name === "json") {
     return JSON.stringify(input);
@@ -4993,7 +5027,7 @@ function formatResultsByName(input, name = "stylish", metadata = {}) {
   if (name === "unix") {
     return formatUnixResults(results);
   }
-  return formatESLintResults(results);
+  return formatESLintResults(results, options);
 }
 
 function formatterResults(input) {

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/lib/stylish-formatter.cjs

@@ -0,0 +1,79 @@
+const { stripVTControlCharacters } = require("node:util");
+
+function formatESLintResults(results, options = {}) {
+  const color = shouldUseColor(options);
+  const paint = (text, open, close) => color ? `\u001b[${open}m${text}\u001b[${close}m` : text;
+  const lines = [""];
+  let errorCount = 0;
+  let warningCount = 0;
+  let fixableErrorCount = 0;
+  let fixableWarningCount = 0;
+
+  for (const result of results) {
+    if (result.messages.length === 0) continue;
+    lines.push(paint(result.filePath, 4, 24));
+    // Sort a copy: formatting must not reorder the caller's results or JSON output.
+    const messages = [...result.messages].sort((left, right) =>
+      (left.line ?? 0) - (right.line ?? 0) || (left.column ?? 0) - (right.column ?? 0)
+    );
+    const rows = messages.map((message) => [
+      String(message.line || 0),
+      String(message.column || 0),
+      message.fatal || message.severity === 2 ? "error" : "warning",
+      // Unlike ESLint stylish, retain punctuation in the original rule message.
+      message.message,
+      message.ruleId || "",
+    ]);
+    const widths = [0, 0, 0, 0];
+    for (const row of rows) {
+      for (let index = 0; index < widths.length; index += 1) {
+        widths[index] = Math.max(widths[index], stripVTControlCharacters(row[index]).length);
+      }
+    }
+    for (const [line, column, severity, message, ruleId] of rows) {
+      const location = " ".repeat(widths[0] - line.length)
+        + paint(`${line}:${column}`, 2, 22)
+        + " ".repeat(widths[1] - column.length);
+      const label = paint(severity, severity === "error" ? 31 : 33, 39)
+        + " ".repeat(widths[2] - severity.length);
+      const padding = " ".repeat(widths[3] - stripVTControlCharacters(message).length);
+      const description = ruleId ? `${message}${padding}  ${paint(ruleId, 2, 22)}` : message;
+      lines.push(`  ${location}  ${label}  ${description}`);
+    }
+    lines.push("");
+    errorCount += result.errorCount;
+    warningCount += result.warningCount;
+    fixableErrorCount += result.fixableErrorCount ?? 0;
+    fixableWarningCount += result.fixableWarningCount ?? 0;
+  }
+
+  if (errorCount || warningCount) {
+    const summary = (text) => paint(paint(text, 1, 22), errorCount ? 31 : 33, 39);
+    lines.push(summary(
+      `✖ ${pluralize(errorCount + warningCount, "problem")} (${pluralize(errorCount, "error")}, ${pluralize(warningCount, "warning")})`
+    ));
+    if (fixableErrorCount || fixableWarningCount) {
+      lines.push(summary(
+        `  ${pluralize(fixableErrorCount, "error")} and ${pluralize(fixableWarningCount, "warning")} potentially fixable with the \`--fix\` option.`
+      ));
+    }
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+function pluralize(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+
+function shouldUseColor(options) {
+  if (typeof options.color === "boolean") return options.color;
+  const env = options.env ? { ...process.env, ...options.env } : process.env;
+  if (env.NO_COLOR !== undefined || env.NODE_DISABLE_COLORS !== undefined) return false;
+  if (env.FORCE_COLOR !== undefined) return env.FORCE_COLOR !== "0";
+  if (env.CLICOLOR_FORCE && env.CLICOLOR_FORCE !== "0") return true;
+  return env.TERM !== "dumb" && Boolean(process.stdout.isTTY);
+}
+
+module.exports = { formatESLintResults };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/lint",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "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.6",
-    "@utoo/lint-darwin-x64": "0.3.6",
-    "@utoo/lint-linux-arm64": "0.3.6",
-    "@utoo/lint-linux-x64": "0.3.6",
-    "@utoo/lint-win32-x64": "0.3.6"
+    "@utoo/lint-darwin-arm64": "0.3.8",
+    "@utoo/lint-darwin-x64": "0.3.8",
+    "@utoo/lint-linux-arm64": "0.3.8",
+    "@utoo/lint-linux-x64": "0.3.8",
+    "@utoo/lint-win32-x64": "0.3.8"
   },
   "dependencies": {
     "@eslint/eslintrc": "2.1.4",