@santi020k/eslint-config-basic 3.0.0 → 3.2.0

package/dist/define-config-metadata.d.ts

@@ -0,0 +1,10 @@
+import { ConfigInput, EslintConfigOptions, FlatConfigArray } from '@santi020k/eslint-config-core';
+
+interface DefineConfigMetadata {
+    extraConfigs: ConfigInput[];
+    options?: EslintConfigOptions;
+}
+declare const attachDefineConfigMetadata: (config: FlatConfigArray, metadata: DefineConfigMetadata) => FlatConfigArray;
+declare const getDefineConfigMetadata: (config: unknown) => DefineConfigMetadata | undefined;
+
+export { type DefineConfigMetadata, attachDefineConfigMetadata, getDefineConfigMetadata };

package/dist/define-config-metadata.js

@@ -0,0 +1,18 @@
+const DEFINE_CONFIG_METADATA = /* @__PURE__ */ Symbol.for("@santi020k/eslint-config-basic/define-config-metadata");
+const attachDefineConfigMetadata = (config, metadata) => {
+  Object.defineProperty(config, DEFINE_CONFIG_METADATA, {
+    configurable: false,
+    enumerable: false,
+    value: metadata,
+    writable: false
+  });
+  return config;
+};
+const getDefineConfigMetadata = (config) => (
+  // eslint-disable-next-line security/detect-object-injection -- shared symbol is an internal fixed metadata key
+  Array.isArray(config) ? config[DEFINE_CONFIG_METADATA] : void 0
+);
+export {
+  attachDefineConfigMetadata,
+  getDefineConfigMetadata
+};

package/dist/frameworks.d.ts

@@ -30,29 +30,5 @@ declare const svelte: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
 declare const tanstackStart: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
 declare const vite: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
 declare const vue: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/**
- * @deprecated Remix merged into React Router v7. Use `reactRouter` (the
- * `react-router` framework key) instead. This alias loads the legacy Remix
- * config and will be removed in the next major version.
- */
-declare const remix: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `angular` instead. */
-declare const angularConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `expo` instead. */
-declare const expoConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `nest` instead. */
-declare const nestConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `next` instead. */
-declare const nextConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `preact` instead. */
-declare const preactConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `react` instead. */
-declare const reactConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `solid` instead. */
-declare const solidConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `svelte` instead. */
-declare const svelteConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
-/** @deprecated Use `vue` instead. */
-declare const vueConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
 
-export { type FrameworkFlags, type FrameworkName, type FrameworkOptions, angular, angularConfig, astro, createDetectedFrameworkFlags, expo, expoConfig, getBundledFrameworkConfig, hono, lit, nest, nestConfig, next, nextConfig, nuxt, preact, preactConfig, qwik, react, reactConfig, reactRouter, remix, slidev, solid, solidConfig, svelte, svelteConfig, tanstackStart, vite, vue, vueConfig };
+export { type FrameworkFlags, type FrameworkName, type FrameworkOptions, angular, astro, createDetectedFrameworkFlags, expo, getBundledFrameworkConfig, hono, lit, nest, next, nuxt, preact, qwik, react, reactRouter, slidev, solid, svelte, tanstackStart, vite, vue };

package/dist/frameworks.js

@@ -1,6 +1,7 @@
 import {
   createModuleLoader
 } from "@santi020k/eslint-config-core";
