@santi020k/eslint-config-basic 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,121 @@
 # @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
+
+- [#77](https://github.com/santi020k/eslint-config-basic/pull/77) [`450fa19`](https://github.com/santi020k/eslint-config-basic/commit/450fa1996aa651671513a32bd5d8736e5336be73) Thanks [@santi020k](https://github.com/santi020k)! - Refresh package metadata and supporting docs for the `santi020k.com` domain migration.
+  - Update documentation, canonical URLs, and package links from `santi020k.me` to `santi020k.com`.
+  - Sync npm package metadata so published packages point to the correct license, repository, issues page, and documentation URLs.
+  - Refresh low-risk ESLint ecosystem and release tooling dependencies.
+
+### Patch Changes
+
+- Updated dependencies [[`450fa19`](https://github.com/santi020k/eslint-config-basic/commit/450fa1996aa651671513a32bd5d8736e5336be73)]:
+  - @santi020k/eslint-config-angular@1.3.0
+  - @santi020k/eslint-config-astro@1.3.0
+  - @santi020k/eslint-config-core@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-optionals@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-typescript@1.3.0
+  - @santi020k/eslint-config-vue@1.3.0
+
 ## 1.2.0
 
 ### Minor Changes
@@ -9,7 +125,6 @@
   This release focuses on a comprehensive update of the documentation site and branding refresh.
 
   ## Highlights
-
   - **VitePress Refresh**: Major updates to the documentation structure, including new guides and improved navigation.
   - **Branding Assets**: Added new official logos, icons, and social preview images (opengraph) in `packages/docs/public`.
   - **Theme Enhancements**: Custom styling and component improvements for a more premium documentation experience.
@@ -40,7 +155,6 @@
 - [#70](https://github.com/santi020k/eslint-config-basic/pull/70) [`ef658c1`](https://github.com/santi020k/eslint-config-basic/commit/ef658c170f6eaadce14a7e662eaa2a3762362e82) Thanks [@santi020k](https://github.com/santi020k)! - # 1.1.0 Release
 
   ## Update Highlights
-
   - **ESLint 10 Support**: Harmonized ESLint version to `^10.1.0` across the monorepo and playgrounds.
   - **Security Patches**: Fixed vulnerabilities in `lodash`, `esbuild`, and `path-to-regexp` via root overrides.
   - **Solid Playground Fix**: Resolved `MODULE_NOT_FOUND` error in the Solid playground linting process.
@@ -70,7 +184,6 @@
 - [#66](https://github.com/santi020k/eslint-config-basic/pull/66) [`6f2f473`](https://github.com/santi020k/eslint-config-basic/commit/6f2f4733642087eb9eac22a7b6193b71453f375d) Thanks [@santi020k](https://github.com/santi020k)! - v0.10.0 Release
 
   ## Major Changes
-
   - **Migration to pnpm**: Full migration of the monorepo from npm to pnpm workspaces (pnpm v10+). This includes better performance, stricter dependency management, and corepack integration.
   - **neostandard removal**: Removed `neostandard` dependency to provide more granular control and modularity in core rules.
   - **Stylistic v4 -> v5**: Upgraded to `@stylistic/eslint-plugin` version 5.x for improved formatting rules and TypeScript 5.7+ support.
@@ -78,14 +191,12 @@
   - **React 19 Support**: Updated React detection logic and configurations to support React 19.
 
   ## Framework Updates
-
   - **Qwik & Remix Support**: Added comprehensive ESLint configurations and functional playground environments for both Qwik and Remix frameworks.
   - **Dependency Alignment**: Resolved critical `typescript-eslint` dependency issues in Astro, Svelte, and Vue packages to ensure proper rule resolution and type safety.
   - **Consistency Refinements**: Standardized `disable-type-checked` rule blocks across all framework-specific configurations.
   - **Documentation Overhaul**: Major documentation refresh in root `README.md` and VitePress documentation. Added clarity on configuration priority, framework auto-detection, and full-settings examples.
 
   ## Maintenance
-
   - **Corepack Enablement**: Added `corepack` support for automated package manager version management.
   - **Turbo Update**: Bumped Turborepo to v2.9+ for faster builds and improved task caching.
   - **Turbo Optimizations**: Configured Turborepo to output in `errors-only` mode with `errorsOnlyShowHash` enabled, significantly reducing terminal noise during build and lint tasks.
@@ -95,7 +206,6 @@
 - [#55](https://github.com/santi020k/eslint-config-basic/pull/55) [`d8e4b4a`](https://github.com/santi020k/eslint-config-basic/commit/d8e4b4a61c2739dbffa3c823d8742ea234c5b731) Thanks [@santi020k](https://github.com/santi020k)! - feat: add standard ESLint configuration and resolve typecheck/hook failures
 
   This release introduces a new standard configuration in `@santi020k/eslint-config-core` and addresses several technical issues:
-
   - Fixed global typecheck failures across the monorepo.
   - Resolved pre-commit hook issues with cspell.
   - Fixed pre-push hook failures related to publint in the playground package.
@@ -133,7 +243,6 @@
 ### Patch Changes
 
 - CI & Workflow Stabilization
-
   - Fixed invalid `actions/setup-node` version from `@v6` to `@v4` in Release and Docs workflows.
   - Improved CLI test performance and reliability by refactoring integration tests into fast in-memory unit tests.
   - Enabled Turborepo caching in GitHub Actions to significantly reduce PR build times.
@@ -256,11 +365,9 @@
 ### Patch Changes
 
 - [#27](https://github.com/santi020k/eslint-config-basic/pull/27) [`577abbe`](https://github.com/santi020k/eslint-config-basic/commit/577abbe49c2a83f6ecc744413daf3d1e1e16be2c) Thanks [@santi020k](https://github.com/santi020k)! - ci: disable Husky git hooks during the release workflow
-
   - Added `HUSKY=0` environment variable to the release workflow to prevent Git hooks from interfering with the automated release process
 
 - [#25](https://github.com/santi020k/eslint-config-basic/pull/25) [`1fb4693`](https://github.com/santi020k/eslint-config-basic/commit/1fb4693b4ff6e3a1a9404096e14039121e1297b5) Thanks [@santi020k](https://github.com/santi020k)! - feat: add GitHub-linked changelogs and automatic GitHub releases with tags
-
   - Switched changelog generator to `@changesets/changelog-github` for richer changelogs with PR links, commit references, and contributor credits
   - Configured release workflow to create GitHub releases with git tags on publish
 

package/README.md

@@ -9,9 +9,9 @@ Composable ESLint 10+ flat-config for JavaScript, TypeScript, and all major fram
 
 This is the main entry point of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
 
-- Docs: [eslint.santi020k.me](https://eslint.santi020k.me/)
+- Docs: [eslint.santi020k.com](https://eslint.santi020k.com/)
 - Repository: [santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
-- Author: [santi020k](https://santi020k.me)
+- Author: [santi020k](https://santi020k.com)
 
 ## Quick start
 
@@ -26,4 +26,4 @@ import { eslintConfig } from '@santi020k/eslint-config-basic'
 export default eslintConfig()
 ```
 
-Auto-detects TypeScript, frameworks, and common tools from your `package.json`. See the [full docs](https://eslint.santi020k.me/) for all options.
+Auto-detects TypeScript, frameworks, and common tools from your `package.json`. See the [full docs](https://eslint.santi020k.com/) for all options.

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,
@@ -127,7 +128,6 @@ const eslintConfig = (options) => {
     // React config (included if any React-based framework is used/passed)
     ...hasReact ? reactParam : [],
     ...nextParam,
-    ...astroParam,
     ...expoParam,
     ...nestParam,
     ...vueParam,
@@ -137,6 +137,9 @@ const eslintConfig = (options) => {
     ...qwikParam,
     ...remixParam,
     ...typescript ? createTypescriptConfig({ tsconfigRootDir }) : [],
+    // Astro needs to run after generic TypeScript so its parser and false-positive
+    // workarounds win for .astro files and embedded expressions.
+    ...astroParam,
     // Next.js App Router overrides (#12)
     ...frameworks.next && nextMode === NextMode.AppRouter ? [
       {
@@ -171,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.2.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": {
-    "eslint": "^9.0.0 || ^10.0.0",
-    "@typescript-eslint/utils": "^8.57.0",
-    "@santi020k/eslint-config-core": "^1.2.0",
-    "@santi020k/eslint-config-optionals": "^1.2.0",
-    "@santi020k/eslint-config-typescript": "^1.2.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.2.0",
-    "@santi020k/eslint-config-astro": "^1.2.0",
-    "@santi020k/eslint-config-expo": "^1.2.0",
-    "@santi020k/eslint-config-nest": "^1.2.0",
-    "@santi020k/eslint-config-next": "^1.2.0",
-    "@santi020k/eslint-config-react": "^1.2.0",
-    "@santi020k/eslint-config-solid": "^1.2.0",
-    "@santi020k/eslint-config-svelte": "^1.2.0",
-    "@santi020k/eslint-config-vue": "^1.2.0",
-    "@santi020k/eslint-config-qwik": "^1.2.0",
-    "@santi020k/eslint-config-remix": "^1.2.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",
@@ -93,6 +93,10 @@
     "url": "git+https://github.com/santi020k/eslint-config-basic.git",
     "directory": "packages/basic"
   },
+  "homepage": "https://eslint.santi020k.com/packages/basic.html",
+  "bugs": {
+    "url": "https://github.com/santi020k/eslint-config-basic/issues"
+  },
   "scripts": {
     "build": "tsup",
     "build:pack": "npm pack",