@santi020k/eslint-config-basic 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @santi020k/eslint-config-basic
 
+## 1.4.0
+
+### Minor Changes
+
+- [#80](https://github.com/santi020k/eslint-config-basic/pull/80) [`7bccef0`](https://github.com/santi020k/eslint-config-basic/commit/7bccef0876e4ffde0c7395b5b20917225a067592) Thanks [@santi020k](https://github.com/santi020k)! - # v1.4.0 — API improvements, new optional, and quality-of-life fixes
+
+  ## Breaking changes
+
+  **Unified Node.js requirement to >=24.0.0.**
+  All packages in the monorepo now strictly require Node.js 24.0.0 or higher. This ensures compatibility with modern dependency versions (such as `cspell` v10) and aligns with the project's long-term maintenance strategy.
+
+  **`detectProjectOptions()` no longer sets boolean flags on `frameworks`.**
+  Previously, auto-detection would set `frameworks.react = true`, `frameworks.next = true`, etc. Passing those values to `eslintConfig()` would throw a `TypeError` because framework configs must be real imports, not booleans.
+
+  Detected frameworks are now reported via a new `detectedFrameworks: DetectedFrameworkName[]` field. The `frameworks` object in the detection result stays empty, so spreading `detectProjectOptions()` into `eslintConfig()` is always safe.
+
+  ```ts
+  // Before (would throw)
+  const opts = detectProjectOptions();
+
+  eslintConfig(opts); // ❌
+
+  // opts.frameworks.next === true → TypeError inside eslintConfig()
+
+  // After (safe)
+  const opts = detectProjectOptions();
+
+  // opts.detectedFrameworks → ['next', 'react']  (informational)
+  // opts.frameworks → {}                          (safe to spread)
+  eslintConfig(opts); // ✅
+  ```
+
+  ## New features
+
+  **`Extension.BestPractices` optional config** — adds four quality rules with no extra dependencies:
+  - `no-console` (warn) — catches leftover debug output
+  - `no-alert` (error) — disallows browser `alert` / `confirm` / `prompt`
+  - `complexity` (warn, max 10) — flags overly complex functions
+  - `max-depth` (warn, max 4) — flags deeply nested blocks
+
+  ```ts
+  eslintConfig({ extensions: [Extension.BestPractices] });
+  ```
+
+  **Category barrel exports for `@santi020k/eslint-config-optionals`** — five new sub-path exports let you import a whole category at once:
+
+  ```ts
+  // also: /extensions  /tools  /libraries
+  ```
+
+  **`NextMode` auto-detection** — `detectProjectOptions()` now detects App Router vs Pages Router by checking for an `app/` or `src/app/` directory, so `options.nextMode` is set automatically.
+
+  **`DetectedFrameworkName` type** — new exported union type listing all framework names that `detectProjectOptions()` can detect. Useful for display logic or tooling built on top of detection.
+
+  ## Improvements
+
+  **Early `tsconfigRootDir` validation** — `createTypescriptConfig()` now throws a clear, actionable error at config-creation time if the provided `tsconfigRootDir` path does not exist on disk, instead of failing silently at ESLint runtime.
+
+  **CI node version matrix** — the build pipeline now runs against Node 24.x to ensure stability across the updated engine requirements.
+
+  **`docs/PHILOSOPHY.md`** — new document explaining the major design decisions: why hard deps, flat config only, lazy framework loading, rule severity philosophy, and how to extend or override rules.
+
+  **Changelog synchronization** — new `sync-docs-changelog.mjs` script to automatically propagate root changelog updates to the documentation site.
+
+  ## Bug Fixes
+  - **CLI Scaffolding**: Resolved bug where auto-detected frameworks were not correctly included in the generated configuration.
+  - **Rule Set Update**: Updated React and Expo collections to reflect rule removals in `eslint-plugin-react-hooks@7` recommended configuration.
+  - **Tailwind CSS Performance**: Fixed `Atomics.wait()` timeout errors in monorepos by providing customizable settings in the recommended Tailwind configuration.
+
+  ## Dependency Updates
+  - **External Plugins**:
+    - Updated `@cspell/eslint-plugin` to `v10.0.0` (Major).
+    - Updated `typescript-eslint` to `v8.59.0`.
+    - Updated `eslint-plugin-react-hooks` to `v7.1.1`.
+    - Updated `eslint-plugin-perfectionist` to `v5.9.0`.
+    - Updated `eslint-plugin-sonarjs` to `v4.0.3`.
+    - Updated `tailwindcss` to `v4.2.4`.
+  - **Core Tooling**:
+    - Updated `eslint` to `v10.2.1`.
+    - Updated `vitest` and `@vitest/coverage-v8` to `v4.1.5`.
+    - Internal alignment of `typescript` version to `v5.9.3`.
+
+### Patch Changes
+
+- Updated dependencies [[`7bccef0`](https://github.com/santi020k/eslint-config-basic/commit/7bccef0876e4ffde0c7395b5b20917225a067592)]:
+  - @santi020k/eslint-config-core@1.4.0
+  - @santi020k/eslint-config-optionals@1.4.0
+  - @santi020k/eslint-config-typescript@1.4.0
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/cli.d.ts

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 declare const handleInit: (cwd?: string) => void;
 declare const handleUpdate: (cwd?: string) => void;
 

package/dist/cli.js

@@ -20,16 +20,16 @@ const resolveConfigPath = (cwd) => {
   ].map((filename) => join(cwd, filename)).find(existsSync);
   return existingConfigPath ?? join(cwd, getDefaultConfigFilename(cwd));
 };
-const getFrameworkKeys = (frameworks) => {
-  const frameworkKeys = new Set(Object.keys(frameworks ?? {}));
+const getFrameworkKeys = (detectedFrameworks) => {
+  const frameworkKeys = new Set(detectedFrameworks ?? []);
   if (frameworkKeys.has("next") || frameworkKeys.has("expo")) {
     frameworkKeys.add("react");
   }
-  return [...frameworkKeys];
+  return [...frameworkKeys].sort();
 };
 const createConfigContent = (cwd) => {
   const options = detectProjectOptions(cwd);
-  const frameworkKeys = getFrameworkKeys(options.frameworks);
+  const frameworkKeys = getFrameworkKeys(options.detectedFrameworks);
   const imports = ["import { eslintConfig } from '@santi020k/eslint-config-basic'"];
   frameworkKeys.forEach((key) => {
     imports.push(`import ${key} from '@santi020k/eslint-config-${key}'`);

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { EslintConfigOptions, FlatConfigArray } from '@santi020k/eslint-config-core';
-export { EslintConfigOptions, Extension, FlatConfigArray, Format, ImportedFramework, Library, NextMode, Preset, ReactConfigKeys, Runtime, Setting, Testing, Tool, coreConfig, createCoreConfig, detectProjectOptions, getGlobalsForRuntime, gitignore, hasReactConfig, jsConfig } from '@santi020k/eslint-config-core';
+export { DetectedFrameworkName, EslintConfigOptions, Extension, FlatConfigArray, Format, ImportedFramework, Library, NextMode, Preset, ReactConfigKeys, Runtime, Setting, Testing, Tool, coreConfig, createCoreConfig, detectProjectOptions, getGlobalsForRuntime, gitignore, hasReactConfig, jsConfig } from '@santi020k/eslint-config-core';
 export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript';
-export { cspell, cypress, graphql, i18next, jest, jsdoc, jsonc, markdown, mdx, perfectionist, playwright, prettier, regexp, security, sonarjs, stencil, storybook, swagger, tailwind, tanstackQuery, tanstackRouter, testingLibrary, toml, unicorn, vitest, yaml } from '@santi020k/eslint-config-optionals';
+export { bestPractices, cspell, cypress, graphql, i18next, jest, jsdoc, jsonc, markdown, mdx, perfectionist, playwright, prettier, regexp, security, sonarjs, stencil, storybook, swagger, tailwind, tanstackQuery, tanstackRouter, testingLibrary, toml, unicorn, vitest, yaml } from '@santi020k/eslint-config-optionals';
 
 /**
  * Generates the ESLint configuration array, applying configurations

package/dist/index.js

@@ -32,6 +32,7 @@ import {
 } from "@santi020k/eslint-config-core";
 import { tsConfig, typescriptConfig } from "@santi020k/eslint-config-typescript";
 import {
+  bestPractices,
   cspell,
   cypress,
   graphql,
@@ -173,6 +174,7 @@ export {
   Setting2 as Setting,
   Testing,
   Tool,
+  bestPractices,
   coreConfig2 as coreConfig,
   createCoreConfig2 as createCoreConfig,
   cspell,

package/dist/optionals.js

@@ -6,6 +6,7 @@ import {
   Tool
 } from "@santi020k/eslint-config-core";
 import {
+  bestPractices,
   cspell,
   cypress,
   graphql,
@@ -53,6 +54,7 @@ const getOptionalConfigs = (libraries, tools, testing, formats, extensions) => {
   if (formats.includes(Format.Yaml)) configs.push(...yaml);
   if (formats.includes(Format.Toml)) configs.push(...toml);
   if (formats.includes(Format.Graphql)) configs.push(...graphql);
+  if (extensions.includes(Extension.BestPractices)) configs.push(...bestPractices);
   if (extensions.includes(Extension.Regexp)) configs.push(...regexp);
   if (extensions.includes(Extension.Unicorn)) configs.push(...unicorn);
   if (extensions.includes(Extension.Sonarjs)) configs.push(...sonarjs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/eslint-config-basic",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A composable ESLint 9/10+ Flat Config package for JavaScript, TypeScript, React, Next.js, Vue, Svelte, Solid, Angular, Astro, Expo, NestJS, Qwik, and Remix.",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,24 +21,24 @@
     "basic-eslint": "./dist/cli.js"
   },
   "dependencies": {
-    "@typescript-eslint/utils": "^8.58.2",
-    "eslint": "^10.2.0",
-    "@santi020k/eslint-config-core": "^1.3.0",
-    "@santi020k/eslint-config-optionals": "^1.3.0",
-    "@santi020k/eslint-config-typescript": "^1.3.0"
+    "@typescript-eslint/utils": "^8.59.0",
+    "eslint": "^10.2.1",
+    "@santi020k/eslint-config-core": "^1.4.0",
+    "@santi020k/eslint-config-optionals": "^1.4.0",
+    "@santi020k/eslint-config-typescript": "^1.4.0"
   },
   "peerDependencies": {
-    "@santi020k/eslint-config-angular": "^1.3.0",
-    "@santi020k/eslint-config-astro": "^1.3.0",
-    "@santi020k/eslint-config-expo": "^1.3.0",
-    "@santi020k/eslint-config-nest": "^1.3.0",
-    "@santi020k/eslint-config-next": "^1.3.0",
-    "@santi020k/eslint-config-qwik": "^1.3.0",
-    "@santi020k/eslint-config-react": "^1.3.0",
-    "@santi020k/eslint-config-remix": "^1.3.0",
-    "@santi020k/eslint-config-solid": "^1.3.0",
-    "@santi020k/eslint-config-svelte": "^1.3.0",
-    "@santi020k/eslint-config-vue": "^1.3.0"
+    "@santi020k/eslint-config-angular": "^1.4.0",
+    "@santi020k/eslint-config-astro": "^1.4.0",
+    "@santi020k/eslint-config-expo": "^1.4.0",
+    "@santi020k/eslint-config-nest": "^1.4.0",
+    "@santi020k/eslint-config-next": "^1.4.0",
+    "@santi020k/eslint-config-qwik": "^1.4.0",
+    "@santi020k/eslint-config-react": "^1.4.0",
+    "@santi020k/eslint-config-remix": "^1.4.0",
+    "@santi020k/eslint-config-solid": "^1.4.0",
+    "@santi020k/eslint-config-svelte": "^1.4.0",
+    "@santi020k/eslint-config-vue": "^1.4.0"
   },
   "peerDependenciesMeta": {
     "@santi020k/eslint-config-angular": {
@@ -84,7 +84,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=24.0.0"
   },
   "license": "MIT",
   "author": "santi020k",