@santi020k/eslint-config-basic 3.5.4 → 3.6.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @santi020k/eslint-config-basic
 
+## 3.6.0
+
+### Minor Changes
+
+- Preserve Node 22.19 support with compatible stable dependencies and deliver the maintained braces recursion guard in affected adapter artifacts. ESLint, GraphQL, and TypeScript remain consumer peers.
+
+- Add optional typed formatting preferences with workspace inheritance. Restrict Testing Library import heuristics in Playwright-owned scopes while retaining actual Testing Library checks and unit-test behavior.
+
+  Doctor now inventories local workspace lint declarations, reports sampled effective-config evidence for potentially redundant Astro workaround fields, and generates missing lint scripts with zero-warning enforcement. Existing scripts, defaults, and overrides remain unchanged.
+
+  Consumer regression fixtures cover mixed Astro/React workspaces, independently linted Expo apps with typed Astro scopes, Playwright/Testing Library coexistence, and React/Hono runtime scopes. No mandatory migration is required. For custom browser-test locations, configure `testingFiles.playwright`; review Doctor candidates across all affected globs before removing fields.
+
+- Refresh the supported dependency ecosystem and security overrides, preserve Zod integration defaults across the plugin upgrade, guarantee TypeScript parsing in Astro frontmatter, and improve the release gates and npm documentation.
+
+    The Basic README gains light/dark artwork, package selection guidance, and published asset/support links. The documentation site uses npm Lumen Astro 4 with accessible motion, contextual GitHub issue reporting, resilient browser feedback, responsive report output, and full-glyph WOFF2 fonts that substantially reduce transfer size.
+
+    Release preparation now accepts validated `release/v<stable-semver>` branches alongside Changesets-generated branches; both undergo source/version checks, complete preflight, and a dependency audit before publication.
+
+    Release verification now retains Node 24 and Windows compatibility checks on
+    release pull requests, runs Linux and macOS visual baselines plus Firefox/WebKit
+    navigation coverage, and verifies registry artifacts, provenance, release tags,
+    published consumer behavior, and live documentation after deployment.
+
+### Patch Changes
+
+- Center the documentation mobile menu and close icons, align utility controls, and clarify the open state with a subtle accented button surface.
+
+- Animate documentation mobile menu opening and closing with subtle icon and drawer transitions, including a brief blur and immediate reduced-motion states.
+
+- Fix narrow mobile header clipping, improve sidebar readability, and remove redundant spacing around the mobile table of contents.
+
+- Resolve generated Markdown reference links to published routes across current docs and frozen archives, preserving fragments and deployment base paths.
+
+- Clarify the v3.6.0 release candidate, upgrade verification, current troubleshooting, and shared editor and CI lint setup.
+- Updated dependencies [`ddaa3c8`]:
+  - @santi020k/eslint-config-core@3.2.0
+  - @santi020k/eslint-config-typescript@3.1.6
+
 ## 3.5.4
 
 ### Patch Changes

package/README.md

@@ -1,17 +1,49 @@
-# @santi020k/eslint-config-basic
+<p align="center">
+  <a href="https://eslint.santi020k.com/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/santi020k/eslint-config-basic/main/assets/readme/hero-dark.svg">
+      <img src="https://raw.githubusercontent.com/santi020k/eslint-config-basic/main/assets/readme/hero-light.svg" alt="ESLint Config Basic — Less setup. Clearer feedback." width="1200" height="360">
+    </picture>
+  </a>
+</p>
+
+<h1 align="center">@santi020k/eslint-config-basic</h1>
+
+<p align="center">
+  <strong>A lean foundation for consistent JavaScript and TypeScript quality.</strong><br>
+  Detect your stack. Add only what you need. Keep feedback useful.
+</p>
 
 DX-first ESLint 10 flat config for JavaScript and TypeScript, with auto-detection
 and opt-in framework packages.
 