+import { isMissingRequestedPackage } from "./optional-package-errors.js";
 const loadModule = createModuleLoader((specifier) => import.meta.resolve(specifier, import.meta.url));
 const createDetectedFrameworkFlags = (detectedFrameworks = []) => Object.fromEntries(
   detectedFrameworks.map((framework) => [framework, true])
@@ -18,7 +19,6 @@ const frameworkLoaders = /* @__PURE__ */ new Map([
   ["qwik", async () => (await loadModule("@santi020k/eslint-config-qwik")).qwik],
   ["react", async () => (await loadModule("@santi020k/eslint-config-react")).reactConfig],
   ["react-router", async () => (await loadModule("@santi020k/eslint-config-react-router")).reactRouter],
-  ["remix", async () => (await loadModule("@santi020k/eslint-config-remix")).default],
   ["slidev", async () => (await loadModule("@santi020k/eslint-config-slidev")).slidev],
   ["solid", async () => (await loadModule("@santi020k/eslint-config-solid")).solidConfig],
   ["svelte", async () => (await loadModule("@santi020k/eslint-config-svelte")).svelteConfig],
@@ -34,8 +34,10 @@ const loadFrameworkConfigInput = (frameworkName) => {
   if (!loader) return Promise.resolve([]);
   const pending = loader().catch((error) => {
     frameworkConfigCache.delete(frameworkName);
+    const specifier = `@santi020k/eslint-config-${frameworkName}`;
+    const remediation = isMissingRequestedPackage(error, specifier) ? `Install "${specifier}" or remove that framework from your defineConfig options.` : `The installed package "${specifier}" failed while evaluating. Inspect this error's cause for the original dependency or runtime failure.`;
     throw new Error(
-      `Unable to load optional framework config "${frameworkName}". Install "@santi020k/eslint-config-${frameworkName}" or remove that framework from your eslintConfig options.`,
+      `Unable to load optional framework config "${frameworkName}". ` + remediation,
       { cause: error }
     );
   });
@@ -65,45 +67,25 @@ const svelte = createBundledFramework("svelte");
 const tanstackStart = createBundledFramework("tanstack-start");
 const vite = createBundledFramework("vite");
 const vue = createBundledFramework("vue");
-const remix = createBundledFramework("remix");
-const angularConfig = angular;
-const expoConfig = expo;
-const nestConfig = nest;
-const nextConfig = next;
-const preactConfig = preact;
-const reactConfig = react;
-const solidConfig = solid;
-const svelteConfig = svelte;
-const vueConfig = vue;
 export {
   angular,
-  angularConfig,
   astro,
   createDetectedFrameworkFlags,
   expo,
-  expoConfig,
   getBundledFrameworkConfig,
   hono,
   lit,
   nest,
-  nestConfig,
   next,
-  nextConfig,
   nuxt,
   preact,
-  preactConfig,
   qwik,
   react,
-  reactConfig,
   reactRouter,
-  remix,
   slidev,
   solid,
-  solidConfig,
   svelte,
-  svelteConfig,
   tanstackStart,
   vite,
-  vue,
-  vueConfig
+  vue
 };

package/dist/index.d.ts

@@ -1,9 +1,14 @@
-import { EslintConfigOptions, ConfigInput, FlatConfigArray } from '@santi020k/eslint-config-core';
-export { DetectedFrameworkName, DetectionOptions, EslintConfigOptions, Extension, ExtensionName, ExtensionOption, FlatConfigArray, Format, FormatName, FormatOption, ImportGroupOptions, ImportedFramework, Library, LibraryName, LibraryOption, NextMode, NextModeName, NextModeOption, OptionalConfigMap, OptionalConfigName, Preset, PresetName, PresetOption, ProjectConfigOptions, ReactConfigKeys, Runtime, RuntimeName, RuntimeOption, Setting, SettingName, SettingOption, StrictMode, Testing, TestingName, TestingOption, Tool, ToolName, ToolOption, TypeScriptMode, TypeScriptOptions, coreConfig, createCoreConfig, createImportGroups, detectProjectOptions, getGlobalsForRuntime, gitignore, groups, hasReactConfig, jsConfig } from '@santi020k/eslint-config-core';
-export { AGENT_TARGETS, AgentTarget, EslintConfigFeatures, GenerateSkillOptions, GenerateSkillResult, generateAgentSkills, generateSkillContent } from './agent-skill-generator.js';
-export { angular, angularConfig, astro, expo, expoConfig, hono, lit, nest, nestConfig, next, nextConfig, nuxt, preact, preactConfig, qwik, react, reactConfig, reactRouter, remix, slidev, solid, solidConfig, svelte, svelteConfig, tanstackStart, vite, vue, vueConfig } from './frameworks.js';
-export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript';
+import { FlatConfigArray, EslintConfigOptions, ConfigInput } from '@santi020k/eslint-config-core';
+export { DetectedFrameworkName, DetectionOptions, EslintConfigOptions, Extension, ExtensionName, ExtensionOption, FlatConfigArray, Format, FormatName, FormatOption, ImportGroupOptions, ImportedFramework, Library, LibraryName, LibraryOption, NextMode, NextModeName, NextModeOption, OptionalConfigMap, OptionalConfigName, Preset, PresetName, PresetOption, ProjectConfigOptions, ReactConfigKeys, Runtime, RuntimeName, RuntimeOption, Setting, SettingName, SettingOption, StrictMode, Testing, TestingName, TestingOption, Tool, ToolName, ToolOption, TypeScriptMode, TypeScriptOptions, coreConfig, createCoreConfig, createGitignoreConfig, createImportGroups, detectProjectOptions, getGlobalsForRuntime, groups, hasReactConfig } from '@santi020k/eslint-config-core';
+export { angular, astro, expo, hono, lit, nest, next, nuxt, preact, qwik, react, reactRouter, slidev, solid, svelte, tanstackStart, vite, vue } from './frameworks.js';
+export { typescriptConfig } from '@santi020k/eslint-config-typescript';
 
+/**
+ * Copies already-loaded plugin objects onto rule blocks that reference them.
+ * ESLint 10 validates plugin availability per effective config object, while
+ * feature packs often keep plugin setup and consumer overrides separate.
+ */
+declare const attachReferencedPlugins: (configs: FlatConfigArray) => FlatConfigArray;
 /**
  * Generates the ESLint configuration array, applying configurations
  * and integration settings based on the input configuration.
@@ -12,10 +17,6 @@ export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript'
  * @param {ConfigInput[]} extraConfigs - Local flat-config overrides appended after generated config
  * @returns {FlatConfigArray} The final ESLint configuration array
  */
-declare const eslintConfig: (options?: EslintConfigOptions, ...extraConfigs: ConfigInput[]) => Promise<FlatConfigArray>;
-/**
- * Alias for `eslintConfig()` that reads naturally in `eslint.config.*` files.
- */
 declare const defineConfig: (options?: EslintConfigOptions, ...extraConfigs: ConfigInput[]) => Promise<FlatConfigArray>;
 
-export { defineConfig, eslintConfig };
+export { attachReferencedPlugins, defineConfig };

package/dist/index.js

@@ -1,10 +1,12 @@
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import {
   applyDetectionControls,
   applyStrictMode,
   applyStrictProfileDefaults,
   coreConfig,
   createCoreConfig,
+  createGitignoreConfig,
   DEFAULT_IGNORES,
   detectProjectOptions,
   Extension,
@@ -12,7 +14,6 @@ import {
   flattenConfigInputs,
   GENERATED_CODE_IGNORES,
   getStrictMode,
-  gitignore,
   Library,
   mergeFrameworkOption,
   mergeOptionalBucket,
@@ -28,57 +29,42 @@ import {
   Testing
 } from "@santi020k/eslint-config-core";
 import { createTypescriptConfig } from "@santi020k/eslint-config-typescript";
+import { attachDefineConfigMetadata } from "./define-config-metadata.js";
 import { createDetectedFrameworkFlags } from "./frameworks.js";
 import { getIntegrationConfigs, getPrettierConfig } from "./integrations.js";
 import { resolveFramework, resolvePreset } from "./resolvers.js";
 import { buildTailwindSettingsConfig } from "./tailwind.js";
-import {
-  AGENT_TARGETS,
-  generateAgentSkills,
-  generateSkillContent
-} from "./agent-skill-generator.js";
 import {
   angular,
-  angularConfig,
   astro,
   expo,
-  expoConfig,
   hono,
   lit,
   nest,
-  nestConfig,
   next,
-  nextConfig,
   nuxt,
   preact,
-  preactConfig,
   qwik,
   react,
-  reactConfig,
   reactRouter,
-  remix,
   slidev,
   solid,
-  solidConfig,
   svelte,
-  svelteConfig,
   tanstackStart,
   vite,
-  vue,
-  vueConfig
+  vue
 } from "./frameworks.js";
 import {
   coreConfig as coreConfig2,
   createCoreConfig as createCoreConfig2,
+  createGitignoreConfig as createGitignoreConfig2,
   createImportGroups,
   detectProjectOptions as detectProjectOptions2,
   Extension as Extension2,
   Format,
   getGlobalsForRuntime,
-  gitignore as gitignore2,
   groups,
   hasReactConfig,
-  jsConfig,
   Library as Library2,
   NextMode as NextMode2,
   Preset as Preset2,
@@ -88,7 +74,7 @@ import {
   Testing as Testing2,
   Tool
 } from "@santi020k/eslint-config-core";
-import { tsConfig, typescriptConfig } from "@santi020k/eslint-config-typescript";
+import { typescriptConfig } from "@santi020k/eslint-config-typescript";
 const buildTailwindResult = (options, entryPoint, rootDir) => ({
   cwd: options.cwd ?? rootDir,
   detectComponentClasses: options.detectComponentClasses ?? true,
@@ -125,12 +111,52 @@ const applyTestingFileOverrides = (configs, testingFiles) => {
     };
   });
 };
-const resolveConfigSetup = (options) => ({
-  autoFrameworks: options?.autoFrameworks ?? true,
-  detectRootDir: options?.detectRootDir ?? options?.tsconfigRootDir,
-  optionMergeStrategy: options?.optionMergeStrategy ?? "merge",
-  requestedPreset: options?.preset
-});
+const ESLINT_CONFIG_FILENAMES = [
+  "eslint.config.js",
+  "eslint.config.cjs",
+  "eslint.config.mjs",
+  "eslint.config.ts",
+  "eslint.config.cts",
+  "eslint.config.mts"
+];
+const findConfigRootFromStack = (stack = new Error().stack) => {
+  if (!stack) return void 0;
+  for (const line of stack.split("\n")) {
+    const configFilename = ESLINT_CONFIG_FILENAMES.find((filename) => line.includes(filename));
+    if (!configFilename) continue;
+    const filenameStart = line.indexOf(configFilename);
+    const fileUrlStart = line.lastIndexOf("file://", filenameStart);
+    const windowsPathStart = line.slice(0, filenameStart).search(/[A-Za-z]:[\\/]/);
+    const absolutePathStart = line.indexOf("/");
+    let configPathStart = absolutePathStart;
+    if (windowsPathStart >= 0) configPathStart = windowsPathStart;
+    if (fileUrlStart >= 0) configPathStart = fileUrlStart;
+    try {
+      if (configPathStart < 0) continue;
+      const configPath = line.slice(configPathStart, filenameStart + configFilename.length);
+      return dirname(configPath.startsWith("file:") ? fileURLToPath(configPath) : configPath);
+    } catch {
+    }
+  }
+  return void 0;
+};
+const resolveConfigSetup = (options) => {
+  const {
+    autoFrameworks = true,
+    detectRootDir,
+    optionMergeStrategy = "merge",
+    preset: requestedPreset,
+    root,
+    tsconfigRootDir
+  } = options ?? {};
+  const implicitRootDir = root ?? detectRootDir ?? tsconfigRootDir ?? findConfigRootFromStack();
+  return {
+    autoFrameworks,
+    detectRootDir: implicitRootDir,
+    optionMergeStrategy,
+    requestedPreset
+  };
+};
 const resolveUniqueLibraries = (libraries, tailwind) => {
   const uniqueLibraries = [...new Set(libraries)];
   if (tailwind === false) return uniqueLibraries.filter((library) => library !== Library.Tailwind);
@@ -154,12 +180,26 @@ const resolveBucketDefaults = (detected) => ({
   detectedTesting: detected.testing ?? [],
   detectedTools: detected.tools ?? []
 });
+const scopeWorkspaceDetection = (detected, isWorkspace) => isWorkspace ? {
+  ...detected,
+  detectedFrameworks: [],
+  libraries: [],
+  nextMode: void 0,
+  runtime: Runtime.Universal
+} : detected;
+const resolveDetectedOptions = (detectRootDir, detection, requestedPreset) => {
+  const rawDetected = detectProjectOptions(detectRootDir);
+  const shouldDetectProjects = requestedPreset === Preset.Monorepo || rawDetected.preset === Preset.Monorepo;
+  const detected = applyDetectionControls(rawDetected, detection, { projects: shouldDetectProjects });
+  const hasDetectedProjects = Object.keys(detected.projects ?? {}).length > 0;
+  return scopeWorkspaceDetection(detected, hasDetectedProjects);
+};
 const resolveNextModeValue = (options, presetDefaults, detected) => options?.nextMode ?? presetDefaults.nextMode ?? detected.nextMode ?? NextMode.Pages;
 const resolveRuntimeValue = (options, presetDefaults, detected, usePresetRuntime) => options?.runtime ?? (usePresetRuntime ? presetDefaults.runtime : void 0) ?? detected.runtime ?? Runtime.Universal;
 const resolveSettingsValue = (options, detected) => options?.settings ?? detected.settings ?? [];
 const resolveTypescriptValue = (options, presetDefaults, detected) => options?.typescript ?? presetDefaults.typescript ?? detected.typescript ?? false;
 const needsReactAutoAdd = (frameworks) => Boolean(
-  frameworks.next ?? frameworks.expo ?? frameworks.remix ?? frameworks["react-router"] ?? (frameworks["tanstack-start"] && !frameworks.solid)
+  frameworks.next ?? frameworks.expo ?? frameworks["react-router"] ?? (frameworks["tanstack-start"] && !frameworks.solid)
 ) && !frameworks.react;
 const applyFrameworkImpliedDeps = (frameworks) => {
   const result = { ...frameworks };
@@ -168,12 +208,12 @@ const applyFrameworkImpliedDeps = (frameworks) => {
   if (result.nuxt && !result.vue) result.vue = true;
   return result;
 };
-const buildIgnoresConfig = (useDefaultIgnores, useGeneratedCodeIgnores, useGitignore, options) => ({
+const buildIgnoresConfig = (useDefaultIgnores, useGeneratedCodeIgnores, useGitignore, options, rootDir) => ({
   defaultIgnores: useDefaultIgnores ? [{
     ignores: [...DEFAULT_IGNORES, ...useGeneratedCodeIgnores ? GENERATED_CODE_IGNORES : []],
     name: "eslint-config-basic/default-ignores"
   }] : [],
-  gitignoreConfig: useGitignore ? gitignore : [],
+  gitignoreConfig: useGitignore ? createGitignoreConfig(rootDir) : [],
   userIgnores: options?.ignores?.length ? [{
     ignores: options.ignores,
     name: "eslint-config-basic/ignores"
@@ -227,6 +267,16 @@ const buildEslintConfigs = async (params) => {
     { hasReact, hasSolid, hasSvelte, hasVue, runtime, tsconfigRootDir }
   );
   const get = (name) => fw[name] ?? [];
+  const typescriptConfigs = resolvedTypescript ? createTypescriptConfig({
+    ...resolvedTypescript,
+    tsconfigRootDir: resolvedTypescript.tsconfigRootDir ?? tsconfigRootDir
+  }) : [];
+  const untypedTypescriptConfigs = typescriptConfigs.filter(
+    (config) => config.name === "eslint-config-typescript/untyped-files"
+  );
+  const typedTypescriptConfigs = typescriptConfigs.filter(
+    (config) => config.name !== "eslint-config-typescript/untyped-files"
+  );
   return [
     ...defaultIgnores,
     ...userIgnores,
@@ -260,7 +310,6 @@ const buildEslintConfigs = async (params) => {
     ...get("solid"),
     ...get("angular"),
     ...get("qwik"),
-    ...get("remix"),
     ...get("react-router"),
     ...get("tanstack-start"),
     ...get("nuxt"),
@@ -268,10 +317,7 @@ const buildEslintConfigs = async (params) => {
     ...get("lit"),
     ...get("slidev"),
     ...get("vite"),
-    ...resolvedTypescript ? createTypescriptConfig({
-      ...resolvedTypescript,
-      tsconfigRootDir: resolvedTypescript.tsconfigRootDir ?? tsconfigRootDir
-    }) : [],
+    ...typedTypescriptConfigs,
     ...get("astro"),
     ...resolvedFrameworks.next && nextMode === NextMode.AppRouter ? [{
       files: ["app/**/*.{ts,tsx}", "src/**/*.{ts,tsx}"],
@@ -291,6 +337,7 @@ const buildEslintConfigs = async (params) => {
       }
     },
     ...tailwindOptions ? [buildTailwindSettingsConfig(tailwindOptions)] : [],
+    ...untypedTypescriptConfigs,
     ...await getPrettierConfig(uniqueTools)
   ];
 };
@@ -329,11 +376,6 @@ const logEslintDebug = ({
   }, null, 2)}
 `);
 };
-const emitBasicWarnings = (options) => {
-  if (options?.frameworks && "remix" in options.frameworks) {
-    process.emitWarning('[eslint-config-basic] Warning: `frameworks.remix` is deprecated and will be removed in the next major. Please use `frameworks["react-router"]` instead.');
-  }
-};
 const emitAstroDoctorWarning = (extensions, frameworks) => {
   if (!extensions.includes(Extension.AstroDoctor) || frameworks.astro) return;
   process.emitWarning(
@@ -344,17 +386,62 @@ const resolveProjectConfigs = async (configuredProjects, projectDefaults, detect
   Object.entries(configuredProjects).map(async ([projectPath, projectOptions]) => {
     const projectRoot = join(detectRootDir ?? process.cwd(), projectPath);
     const inheritedOptions = mergeProjectOptions(projectDefaults ?? {}, projectOptions);
-    const scopedConfigs = await eslintConfig({
+    const scopedConfigs = await defineConfig({
       autoFrameworks,
       ...inheritedOptions,
-      detectRootDir: inheritedOptions.detectRootDir ?? projectRoot,
       projectDefaults: void 0,
       projects: void 0,
-      tsconfigRootDir: inheritedOptions.tsconfigRootDir ?? projectRoot
+      root: inheritedOptions.root ?? inheritedOptions.detectRootDir ?? projectRoot
     });
-    return scopedConfigs.map((config) => scopeConfigToProject(config, projectPath));
+    return scopedConfigs.map((config) => config.name === "eslint-config/gitignore" ? config : scopeConfigToProject(config, projectPath));
   })
 );
+const resolveInheritedProjectDefaults = (options) => mergeProjectOptions(
+  {
+    ...options?.detection === void 0 ? {} : { detection: options.detection },
+    ...options?.tailwind === void 0 ? {} : { tailwind: options.tailwind }
+  },
+  options?.projectDefaults ?? {}
+);
+const getPluginNameFromRule = (ruleName, availablePluginNames) => {
+  const segments = ruleName.split("/");
+  if (segments.length < 2) return void 0;
+  const registeredPrefix = [...availablePluginNames].filter((pluginName) => ruleName.startsWith(`${pluginName}/`)).sort((left, right) => right.length - left.length)[0];
+  if (registeredPrefix) return registeredPrefix;
+  return ruleName.startsWith("@") && segments.length > 2 ? segments.slice(0, 2).join("/") : segments[0];
+};
+const attachReferencedPlugins = (configs) => {
+  const availablePlugins = /* @__PURE__ */ new Map();
+  const ambiguousPluginNames = /* @__PURE__ */ new Set();
+  for (const config of configs) {
+    for (const [pluginName, plugin] of Object.entries(config.plugins ?? {})) {
+      const existingPlugin = availablePlugins.get(pluginName);
+      if (existingPlugin && existingPlugin !== plugin) {
+        availablePlugins.delete(pluginName);
+        ambiguousPluginNames.add(pluginName);
+      } else if (!ambiguousPluginNames.has(pluginName)) {
+        availablePlugins.set(pluginName, plugin);
+      }
+    }
+  }
+  return configs.map((config) => {
+    const requiredPlugins = new Set(
+      Object.keys(config.rules ?? {}).map((ruleName) => getPluginNameFromRule(ruleName, availablePlugins.keys())).filter((pluginName) => pluginName !== void 0)
+    );
+    const missingPluginEntries = [...requiredPlugins].flatMap((pluginName) => {
+      const plugin = availablePlugins.get(pluginName);
+      return !Object.hasOwn(config.plugins ?? {}, pluginName) && plugin ? [[pluginName, plugin]] : [];
+    });
+    if (missingPluginEntries.length === 0) return config;
+    return {
+      ...config,
+      plugins: {
+        ...config.plugins,
+        ...Object.fromEntries(missingPluginEntries)
+      }
+    };
+  });
+};
 const getConfigsParams = (options, rootDir, runtime, uniqueLibraries, uniqueSettings, resolvedFrameworks) => {
   const hasReact = !!resolvedFrameworks.react;
   const hasVue = !!resolvedFrameworks.vue;
@@ -365,7 +452,13 @@ const getConfigsParams = (options, rootDir, runtime, uniqueLibraries, uniqueSett
   const useGeneratedCodeIgnores = !uniqueSettings.includes(Setting.NoGeneratedCodeIgnores);
   const tailwindOptions = uniqueLibraries.includes(Library.Tailwind) ? resolveTailwindOptions(rootDir, options?.tailwind) : void 0;
   const runtimeCoreConfig = runtime === Runtime.Universal ? coreConfig : createCoreConfig(runtime);
-  const { defaultIgnores, gitignoreConfig, userIgnores } = buildIgnoresConfig(useDefaultIgnores, useGeneratedCodeIgnores, useGitignore, options);
+  const { defaultIgnores, gitignoreConfig, userIgnores } = buildIgnoresConfig(
+    useDefaultIgnores,
+    useGeneratedCodeIgnores,
+    useGitignore,
+    options,
+    rootDir
+  );
   return {
     astroOptions: { hasReact, hasSolid, hasSvelte, hasVue },
     defaultIgnores,
@@ -375,8 +468,7 @@ const getConfigsParams = (options, rootDir, runtime, uniqueLibraries, uniqueSett
     userIgnores
   };
 };
-const eslintConfig = async (options, ...extraConfigs) => {
-  emitBasicWarnings(options);
+const defineConfig = async (options, ...extraConfigs) => {
   const {
     detection,
     extensions: optExtensions,
@@ -390,12 +482,7 @@ const eslintConfig = async (options, ...extraConfigs) => {
     workspacePrefixes
   } = options ?? {};
   const { autoFrameworks, detectRootDir, optionMergeStrategy, requestedPreset } = resolveConfigSetup(options);
-  const shouldDefaultProjectDetection = requestedPreset === Preset.Monorepo;
-  const detected = applyDetectionControls(
-    detectProjectOptions(detectRootDir),
-    detection,
-    { projects: shouldDefaultProjectDetection }
-  );
+  const detected = resolveDetectedOptions(detectRootDir, detection, requestedPreset);
   const { frameworkDefaults, preset, presetDefaults } = resolvePresetMeta(requestedPreset, detected, autoFrameworks);
   const configuredProjects = resolveConfiguredProjects(detected, options);
   const { detectedExtensions, detectedFormats, detectedLibraries, detectedTesting, detectedTools } = resolveBucketDefaults(detected);
@@ -496,17 +583,16 @@ const eslintConfig = async (options, ...extraConfigs) => {
   });
   const projectConfigs = await resolveProjectConfigs(
     configuredProjects,
-    options?.projectDefaults,
+    resolveInheritedProjectDefaults(options),
     detectRootDir,
     options?.autoFrameworks
   );
   const allConfigs = [...configs, ...projectConfigs.flat(), ...flattenConfigInputs(extraConfigs)];
   const patchedConfigs = workspacePrefixes?.length ? patchImportGroups(allConfigs, workspacePrefixes) : allConfigs;
-  return applyStrictMode(patchedConfigs, strict);
+  const finalConfig = attachReferencedPlugins(applyStrictMode(patchedConfigs, strict));
+  return attachDefineConfigMetadata(finalConfig, { extraConfigs, options });
 };
-const defineConfig = eslintConfig;
 export {
-  AGENT_TARGETS,
   Extension2 as Extension,
   Format,
   Library2 as Library,
@@ -518,46 +604,32 @@ export {
   Testing2 as Testing,
   Tool,
   angular,
-  angularConfig,
   astro,
+  attachReferencedPlugins,
   coreConfig2 as coreConfig,
   createCoreConfig2 as createCoreConfig,
+  createGitignoreConfig2 as createGitignoreConfig,
   createImportGroups,
   defineConfig,
   detectProjectOptions2 as detectProjectOptions,
-  eslintConfig,
   expo,
-  expoConfig,
-  generateAgentSkills,
-  generateSkillContent,
   getGlobalsForRuntime,
-  gitignore2 as gitignore,
   groups,
   hasReactConfig,
   hono,
-  jsConfig,
   lit,
   nest,
-  nestConfig,
   next,
-  nextConfig,
   nuxt,
   preact,
-  preactConfig,
   qwik,
   react,
-  reactConfig,
   reactRouter,
-  remix,
   slidev,
   solid,
-  solidConfig,
   svelte,
-  svelteConfig,
   tanstackStart,
-  tsConfig,
   typescriptConfig,
   vite,
-  vue,
-  vueConfig
+  vue
 };

package/dist/integrations.js

@@ -1,40 +1,48 @@
 import {
   createModuleLoader,
-  Tool
+  resolveConfigFeatures
 } from "@santi020k/eslint-config-core";
+import { isMissingRequestedPackage } from "./optional-package-errors.js";
 const loadModule = createModuleLoader((specifier) => import.meta.resolve(specifier, import.meta.url));
-let integrationsModule;
-const loadIntegrations = async () => {
-  integrationsModule ??= loadModule("@santi020k/eslint-config-integrations");
+const packCache = /* @__PURE__ */ new Map();
+const loadFeaturePack = async (specifier) => {
+  let pending = packCache.get(specifier);
+  if (!pending) {
+    pending = loadModule(specifier);
+    packCache.set(specifier, pending);
+  }
   try {
-    return await integrationsModule;
+    const module = await pending;
+    if (!module.features) {
+      throw new Error(`Installed package "${specifier}" does not export a feature registry.`);
+    }
+    return module.features;
   } catch (error) {
-    integrationsModule = void 0;
+    packCache.delete(specifier);
+    const remediation = isMissingRequestedPackage(error, specifier) ? "Install it for the selected options, or remove those options from defineConfig()." : "The installed feature pack failed while evaluating. Inspect this error's cause for the original dependency or runtime failure.";
     throw new Error(
-      'Unable to load optional package "@santi020k/eslint-config-integrations". Install it for integrations, or remove the selected integration options.',
+      `Unable to load optional feature pack "${specifier}". ` + remediation,
       { cause: error }
     );
   }
 };
+const loadSelectedPacks = async (libraries, tools, testing, formats, extensions) => (await Promise.all([
+  extensions.length > 0 ? loadFeaturePack("@santi020k/eslint-config-extensions/registry") : [],
+  formats.length > 0 ? loadFeaturePack("@santi020k/eslint-config-formats/registry") : [],
+  libraries.length > 0 ? loadFeaturePack("@santi020k/eslint-config-libraries/registry") : [],
+  testing.length > 0 ? loadFeaturePack("@santi020k/eslint-config-testing/registry") : [],
+  tools.length > 0 ? loadFeaturePack("@santi020k/eslint-config-tools/registry") : []
+])).flat();
 const getIntegrationConfigs = async (libraries, tools, testing, formats, extensions) => {
-  if (libraries.length === 0 && tools.length === 0 && testing.length === 0 && formats.length === 0 && extensions.length === 0) return [];
-  const module = await loadIntegrations();
-  if (!module.getIntegrationConfigs) {
-    throw new Error(
-      'Installed "@santi020k/eslint-config-integrations" is incompatible. Update it to v3 or newer.'
-    );
-  }
-  return module.getIntegrationConfigs(libraries, tools, testing, formats, extensions);
+  const selected = [...libraries, ...tools, ...testing, ...formats, ...extensions];
+  if (selected.length === 0) return [];
+  const features = await loadSelectedPacks(libraries, tools, testing, formats, extensions);
+  return resolveConfigFeatures(features, selected);
 };
 const getPrettierConfig = async (tools) => {
-  if (!tools.includes(Tool.Prettier)) return [];
-  const module = await loadIntegrations();
-  if (!module.getPrettierConfig) {
-    throw new Error(
-      'Installed "@santi020k/eslint-config-integrations" is incompatible. Update it to v3 or newer.'
-    );
-  }
-  return module.getPrettierConfig(tools);
+  if (tools.length === 0) return [];
+  const features = await loadFeaturePack("@santi020k/eslint-config-tools/registry");
+  return resolveConfigFeatures(features, tools, "finalizer");
 };
 export {
   getIntegrationConfigs,

package/dist/optional-package-errors.d.ts

@@ -0,0 +1,3 @@
+declare const isMissingRequestedPackage: (error: unknown, specifier: string) => boolean;
+
+export { isMissingRequestedPackage };