@santi020k/eslint-config-basic 2.1.1 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @santi020k/eslint-config-basic
 
+## 3.0.0
+
+### Major Changes
+
+- Make the lean dependency model the default. Framework and integration config
+  packages are optional peers instead of hard dependencies.
+- Add `@santi020k/eslint-config-basic/recommended` for a one-line zero-config
+  `eslint.config.*` file.
+- Move integration factory exports to
+  `@santi020k/eslint-config-integrations`; the new
+  `@santi020k/eslint-config-full` package re-exports the batteries-included API.
+- Make `Preset.Basic` dependency-free beyond core and TypeScript support.
+- Make `basic-eslint init` generate the one-line recommended config.
+
+See the [v2 to v3 migration guide](https://eslint.santi020k.com/guide/migration-v2-to-v3/).
+
 ## 2.1.1
 
 ### Patch Changes

package/README.md

@@ -1,11 +1,19 @@
 # @santi020k/eslint-config-basic
 
-The primary entry point that composes all feature-specific configurations.
+The lean v3 default for ESLint 10 flat config.
 
-This package is part of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
+```sh
+npm install -D eslint @santi020k/eslint-config-basic
+```
 
-- Docs: [Main package](https://eslint.santi020k.com/packages/basic)
-- Repository: [santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
-- Author: [santi020k](https://santi020k.com)
+```js
+export { default } from '@santi020k/eslint-config-basic/recommended'
+```
 
-The canonical documentation lives on the Starlight site, so this README intentionally stays short to avoid duplication.
+Add only the framework packages and `@santi020k/eslint-config-integrations`
+that the project uses. Choose `@santi020k/eslint-config-full` for the
+batteries-included dependency model.
+
+- [Documentation](https://eslint.santi020k.com/)
+- [Migration from v2](https://eslint.santi020k.com/guide/migration-v2-to-v3/)
+- [Repository](https://github.com/santi020k/eslint-config-basic)

package/dist/agent-skill-generator.js

@@ -105,6 +105,9 @@ const FEATURE_MAP = [
   ["eslint-config-preact/", "frameworks", "Preact"],
   ["eslint-config-slidev/", "frameworks", "Slidev"],
   ["eslint-config-vite/", "frameworks", "Vite"],
+  // Extensions
+  ["eslint-config-integrations/astro-doctor", "extensions", "Astro Doctor"],
+  ["astro-doctor/", "extensions", "Astro Doctor"],
   // Testing
   ["integrations/vitest", "testing", "Vitest"],
   ["integrations/jest", "testing", "Jest"],

package/dist/cli.js

@@ -56,6 +56,7 @@ const FRAMEWORK_KEY_TO_PACKAGE = Object.fromEntries(
 );
 const LITE_PACKAGE_NAME = "@santi020k/eslint-config-lite";
 const INTEGRATIONS_PACKAGE_NAME = "@santi020k/eslint-config-integrations";
+const ASTRO_DOCTOR_PACKAGE_NAME = "@santi020k/eslint-plugin-astro-doctor";
 const TYPESCRIPT_PACKAGE_NAME = "typescript";
 const getConfigPathIfPresent = (cwd) => {
   const configPath = [
@@ -177,39 +178,8 @@ const detectWorkspaceProjects = (cwd) => {
   ];
   return [...new Set(patterns.flatMap((pattern) => expandWorkspacePattern(cwd, pattern)))].sort();
 };
-const getDetectionValues = (options) => ({
-  extensions: options.extensions ?? [],
-  formats: options.formats ?? [],
-  libraries: options.libraries ?? [],
-  runtime: options.runtime ?? "universal",
-  settings: options.settings ?? [],
-  testing: options.testing ?? [],
-  tools: options.tools ?? [],
-  typescript: options.typescript ?? false
-});
 const createConfigContent = (cwd) => {
-  const options = detectProjectOptions(cwd);
-  const values = getDetectionValues(options);
-  const frameworkKeys = getFrameworkKeys(options.detectedFrameworks);
-  const imports = ["import { eslintConfig } from '@santi020k/eslint-config-basic'"];
-  const presetLine = options.preset && options.preset !== "basic" ? `  preset: ${JSON.stringify(options.preset)},
-` : "";
-  const configContent = `${imports.join("\n")}
-
-export default await eslintConfig({
-${presetLine}  typescript: ${JSON.stringify(values.typescript)},
-  frameworks: {
-    ${frameworkKeys.map((key) => `${toPropertyKey(key)}: true`).join(",\n    ")}
-  },
-  libraries: ${JSON.stringify(values.libraries, null, 2)},
-  testing: ${JSON.stringify(values.testing, null, 2)},
-  formats: ${JSON.stringify(values.formats, null, 2)},
-  tools: ${JSON.stringify(values.tools, null, 2)},
-  extensions: ${JSON.stringify(values.extensions, null, 2)},
-  runtime: ${JSON.stringify(values.runtime)},
-  settings: ${JSON.stringify(values.settings, null, 2)}
-})
-`;
+  const configContent = "export { default } from '@santi020k/eslint-config-basic/recommended'\n";
   return {
     configContent,
     configPath: resolveConfigPath(cwd)
@@ -284,9 +254,9 @@ const printUsage = () => {
     "Commands:",
     "  init            Create eslint.config.js/mjs if missing",
     "  update          Regenerate eslint.config.js/mjs from detection",
-    "  explain         Print detected v2 config inputs",
+    "  explain         Print detected v3 config inputs",
     "  inspect         Print detected inputs and active config features",
-    "  doctor          Check project setup for common v2 adoption issues",
+    "  doctor          Check project setup for common v3 adoption issues",
     "  docs            Generate ESLINT_STANDARDS.md from detection",
     "  migrate         Report v1-to-v2 migration suggestions",
     "  generate-skill  Generate AI agent standards files",
@@ -386,6 +356,58 @@ const handleInspect = async (cwd = process.cwd(), json = false) => {
     `- Workspace projects: ${formatList(summary.workspaceProjects)}`
   ].join("\n"));
 };
+const semver = createRequire(import.meta.url)("semver");
+const readPackageMetadataFromMain = (mainPath, packageName) => {
+  let directory = dirname(mainPath);
+  for (let depth = 0; depth < 4; depth++) {
+    const packagePath = join(directory, "package.json");
+    if (existsSync(packagePath)) {
+      const metadata = JSON.parse(readFileSync(packagePath, "utf8"));
+      if (metadata.name === packageName) return metadata;
+    }
+    directory = dirname(directory);
+  }
+  return null;
+};
+const resolvePackageMetadata = (cwd, packageName) => {
+  try {
+    const projectRequire = createRequire(join(cwd, "package.json"));
+    try {
+      return readPackageMetadataFromMain(projectRequire.resolve(packageName), packageName);
+    } catch {
+      const integrationsMain = projectRequire.resolve(INTEGRATIONS_PACKAGE_NAME);
+      const integrationsRequire = createRequire(integrationsMain);
+      return readPackageMetadataFromMain(integrationsRequire.resolve(packageName), packageName);
+    }
+  } catch {
+    return null;
+  }
+};
+const getAstroDoctorNodeWarning = (metadata) => {
+  const nodeRange = metadata.engines?.node;
+  if (!nodeRange || semver.satisfies(process.versions.node, nodeRange)) return null;
+  return `Astro Doctor ${metadata.version ?? ""} requires Node ${nodeRange}, but the current runtime is ${process.versions.node}.`;
+};
+const getAstroDoctorEslintWarning = (metadata, eslintMetadata) => {
+  const eslintRange = metadata.peerDependencies?.eslint;
+  const eslintVersion = eslintMetadata?.version;
+  if (!eslintRange || !eslintVersion || semver.satisfies(eslintVersion, eslintRange)) return null;
+  return `Astro Doctor ${metadata.version ?? ""} requires ESLint ${eslintRange}, but this project resolves ${eslintVersion}.`;
+};
+const getAstroDoctorCompatibilityWarnings = (cwd, enabled) => {
+  if (!enabled) return [];
+  const pluginMetadata = resolvePackageMetadata(cwd, ASTRO_DOCTOR_PACKAGE_NAME);
+  if (!pluginMetadata) {
+    return [
+      `Astro Doctor is enabled, but ${ASTRO_DOCTOR_PACKAGE_NAME} could not be resolved. Reinstall dependencies or disable the \`astro-doctor\` feature.`
+    ];
+  }
+  const eslintMetadata = resolvePackageMetadata(cwd, "eslint");
+  return [
+    getAstroDoctorNodeWarning(pluginMetadata),
+    getAstroDoctorEslintWarning(pluginMetadata, eslintMetadata)
+  ].filter((warning) => warning !== null);
+};
 const findDuplicateEslint = (cwd = process.cwd()) => {
   try {
     const projectRequire = createRequire(join(cwd, "package.json"));
@@ -430,7 +452,7 @@ const validateConfigContent = (configContent, hasV1FrameworkImports, declaredDep
   }
   return warnings;
 };
-const buildDoctorDiagnosis = (cwd, configPath, configContent, hasV1FrameworkImports, activeConfig, declaredDependencies, summary) => {
+const validateProjectSetup = (cwd, configPath, activeConfig, hasV1FrameworkImports) => {
   const issues = [];
   const warnings = [];
   if (!readPackageJson(cwd)) {
@@ -444,15 +466,47 @@ const buildDoctorDiagnosis = (cwd, configPath, configContent, hasV1FrameworkImpo
   if (!hasLintScript(cwd)) {
     warnings.push("No `lint` script found in package.json.");
   }
-  if (configContent) {
-    warnings.push(...validateConfigContent(configContent, hasV1FrameworkImports, declaredDependencies, summary));
+  return { issues, warnings };
+};
+const isAstroDoctorConfigured = (activeConfig, configContent) => [
+  activeConfig?.extensions.includes("Astro Doctor") ?? false,
+  configContent?.includes("astro-doctor") ?? false,
+  configContent?.includes("AstroDoctor") ?? false
+].includes(true);
+const isAstroConfigured = (activeConfig, summary) => [
+  activeConfig?.frameworks.includes("Astro") ?? false,
+  summary.frameworks.includes("astro")
+].some(Boolean);
+const checkAstroDoctorStatus = (activeConfig, configContent, summary, warnings) => {
+  const astroDoctorEnabled = isAstroDoctorConfigured(activeConfig, configContent);
+  const astroEnabled = isAstroConfigured(activeConfig, summary);
+  if (astroDoctorEnabled && !astroEnabled) {
+    warnings.push(
+      "Astro Doctor is enabled without Astro. Enable `frameworks: { astro: true }` or remove the `astro-doctor` feature."
+    );
+  } else if (astroEnabled && !astroDoctorEnabled) {
+    warnings.push(
+      'Astro was detected without Astro Doctor. Enable `features: { "astro-doctor": true }` for additional Astro diagnostics.'
+    );
   }
+  return astroDoctorEnabled;
+};
+const checkDuplicateEslint = (cwd, warnings) => {
   const duplicateEslint = findDuplicateEslint(cwd);
   if (duplicateEslint) {
     warnings.push(
       `Two ESLint copies are installed: the project resolves ${duplicateEslint.projectVersion} while the config packages resolve ${duplicateEslint.configVersion}. Only ESLint 10 is supported, and parallel copies can apply different rule behavior between your editor and CLI. Align the project's eslint version with the config's (or dedupe via your package manager).`
     );
   }
+};
+const buildDoctorDiagnosis = (cwd, configPath, configContent, hasV1FrameworkImports, activeConfig, declaredDependencies, summary) => {
+  const { issues, warnings } = validateProjectSetup(cwd, configPath, activeConfig, hasV1FrameworkImports);
+  if (configContent) {
+    warnings.push(...validateConfigContent(configContent, hasV1FrameworkImports, declaredDependencies, summary));
+  }
+  const astroDoctorEnabled = checkAstroDoctorStatus(activeConfig, configContent, summary, warnings);
+  warnings.push(...getAstroDoctorCompatibilityWarnings(cwd, astroDoctorEnabled));
+  checkDuplicateEslint(cwd, warnings);
   return { issues, warnings };
 };
 const outputDoctorResult = (json, configPath, packageManager, summary, liteInstallCommand, issues, warnings) => {
@@ -547,7 +601,7 @@ const processConfigMigration = (configPath, write, suggestions) => {
     const backupPath = `${configPath}.bak`;
     writeFileSync(backupPath, configContent);
     writeFileSync(configPath, result.content);
-    const message = `Rewrote ${basename(configPath)} with v2 framework booleans: ${result.frameworks.join(", ")}. Original backed up to ${basename(backupPath)}.`;
+    const message = `Rewrote ${basename(configPath)} with framework booleans: ${result.frameworks.join(", ")}. Original backed up to ${basename(backupPath)}.`;
     applied.push(message);
     suggestions.push(`- ${message}`);
   } else {
@@ -562,8 +616,8 @@ const handleMigrate = (cwd = process.cwd(), write = false, json = false) => {
     "- Install only @santi020k/eslint-config-basic for the public config API.",
     "- Replace framework imports with bundled booleans such as frameworks: { react: true, next: true }.",
     "- Remove app-level @santi020k/eslint-config-react/next/vue/etc. config package imports.",
-    "- Try eslintConfig() first; v2 auto-detects supported frameworks and integrations.",
-    "- Use basic-eslint explain to review what v2 detects before committing the migration."
+    "- Try eslintConfig() first; v3 auto-detects supported frameworks and integrations.",
+    "- Use basic-eslint explain to review what v3 detects before committing the migration."
   ];
   const applied = processConfigMigration(configPath, write, suggestions);
   if (json) {

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 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, 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 { 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 { a11y, aiSdk, autogen, bestPractices, biome, boundaries, command, compat, cspell, css, cypress, deMorgan, depend, docker, drizzle, githubActions, googleGenAi, graphql, html, i18next, jest, jestDom, jsdoc, jsonc, langchain, llamaIndex, markdown, mastra, mcp, mdx, mikroOrm, noOnlyTests, node, nx, openAiAgents, oxlint, packageJson, perfectionist, playwright, pnpm, prettier, prisma, regexp, security, sequelize, sonarjs, stencil, storybook, swagger, tailwind, tanstackQuery, tanstackRouter, testingLibrary, toml, turbo, typeorm, unicorn, vitest, yaml, zod } from '@santi020k/eslint-config-integrations';
 export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript';
 
 /**

package/dist/index.js

@@ -16,6 +16,7 @@ import {
   Library,
   mergeFrameworkOption,
   mergeOptionalBucket,
+  mergeProjectOptions,
   NextMode,
   patchImportGroups,
   Preset,
@@ -26,11 +27,11 @@ import {
   Setting,
   Testing
 } from "@santi020k/eslint-config-core";
-import { tailwind as tailwindIntegration } from "@santi020k/eslint-config-integrations";
 import { createTypescriptConfig } from "@santi020k/eslint-config-typescript";
 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,
@@ -87,109 +88,20 @@ import {
   Testing as Testing2,
   Tool
 } from "@santi020k/eslint-config-core";
-import {
-  a11y,
-  aiSdk,
-  autogen,
-  bestPractices,
-  biome,
-  boundaries,
-  command,
-  compat,
-  cspell,
-  css,
-  cypress,
-  deMorgan,
-  depend,
-  docker,
-  drizzle,
-  githubActions,
-  googleGenAi,
-  graphql,
-  html,
-  i18next,
-  jest,
-  jestDom,
-  jsdoc,
-  jsonc,
-  langchain,
-  llamaIndex,
-  markdown,
-  mastra,
-  mcp,
-  mdx,
-  mikroOrm,
-  node,
-  noOnlyTests,
-  nx,
-  openAiAgents,
-  oxlint,
-  packageJson,
-  perfectionist,
-  playwright,
-  pnpm,
-  prettier,
-  prisma,
-  regexp,
-  security,
-  sequelize,
-  sonarjs,
-  stencil,
-  storybook,
-  swagger,
-  tailwind,
-  tanstackQuery,
-  tanstackRouter,
-  testingLibrary,
-  toml,
-  turbo,
-  typeorm,
-  unicorn,
-  vitest,
-  yaml,
-  zod
-} from "@santi020k/eslint-config-integrations";
 import { tsConfig, typescriptConfig } from "@santi020k/eslint-config-typescript";
-const buildTailwindResult = (options, entryPoint) => ({
+const buildTailwindResult = (options, entryPoint, rootDir) => ({
+  cwd: options.cwd ?? rootDir,
   detectComponentClasses: options.detectComponentClasses ?? true,
   ...entryPoint ? { entryPoint } : {},
   ...options.ignore?.length ? { ignore: options.ignore } : {},
   ...options.noUnknownClasses === void 0 ? {} : { noUnknownClasses: options.noUnknownClasses }
 });
-const resolveTailwindOptions = (rootDir, tailwind2) => {
-  if (tailwind2 === false) return void 0;
-  const options = tailwind2 ?? {};
+const resolveTailwindOptions = (rootDir, tailwind) => {
+  if (tailwind === false) return void 0;
+  const options = tailwind ?? {};
   const entryPoint = options.entryPoint ?? findTailwindEntryPoint(rootDir);
-  if (!entryPoint && options.detectComponentClasses === void 0 && !options.ignore?.length && options.noUnknownClasses === void 0) return void 0;
-  return buildTailwindResult(options, entryPoint);
-};
-const createNoUnknownClassesRule = (tailwindOptions, unknownClassOptions, hasUnknownClassOptions) => {
-  if (!hasUnknownClassOptions && tailwindOptions.noUnknownClasses === void 0) return void 0;
-  const severity = tailwindOptions.noUnknownClasses ?? "error";
-  if (severity === false) return "off";
-  return hasUnknownClassOptions ? [severity, unknownClassOptions] : severity;
-};
-const loadTailwindPlugins = async () => {
-  const tailwindConfigs = await tailwindIntegration();
-  const pluginConfig = tailwindConfigs.find((config) => config.plugins?.["better-tailwindcss"]);
-  return pluginConfig?.plugins ?? {};
-};
-const createTailwindSettingsConfig = async (tailwindOptions) => {
-  const { noUnknownClasses: _noUnknownClasses, ...settingsOptions } = tailwindOptions;
-  const unknownClassOptions = {
-    ...tailwindOptions.entryPoint ? { entryPoint: tailwindOptions.entryPoint } : {},
-    ...tailwindOptions.ignore?.length ? { ignore: tailwindOptions.ignore } : {}
-  };
-  const hasUnknownClassOptions = Object.keys(unknownClassOptions).length > 0;
-  const noUnknownClassesRule = createNoUnknownClassesRule(tailwindOptions, unknownClassOptions, hasUnknownClassOptions);
-  return {
-    name: "eslint-config-basic/tailwind-settings",
-    plugins: await loadTailwindPlugins(),
-    ...noUnknownClassesRule === void 0 ? {} : { rules: { "better-tailwindcss/no-unknown-classes": noUnknownClassesRule } },
-    settings: {
-      "better-tailwindcss": settingsOptions
-    }
-  };
+  if (!entryPoint && options.cwd === void 0 && options.detectComponentClasses === void 0 && !options.ignore?.length && options.noUnknownClasses === void 0) return void 0;
+  return buildTailwindResult(options, entryPoint, rootDir);
 };
 const TESTING_CONFIG_NAMES = {
   [Testing.Cypress]: ["integrations/cypress"],
@@ -204,9 +116,7 @@ const applyTestingFileOverrides = (configs, testingFiles) => {
   const entries = Object.entries(testingFiles).filter(([, files]) => files.length > 0);
   if (entries.length === 0) return configs;
   return configs.map((config) => {
-    const match = entries.find(
-      ([testingName]) => (TESTING_CONFIG_NAMES[testingName] ?? []).includes(config.name ?? "")
-    );
+    const match = entries.find(([testingName]) => (TESTING_CONFIG_NAMES[testingName] ?? []).includes(config.name ?? ""));
     if (!match) return config;
     const [, files] = match;
     return {
@@ -221,10 +131,10 @@ const resolveConfigSetup = (options) => ({
   optionMergeStrategy: options?.optionMergeStrategy ?? "merge",
   requestedPreset: options?.preset
 });
-const resolveUniqueLibraries = (libraries, tailwind2) => {
+const resolveUniqueLibraries = (libraries, tailwind) => {
   const uniqueLibraries = [...new Set(libraries)];
-  if (tailwind2 === false) return uniqueLibraries.filter((library) => library !== Library.Tailwind);
-  if (!tailwind2) return uniqueLibraries;
+  if (tailwind === false) return uniqueLibraries.filter((library) => library !== Library.Tailwind);
+  if (!tailwind) return uniqueLibraries;
   return [.../* @__PURE__ */ new Set([...uniqueLibraries, Library.Tailwind])];
 };
 const resolvePresetMeta = (requestedPreset, detected, autoFrameworks) => {
@@ -270,19 +180,23 @@ const buildIgnoresConfig = (useDefaultIgnores, useGeneratedCodeIgnores, useGitig
   }] : []
 });
 const FRAMEWORK_EXTRA_OPTS = {
-  astro: (ctx) => ({ hasReact: ctx.hasReact, hasSolid: ctx.hasSolid, hasSvelte: ctx.hasSvelte, hasVue: ctx.hasVue }),
+  astro: (ctx) => ({
+    hasReact: ctx.hasReact,
+    hasSolid: ctx.hasSolid,
+    hasSvelte: ctx.hasSvelte,
+    hasVue: ctx.hasVue,
+    tsconfigRootDir: ctx.tsconfigRootDir
+  }),
   hono: (ctx) => ({ runtime: ctx.runtime }),
   slidev: (ctx) => ({ runtime: ctx.runtime }),
   vite: (ctx) => ({ runtime: ctx.runtime })
 };
 const resolveEnabledFrameworks = async (frameworks, ctx) => {
   const entries = await Promise.all(
-    Object.entries(frameworks).filter((entry) => Boolean(entry[1])).map(
-      ([name, value]) => (
-        // eslint-disable-next-line security/detect-object-injection
-        resolveFramework(name, value, FRAMEWORK_EXTRA_OPTS[name]?.(ctx)).then((config) => [name, config])
-      )
-    )
+    Object.entries(frameworks).filter((entry) => Boolean(entry[1])).map(([name, value]) => (
+      // eslint-disable-next-line security/detect-object-injection
+      resolveFramework(name, value, FRAMEWORK_EXTRA_OPTS[name]?.(ctx)).then((config) => [name, config])
+    ))
   );
   return Object.fromEntries(entries);
 };
@@ -308,7 +222,10 @@ const buildEslintConfigs = async (params) => {
     userIgnores
   } = params;
   const { hasReact, hasSolid, hasSvelte, hasVue } = astroOptions;
-  const fw = await resolveEnabledFrameworks(resolvedFrameworks, { hasReact, hasSolid, hasSvelte, hasVue, runtime });
+  const fw = await resolveEnabledFrameworks(
+    resolvedFrameworks,
+    { hasReact, hasSolid, hasSvelte, hasVue, runtime, tsconfigRootDir }
+  );
   const get = (name) => fw[name] ?? [];
   return [
     ...defaultIgnores,
@@ -373,7 +290,7 @@ const buildEslintConfigs = async (params) => {
         ...uniqueExtensions.includes(Extension.Security) ? { "security/detect-non-literal-fs-filename": "off" } : {}
       }
     },
-    ...tailwindOptions ? [await createTailwindSettingsConfig(tailwindOptions)] : [],
+    ...tailwindOptions ? [buildTailwindSettingsConfig(tailwindOptions)] : [],
     ...await getPrettierConfig(uniqueTools)
   ];
 };
@@ -417,6 +334,47 @@ const emitBasicWarnings = (options) => {
     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(
+    "[eslint-config-basic] Warning: Astro Doctor is enabled without the Astro framework config. Enable `frameworks: { astro: true }` or remove the `astro-doctor` feature."
+  );
+};
+const resolveProjectConfigs = async (configuredProjects, projectDefaults, detectRootDir, autoFrameworks) => Promise.all(
+  Object.entries(configuredProjects).map(async ([projectPath, projectOptions]) => {
+    const projectRoot = join(detectRootDir ?? process.cwd(), projectPath);
+    const inheritedOptions = mergeProjectOptions(projectDefaults ?? {}, projectOptions);
+    const scopedConfigs = await eslintConfig({
+      autoFrameworks,
+      ...inheritedOptions,
+      detectRootDir: inheritedOptions.detectRootDir ?? projectRoot,
+      projectDefaults: void 0,
+      projects: void 0,
+      tsconfigRootDir: inheritedOptions.tsconfigRootDir ?? projectRoot
+    });
+    return scopedConfigs.map((config) => scopeConfigToProject(config, projectPath));
+  })
+);
+const getConfigsParams = (options, rootDir, runtime, uniqueLibraries, uniqueSettings, resolvedFrameworks) => {
+  const hasReact = !!resolvedFrameworks.react;
+  const hasVue = !!resolvedFrameworks.vue;
+  const hasSvelte = !!resolvedFrameworks.svelte;
+  const hasSolid = !!resolvedFrameworks.solid;
+  const useGitignore = !uniqueSettings.includes(Setting.NoGitignore);
+  const useDefaultIgnores = !uniqueSettings.includes(Setting.NoDefaultIgnores);
+  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);
+  return {
+    astroOptions: { hasReact, hasSolid, hasSvelte, hasVue },
+    defaultIgnores,
+    gitignoreConfig,
+    runtimeCoreConfig,
+    tailwindOptions,
+    userIgnores
+  };
+};
 const eslintConfig = async (options, ...extraConfigs) => {
   emitBasicWarnings(options);
   const {
@@ -498,27 +456,19 @@ const eslintConfig = async (options, ...extraConfigs) => {
   const uniqueTools = [...new Set(tools)];
   const uniqueExtensions = [...new Set(extensions)];
   const uniqueSettings = [...new Set(settings)];
-  const hasReact = !!resolvedFrameworks.react;
-  const hasVue = !!resolvedFrameworks.vue;
-  const hasSvelte = !!resolvedFrameworks.svelte;
-  const hasSolid = !!resolvedFrameworks.solid;
-  const useGitignore = !uniqueSettings.includes(Setting.NoGitignore);
-  const useDefaultIgnores = !uniqueSettings.includes(Setting.NoDefaultIgnores);
-  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);
+  emitAstroDoctorWarning(uniqueExtensions, resolvedFrameworks);
+  const params = getConfigsParams(options, rootDir, runtime, uniqueLibraries, uniqueSettings, resolvedFrameworks);
   const configs = await buildEslintConfigs({
-    astroOptions: { hasReact, hasSolid, hasSvelte, hasVue },
-    defaultIgnores,
-    gitignoreConfig,
+    astroOptions: params.astroOptions,
+    defaultIgnores: params.defaultIgnores,
+    gitignoreConfig: params.gitignoreConfig,
     nextMode,
     resolvedFrameworks,
     resolvedTypescript,
     rootDir,
     runtime,
-    runtimeCoreConfig,
-    tailwindOptions,
+    runtimeCoreConfig: params.runtimeCoreConfig,
+    tailwindOptions: params.tailwindOptions,
     testingFiles: options?.testingFiles,
     tsconfigRootDir,
     uniqueExtensions,
@@ -526,7 +476,7 @@ const eslintConfig = async (options, ...extraConfigs) => {
     uniqueLibraries,
     uniqueTesting,
     uniqueTools,
-    userIgnores
+    userIgnores: params.userIgnores
   });
   logEslintDebug({
     autoFrameworks,
@@ -544,18 +494,11 @@ const eslintConfig = async (options, ...extraConfigs) => {
     uniqueTesting,
     uniqueTools
   });
-  const projectConfigs = await Promise.all(
-    Object.entries(configuredProjects).map(async ([projectPath, projectOptions]) => {
-      const projectRoot = join(detectRootDir ?? process.cwd(), projectPath);
-      const scopedConfigs = await eslintConfig({
-        autoFrameworks: options?.autoFrameworks,
-        ...projectOptions,
-        detectRootDir: projectOptions.detectRootDir ?? projectRoot,
-        projects: void 0,
-        tsconfigRootDir: projectOptions.tsconfigRootDir ?? projectRoot
-      });
-      return scopedConfigs.map((config) => scopeConfigToProject(config, projectPath));
-    })
+  const projectConfigs = await resolveProjectConfigs(
+    configuredProjects,
+    options?.projectDefaults,
+    detectRootDir,
+    options?.autoFrameworks
   );
   const allConfigs = [...configs, ...projectConfigs.flat(), ...flattenConfigInputs(extraConfigs)];
   const patchedConfigs = workspacePrefixes?.length ? patchImportGroups(allConfigs, workspacePrefixes) : allConfigs;
@@ -574,107 +517,47 @@ export {
   Setting2 as Setting,
   Testing2 as Testing,
   Tool,
-  a11y,
-  aiSdk,
   angular,
   angularConfig,
   astro,
-  autogen,
-  bestPractices,
-  biome,
-  boundaries,
-  command,
-  compat,
   coreConfig2 as coreConfig,
   createCoreConfig2 as createCoreConfig,
   createImportGroups,
-  cspell,
-  css,
-  cypress,
-  deMorgan,
   defineConfig,
-  depend,
   detectProjectOptions2 as detectProjectOptions,
-  docker,
-  drizzle,
   eslintConfig,
   expo,
   expoConfig,
   generateAgentSkills,
   generateSkillContent,
   getGlobalsForRuntime,
-  githubActions,
   gitignore2 as gitignore,
-  googleGenAi,
-  graphql,
   groups,
   hasReactConfig,
   hono,
-  html,
-  i18next,
-  jest,
-  jestDom,
   jsConfig,
-  jsdoc,
-  jsonc,
-  langchain,
   lit,
-  llamaIndex,
-  markdown,
-  mastra,
-  mcp,
-  mdx,
-  mikroOrm,
   nest,
   nestConfig,
   next,
   nextConfig,
-  noOnlyTests,
-  node,
   nuxt,
-  nx,
-  openAiAgents,
-  oxlint,
-  packageJson,
-  perfectionist,
-  playwright,
-  pnpm,
   preact,
   preactConfig,
-  prettier,
-  prisma,
   qwik,
   react,
   reactConfig,
   reactRouter,
-  regexp,
   remix,
-  security,
-  sequelize,
   slidev,
   solid,
   solidConfig,
-  sonarjs,
-  stencil,
-  storybook,
   svelte,
   svelteConfig,
-  swagger,
-  tailwind,
-  tanstackQuery,
-  tanstackRouter,
   tanstackStart,
-  testingLibrary,
-  toml,
   tsConfig,
-  turbo,
-  typeorm,
   typescriptConfig,
-  unicorn,
   vite,
-  vitest,
   vue,
-  vueConfig,
-  yaml,
-  zod
+  vueConfig
 };

package/dist/integrations.d.ts

@@ -1 +1,6 @@
-export { getIntegrationConfigs, getPrettierConfig } from '@santi020k/eslint-config-integrations';
+import { Library, Tool, Testing, Format, Extension, FlatConfigArray } from '@santi020k/eslint-config-core';
+
+declare const getIntegrationConfigs: (libraries: Library[], tools: Tool[], testing: Testing[], formats: Format[], extensions: Extension[]) => Promise<FlatConfigArray>;
+declare const getPrettierConfig: (tools: Tool[]) => Promise<FlatConfigArray>;
+
+export { getIntegrationConfigs, getPrettierConfig };

package/dist/integrations.js

@@ -1,4 +1,41 @@
-import { getIntegrationConfigs, getPrettierConfig } from "@santi020k/eslint-config-integrations";
+import {
+  createModuleLoader,
+  Tool
+} from "@santi020k/eslint-config-core";
+const loadModule = createModuleLoader((specifier) => import.meta.resolve(specifier, import.meta.url));
+let integrationsModule;
+const loadIntegrations = async () => {
+  integrationsModule ??= loadModule("@santi020k/eslint-config-integrations");
+  try {
+    return await integrationsModule;
+  } catch (error) {
+    integrationsModule = void 0;
+    throw new Error(
+      'Unable to load optional package "@santi020k/eslint-config-integrations". Install it for integrations, or remove the selected integration options.',
+      { cause: error }
+    );
+  }
+};
+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 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);
+};
 export {
   getIntegrationConfigs,
   getPrettierConfig

package/dist/recommended.d.ts

@@ -0,0 +1,5 @@
+import * as typescript_eslint from 'typescript-eslint';
+
+declare const _default: typescript_eslint.FlatConfig.ConfigArray;
+
+export { _default as default };

package/dist/recommended.js

@@ -0,0 +1,5 @@
+import { defineConfig } from "./index.js";
+var recommended_default = await defineConfig();
+export {
+  recommended_default as default
+};

package/dist/resolvers.js

@@ -47,12 +47,7 @@ const resolvePreset = (preset) => {
         typescript: true
       };
     case Preset.Basic:
-      return {
-        extensions: [Extension.Unicorn, Extension.Perfectionist, Extension.Security],
-        formats: [Format.Mdx, Format.Markdown, Format.Jsonc, Format.Yaml, Format.Toml],
-        runtime: Runtime.Universal,
-        tools: [Tool.Prettier]
-      };
+      return { runtime: Runtime.Universal };
     case Preset.Browser:
       return {
         runtime: Runtime.Browser,

package/dist/tailwind.d.ts

@@ -0,0 +1,6 @@
+import { TailwindOptions } from '@santi020k/eslint-config-core';
+import { TSESLint } from '@typescript-eslint/utils';
+
+declare const buildTailwindSettingsConfig: (tailwindOptions: TailwindOptions) => TSESLint.FlatConfig.Config;
+
+export { buildTailwindSettingsConfig };

package/dist/tailwind.js

@@ -0,0 +1,25 @@
+const buildTailwindSettingsConfig = (tailwindOptions) => {
+  const { noUnknownClasses, ...settingsOptions } = tailwindOptions;
+  const unknownClassOptions = {
+    ...tailwindOptions.entryPoint ? { entryPoint: tailwindOptions.entryPoint } : {},
+    ...tailwindOptions.ignore?.length ? { ignore: tailwindOptions.ignore } : {}
+  };
+  const hasUnknownClassOptions = Object.keys(unknownClassOptions).length > 0;
+  const severity = noUnknownClasses ?? "error";
+  let noUnknownClassesRule;
+  if (hasUnknownClassOptions || noUnknownClasses !== void 0) {
+    if (severity === false) {
+      noUnknownClassesRule = "off";
+    } else {
+      noUnknownClassesRule = hasUnknownClassOptions ? [severity, unknownClassOptions] : severity;
+    }
+  }
+  return {
+    name: "eslint-config-basic/tailwind-settings",
+    ...noUnknownClassesRule === void 0 ? {} : { rules: { "better-tailwindcss/no-unknown-classes": noUnknownClassesRule } },
+    settings: { "better-tailwindcss": settingsOptions }
+  };
+};
+export {
+  buildTailwindSettingsConfig
+};

package/package.json

@@ -1,20 +1,26 @@
 {
   "name": "@santi020k/eslint-config-basic",
-  "version": "2.1.1",
+  "version": "3.0.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "description": "A composable ESLint 10+ Flat Config package for JavaScript, TypeScript, React, Next.js, Vue, Nuxt, Svelte, Solid, Angular, Astro, Expo, NestJS, Hono, Preact, Qwik, React Router, TanStack Start, Lit, Vite, and Slidev.",
+  "description": "Lean, auto-detecting ESLint 10 flat config with opt-in framework and integration packages.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/recommended.js"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./recommended": {
+      "types": "./dist/recommended.d.ts",
+      "import": "./dist/recommended.js"
     }
   },
   "files": [
@@ -26,41 +32,122 @@
     "basic-eslint": "./dist/cli.js"
   },
   "dependencies": {
-    "@typescript-eslint/utils": "^8.61.1",
-    "@santi020k/eslint-config-angular": "^2.1.1",
-    "@santi020k/eslint-config-astro": "^2.1.1",
-    "@santi020k/eslint-config-core": "^2.1.1",
-    "@santi020k/eslint-config-expo": "^2.1.1",
-    "@santi020k/eslint-config-hono": "^2.1.1",
-    "@santi020k/eslint-config-integrations": "^2.1.1",
-    "@santi020k/eslint-config-lit": "^2.1.1",
-    "@santi020k/eslint-config-nest": "^2.1.1",
-    "@santi020k/eslint-config-next": "^2.1.1",
-    "@santi020k/eslint-config-nuxt": "^2.1.1",
-    "@santi020k/eslint-config-preact": "^2.1.1",
-    "@santi020k/eslint-config-qwik": "^2.1.1",
-    "@santi020k/eslint-config-react": "^2.1.1",
-    "@santi020k/eslint-config-react-router": "^2.1.1",
-    "@santi020k/eslint-config-remix": "^2.1.1",
-    "@santi020k/eslint-config-slidev": "^2.1.1",
-    "@santi020k/eslint-config-solid": "^2.1.1",
-    "@santi020k/eslint-config-svelte": "^2.1.1",
-    "@santi020k/eslint-config-tanstack-start": "^2.1.1",
-    "@santi020k/eslint-config-typescript": "^2.1.1",
-    "@santi020k/eslint-config-vite": "^2.1.1",
-    "@santi020k/eslint-config-vue": "^2.1.1"
+    "@typescript-eslint/utils": "^8.65.0",
+    "semver": "^7.8.5",
+    "@santi020k/eslint-config-core": "^3.0.0",
+    "@santi020k/eslint-config-typescript": "^3.0.0"
   },
   "devDependencies": {
-    "@types/node": "^26.0.0",
-    "publint": "^0.3.21",
+    "@types/node": "^26.1.1",
+    "publint": "^0.3.22",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.2",
+    "@santi020k/eslint-config-angular": "^3.0.0",
+    "@santi020k/eslint-config-astro": "^3.0.0",
+    "@santi020k/eslint-config-expo": "^3.0.0",
+    "@santi020k/eslint-config-hono": "^3.0.0",
+    "@santi020k/eslint-config-integrations": "^3.0.0",
+    "@santi020k/eslint-config-lit": "^3.0.0",
+    "@santi020k/eslint-config-nest": "^3.0.0",
+    "@santi020k/eslint-config-next": "^3.0.0",
+    "@santi020k/eslint-config-nuxt": "^3.0.0",
+    "@santi020k/eslint-config-preact": "^3.0.0",
+    "@santi020k/eslint-config-qwik": "^3.0.0",
+    "@santi020k/eslint-config-react": "^3.0.0",
+    "@santi020k/eslint-config-react-router": "^3.0.0",
+    "@santi020k/eslint-config-remix": "^3.0.0",
+    "@santi020k/eslint-config-slidev": "^3.0.0",
+    "@santi020k/eslint-config-solid": "^3.0.0",
+    "@santi020k/eslint-config-svelte": "^3.0.0",
+    "@santi020k/eslint-config-tanstack-start": "^3.0.0",
+    "@santi020k/eslint-config-vite": "^3.0.0",
+    "@santi020k/eslint-config-vue": "^3.0.0"
   },
   "peerDependencies": {
     "eslint": "^10.0.0",
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.0.0",
+    "@santi020k/eslint-config-angular": "^3.0.0",
+    "@santi020k/eslint-config-astro": "^3.0.0",
+    "@santi020k/eslint-config-expo": "^3.0.0",
+    "@santi020k/eslint-config-hono": "^3.0.0",
+    "@santi020k/eslint-config-integrations": "^3.0.0",
+    "@santi020k/eslint-config-lit": "^3.0.0",
+    "@santi020k/eslint-config-nest": "^3.0.0",
+    "@santi020k/eslint-config-next": "^3.0.0",
+    "@santi020k/eslint-config-nuxt": "^3.0.0",
+    "@santi020k/eslint-config-preact": "^3.0.0",
+    "@santi020k/eslint-config-qwik": "^3.0.0",
+    "@santi020k/eslint-config-react": "^3.0.0",
+    "@santi020k/eslint-config-react-router": "^3.0.0",
+    "@santi020k/eslint-config-remix": "^3.0.0",
+    "@santi020k/eslint-config-slidev": "^3.0.0",
+    "@santi020k/eslint-config-solid": "^3.0.0",
+    "@santi020k/eslint-config-svelte": "^3.0.0",
+    "@santi020k/eslint-config-tanstack-start": "^3.0.0",
+    "@santi020k/eslint-config-vite": "^3.0.0",
+    "@santi020k/eslint-config-vue": "^3.0.0"
   },
   "peerDependenciesMeta": {
+    "@santi020k/eslint-config-angular": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-astro": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-expo": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-hono": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-integrations": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-lit": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-nest": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-next": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-nuxt": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-preact": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-qwik": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-react": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-react-router": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-remix": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-slidev": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-solid": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-svelte": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-tanstack-start": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-vite": {
+      "optional": true
+    },
+    "@santi020k/eslint-config-vue": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     }