-[Documentation](https://eslint.santi020k.com/) ·
-[npm](https://www.npmjs.com/package/@santi020k/eslint-config-basic) ·
-[Migration to v3](https://eslint.santi020k.com/guide/migration-v2-to-v3/)
+<p align="center">
+  <a href="https://eslint.santi020k.com/">Documentation</a> ·
+  <a href="https://eslint.santi020k.com/guide/config-builder/">Config builder</a> ·
+  <a href="https://www.npmjs.com/package/@santi020k/eslint-config-basic">npm</a> ·
+  <a href="https://eslint.santi020k.com/guide/migration-v2-to-v3/">Migration to v3</a> ·
+  <a href="https://github.com/santi020k/eslint-config-basic/issues/new/choose">Get help</a>
+</p>
 
-[![Build](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml/badge.svg)](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml)
-[![CodeQL](https://github.com/santi020k/eslint-config-basic/actions/workflows/codeql.yml/badge.svg)](https://github.com/santi020k/eslint-config-basic/actions/workflows/codeql.yml)
-[![npm version](https://img.shields.io/npm/v/@santi020k/eslint-config-basic.svg)](https://www.npmjs.com/package/@santi020k/eslint-config-basic)
-[![npm downloads](https://img.shields.io/npm/dm/@santi020k/eslint-config-basic.svg)](https://www.npmjs.com/package/@santi020k/eslint-config-basic)
-[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/santi020k/eslint-config-basic/blob/main/LICENSE)
+<p align="center">
+  <a href="https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml"><img src="https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml/badge.svg" alt="Build"></a>
+  <a href="https://github.com/santi020k/eslint-config-basic/actions/workflows/codeql.yml"><img src="https://github.com/santi020k/eslint-config-basic/actions/workflows/codeql.yml/badge.svg" alt="CodeQL"></a>
+  <a href="https://www.npmjs.com/package/@santi020k/eslint-config-basic"><img src="https://img.shields.io/npm/v/@santi020k/eslint-config-basic.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@santi020k/eslint-config-basic"><img src="https://img.shields.io/npm/dm/@santi020k/eslint-config-basic.svg" alt="npm downloads"></a>
+  <a href="https://github.com/santi020k/eslint-config-basic/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license"></a>
+</p>
+
+**Explore:** [Quick start](#quick-start) · [Why v3 changed dependency ownership](#why-v3-changed-dependency-ownership) · [Custom configuration](#custom-configuration) · [Package choice](#package-choice) · [CLI](#cli) · [Compatibility](#compatibility)
+
+## Choose your path
+
+| Your project | Start here | What stays in your control |
+| --- | --- | --- |
+| **JavaScript or TypeScript** | [Basic](https://eslint.santi020k.com/packages/basic/) | A lean foundation with automatic detection |
+| **A framework application** | [Framework guides](https://eslint.santi020k.com/frameworks/react/) | Install the adapter for your actual stack |
+| **Testing and tooling** | [Feature packs](https://eslint.santi020k.com/tooling/overview/) | Opt into the integrations you use |
+| **Everything included** | [Full](https://eslint.santi020k.com/packages/full/) | One package owns the supported integrations |
+| **An existing configuration** | [Interactive builder](https://eslint.santi020k.com/guide/config-builder/) | Preview choices before adopting them |
 
 ## Quick start
 
@@ -151,6 +183,31 @@ export default await defineConfig({
 TypeScript config files (`**/*.config.{ts,mts,cts}`) use this syntax fallback
 automatically. Set `untypedFiles: false` to require type information everywhere.
 
+## Formatting preferences
+
+Choose common style preferences without repeating individual rule names:
+
+```js
+export default await defineConfig({
+  formatting: {
+    arrowParens: 'always',
+    commaDangle: 'always-multiline',
+    quotes: 'double',
+    semi: true
+  }
+})
+```
+
+Every field is optional. `arrowParens` accepts `always` or `as-needed`,
+`commaDangle` accepts `always-multiline` or `never`, `quotes` accepts `double` or
+`single`, and `semi` is a boolean. Omitted fields retain existing defaults.
+Preferences use warning severity; `strict: 'ci'` or `strict: 'pedantic'` promotes
+them to errors. Correctness rules are unchanged. Prettier compatibility and local
+flat-config overrides take precedence. Root preferences are inherited by
+`projects`; each project can override individual fields. Use
+`optionMergeStrategy: 'replace'` in a project to replace its inherited formatting
+object instead of merging fields.
+
 ## Package choice
 
 | Package | Use it when | Dependency model |
@@ -161,6 +218,20 @@ automatically. Set `untypedFiles: false` to require type information everywhere.
 | `@santi020k/eslint-config-integrations` | Existing aggregate-package users | Deprecated v3 compatibility path; removed in v4 |
 | Individual framework packages | Custom composition | One framework and its plugin set |
 
+## From setup to useful feedback
+
+```mermaid
+flowchart LR
+  A[Install Basic] --> B[Detect your stack]
+  B --> C[Compose flat config]
+  C --> D[Lint in editor and CI]
+  D --> E[Explain and improve]
+```
+
+Detection starts from your configuration directory. Framework adapters and feature packs
+stay explicit dependencies; lint feedback works in your editor and existing CI.
+Use the CLI to understand a rule before changing it, and review a migration before writing it.
+
 ## CLI
 
 ```sh
@@ -183,11 +254,23 @@ that editor-facing ESLint config declarations stay portable. The remaining
 commands automate v3 migration, incremental strict-mode adoption, budgeted
 performance profiling, and effective-rule change review.
 
+Doctor's JSON project report includes `lintOwnership.localConfig`, `lintScript`,
+and `guidance` to help review overlapping workspace lint commands. Doctor also
+reports potentially redundant Astro parser and rule fields passed directly to
+`defineConfig()` when the installed composer and current effective config agree
+on sampled files. These are review candidates, never automatic removals.
+
+When Playwright and Testing Library are both enabled, Playwright-owned globs
+restrict Testing Library's import heuristics while retaining checks for actual
+Testing Library imports. Use `testingFiles.playwright` for browser tests outside
+the standard Playwright directories; generic `tests/**/*.spec.ts` files are not
+assumed to belong to Playwright.
+
 ## Compatibility
 
 - Node.js: `>=22.19.0`
 - ESLint: `^10.0.0`
-- TypeScript: `>=5.0.0` when enabled
+- TypeScript: `>=5.0.0 <7.0.0` when enabled
 - Package managers: npm, pnpm, Yarn, and Bun
 
 Packages in the `@santi020k/eslint-config-*` family use independent minor and
@@ -201,6 +284,18 @@ for package moves and copy-paste commands. The
 [planned v4 removals](https://eslint.santi020k.com/guide/v4-removals/) page
 tracks compatibility APIs that are deprecated during v3.
 
+## Contribute and get support
+
+- [Report a reproducible bug](https://github.com/santi020k/eslint-config-basic/issues/new/choose), ask a setup question, or propose a framework integration.
+- [Read the contribution guide](https://github.com/santi020k/eslint-config-basic/blob/main/.github/CONTRIBUTING.md) for workspace setup, behavioral tests, and the release checks.
+- [Report security vulnerabilities privately](https://github.com/santi020k/eslint-config-basic/blob/main/.github/SECURITY.md); keep credentials and private project data out of public issues.
+- [Read the changelog](https://eslint.santi020k.com/guide/changelog/) before upgrading.
+
+Built by [Santiago Molina](https://santi020k.com), alongside
+[Lumen UI](https://github.com/santi020k/lumen),
+[Quality](https://github.com/santi020k/quality), and
+[Astro Doctor](https://github.com/santi020k/astro-doctor).
+
 ## License
 
 MIT © [santi020k](https://santi020k.com). See [LICENSE](https://github.com/santi020k/eslint-config-basic/blob/main/LICENSE).

package/dist/cli-consumer-guidance.d.ts

@@ -0,0 +1,24 @@
+import { FlatConfigArray } from '@santi020k/eslint-config-core';
+
+interface EffectiveConfig {
+    languageOptions?: {
+        parserOptions?: Record<string, unknown>;
+    };
+    rules?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+}
+interface ConfigInspector {
+    calculateConfigForFile: (file: string) => Promise<EffectiveConfig | undefined>;
+}
+type InspectorConstructor = new (options: {
+    cwd: string;
+    overrideConfig: FlatConfigArray;
+    overrideConfigFile: true;
+}) => ConfigInspector;
+/** Narrow ESLint's dynamic effective-config result at the API boundary. */
+declare const toEffectiveConfig: (value: unknown) => EffectiveConfig | undefined;
+/** Only report fields proven redundant for a sampled file; never remove a whole override block. */
+declare const compareConsumerOverrides: (cwd: string, config: FlatConfigArray, baseline: FlatConfigArray, Inspector: InspectorConstructor) => Promise<string[]>;
+declare const getConsumerOverrideGuidance: (cwd: string, configPath: null | string) => Promise<string[]>;
+
+export { compareConsumerOverrides, getConsumerOverrideGuidance, toEffectiveConfig };

package/dist/cli-consumer-guidance.js

@@ -0,0 +1,146 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { createRequire, findPackageJSON } from "node:module";
+import { dirname, join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+import { flattenConfigInputs } from "@santi020k/eslint-config-core";
+import { getDefineConfigMetadata } from "./define-config-metadata.js";
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isFlatConfig = (value) => Array.isArray(value) && value.every(isRecord);
+const isComposer = (value) => isRecord(value) && typeof value.defineConfig === "function";
+const isEslint = (value) => isRecord(value) && typeof value.ESLint === "function";
+const toEffectiveConfig = (value) => {
+  if (!isRecord(value)) return void 0;
+  const languageOptions = isRecord(value.languageOptions) ? value.languageOptions : void 0;
+  const parserOptions = isRecord(languageOptions?.parserOptions) ? languageOptions.parserOptions : void 0;
+  return {
+    languageOptions: { parserOptions },
+    rules: isRecord(value.rules) ? value.rules : void 0,
+    settings: isRecord(value.settings) ? value.settings : void 0
+  };
+};
+const ASTRO_WORKAROUND_RULES = /* @__PURE__ */ new Set([
+  "@stylistic/indent",
+  "@stylistic/jsx-closing-tag-location",
+  "@stylistic/jsx-indent",
+  "@stylistic/jsx-indent-props",
+  "@typescript-eslint/no-unused-vars",
+  "@typescript-eslint/no-unused-expressions",
+  "no-undef",
+  "no-unused-vars",
+  "no-unused-expressions"
+]);
+const collectAstroFiles = (root, files, depth = 0) => {
+  if (depth > 8) return;
+  const entries = readdirSync(root, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
+  for (const entry of entries) {
+    if (files.length >= 32) break;
+    const path = join(root, entry.name);
+    if (entry.isFile() && entry.name.endsWith(".astro")) files.push(path);
+    if (entry.isDirectory() && !entry.name.startsWith(".") && !["node_modules", "dist", "build", "coverage"].includes(entry.name)) collectAstroFiles(path, files, depth + 1);
+  }
+};
+const severity = (value) => {
+  const first = Array.isArray(value) ? value[0] : value;
+  return first === "off" ? 0 : first;
+};
+const createCandidates = (cwd, extras, baseline, Inspector) => extras.filter((entry) => entry.files?.some((pattern) => typeof pattern === "string" && pattern.includes(".astro"))).filter((entry) => entry.languageOptions?.parserOptions?.parser || Object.keys(entry.rules ?? {}).some((rule) => ASTRO_WORKAROUND_RULES.has(rule))).map((entry, index) => ({
+  entry,
+  inspector: new Inspector({
+    cwd,
+    overrideConfig: [...baseline, {
+      ...entry,
+      settings: { ...entry.settings, "eslint-config-basic/doctor-scope": true }
+    }],
+    overrideConfigFile: true
+  }),
+  key: `${index}:${entry.name ?? "override"}`
+}));
+const isRedundantRule = (rule, value, current, baseline) => ASTRO_WORKAROUND_RULES.has(rule) && severity(value) === 0 && severity(current.rules?.[rule]) === 0 && severity(baseline.rules?.[rule]) === 0;
+const getParser = (config) => config.languageOptions?.parserOptions?.parser;
+const sameParser = (left, right) => left === right || isRecord(left) && isRecord(right) && typeof left.parseForESLint === "function" && left.parseForESLint === right.parseForESLint && left.parse === right.parse;
+const isRedundantParser = (entry, current, baseline) => {
+  const parser = getParser(entry);
+  return Boolean(parser) && sameParser(parser, getParser(current)) && sameParser(parser, getParser(baseline));
+};
+const recordCandidate = (candidate, current, baseline, file, guidance) => {
+  const { entry, key } = candidate;
+  for (const [rule, value] of Object.entries(entry.rules ?? {})) {
+    if (!isRedundantRule(rule, value, current, baseline)) continue;
+    const id = `${key}:${rule}`;
+    guidance.set(id, guidance.get(id) ?? `Review Astro workaround ${rule}: installed generated and current effective configs both disable it for ${file}. Remove only that field after checking all override globs; rerun lint, typecheck, and repeated autofix before removing the override.`);
+  }
+  if (isRedundantParser(entry, current, baseline)) {
+    const id = `${key}:parser`;
+    guidance.set(id, guidance.get(id) ?? `Review the explicit Astro TypeScript parser: the installed generated config already supplies the same parser for ${file}. Check every override glob and rerun lint, typecheck, and repeated autofix before removing only the parser field.`);
+  }
+};
+const inspectTarget = async (cwd, target, current, generated, candidates, guidance) => {
+  const [effective, defaults] = await Promise.all([
+    current.calculateConfigForFile(target),
+    generated.calculateConfigForFile(target)
+  ]);
+  if (!effective || !defaults) return;
+  for (const candidate of candidates) {
+    const scoped = await candidate.inspector.calculateConfigForFile(target);
+    if (scoped?.settings?.["eslint-config-basic/doctor-scope"] !== true) continue;
+    recordCandidate(candidate, effective, defaults, relative(cwd, target), guidance);
+  }
+};
+const compareConsumerOverrides = async (cwd, config, baseline, Inspector) => {
+  const metadata = getDefineConfigMetadata(config);
+  if (!metadata) return [];
+  const candidates = createCandidates(cwd, flattenConfigInputs(metadata.extraConfigs), baseline, Inspector);
+  if (candidates.length === 0) return [];
+  const current = new Inspector({ cwd, overrideConfig: config, overrideConfigFile: true });
+  const generated = new Inspector({ cwd, overrideConfig: baseline, overrideConfigFile: true });
+  const guidance = /* @__PURE__ */ new Map();
+  const files = [];
+  collectAstroFiles(cwd, files);
+  for (const file of files) {
+    await inspectTarget(cwd, file, current, generated, candidates, guidance);
+    await inspectTarget(cwd, `${file}/consumer-script.js`, current, generated, candidates, guidance);
+  }
+  return [...guidance.values()];
+};
+const resolveComposerEntry = (cwd) => {
+  const manifestPath = findPackageJSON(
+    "@santi020k/eslint-config-basic",
+    pathToFileURL(join(cwd, "package.json"))
+  );
+  if (!manifestPath) throw new Error("The installed Basic package manifest could not be resolved.");
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  const exports = isRecord(manifest) && isRecord(manifest.exports) ? manifest.exports : void 0;
+  const entry = isRecord(exports?.["."]) ? exports["."].import : void 0;
+  if (typeof entry !== "string" || !entry.startsWith("./")) {
+    throw new Error("The installed Basic package does not declare a supported public root import export.");
+  }
+  return pathToFileURL(join(dirname(manifestPath), entry)).href;
+};
+const compareInstalledComposer = async (cwd, config) => {
+  const metadata = getDefineConfigMetadata(config);
+  if (!metadata || metadata.extraConfigs.length === 0) return [];
+  const projectRequire = createRequire(join(cwd, "package.json"));
+  const composer = await import(resolveComposerEntry(cwd));
+  const eslint = projectRequire("eslint");
+  if (!isComposer(composer) || !isEslint(eslint)) return [];
+  const legacyRoot = Reflect.get(metadata.options ?? {}, "detectRootDir");
+  const root = metadata.root ?? metadata.options?.root ?? (typeof legacyRoot === "string" ? legacyRoot : cwd);
+  const baseline = await composer.defineConfig({ ...metadata.options, root });
+  return await compareConsumerOverrides(cwd, config, baseline, eslint.ESLint);
+};
+const getConsumerOverrideGuidance = async (cwd, configPath) => {
+  if (!configPath || !existsSync(configPath)) return [];
+  try {
+    const loaded = await import(pathToFileURL(configPath).href);
+    const config = isRecord(loaded) ? await loaded.default : void 0;
+    return isFlatConfig(config) ? await compareInstalledComposer(cwd, config) : [];
+  } catch (error) {
+    return [`Could not compare consumer overrides with the installed generated config: ${error instanceof Error ? error.message : String(error)}. Keep existing overrides until effective-config comparison succeeds.`];
+  }
+};
+export {
+  compareConsumerOverrides,
+  getConsumerOverrideGuidance,
+  toEffectiveConfig
+};
+//# sourceMappingURL=cli-consumer-guidance.js.map

package/dist/cli-consumer-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli-consumer-guidance.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { createRequire, findPackageJSON } from 'node:module'\nimport { dirname, join, relative } from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\nimport { type FlatConfigArray, flattenConfigInputs } from '@santi020k/eslint-config-core'\n\nimport { getDefineConfigMetadata } from './define-config-metadata.js'\nimport type { defineConfig } from './index.js'\n\ninterface EffectiveConfig {\n  languageOptions?: { parserOptions?: Record<string, unknown> }\n  rules?: Record<string, unknown>\n  settings?: Record<string, unknown>\n}\n\ninterface ConfigInspector {\n  calculateConfigForFile: (file: string) => Promise<EffectiveConfig | undefined>\n}\n\ntype InspectorConstructor = new(options: {\n  cwd: string\n  overrideConfig: FlatConfigArray\n  overrideConfigFile: true\n}) => ConfigInspector\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => (\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n)\n\nconst isFlatConfig = (value: unknown): value is FlatConfigArray => (\n  Array.isArray(value) && value.every(isRecord)\n)\n\nconst isComposer = (value: unknown): value is { defineConfig: typeof defineConfig } => (\n  isRecord(value) && typeof value.defineConfig === 'function'\n)\n\nconst isEslint = (value: unknown): value is { ESLint: InspectorConstructor } => (\n  isRecord(value) && typeof value.ESLint === 'function'\n)\n\n/** Narrow ESLint's dynamic effective-config result at the API boundary. */\nexport const toEffectiveConfig = (value: unknown): EffectiveConfig | undefined => {\n  if (!isRecord(value)) return undefined\n\n  const languageOptions = isRecord(value.languageOptions) ? value.languageOptions : undefined\n  const parserOptions = isRecord(languageOptions?.parserOptions) ? languageOptions.parserOptions : undefined\n\n  return {\n    languageOptions: { parserOptions },\n    rules: isRecord(value.rules) ? value.rules : undefined,\n    settings: isRecord(value.settings) ? value.settings : undefined\n  }\n}\n\nconst ASTRO_WORKAROUND_RULES = new Set([\n  '@stylistic/indent',\n  '@stylistic/jsx-closing-tag-location',\n  '@stylistic/jsx-indent',\n  '@stylistic/jsx-indent-props',\n  '@typescript-eslint/no-unused-vars',\n  '@typescript-eslint/no-unused-expressions',\n  'no-undef',\n  'no-unused-vars',\n  'no-unused-expressions'\n])\n\nconst collectAstroFiles = (root: string, files: string[], depth = 0): void => {\n  if (depth > 8) return\n\n  const entries = readdirSync(root, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))\n\n  for (const entry of entries) {\n    if (files.length >= 32) break\n\n    const path = join(root, entry.name)\n\n    if (entry.isFile() && entry.name.endsWith('.astro')) files.push(path)\n\n    if (entry.isDirectory() && !entry.name.startsWith('.') &&\n      !['node_modules', 'dist', 'build', 'coverage'].includes(entry.name)) collectAstroFiles(path, files, depth + 1)\n  }\n}\n\nconst severity = (value: unknown): unknown => {\n  const first: unknown = Array.isArray(value) ? value[0] : value\n\n  return first === 'off' ? 0 : first\n}\n\ntype ConfigEntry = FlatConfigArray[number]\n\ninterface Candidate {\n  entry: ConfigEntry\n  inspector: ConfigInspector\n  key: string\n}\n\nconst createCandidates = (\n  cwd: string,\n  extras: FlatConfigArray,\n  baseline: FlatConfigArray,\n  Inspector: InspectorConstructor\n): Candidate[] => (\n  extras.filter(entry => entry.files?.some(pattern => typeof pattern === 'string' && pattern.includes('.astro')))\n    .filter(entry => entry.languageOptions?.parserOptions?.parser ||\n      Object.keys(entry.rules ?? {}).some(rule => ASTRO_WORKAROUND_RULES.has(rule)))\n    .map((entry, index) => ({\n      entry,\n      inspector: new Inspector({\n        cwd,\n        overrideConfig: [...baseline, {\n          ...entry,\n          settings: { ...entry.settings, 'eslint-config-basic/doctor-scope': true }\n        }],\n        overrideConfigFile: true\n      }),\n      key: `${index}:${entry.name ?? 'override'}`\n    }))\n)\n\nconst isRedundantRule = (\n  rule: string,\n  value: unknown,\n  current: EffectiveConfig,\n  baseline: EffectiveConfig\n): boolean => (\n  ASTRO_WORKAROUND_RULES.has(rule) && severity(value) === 0 &&\n  severity(current.rules?.[rule]) === 0 && severity(baseline.rules?.[rule]) === 0\n)\n\nconst getParser = (config: EffectiveConfig): unknown => config.languageOptions?.parserOptions?.parser\n\n// ESLint clones nested parser options; entry-point function identity survives that merge.\nconst sameParser = (left: unknown, right: unknown): boolean => (\n  left === right || (isRecord(left) && isRecord(right) &&\n    typeof left.parseForESLint === 'function' && left.parseForESLint === right.parseForESLint && left.parse === right.parse)\n)\n\nconst isRedundantParser = (entry: ConfigEntry, current: EffectiveConfig, baseline: EffectiveConfig): boolean => {\n  const parser = getParser(entry)\n\n  return Boolean(parser) && sameParser(parser, getParser(current)) && sameParser(parser, getParser(baseline))\n}\n\nconst recordCandidate = (\n  candidate: Candidate,\n  current: EffectiveConfig,\n  baseline: EffectiveConfig,\n  file: string,\n  guidance: Map<string, string>\n): void => {\n  const { entry, key } = candidate\n\n  for (const [rule, value] of Object.entries(entry.rules ?? {})) {\n    if (!isRedundantRule(rule, value, current, baseline)) continue\n\n    const id = `${key}:${rule}`\n\n    guidance.set(id, guidance.get(id) ??\n    `Review Astro workaround ${rule}: installed generated and current effective configs both disable it ` +\n    `for ${file}. Remove only that field after checking all override globs; ` +\n    'rerun lint, typecheck, and repeated autofix before removing the override.')\n  }\n\n  if (isRedundantParser(entry, current, baseline)) {\n    const id = `${key}:parser`\n\n    guidance.set(id, guidance.get(id) ??\n    'Review the explicit Astro TypeScript parser: the installed generated config already supplies the ' +\n    `same parser for ${file}. Check every override glob and rerun lint, typecheck, ` +\n    'and repeated autofix before removing only the parser field.')\n  }\n}\n\nconst inspectTarget = async (\n  cwd: string,\n  target: string,\n  current: ConfigInspector,\n  generated: ConfigInspector,\n  candidates: Candidate[],\n  guidance: Map<string, string>\n): Promise<void> => {\n  const [effective, defaults] = await Promise.all([\n    current.calculateConfigForFile(target),\n    generated.calculateConfigForFile(target)\n  ])\n\n  if (!effective || !defaults) return\n\n  for (const candidate of candidates) {\n    const scoped = await candidate.inspector.calculateConfigForFile(target)\n\n    if (scoped?.settings?.['eslint-config-basic/doctor-scope'] !== true) continue\n\n    recordCandidate(candidate, effective, defaults, relative(cwd, target), guidance)\n  }\n}\n\n/** Only report fields proven redundant for a sampled file; never remove a whole override block. */\nexport const compareConsumerOverrides = async (\n  cwd: string,\n  config: FlatConfigArray,\n  baseline: FlatConfigArray,\n  Inspector: InspectorConstructor\n): Promise<string[]> => {\n  const metadata = getDefineConfigMetadata(config)\n\n  if (!metadata) return []\n\n  const candidates = createCandidates(cwd, flattenConfigInputs(metadata.extraConfigs), baseline, Inspector)\n\n  if (candidates.length === 0) return []\n\n  const current = new Inspector({ cwd, overrideConfig: config, overrideConfigFile: true })\n  const generated = new Inspector({ cwd, overrideConfig: baseline, overrideConfigFile: true })\n  const guidance = new Map<string, string>()\n  const files: string[] = []\n\n  collectAstroFiles(cwd, files)\n\n  for (const file of files) {\n    await inspectTarget(cwd, file, current, generated, candidates, guidance)\n\n    await inspectTarget(cwd, `${file}/consumer-script.js`, current, generated, candidates, guidance)\n  }\n\n  return [...guidance.values()]\n}\n\nconst resolveComposerEntry = (cwd: string): string => {\n  const manifestPath = findPackageJSON(\n    '@santi020k/eslint-config-basic',\n    pathToFileURL(join(cwd, 'package.json'))\n  )\n\n  if (!manifestPath) throw new Error('The installed Basic package manifest could not be resolved.')\n\n  const manifest: unknown = JSON.parse(readFileSync(manifestPath, 'utf8'))\n  const exports = isRecord(manifest) && isRecord(manifest.exports) ? manifest.exports : undefined\n  const entry = isRecord(exports?.['.']) ? exports['.'].import : undefined\n\n  if (typeof entry !== 'string' || !entry.startsWith('./')) {\n    throw new Error('The installed Basic package does not declare a supported public root import export.')\n  }\n\n  return pathToFileURL(join(dirname(manifestPath), entry)).href\n}\n\nconst compareInstalledComposer = async (cwd: string, config: FlatConfigArray): Promise<string[]> => {\n  const metadata = getDefineConfigMetadata(config)\n\n  if (!metadata || metadata.extraConfigs.length === 0) return []\n\n  const projectRequire = createRequire(join(cwd, 'package.json'))\n  const composer: unknown = await import(resolveComposerEntry(cwd))\n  const eslint: unknown = projectRequire('eslint')\n\n  if (!isComposer(composer) || !isEslint(eslint)) return []\n\n  const legacyRoot: unknown = Reflect.get(metadata.options ?? {}, 'detectRootDir')\n  const root = metadata.root ?? metadata.options?.root ?? (typeof legacyRoot === 'string' ? legacyRoot : cwd)\n  const baseline = await composer.defineConfig({ ...metadata.options, root })\n\n  return await compareConsumerOverrides(cwd, config, baseline, eslint.ESLint)\n}\n\nexport const getConsumerOverrideGuidance = async (cwd: string, configPath: null | string): Promise<string[]> => {\n  if (!configPath || !existsSync(configPath)) return []\n\n  try {\n    const loaded: unknown = await import(pathToFileURL(configPath).href)\n    const config: unknown = isRecord(loaded) ? await loaded.default : undefined\n\n    return isFlatConfig(config) ? await compareInstalledComposer(cwd, config) : []\n  } catch (error) {\n    return [`Could not compare consumer overrides with the installed generated config: ${\n      error instanceof Error ? error.message : String(error)\n    }. Keep existing overrides until effective-config comparison succeeds.`]\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli-preset.js

@@ -11,7 +11,7 @@ import { getDefineConfigMetadata } from "./define-config-metadata.js";
 import { defineConfig } from "./index.js";
 import { isMissingRequestedPackage } from "./optional-package-errors.js";
 import { resolvePreset } from "./resolvers.js";
-const PRESETS = new Set(Object.values(Preset));
+const PRESETS = new Map(Object.values(Preset).map((preset) => [preset, preset]));
 const CONFIG_FILENAMES = [
   "eslint.config.js",
   "eslint.config.mjs",
@@ -484,12 +484,12 @@ const createPresetReport = async (cwd, presetName, file = "eslint.config.js", op
     throw new Error("Writing preset fixes requires semanticOnly to avoid an unchecked formatting rewrite.");
   }
   const normalizedPreset = presetName.toLowerCase();
-  if (!PRESETS.has(normalizedPreset)) {
+  const preset = PRESETS.get(normalizedPreset);
+  if (preset === void 0) {
     throw new Error(
-      `Unknown preset "${presetName}". Use one of: ${[...PRESETS].sort().join(", ")}.`
+      `Unknown preset "${presetName}". Use one of: ${[...PRESETS.keys()].sort().join(", ")}.`
     );
   }
-  const preset = normalizedPreset;
   const presetOptions = resolvePreset(preset);
   const current = await loadProjectEslint(cwd).calculateConfigForFile(file);
   const currentMetadata = await loadDefineConfigMetadata(cwd);