@santi020k/eslint-config-basic 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -1,10 +1,73 @@
 # @santi020k/eslint-config-basic
 
+## 1.2.0
+
+### Minor Changes
+
+- [#74](https://github.com/santi020k/eslint-config-basic/pull/74) [`c63e902`](https://github.com/santi020k/eslint-config-basic/commit/c63e902ab0107b9d2231a84715f2d220ea283489) Thanks [@santi020k](https://github.com/santi020k)! - # v1.2.0 Release - Documentation Overhaul
+
+  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.
+  - **Improved Installation Guide**: Updated steps for getting started with the latest features.
+
+### Patch Changes
+
+- Updated dependencies [[`c63e902`](https://github.com/santi020k/eslint-config-basic/commit/c63e902ab0107b9d2231a84715f2d220ea283489)]:
+  - @santi020k/eslint-config-core@1.2.0
+  - @santi020k/eslint-config-typescript@1.2.0
+  - @santi020k/eslint-config-react@1.2.0
+  - @santi020k/eslint-config-next@1.2.0
+  - @santi020k/eslint-config-astro@1.2.0
+  - @santi020k/eslint-config-vue@1.2.0
+  - @santi020k/eslint-config-svelte@1.2.0
+  - @santi020k/eslint-config-solid@1.2.0
+  - @santi020k/eslint-config-angular@1.2.0
+  - @santi020k/eslint-config-nest@1.2.0
+  - @santi020k/eslint-config-expo@1.2.0
+  - @santi020k/eslint-config-qwik@1.2.0
+  - @santi020k/eslint-config-remix@1.2.0
+  - @santi020k/eslint-config-optionals@1.2.0
+
+## 1.1.0
+
+### Minor Changes
+
+- [#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.
+
+### Patch Changes
+
+- Updated dependencies [[`ef658c1`](https://github.com/santi020k/eslint-config-basic/commit/ef658c170f6eaadce14a7e662eaa2a3762362e82)]:
+  - @santi020k/eslint-config-core@1.1.0
+  - @santi020k/eslint-config-typescript@1.1.0
+  - @santi020k/eslint-config-astro@1.1.0
+  - @santi020k/eslint-config-vue@1.1.0
+  - @santi020k/eslint-config-optionals@1.1.0
+  - @santi020k/eslint-config-qwik@1.1.0
+  - @santi020k/eslint-config-remix@1.1.0
+  - @santi020k/eslint-config-angular@1.1.0
+  - @santi020k/eslint-config-expo@1.1.0
+  - @santi020k/eslint-config-nest@1.1.0
+  - @santi020k/eslint-config-next@1.1.0
+  - @santi020k/eslint-config-react@1.1.0
+  - @santi020k/eslint-config-solid@1.1.0
+  - @santi020k/eslint-config-svelte@1.1.0
+
 ## 1.0.0
 
 ### Minor Changes
 
-- [#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
+- [#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
 
@@ -61,7 +124,6 @@
 ### Minor Changes
 
 - 13e8e5a: # Release 0.8.0
-
   - **Snippet Fixes**: Resolved ESLint parsing errors in virtual TypeScript files within Markdown, Astro, and VitePress code blocks by disabling type-aware rules for those snippets.
   - **Standalone TS Support**: Restored `disableTypeChecked` configuration in the TypeScript package, ensuring it remains fully functional and parsing-error-free when used without the main composer.
   - **Documentation Reorganization**: Significantly expanded and restructured the documentation site, adding new pages for the Inspector, CLI Tooling, Extensions, and better framework-specific guides.
@@ -70,7 +132,7 @@
 
 ### Patch Changes
 
-- # CI & Workflow Stabilization
+- 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.
@@ -187,7 +249,6 @@
 ### Minor Changes
 
 - [#28](https://github.com/santi020k/eslint-config-basic/pull/28) [`162afdb`](https://github.com/santi020k/eslint-config-basic/commit/162afdb2f0a30714487915bdf083234426018ad2) Thanks [@santi020k](https://github.com/santi020k)! - feat: add `regexp` optional config with `eslint-plugin-regexp`
-
   - New `OptionalOption.Regexp` to enable regex linting via `eslint-plugin-regexp`
   - Catches common regex mistakes: exponential backtracking, unnecessary escapes, and optimizable character classes
   - Uses recommended rules with selective overrides for smoother adoption
@@ -212,7 +273,6 @@
 ### Minor Changes
 
 - feat: add Nest.js, Vue, and Expo ESLint configs with optionals package
-
   - Added `@santi020k/eslint-config-nest` with NestJS-specific linting rules
   - Added `@santi020k/eslint-config-vue` with Vue 3 linting rules
   - Added `@santi020k/eslint-config-expo` with Expo/React Native linting rules

package/README.md

@@ -3,101 +3,27 @@
 [![CI](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml/badge.svg)](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.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)
-[![Docs](https://img.shields.io/badge/docs-VitePress-114d66.svg)](https://eslint.santi020k.me/)
 [![license](https://img.shields.io/npm/l/@santi020k/eslint-config-basic.svg)](https://github.com/santi020k/eslint-config-basic/blob/main/LICENSE)
 
-Composable ESLint 10+ flat-config tooling for JavaScript and TypeScript projects, with optional framework packages for React, Next.js, Astro, Vue, Svelte, Solid, Angular, NestJS, Expo, Qwik, and Remix.
+Composable ESLint 10+ flat-config for JavaScript, TypeScript, and all major frameworks.
 
-## Canonical Docs
+This is the main entry point of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
 
-- Docs site: [eslint.santi020k.me](https://eslint.santi020k.me/)
-- Repository: [github.com/santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
+- Docs: [eslint.santi020k.me](https://eslint.santi020k.me/)
+- Repository: [santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
 - Author: [santi020k](https://santi020k.me)
 
-## ✨ Key Features
-
-- **🎯 Composable & Modular**: Mix and match configurations for different frameworks and tools using a clean, options-based API.
-- **🔍 Deep Auto-Detection**: Automatically detects your project's frameworks, libraries, and tools. Core features like TypeScript and runtime presets are enabled by default if detected.
-- **⚡ Lazy Loading**: Framework-specific configurations are loaded only when needed, ensuring maximum performance and avoiding unnecessary peer dependency conflicts.
-- **🛡️ Strict Mode**: Opt-in `strict: true` to promote all warnings to errors, perfect for CI/CD and maintaining high code standards.
-- **🌐 Smart Runtime Support**: Built-in support for Node.js, Browser, or Universal runtimes with appropriate globals and rules.
-- **💅 Prettier Integrated**: Seamlessly integrated with Prettier out of the box for consistent code formatting.
-- **🧩 Extensive Plugin Support**: Tailored rules for Tailwind CSS, Vitest, Testing Library, Storybook, TanStack (Query/Router), and more.
-
-## 🚀 Quick Start
-
-### Installation
+## Quick start
 
 ```bash
 npm install -D eslint @santi020k/eslint-config-basic
 ```
 
-### Usage
-
-Create an `eslint.config.js` in your project root. By default, it will detect your project settings:
-
 ```js
+// eslint.config.js
 import { eslintConfig } from '@santi020k/eslint-config-basic'
 
 export default eslintConfig()
 ```
 
-### Comprehensive Example
-
-Here is an example with many features activated. Note that many of these are automatically detected if the corresponding packages are in your `package.json`.
-
-```js
-import { eslintConfig, Extension, Format, Library, Testing, Tool } from '@santi020k/eslint-config-basic'
-import next from '@santi020k/eslint-config-next'
-import react from '@santi020k/eslint-config-react'
-
-export default eslintConfig({
-  // Explicitly enable TypeScript (auto-detected if tsconfig.json exists)
-  typescript: true,
-
-  // Strict mode: warnings become errors
-  strict: true,
-
-  // Frameworks (imports are lazy-loaded)
-  frameworks: {
-    react,
-    next
-  },
-
-  // Optional integrations
-  libraries: [Library.Tailwind, Library.TanstackQuery],
-  testing: [Testing.Vitest, Testing.Playwright, Testing.TestingLibrary],
-  formats: [Format.Mdx, Format.Jsonc, Format.Graphql],
-  tools: [Tool.Prettier, Tool.Cspell],
-  extensions: [Extension.Unicorn, Extension.Sonarjs, Extension.Perfectionist]
-})
-```
-
-## Framework packages
-
-- TypeScript: [`@santi020k/eslint-config-typescript`](https://eslint.santi020k.me/frameworks/typescript.html)
-- React: [`@santi020k/eslint-config-react`](https://eslint.santi020k.me/frameworks/react.html)
-- Next.js: [`@santi020k/eslint-config-next`](https://eslint.santi020k.me/frameworks/next.html)
-- Astro: [`@santi020k/eslint-config-astro`](https://eslint.santi020k.me/frameworks/astro.html)
-- Vue: [`@santi020k/eslint-config-vue`](https://eslint.santi020k.me/frameworks/vue.html)
-- Svelte: [`@santi020k/eslint-config-svelte`](https://eslint.santi020k.me/frameworks/svelte.html)
-- Solid: [`@santi020k/eslint-config-solid`](https://eslint.santi020k.me/frameworks/solid.html)
-- Angular: [`@santi020k/eslint-config-angular`](https://eslint.santi020k.me/frameworks/angular.html)
-- NestJS: [`@santi020k/eslint-config-nest`](https://eslint.santi020k.me/frameworks/nest.html)
-- Expo: [`@santi020k/eslint-config-expo`](https://eslint.santi020k.me/frameworks/expo.html)
-- Qwik: [`@santi020k/eslint-config-qwik`](https://eslint.santi020k.me/frameworks/qwik.html)
-- Remix: [`@santi020k/eslint-config-remix`](https://eslint.santi020k.me/frameworks/remix.html)
-
-## Development
-
-```bash
-pnpm install    # Install dependencies
-pnpm run build  # Build all packages
-pnpm run test   # Run integration tests
-pnpm run lint   # Run linting checks
-pnpm run ok     # Run all checks
-```
-
----
-
-*Authored with ❤️ by [santi020k](https://santi020k.me)*
+Auto-detects TypeScript, frameworks, and common tools from your `package.json`. See the [full docs](https://eslint.santi020k.me/) for all options.

package/dist/index.js

@@ -6,32 +6,31 @@ import {
   createCoreConfig,
   detectProjectOptions,
   gitignore,
-  hasReactConfig,
   NextMode,
   Runtime,
   Setting
 } from "@santi020k/eslint-config-core";
 import { createTypescriptConfig } from "@santi020k/eslint-config-typescript";
 import {
-  Library,
-  Tool,
-  Extension,
-  Setting as Setting2,
-  Runtime as Runtime2,
-  Preset,
-  Testing,
-  Format,
-  NextMode as NextMode2,
-  ReactConfigKeys,
-  hasReactConfig as hasReactConfig2,
   coreConfig as coreConfig2,
   createCoreConfig as createCoreConfig2,
+  detectProjectOptions as detectProjectOptions2,
+  Extension,
+  Format,
   getGlobalsForRuntime,
-  jsConfig,
   gitignore as gitignore2,
-  detectProjectOptions as detectProjectOptions2
+  hasReactConfig,
+  jsConfig,
+  Library,
+  NextMode as NextMode2,
+  Preset,
+  ReactConfigKeys,
+  Runtime as Runtime2,
+  Setting as Setting2,
+  Testing,
+  Tool
 } from "@santi020k/eslint-config-core";
-import { typescriptConfig, tsConfig } from "@santi020k/eslint-config-typescript";
+import { tsConfig, typescriptConfig } from "@santi020k/eslint-config-typescript";
 import {
   cspell,
   cypress,
@@ -89,9 +88,19 @@ const eslintConfig = (options) => {
       "Next and Expo configurations require frameworks.react. Import @santi020k/eslint-config-react and pass it via frameworks.react."
     );
   }
+  const hasReact = !!frameworks.react;
+  const hasVue = !!frameworks.vue;
+  const hasSvelte = !!frameworks.svelte;
+  const hasSolid = !!frameworks.solid;
+  const useGitignore = !uniqueSettings.includes(Setting.NoGitignore);
   const reactParam = resolveFramework("react", frameworks.react);
   const nextParam = resolveFramework("next", frameworks.next);
-  const astroParam = resolveFramework("astro", frameworks.astro);
+  const astroParam = resolveFramework("astro", frameworks.astro, {
+    hasReact,
+    hasVue,
+    hasSvelte,
+    hasSolid
+  });
   const expoParam = resolveFramework("expo", frameworks.expo);
   const nestParam = resolveFramework("nest", frameworks.nest);
   const vueParam = resolveFramework("vue", frameworks.vue);
@@ -100,8 +109,6 @@ const eslintConfig = (options) => {
   const angularParam = resolveFramework("angular", frameworks.angular);
   const qwikParam = resolveFramework("qwik", frameworks.qwik);
   const remixParam = resolveFramework("remix", frameworks.remix);
-  const hasReact = hasReactConfig({ frameworks });
-  const useGitignore = !uniqueSettings.includes(Setting.NoGitignore);
   const runtimeCoreConfig = runtime !== Runtime.Universal ? createCoreConfig(runtime) : coreConfig;
   const configs = [
     // Settings
@@ -119,9 +126,17 @@ const eslintConfig = (options) => {
     ...runtimeCoreConfig,
     // React config (included if any React-based framework is used/passed)
     ...hasReact ? reactParam : [],
-    // Framework-specific configs (Modularized)
-    ...typescript ? createTypescriptConfig({ tsconfigRootDir }) : [],
     ...nextParam,
+    ...astroParam,
+    ...expoParam,
+    ...nestParam,
+    ...vueParam,
+    ...svelteParam,
+    ...solidParam,
+    ...angularParam,
+    ...qwikParam,
+    ...remixParam,
+    ...typescript ? createTypescriptConfig({ tsconfigRootDir }) : [],
     // Next.js App Router overrides (#12)
     ...frameworks.next && nextMode === NextMode.AppRouter ? [
       {
@@ -132,15 +147,6 @@ const eslintConfig = (options) => {
         }
       }
     ] : [],
-    ...astroParam,
-    ...expoParam,
-    ...nestParam,
-    ...vueParam,
-    ...svelteParam,
-    ...solidParam,
-    ...angularParam,
-    ...qwikParam,
-    ...remixParam,
     // Optionals
     ...getOptionalConfigs(
       uniqueLibraries,
@@ -174,7 +180,7 @@ export {
   getGlobalsForRuntime,
   gitignore2 as gitignore,
   graphql,
-  hasReactConfig2 as hasReactConfig,
+  hasReactConfig,
   i18next,
   jest,
   jsConfig,

package/dist/resolvers.d.ts

@@ -1,9 +1,9 @@
 import { ImportedFramework, FlatConfigArray, Preset, EslintConfigOptions } from '@santi020k/eslint-config-core';
 
 /**
- * Resolves an imported framework (either array or default export) into a config array.
+ * Resolves an imported framework (either array, object with default, or factory function) into a config array.
  */
-declare const resolveFramework: (frameworkName: string, framework?: ImportedFramework) => FlatConfigArray;
+declare const resolveFramework: (frameworkName: string, framework?: ImportedFramework, options?: Record<string, unknown>) => FlatConfigArray;
 /**
  * Resolves a preset into options
  */

package/dist/resolvers.js

@@ -7,14 +7,23 @@ import {
   Testing,
   Tool
 } from "@santi020k/eslint-config-core";
-const resolveFramework = (frameworkName, framework) => {
+const resolveFramework = (frameworkName, framework, options) => {
   if (!framework) return [];
   if (framework === true) {
     throw new TypeError(
       `Framework "${frameworkName}" requires an imported config. Install @santi020k/eslint-config-${frameworkName} and pass it via frameworks.${frameworkName}.`
     );
   }
-  return Array.isArray(framework) ? framework : framework.default;
+  if (typeof framework === "function") {
+    return framework(options);
+  }
+  if (typeof framework === "object" && "default" in framework) {
+    if (typeof framework.default === "function") {
+      return framework.default(options);
+    }
+    return framework.default;
+  }
+  return Array.isArray(framework) ? framework : [];
 };
 const resolvePreset = (preset) => {
   switch (preset) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/eslint-config-basic",
-  "version": "1.0.0",
+  "version": "1.2.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.0.0",
-    "@santi020k/eslint-config-optionals": "^1.0.0",
-    "@santi020k/eslint-config-typescript": "^1.0.0"
+    "@santi020k/eslint-config-core": "^1.2.0",
+    "@santi020k/eslint-config-optionals": "^1.2.0",
+    "@santi020k/eslint-config-typescript": "^1.2.0"
   },
   "peerDependencies": {
-    "eslint": "^9.0.0 || ^10.0.0",
-    "@santi020k/eslint-config-angular": "^1.0.0",
-    "@santi020k/eslint-config-astro": "^1.0.0",
-    "@santi020k/eslint-config-expo": "^1.0.0",
-    "@santi020k/eslint-config-nest": "^1.0.0",
-    "@santi020k/eslint-config-next": "^1.0.0",
-    "@santi020k/eslint-config-react": "^1.0.0",
-    "@santi020k/eslint-config-solid": "^1.0.0",
-    "@santi020k/eslint-config-svelte": "^1.0.0",
-    "@santi020k/eslint-config-vue": "^1.0.0",
-    "@santi020k/eslint-config-qwik": "^0.8.2",
-    "@santi020k/eslint-config-remix": "^0.8.2"
+    "@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"
   },
   "peerDependenciesMeta": {
     "@santi020k/eslint-config-angular": {