@ttsc/lint 0.8.0-dev.20260505 → 0.8.0

package/plugin/config.go

@@ -6,6 +6,7 @@ import (
   "os"
   "os/exec"
   "path/filepath"
+  "sort"
   "strings"
 )
 
@@ -71,7 +72,170 @@ func FindLintEntry(entries []PluginEntry) (*PluginEntry, error) {
 // rule name (e.g. "no-var").
 type RuleConfig map[string]Severity
 
-// ParseRules normalizes the rules map from a tsconfig plugin entry.
+// ResolvedRuleConfig is the rule map that applies to one source file.
+// `Ignored` means an external ESLint-style ignore-only config matched the
+// file and the engine should skip linting it entirely.
+type ResolvedRuleConfig struct {
+  Rules   RuleConfig
+  Ignored bool
+}
+
+type RuleResolver interface {
+  ResolveRules(fileName string) ResolvedRuleConfig
+  ActiveRuleNames() []string
+  EnabledRuleConfig() RuleConfig
+}
+
+func (c RuleConfig) ResolveRules(string) ResolvedRuleConfig {
+  return ResolvedRuleConfig{Rules: c}
+}
+
+func (c RuleConfig) ActiveRuleNames() []string {
+  return sortedRuleNames(c, func(sev Severity) bool { return sev != SeverityOff })
+}
+
+func (c RuleConfig) EnabledRuleConfig() RuleConfig {
+  out := RuleConfig{}
+  for name, sev := range c {
+    if sev != SeverityOff {
+      out[name] = sev
+    }
+  }
+  return out
+}
+
+type ConfigStore struct {
+  entries               []ConfigEntry
+  externalConfigPath    string
+  eslintRuntime         bool
+  eslintRuntimeRequired bool
+}
+
+type ConfigEntry struct {
+  BaseDir    string
+  Files      []string
+  Ignores    []string
+  Rules      RuleConfig
+  IgnoreOnly bool
+}
+
+func (s *ConfigStore) ResolveRules(fileName string) ResolvedRuleConfig {
+  if s == nil {
+    return ResolvedRuleConfig{Rules: RuleConfig{}}
+  }
+  for _, entry := range s.entries {
+    if entry.IgnoreOnly && entry.matchesIgnores(fileName) {
+      return ResolvedRuleConfig{Rules: RuleConfig{}, Ignored: true}
+    }
+  }
+  out := RuleConfig{}
+  for _, entry := range s.entries {
+    if entry.IgnoreOnly || !entry.matchesFile(fileName) {
+      continue
+    }
+    for name, sev := range entry.Rules {
+      out[name] = sev
+    }
+  }
+  return ResolvedRuleConfig{Rules: out}
+}
+
+func (s *ConfigStore) ActiveRuleNames() []string {
+  if s == nil {
+    return nil
+  }
+  active := RuleConfig{}
+  for _, entry := range s.entries {
+    if entry.IgnoreOnly {
+      continue
+    }
+    for name, sev := range entry.Rules {
+      if sev != SeverityOff {
+        active[name] = sev
+      }
+    }
+  }
+  return sortedRuleNames(active, func(Severity) bool { return true })
+}
+
+func (s *ConfigStore) EnabledRuleConfig() RuleConfig {
+  out := RuleConfig{}
+  if s == nil {
+    return out
+  }
+  for _, entry := range s.entries {
+    if entry.IgnoreOnly {
+      continue
+    }
+    for name, sev := range entry.Rules {
+      if sev == SeverityOff {
+        continue
+      }
+      if out[name] != SeverityError {
+        out[name] = sev
+      }
+    }
+  }
+  return out
+}
+
+func (s *ConfigStore) Flatten() RuleConfig {
+  out := RuleConfig{}
+  if s == nil {
+    return out
+  }
+  for _, entry := range s.entries {
+    if entry.IgnoreOnly {
+      continue
+    }
+    for name, sev := range entry.Rules {
+      out[name] = sev
+    }
+  }
+  return out
+}
+
+func (s *ConfigStore) ExternalConfigPath() string {
+  if s == nil {
+    return ""
+  }
+  return s.externalConfigPath
+}
+
+func (s *ConfigStore) WantsESLintRuntime() bool {
+  if s == nil {
+    return false
+  }
+  if s.eslintRuntime {
+    return true
+  }
+  base := filepath.Base(s.externalConfigPath)
+  return strings.HasPrefix(base, "eslint.config.")
+}
+
+func (s *ConfigStore) RequiresESLintRuntime() bool {
+  if s == nil {
+    return false
+  }
+  return s.eslintRuntimeRequired
+}
+
+func (e ConfigEntry) matchesFile(fileName string) bool {
+  if len(e.Files) > 0 && !matchAnyPattern(e.BaseDir, e.Files, fileName) {
+    return false
+  }
+  if e.matchesIgnores(fileName) {
+    return false
+  }
+  return true
+}
+
+func (e ConfigEntry) matchesIgnores(fileName string) bool {
+  return len(e.Ignores) > 0 && matchAnyPattern(e.BaseDir, e.Ignores, fileName)
+}
+
+// ParseRules normalizes the standard native rules map from a tsconfig plugin
+// entry.
 //
 // Severity values:
 //   - `"off"` → SeverityOff
@@ -99,11 +263,257 @@ func ParseRules(raw any) (RuleConfig, error) {
   return out, nil
 }
 
+func parseExternalConfigRules(raw any) (RuleConfig, error) {
+  store, err := parseExternalConfigStore(raw, "")
+  if err != nil {
+    return nil, err
+  }
+  return store.Flatten(), nil
+}
+
+func parseExternalConfigStore(raw any, configDir string) (*ConfigStore, error) {
+  return parseExternalConfigStoreWithRuntimeMode(raw, configDir, false)
+}
+
+func parseExternalConfigStoreForFile(raw any, configDir string) (*ConfigStore, error) {
+  return parseExternalConfigStoreWithRuntimeMode(raw, configDir, true)
+}
+
+func parseExternalConfigStoreWithRuntimeMode(raw any, configDir string, allowRuntimeOnly bool) (*ConfigStore, error) {
+  store := &ConfigStore{}
+  if err := collectExternalConfigEntries(store, raw, configDir, "config", allowRuntimeOnly); err != nil {
+    return nil, err
+  }
+  return store, nil
+}
+
+func collectExternalConfigEntries(store *ConfigStore, raw any, baseDir, path string, allowRuntimeOnly bool) error {
+  if raw == nil {
+    return nil
+  }
+  switch typed := raw.(type) {
+  case []any:
+    for i, item := range typed {
+      if err := collectExternalConfigEntries(store, item, baseDir, fmt.Sprintf("%s[%d]", path, i), allowRuntimeOnly); err != nil {
+        return err
+      }
+    }
+    return nil
+  case map[string]any:
+    if isESLintConfigObject(typed) {
+      if marker, ok := typed["__ttscLintEslintRuntime"].(bool); ok && marker {
+        store.eslintRuntime = true
+        store.eslintRuntimeRequired = true
+      }
+      localBaseDir := baseDir
+      if rawBasePath, ok := typed["basePath"]; ok {
+        basePath, ok := rawBasePath.(string)
+        if !ok {
+          return fmt.Errorf("@ttsc/lint: %s.basePath must be a string, got %T", path, rawBasePath)
+        }
+        if filepath.IsAbs(basePath) {
+          localBaseDir = basePath
+        } else {
+          localBaseDir = filepath.Join(baseDir, basePath)
+        }
+      }
+      if hasESLintRuntimeFields(typed) {
+        store.eslintRuntime = true
+        store.eslintRuntimeRequired = true
+      }
+      if extended, ok := typed["extends"]; ok {
+        if err := collectExternalExtends(store, extended, localBaseDir, path+".extends", allowRuntimeOnly); err != nil {
+          return err
+        }
+      }
+      files, err := parsePatternList(typed["files"], path+".files")
+      if err != nil {
+        return err
+      }
+      ignores, err := parsePatternList(typed["ignores"], path+".ignores")
+      if err != nil {
+        return err
+      }
+      if rules, ok := typed["rules"]; ok {
+        parsed, err := parseExternalRuleMap(rules, path+".rules")
+        if err != nil {
+          return err
+        }
+        store.entries = append(store.entries, ConfigEntry{
+          BaseDir: localBaseDir,
+          Files:   files,
+          Ignores: ignores,
+          Rules:   parsed,
+        })
+        return nil
+      }
+      if len(files) == 0 && len(ignores) > 0 {
+        store.entries = append(store.entries, ConfigEntry{
+          BaseDir:    localBaseDir,
+          Ignores:    ignores,
+          IgnoreOnly: true,
+        })
+      }
+      return nil
+    }
+    parsed, err := parseExternalRuleMap(typed, path)
+    if err != nil {
+      return err
+    }
+    store.entries = append(store.entries, ConfigEntry{
+      BaseDir: baseDir,
+      Rules:   parsed,
+    })
+    return nil
+  default:
+    return fmt.Errorf("@ttsc/lint: %s must be an object or flat config array, got %T", path, raw)
+  }
+}
+
+func collectExternalExtends(store *ConfigStore, raw any, baseDir, path string, allowRuntimeOnly bool) error {
+  switch typed := raw.(type) {
+  case string:
+    if allowRuntimeOnly {
+      store.eslintRuntime = true
+      store.eslintRuntimeRequired = true
+      return nil
+    }
+    return fmt.Errorf("@ttsc/lint: %s must be an object or flat config array, got %T", path, raw)
+  case []any:
+    for i, item := range typed {
+      itemPath := fmt.Sprintf("%s[%d]", path, i)
+      if _, ok := item.(string); ok && allowRuntimeOnly {
+        store.eslintRuntime = true
+        store.eslintRuntimeRequired = true
+        continue
+      }
+      if err := collectExternalConfigEntries(store, item, baseDir, itemPath, allowRuntimeOnly); err != nil {
+        return err
+      }
+    }
+    return nil
+  default:
+    return collectExternalConfigEntries(store, raw, baseDir, path, allowRuntimeOnly)
+  }
+}
+
+func parseExternalRuleMap(raw any, path string) (RuleConfig, error) {
+  out := RuleConfig{}
+  if err := collectExternalRuleMap(out, raw, path); err != nil {
+    return nil, err
+  }
+  return out, nil
+}
+
+func collectExternalRuleMap(out RuleConfig, raw any, path string) error {
+  dict, ok := raw.(map[string]any)
+  if !ok {
+    return fmt.Errorf("@ttsc/lint: %s must be a rules object, got %T", path, raw)
+  }
+  for name, value := range dict {
+    sev, err := parseExternalSeverity(value)
+    if err != nil {
+      return fmt.Errorf("@ttsc/lint: rule %q: %w", name, err)
+    }
+    out[normalizeExternalRuleName(name)] = sev
+  }
+  return nil
+}
+
+func isESLintConfigObject(value map[string]any) bool {
+  for _, key := range []string{
+    "basePath",
+    "extends",
+    "files",
+    "ignores",
+    "languageOptions",
+    "linterOptions",
+    "name",
+    "plugins",
+    "processor",
+    "rules",
+    "settings",
+    "__ttscLintEslintRuntime",
+  } {
+    if _, ok := value[key]; ok {
+      return true
+    }
+  }
+  return false
+}
+
+func hasESLintRuntimeFields(value map[string]any) bool {
+  for _, key := range []string{
+    "languageOptions",
+    "linterOptions",
+    "plugins",
+    "processor",
+    "settings",
+  } {
+    if _, ok := value[key]; ok {
+      return true
+    }
+  }
+  return false
+}
+
+func normalizeExternalRuleName(name string) string {
+  name = strings.TrimPrefix(name, "@typescript-eslint/")
+  return strings.TrimPrefix(name, "typescript-eslint/")
+}
+
+func parsePatternList(raw any, path string) ([]string, error) {
+  if raw == nil {
+    return nil, nil
+  }
+  switch typed := raw.(type) {
+  case string:
+    if strings.TrimSpace(typed) == "" {
+      return nil, fmt.Errorf("@ttsc/lint: %s must not contain an empty pattern", path)
+    }
+    return []string{typed}, nil
+  case []any:
+    out := make([]string, 0, len(typed))
+    for i, item := range typed {
+      pattern, ok := item.(string)
+      if !ok {
+        return nil, fmt.Errorf("@ttsc/lint: %s[%d] must be a string, got %T", path, i, item)
+      }
+      if strings.TrimSpace(pattern) == "" {
+        return nil, fmt.Errorf("@ttsc/lint: %s[%d] must not be empty", path, i)
+      }
+      out = append(out, pattern)
+    }
+    return out, nil
+  default:
+    return nil, fmt.Errorf("@ttsc/lint: %s must be a string or string array, got %T", path, raw)
+  }
+}
+
 // LoadRuleConfig resolves the lint config for one plugin entry. The only
 // accepted lint-specific tsconfig key is `config`; it may be either an inline
 // rules object or a string path to a standalone config file. Relative config
 // paths are resolved from the tsconfig directory.
 func LoadRuleConfig(entry *PluginEntry, cwd, tsconfigPath string) (RuleConfig, error) {
+  resolver, err := LoadConfigResolver(entry, cwd, tsconfigPath)
+  if err != nil {
+    return nil, err
+  }
+  switch typed := resolver.(type) {
+  case RuleConfig:
+    return typed, nil
+  case *ConfigStore:
+    return typed.Flatten(), nil
+  default:
+    return resolver.EnabledRuleConfig(), nil
+  }
+}
+
+// LoadConfigResolver resolves one plugin entry into the engine-facing config
+// model. Inline `config` remains the native flat rule map. External config
+// files may carry ESLint flat-config-style file globs, ignores, object
+// extends, and rule severity tuples.
+func LoadConfigResolver(entry *PluginEntry, cwd, tsconfigPath string) (RuleResolver, error) {
   if entry == nil {
     return RuleConfig{}, nil
   }
@@ -119,18 +529,22 @@ func LoadRuleConfig(entry *PluginEntry, cwd, tsconfigPath string) (RuleConfig, e
 
   value, ok := inline["config"]
   if !ok {
-    return RuleConfig{}, nil
+    discovered, err := findESLintConfigFile(cwd, tsconfigPath)
+    if err != nil {
+      return nil, err
+    }
+    if discovered == "" {
+      return RuleConfig{}, nil
+    }
+    return loadExternalConfigResolver(discovered)
   }
   switch typed := value.(type) {
   case string:
     if strings.TrimSpace(typed) == "" {
       return nil, fmt.Errorf("@ttsc/lint: \"config\" must not be empty")
     }
-    rules, err := loadConfigFile(resolveConfigFilePath(typed, cwd, tsconfigPath))
-    if err != nil {
-      return nil, err
-    }
-    return ParseRules(rules)
+    location := resolveConfigFilePath(typed, cwd, tsconfigPath)
+    return loadExternalConfigResolver(location)
   case map[string]any:
     return ParseRules(typed)
   default:
@@ -138,6 +552,57 @@ func LoadRuleConfig(entry *PluginEntry, cwd, tsconfigPath string) (RuleConfig, e
   }
 }
 
+func loadExternalConfigResolver(location string) (RuleResolver, error) {
+  raw, err := loadConfigFile(location)
+  if err != nil {
+    return nil, err
+  }
+  store, err := parseExternalConfigStoreForFile(raw, filepath.Dir(location))
+  if err != nil {
+    return nil, err
+  }
+  store.externalConfigPath = location
+  return store, nil
+}
+
+func findESLintConfigFile(cwd, tsconfigPath string) (string, error) {
+  dir := cwd
+  if tsconfigPath != "" {
+    resolvedTsconfig := tsconfigPath
+    if !filepath.IsAbs(resolvedTsconfig) {
+      resolvedTsconfig = filepath.Join(cwd, resolvedTsconfig)
+    }
+    dir = filepath.Dir(resolvedTsconfig)
+  }
+  for {
+    matches := make([]string, 0, 1)
+    for _, name := range []string{
+      "eslint.config.js",
+      "eslint.config.mjs",
+      "eslint.config.cjs",
+      "eslint.config.ts",
+      "eslint.config.mts",
+      "eslint.config.cts",
+    } {
+      candidate := filepath.Join(dir, name)
+      if stat, err := os.Stat(candidate); err == nil && !stat.IsDir() {
+        matches = append(matches, candidate)
+      }
+    }
+    if len(matches) > 1 {
+      return "", fmt.Errorf("@ttsc/lint: multiple eslint config files found in %s; set \"config\" explicitly", dir)
+    }
+    if len(matches) == 1 {
+      return matches[0], nil
+    }
+    parent := filepath.Dir(dir)
+    if parent == dir {
+      return "", nil
+    }
+    dir = parent
+  }
+}
+
 func resolveConfigFilePath(configPath, cwd, tsconfigPath string) string {
   if filepath.IsAbs(configPath) {
     return configPath
@@ -153,7 +618,7 @@ func resolveConfigFilePath(configPath, cwd, tsconfigPath string) string {
   return filepath.Join(base, configPath)
 }
 
-func loadConfigFile(location string) (map[string]any, error) {
+func loadConfigFile(location string) (any, error) {
   ext := strings.ToLower(filepath.Ext(location))
   switch ext {
   case ".json":
@@ -167,22 +632,22 @@ func loadConfigFile(location string) (map[string]any, error) {
   }
 }
 
-func loadJSONConfigFile(location string) (map[string]any, error) {
+func loadJSONConfigFile(location string) (any, error) {
   body, err := os.ReadFile(location)
   if err != nil {
     return nil, fmt.Errorf("@ttsc/lint: read config file %s: %w", location, err)
   }
-  var out map[string]any
+  var out any
   if err := json.Unmarshal(body, &out); err != nil {
     return nil, fmt.Errorf("@ttsc/lint: parse config file %s: %w", location, err)
   }
-  if out == nil {
-    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object", location)
+  if !isConfigContainer(out) {
+    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object or flat config array", location)
   }
   return out, nil
 }
 
-func loadScriptConfigFile(location string) (map[string]any, error) {
+func loadScriptConfigFile(location string) (any, error) {
   const script = `
 const { pathToFileURL } = require("node:url");
 
@@ -190,14 +655,94 @@ const { pathToFileURL } = require("node:url");
   const mod = await import(pathToFileURL(process.argv[1]).href);
   const candidate = mod.default ?? mod.config ?? mod;
   const value = typeof candidate === "function" ? await candidate() : candidate;
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("config file must export an object");
+  if (value === null || typeof value !== "object") {
+    throw new Error("config file must export an object or flat config array");
   }
-  process.stdout.write(JSON.stringify(value));
+  process.stdout.write(JSON.stringify(toSerializableConfig(value)));
 })().catch((error) => {
   process.stderr.write(error && error.stack ? error.stack : String(error));
   process.exit(1);
 });
+
+function toSerializableConfig(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => toSerializableConfig(item));
+  }
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+  if (isESLintConfigObject(value)) {
+    const out = {};
+    if (hasESLintRuntimeFields(value)) {
+      out.__ttscLintEslintRuntime = true;
+    }
+    if (Object.prototype.hasOwnProperty.call(value, "basePath")) {
+      out.basePath = value.basePath;
+    }
+    if (Object.prototype.hasOwnProperty.call(value, "extends")) {
+      out.extends = toSerializableConfig(value.extends);
+    }
+    if (Object.prototype.hasOwnProperty.call(value, "files")) {
+      out.files = toSerializablePatterns(value.files, "files");
+    }
+    if (Object.prototype.hasOwnProperty.call(value, "ignores")) {
+      out.ignores = toSerializablePatterns(value.ignores, "ignores");
+    }
+    if (Object.prototype.hasOwnProperty.call(value, "rules")) {
+      out.rules = toSerializableRules(value.rules);
+    }
+    return out;
+  }
+  return { rules: toSerializableRules(value) };
+}
+
+function toSerializableRules(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("rules must be an object");
+  }
+  return Object.fromEntries(Object.entries(value));
+}
+
+function toSerializablePatterns(value, key) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item, index) => {
+      if (typeof item !== "string") {
+        throw new Error(key + "[" + index + "] must be a string");
+      }
+      return item;
+    });
+  }
+  throw new Error(key + " must be a string or string array");
+}
+
+function isESLintConfigObject(value) {
+  return [
+    "basePath",
+    "extends",
+    "files",
+    "ignores",
+    "languageOptions",
+    "linterOptions",
+    "name",
+    "plugins",
+    "processor",
+    "rules",
+    "settings",
+  ].some((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+
+function hasESLintRuntimeFields(value) {
+  return [
+    "languageOptions",
+    "linterOptions",
+    "plugins",
+    "processor",
+    "settings",
+  ].some((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
 `
   node := os.Getenv("TTSC_NODE_BINARY")
   if node == "" {
@@ -215,17 +760,17 @@ const { pathToFileURL } = require("node:url");
     }
     return nil, fmt.Errorf("@ttsc/lint: load config file %s: %w", location, err)
   }
-  var out map[string]any
+  var out any
   if err := json.Unmarshal(output, &out); err != nil {
     return nil, fmt.Errorf("@ttsc/lint: parse config file %s output: %w", location, err)
   }
-  if out == nil {
-    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object", location)
+  if !isConfigContainer(out) {
+    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object or flat config array", location)
   }
   return out, nil
 }
 
-func loadTypeScriptConfigFile(location string) (map[string]any, error) {
+func loadTypeScriptConfigFile(location string) (any, error) {
   tempDir, err := os.MkdirTemp("", "ttsc-lint-config-")
   if err != nil {
     return nil, fmt.Errorf("@ttsc/lint: create config loader tempdir: %w", err)
@@ -276,16 +821,25 @@ func loadTypeScriptConfigFile(location string) (map[string]any, error) {
     }
     return nil, fmt.Errorf("@ttsc/lint: load TypeScript config file %s: %w", location, err)
   }
-  var out map[string]any
+  var out any
   if err := json.Unmarshal(output, &out); err != nil {
     return nil, fmt.Errorf("@ttsc/lint: parse TypeScript config file %s output: %w", location, err)
   }
-  if out == nil {
-    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object", location)
+  if !isConfigContainer(out) {
+    return nil, fmt.Errorf("@ttsc/lint: config file %s must export an object or flat config array", location)
   }
   return out, nil
 }
 
+func isConfigContainer(value any) bool {
+  switch value.(type) {
+  case []any, map[string]any:
+    return true
+  default:
+    return false
+  }
+}
+
 func relativeImportSpecifier(fromDir, location string) (string, error) {
   relative, err := filepath.Rel(fromDir, location)
   if err != nil {
@@ -309,10 +863,10 @@ declare const process: {
 
 try {
   const value = await resolveConfig(importedConfig, true);
-  if (!isObject(value) || Array.isArray(value)) {
-    throw new Error("config file must export an object");
+  if (!isObject(value)) {
+    throw new Error("config file must export an object or flat config array");
   }
-  process.stdout.write(JSON.stringify(value));
+  process.stdout.write(JSON.stringify(toSerializableConfig(value)));
 } catch (error) {
   process.stderr.write(error instanceof Error && error.stack ? error.stack : String(error));
   process.exit(1);
@@ -346,6 +900,86 @@ function isObject(value: unknown): value is Record<string, unknown> {
 function hasOwn(value: Record<string, unknown>, key: string): boolean {
   return Object.prototype.hasOwnProperty.call(value, key);
 }
+
+function toSerializableConfig(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map((item) => toSerializableConfig(item));
+  }
+  if (!isObject(value)) {
+    return value;
+  }
+  if (isESLintConfigObject(value)) {
+    const out: Record<string, unknown> = {};
+    if (hasESLintRuntimeFields(value)) {
+      out.__ttscLintEslintRuntime = true;
+    }
+    if (hasOwn(value, "basePath")) {
+      out.basePath = value.basePath;
+    }
+    if (hasOwn(value, "extends")) {
+      out.extends = toSerializableConfig(value.extends);
+    }
+    if (hasOwn(value, "files")) {
+      out.files = toSerializablePatterns(value.files, "files");
+    }
+    if (hasOwn(value, "ignores")) {
+      out.ignores = toSerializablePatterns(value.ignores, "ignores");
+    }
+    if (hasOwn(value, "rules")) {
+      out.rules = toSerializableRules(value.rules);
+    }
+    return out;
+  }
+  return { rules: toSerializableRules(value) };
+}
+
+function toSerializableRules(value: unknown): Record<string, unknown> {
+  if (!isObject(value) || Array.isArray(value)) {
+    throw new Error("rules must be an object");
+  }
+  return Object.fromEntries(Object.entries(value));
+}
+
+function toSerializablePatterns(value: unknown, key: string): string | string[] {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item, index) => {
+      if (typeof item !== "string") {
+        throw new Error(key + "[" + index + "] must be a string");
+      }
+      return item;
+    });
+  }
+  throw new Error(key + " must be a string or string array");
+}
+
+function isESLintConfigObject(value: Record<string, unknown>): boolean {
+  return [
+    "basePath",
+    "extends",
+    "files",
+    "ignores",
+    "languageOptions",
+    "linterOptions",
+    "name",
+    "plugins",
+    "processor",
+    "rules",
+    "settings",
+  ].some((key) => hasOwn(value, key));
+}
+
+function hasESLintRuntimeFields(value: Record<string, unknown>): boolean {
+  return [
+    "languageOptions",
+    "linterOptions",
+    "plugins",
+    "processor",
+    "settings",
+  ].some((key) => hasOwn(value, key));
+}
 `, importLiteral)
 }
 
@@ -451,6 +1085,16 @@ func setEnv(env []string, key, value string) []string {
   return append(env, prefix+value)
 }
 
+func parseExternalSeverity(v any) (Severity, error) {
+  if tuple, ok := v.([]any); ok {
+    if len(tuple) == 0 {
+      return SeverityOff, fmt.Errorf("severity tuple must not be empty")
+    }
+    return parseSeverity(tuple[0])
+  }
+  return parseSeverity(v)
+}
+
 func parseSeverity(v any) (Severity, error) {
   switch x := v.(type) {
   case string:
@@ -462,7 +1106,7 @@ func parseSeverity(v any) (Severity, error) {
     case "error":
       return SeverityError, nil
     }
-    return SeverityOff, fmt.Errorf("unknown severity %q (want off | warning | error)", x)
+    return SeverityOff, fmt.Errorf("unknown severity %q (want off | warn | warning | error)", x)
   case float64:
     switch x {
     case 0:
@@ -472,9 +1116,96 @@ func parseSeverity(v any) (Severity, error) {
     case 2:
       return SeverityError, nil
     }
-    return SeverityOff, fmt.Errorf("unknown severity %v (want off | warning | error)", x)
+    return SeverityOff, fmt.Errorf("unknown severity %v (want 0 | 1 | 2)", x)
+  }
+  return SeverityOff, fmt.Errorf("severity must be one of: off | warn | warning | error | 0 | 1 | 2, got %T", v)
+}
+
+func sortedRuleNames(config RuleConfig, include func(Severity) bool) []string {
+  names := make([]string, 0, len(config))
+  for name, sev := range config {
+    if include(sev) {
+      names = append(names, name)
+    }
+  }
+  sort.Strings(names)
+  return names
+}
+
+func matchAnyPattern(baseDir string, patterns []string, fileName string) bool {
+  rel := filepath.ToSlash(fileName)
+  if baseDir != "" {
+    base := baseDir
+    if abs, err := filepath.Abs(base); err == nil {
+      base = abs
+    }
+    file := fileName
+    if abs, err := filepath.Abs(file); err == nil {
+      file = abs
+    }
+    if candidate, err := filepath.Rel(base, file); err == nil {
+      if candidate == ".." || strings.HasPrefix(candidate, ".."+string(filepath.Separator)) {
+        return false
+      }
+      rel = filepath.ToSlash(candidate)
+    }
+  }
+  rel = strings.TrimPrefix(rel, "./")
+  for _, pattern := range patterns {
+    if matchGlob(normalizeGlobPattern(pattern), rel) {
+      return true
+    }
+  }
+  return false
+}
+
+func normalizeGlobPattern(pattern string) string {
+  pattern = filepath.ToSlash(pattern)
+  pattern = strings.TrimPrefix(pattern, "./")
+  if !strings.Contains(pattern, "/") {
+    return "**/" + pattern
+  }
+  return pattern
+}
+
+func matchGlob(pattern, name string) bool {
+  pattern = strings.Trim(pattern, "/")
+  name = strings.Trim(name, "/")
+  if pattern == "" {
+    return name == ""
+  }
+  patternParts := strings.Split(pattern, "/")
+  nameParts := []string{}
+  if name != "" {
+    nameParts = strings.Split(name, "/")
+  }
+  return matchGlobParts(patternParts, nameParts)
+}
+
+func matchGlobParts(patternParts, nameParts []string) bool {
+  if len(patternParts) == 0 {
+    return len(nameParts) == 0
+  }
+  head := patternParts[0]
+  if head == "**" {
+    if matchGlobParts(patternParts[1:], nameParts) {
+      return true
+    }
+    for i := range nameParts {
+      if matchGlobParts(patternParts[1:], nameParts[i+1:]) {
+        return true
+      }
+    }
+    return false
+  }
+  if len(nameParts) == 0 {
+    return false
+  }
+  ok, err := filepath.Match(head, nameParts[0])
+  if err != nil || !ok {
+    return false
   }
-  return SeverityOff, fmt.Errorf("severity must be one of: off | warning | error, got %T", v)
+  return matchGlobParts(patternParts[1:], nameParts[1:])
 }
 
 // Severity returns the configured level for a rule, defaulting to