@santi020k/eslint-config-basic 3.1.0 → 3.2.0

package/dist/index.d.ts

@@ -1,8 +1,14 @@
-import { EslintConfigOptions, ConfigInput, FlatConfigArray } from '@santi020k/eslint-config-core';
+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.
@@ -13,4 +19,4 @@ export { typescriptConfig } from '@santi020k/eslint-config-typescript';
  */
 declare const defineConfig: (options?: EslintConfigOptions, ...extraConfigs: ConfigInput[]) => Promise<FlatConfigArray>;
 
-export { defineConfig };
+export { attachReferencedPlugins, defineConfig };

package/dist/index.js

@@ -29,6 +29,7 @@ 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";
@@ -266,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,
@@ -306,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}"],
@@ -329,6 +337,7 @@ const buildEslintConfigs = async (params) => {
       }
     },
     ...tailwindOptions ? [buildTailwindSettingsConfig(tailwindOptions)] : [],
+    ...untypedTypescriptConfigs,
     ...await getPrettierConfig(uniqueTools)
   ];
 };
@@ -387,6 +396,52 @@ const resolveProjectConfigs = async (configuredProjects, projectDefaults, detect
     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;
@@ -528,13 +583,14 @@ const defineConfig = 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 });
 };
 export {
   Extension2 as Extension,
@@ -549,6 +605,7 @@ export {
   Tool,
   angular,
   astro,
+  attachReferencedPlugins,
   coreConfig2 as coreConfig,
   createCoreConfig2 as createCoreConfig,
   createGitignoreConfig2 as createGitignoreConfig,

package/dist/integrations.js

@@ -2,6 +2,7 @@ import {
   createModuleLoader,
   resolveConfigFeatures
 } from "@santi020k/eslint-config-core";
+import { isMissingRequestedPackage } from "./optional-package-errors.js";
 const loadModule = createModuleLoader((specifier) => import.meta.resolve(specifier, import.meta.url));
 const packCache = /* @__PURE__ */ new Map();
 const loadFeaturePack = async (specifier) => {
@@ -18,8 +19,9 @@ const loadFeaturePack = async (specifier) => {
     return module.features;
   } catch (error) {
     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 feature pack "${specifier}". Install it for the selected options, or remove those options from defineConfig().`,
+      `Unable to load optional feature pack "${specifier}". ` + remediation,
       { cause: error }
     );
   }

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

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

package/dist/optional-package-errors.js

@@ -0,0 +1,14 @@
+const getPackageRoot = (specifier) => {
+  const segments = specifier.split("/");
+  return specifier.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+};
+const isMissingRequestedPackage = (error, specifier) => {
+  if (!(error instanceof Error)) return false;
+  const code = "code" in error ? String(error.code) : "";
+  if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") return false;
+  const missingSpecifier = /Cannot find (?:module|package) ['"]([^'"]+)['"]/.exec(error.message)?.[1];
+  return missingSpecifier !== void 0 && getPackageRoot(missingSpecifier) === getPackageRoot(specifier);
+};
+export {
+  isMissingRequestedPackage
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/eslint-config-basic",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -30,7 +30,8 @@
   "files": [
     "dist",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "IMPROVEMENTS.md"
   ],
   "bin": {
     "basic-eslint": "./dist/cli.js"
@@ -39,16 +40,16 @@
     "@typescript-eslint/utils": "^8.65.0",
     "semver": "^7.8.5",
     "@santi020k/eslint-config-core": "^3.1.0",
-    "@santi020k/eslint-config-typescript": "^3.1.0"
+    "@santi020k/eslint-config-typescript": "^3.1.1"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "publint": "^0.3.22",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "@santi020k/eslint-config-angular": "^3.1.0",
     "@santi020k/eslint-config-astro": "^3.1.0",
     "@santi020k/eslint-config-expo": "^3.1.0",
+    "@santi020k/eslint-config-angular": "^3.1.0",
     "@santi020k/eslint-config-extensions": "^3.1.0",
     "@santi020k/eslint-config-formats": "^3.1.0",
     "@santi020k/eslint-config-hono": "^3.1.0",
@@ -73,9 +74,9 @@
   "peerDependencies": {
     "eslint": "^10.0.0",
     "typescript": ">=5.0.0",
-    "@santi020k/eslint-config-angular": "^3.1.0",
     "@santi020k/eslint-config-astro": "^3.1.0",
     "@santi020k/eslint-config-expo": "^3.1.0",
+    "@santi020k/eslint-config-angular": "^3.1.0",
     "@santi020k/eslint-config-extensions": "^3.1.0",
     "@santi020k/eslint-config-formats": "^3.1.0",
     "@santi020k/eslint-config-hono": "^3.1.0",
@@ -93,9 +94,9 @@
     "@santi020k/eslint-config-svelte": "^3.1.0",
     "@santi020k/eslint-config-tanstack-start": "^3.1.0",
     "@santi020k/eslint-config-testing": "^3.1.0",
-    "@santi020k/eslint-config-tools": "^3.1.0",
     "@santi020k/eslint-config-vite": "^3.1.0",
-    "@santi020k/eslint-config-vue": "^3.1.0"
+    "@santi020k/eslint-config-vue": "^3.1.0",
+    "@santi020k/eslint-config-tools": "^3.1.0"
   },
   "peerDependenciesMeta": {
     "@santi020k/eslint-config-angular": {