@viclafouch/eslint-config-viclafouch 4.22.1-beta.3 → 4.22.1-beta.5

package/.claude/settings.local.json

@@ -10,7 +10,10 @@
       "Bash(npm view:*)",
       "Bash(node -e:*)",
       "Bash(git add:*)",
-      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: update dependencies and refactor next config to flat config\n\n- Update all dependencies to latest versions\n- Refactor next.mjs to use nextPlugin.configs.recommended directly\n- Remove @eslint/eslintrc FlatCompat dependency\n- Reorganize exports alphabetically in index.mjs\n- Add ignores for *.d.ts files in eslint.config.mjs\n- Add coding conventions section to CLAUDE.md\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: update dependencies and refactor next config to flat config\n\n- Update all dependencies to latest versions\n- Refactor next.mjs to use nextPlugin.configs.recommended directly\n- Remove @eslint/eslintrc FlatCompat dependency\n- Reorganize exports alphabetically in index.mjs\n- Add ignores for *.d.ts files in eslint.config.mjs\n- Add coding conventions section to CLAUDE.md\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "WebSearch",
+      "Bash(npx eslint:*)",
+      "Bash(git -C /Users/victordelafouchardiere/Desktop/eslint-config-viclafouch status)"
     ]
   }
 }

package/CLAUDE.md

@@ -4,14 +4,15 @@ This file documents the **@viclafouch/eslint-config-viclafouch** project to faci
 
 ## What is this project?
 
-This is a reusable ESLint and Prettier configuration package published on npm. It provides a comprehensive, modular set of linting and formatting rules designed for modern JavaScript/TypeScript projects. The goal is to share consistent code quality standards across all of Victor de la Fouchardiere's projects.
+This is a reusable ESLint and Prettier configuration package published on npm. It provides a comprehensive, modular set of linting and formatting rules designed for modern TypeScript projects. The goal is to share consistent code quality standards across all of Victor de la Fouchardiere's projects.
 
 **Key features:**
-- JavaScript ES6+, TypeScript, JSX/TSX support
+- TypeScript-first configuration (all projects are TypeScript by default)
+- ES6+, JSX/TSX support
 - React.js and Next.js frameworks
 - Tailwind CSS v4 linting
-- Testing libraries support
 - Promise handling and best practices
+- Unicorn plugin for modern JavaScript
 
 ## File Structure
 
@@ -21,14 +22,13 @@ This is a reusable ESLint and Prettier configuration package published on npm. I
 |------|-------------|
 | `index.mjs` | Main entry point, exports all configuration modules |
 | `index.d.ts` | TypeScript type definitions for the package |
-| `eslint.config.mjs` | ESLint configuration for this package itself (uses baseConfig + prettierConfig) |
+| `eslint.config.mjs` | ESLint configuration for this package itself |
 
 ### Configuration Modules (root)
 
 | File | Description |
 |------|-------------|
-| `base.mjs` | Core JavaScript/TypeScript linting rules (imports all `/rules/` files) |
-| `typescript.mjs` | TypeScript-specific rules with parser and project service |
+| `typescript.mjs` | Wrapper that exports `rules/typescript.mjs` |
 | `react.mjs` | React library rules and JSX accessibility (jsx-a11y) |
 | `next.mjs` | Next.js-specific rules (extends react + hooks + Next.js plugin) |
 | `hooks.mjs` | React Hooks rules (rules-of-hooks, exhaustive-deps, useState naming) |
@@ -36,6 +36,15 @@ This is a reusable ESLint and Prettier configuration package published on npm. I
 | `prettier.mjs` | Prettier integration via eslint-plugin-prettier |
 | `better-tailwindcss.mjs` | Tailwind CSS v4 linting (function accepting `{ entryPoint }`) |
 
+### Rules Directory
+
+| File | Description |
+|------|-------------|
+| `rules/typescript.mjs` | **Main configuration file.** Contains all base rules (best practices, ES6+, variables, errors, style, node) + TypeScript rules + Unicorn + Promise plugins |
+| `rules/imports.mjs` | Import sorting rules with alias detection from tsconfig/jsconfig |
+| `rules/react.mjs` | React-specific rules |
+| `rules/react-hooks.mjs` | React Hooks rules |
+
 ### Utility Files for Other Projects
 
 | File | Description |
@@ -61,51 +70,34 @@ npm run publish:beta  # Publish beta version
 Each module exports an array of configurations that can be spread:
 
 ```javascript
-// Minimal setup
-import { baseConfig } from '@viclafouch/eslint-config-viclafouch'
-export default [...baseConfig]
-
-// Full Next.js setup
-import { baseConfig, typescriptConfig, nextConfig, prettierConfig } from '@viclafouch/eslint-config-viclafouch'
-export default [...baseConfig, ...typescriptConfig, ...nextConfig, ...prettierConfig]
+// Typical Next.js setup
+import {
+  typescriptConfig,
+  nextConfig,
+  importsConfig,
+  prettierConfig
+} from '@viclafouch/eslint-config-viclafouch'
+
+export default [
+  { ignores: ['**/node_modules/**', '**/.next/**'] },
+  ...typescriptConfig,
+  ...nextConfig,
+  ...importsConfig,
+  ...prettierConfig
+]
 ```
 
 ### Loading Hierarchy
 
-1. **baseConfig** → loads 7 rule modules + Unicorn plugin
-2. **typescriptConfig** → replaces some rules with TypeScript versions
-3. **reactConfig** → adds JSX/a11y rules
-4. **nextConfig** → extends react + hooks + Next.js plugin
-5. **importsConfig** → organizes import sorting
-6. **prettierConfig** → formatting (must be last)
-7. **betterTailwindcssConfig({ entryPoint })** → Tailwind CSS v4
-
-## Usage in Other Projects
-
-### Extending tsconfig.json
-
-```json
-{
-  "extends": "@viclafouch/eslint-config-viclafouch/tsconfig.json",
-  "compilerOptions": {
-    // Project-specific overrides
-  }
-}
-```
-
-### Using reset.d.ts
-
-The `reset.d.ts` file re-exports improved types from `@total-typescript/ts-reset`, providing:
-
-- Better inference for `.filter(Boolean)`
-- Stricter types for `JSON.parse`
-- Improved `Array.includes()`
-
-To use it, reference it in your project's tsconfig.json or include it in your types.
+1. **typescriptConfig** → Base configuration with all rules (ES6+, best practices, TypeScript, Unicorn, Promise)
+2. **nextConfig** → Next.js rules (includes React + Hooks + a11y)
+3. **reactConfig** + **hooksConfig** → For React without Next.js
+4. **importsConfig** → Import sorting
+5. **betterTailwindcssConfig({ entryPoint })** → Tailwind CSS v4
+6. **prettierConfig** → Formatting (must be last)
 
 ## Integrated Plugins
 
-- `@eslint/js` - Core ESLint rules
 - `typescript-eslint` - TypeScript linting
 - `eslint-plugin-react` - React rules
 - `eslint-plugin-react-hooks` - Hooks enforcement
@@ -132,6 +124,8 @@ To use it, reference it in your project's tsconfig.json or include it in your ty
 - Use `'off'` for rules that should be disabled
 - **NEVER use `'warn'`** - warnings are not acceptable in this configuration
 
+**Exception**: `no-console` uses `'warn'` to allow console statements during development.
+
 This ensures that linting is either passing or failing, with no ambiguous middle ground.
 
 ### Rule Comment Format
@@ -162,4 +156,4 @@ For TypeScript rules, use the appropriate documentation URL:
 - TypeScript ESLint: `https://typescript-eslint.io/rules/rule-name`
 - React: `https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/rule-name.md`
 - React Hooks: `https://react.dev/reference/rules/rules-of-hooks`
-
+- Unicorn: `https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/rule-name.md`

package/README.md

@@ -1,258 +1,177 @@
-# Eslint / Prettier Setup of @viclafouch 📦
+# @viclafouch/eslint-config-viclafouch
 
-These are the ESLint and Prettier settings for a Next.js project ⚡️
+ESLint and Prettier configuration for modern TypeScript projects.
 
+## Installation
 
-# Table of Contents
-
-- [Eslint / Prettier Setup of @viclafouch 📦](#eslint--prettier-setup-of-viclafouch-)
-- [Table of Contents](#table-of-contents)
-  - [What it does](#what-it-does)
-  - [Local / Per Project Install](#local--per-project-install)
-    - [Scripts](#scripts)
-  - [If you use TypeScript](#if-you-use-typescript)
-    - [Extend your tsconfig](#extend-your-tsconfig)
-    - [Add the typescript eslint config](#add-the-typescript-eslint-config)
-    - [Better typing](#better-typing)
-    - [Scripts](#scripts-1)
-  - [If you want to enable imports sorting](#if-you-want-to-enable-imports-sorting)
-  - [If you use Next.js](#if-you-use-nextjs)
-  - [If you use React.js](#if-you-use-reactjs)
-  - [If you use Tailwind CSS v4](#if-you-use-tailwind-css-v4)
-  - [If you want to use Prettier](#if-you-want-to-use-prettier)
-  - [If you use VS Code](#if-you-use-vs-code)
-
-## What it does
-
-* Lints JavaScript / TypeScript based on the latest standards
-* Multiple configs `react` `hooks` `next` `tailwindcss`..
-* Shared `tsconfig.json`
-* Fixes issues and formatting errors with Prettier
-* Check for accessibility rules on JSX elements.
-
-## Local / Per Project Install
-
-1. If you don't already have a `package.json` file, create one with `npm init`.
-
-2. Then we need to install the config:
-
-```
+```bash
 npm i -D @viclafouch/eslint-config-viclafouch
 ```
 
-3. Make sure your `package.json` has `"type": "module"`:
+## Quick Init (recommended)
 
-```json
-{
-  "name": "your-project",
-  "type": "module",
-  ...
-}
+```bash
+npx @viclafouch/eslint-config-viclafouch
 ```
 
-4. Create a `eslint.config.js` file in the root of your project's directory (it should live where package.json does).
+This will prompt you to select your stack and create the `eslint.config.js` file automatically.
 
-5. Extends your config with the minimal base of @viclafouch config :
+## Manual Setup (React + Tailwind)
 
 ```js
-import { baseConfig } from '@viclafouch/eslint-config-viclafouch'
+// eslint.config.js
+import {
+  betterTailwindcssConfig,
+  importsConfig,
+  prettierConfig,
+  reactConfig,
+  typescriptConfig
+} from '@viclafouch/eslint-config-viclafouch'
 
 /**
  * @type {import("eslint").Linter.Config}
  */
 export default [
-  ...baseConfig,
   {
-    ignores: ['**/node_modules/**']
-  }
+    ignores: [
+      '**/node_modules/**',
+      '**/.output/**',
+      '**/.tanstack/**'
+    ]
+  },
+  ...typescriptConfig,
+  ...reactConfig,
+  ...importsConfig,
+  ...betterTailwindcssConfig({ entryPoint: 'src/styles.css' }),
+  ...prettierConfig
 ]
 ```
 
-### Scripts
-
-You can add two scripts to your package.json to lint and/or fix your code:
-
-```json
-{
-  "scripts": {
-    "lint": "eslint",
-    "lint:fix": "npm run lint -- --fix",
-  }
-}
-```
-## If you use TypeScript
-
-### Extend your tsconfig
+## Stack Examples
 
-First, extend your current config file `tsconfig.json` with this following snippet:
-
-```json
-{
-  "extends": "@viclafouch/eslint-config-viclafouch/tsconfig.json",
-  ...
-}
-```
-
-### Add the typescript eslint config
-
-Then, add the TypeScript Eslint rules to your `.eslintrc` file:
+### React + Vite (without Tailwind)
 
 ```js
-import { baseConfig, typescriptConfig } from '@viclafouch/eslint-config-viclafouch'
+// eslint.config.js
+import {
+  hooksConfig,
+  importsConfig,
+  prettierConfig,
+  reactConfig,
+  typescriptConfig
+} from '@viclafouch/eslint-config-viclafouch'
 
 /**
  * @type {import("eslint").Linter.Config}
  */
 export default [
-  ...baseConfig,
+  { ignores: ['**/node_modules/**', '**/dist/**'] },
   ...typescriptConfig,
-  {
-    ignores: ['**/node_modules/**']
-  }
+  ...reactConfig,
+  ...hooksConfig,
+  ...importsConfig,
+  ...prettierConfig
 ]
 ```
 
-### Better typing
-
-TypeScript's built-in typings are not perfect. viclafouch-reset makes them better.
-
-1. Create a `reset.d.ts` file in your project with these contents:
-
-```ts
-// Do not add any other lines of code to this file!
-import '@viclafouch/eslint-config-viclafouch/reset.d'
-```
-
-2. Enjoy improved typings across your entire project.
-
-### Scripts
-
-You can add two scripts to your package.json to lint and/or fix your code:
-
-```json
-{
-  "scripts": {
-    "lint": "tsc --noEmit && eslint",
-    "lint:fix": "npm run lint -- --fix",
-  },
-}
-```
-
-## If you want to enable imports sorting
-
-If you want to sort your imports using your alias at the same time from your `jsonfig.json` or `tsconfig.json` file.
+### Pure TypeScript (Node.js, lib)
 
 ```js
-import { baseConfig, importsConfig } from '@viclafouch/eslint-config-viclafouch'
+// eslint.config.js
+import {
+  importsConfig,
+  prettierConfig,
+  typescriptConfig
+} from '@viclafouch/eslint-config-viclafouch'
 
 /**
  * @type {import("eslint").Linter.Config}
  */
 export default [
-  ...baseConfig,
+  { ignores: ['**/node_modules/**', '**/dist/**'] },
+  ...typescriptConfig,
   ...importsConfig,
-  {
-    ignores: ['**/node_modules/**']
-  }
+  ...prettierConfig
 ]
 ```
 
-## If you use Next.js
-
-You can also add additional rules for Next.js. It includes the following configurations : `reactConfig`, `hooksConfig` and Next.js specific rules.
+### Next.js
 
 ```js
-import { baseConfig, nextConfig } from '@viclafouch/eslint-config-viclafouch'
+// eslint.config.js
+import {
+  betterTailwindcssConfig,
+  importsConfig,
+  nextConfig,
+  prettierConfig,
+  typescriptConfig
+} from '@viclafouch/eslint-config-viclafouch'
 
 /**
  * @type {import("eslint").Linter.Config}
  */
 export default [
-  ...baseConfig,
+  { ignores: ['**/node_modules/**', '**/.next/**'] },
+  ...typescriptConfig,
   ...nextConfig,
-  {
-    ignores: ['**/node_modules/**', '**/dist/**', '**/.next/**']
-  }
+  ...importsConfig,
+  ...betterTailwindcssConfig({ entryPoint: 'src/app/globals.css' }),
+  ...prettierConfig
 ]
 ```
 
-## If you use React.js
+## Available Configurations
 
-You can also add additional rules for only React.js ecosystem (without Next.js).
+| Config | Description |
+|--------|-------------|
+| `typescriptConfig` | **Required base.** TypeScript, ES6+, best practices, unicorn, promise |
+| `reactConfig` | React and JSX a11y |
+| `hooksConfig` | React Hooks |
+| `nextConfig` | Next.js (includes React + Hooks + a11y) |
+| `importsConfig` | Automatic import sorting |
+| `betterTailwindcssConfig({ entryPoint })` | Tailwind CSS v4 |
+| `prettierConfig` | Prettier (always last) |
 
-```js
-import { baseConfig, hooksConfig, reactConfig } from '@viclafouch/eslint-config-viclafouch'
+## TypeScript
 
-/**
- * @type {import("eslint").Linter.Config}
- */
-export default [
-  ...baseConfig,
-  ...hooksConfig,
-  ...reactConfig,
-  {
-    ignores: ['**/node_modules/**']
+### Extend tsconfig.json
+
+```json
+{
+  "extends": "@viclafouch/eslint-config-viclafouch/tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
   }
-]
+}
 ```
 
-## If you use Tailwind CSS v4
+### Better Typing with reset.d.ts
 
-You can add linting rules for Tailwind CSS v4 using `eslint-plugin-better-tailwindcss`. You need to provide the path to your CSS entry file via the `entryPoint` option.
+Improves native types (`.filter(Boolean)`, `JSON.parse`, `Array.includes()`, etc.):
 
-```js
-import { baseConfig, betterTailwindcssConfig } from '@viclafouch/eslint-config-viclafouch'
-
-/**
- * @type {import("eslint").Linter.Config}
- */
-export default [
-  ...baseConfig,
-  ...betterTailwindcssConfig({
-    entryPoint: 'src/global.css'
-  }),
-  {
-    ignores: ['**/node_modules/**']
-  }
-]
+```ts
+import '@viclafouch/eslint-config-viclafouch/reset.d'
 ```
 
-## If you want to use Prettier
-
-Be sure for the prettier config to be the last one.
-
-```js
-import {
-  baseConfig,
-  hooksConfig,
-  importsConfig,
-  prettierConfig,
-  reactConfig,
-  typescriptConfig
-} from '@viclafouch/eslint-config-viclafouch'
+## Scripts
 
-/**
- * @type {import("eslint").Linter.Config}
- */
-export default [
-  ...baseConfig,
-  ...reactConfig,
-  ...hooksConfig,
-  ...importsConfig,
-  ...typescriptConfig,
-  ...prettierConfig,
-  {
-    ignores: ['**/node_modules/**', '**/dist/**']
+```json
+{
+  "type": "module",
+  "scripts": {
+    "lint": "tsc --noEmit && eslint .",
+    "lint:fix": "npm run lint -- --fix"
   }
-]
+}
 ```
 
-## If you use VS Code
-
-Once you have done. You probably want your editor to lint and fix for you.
+## VS Code
 
-1. Install the [ESLint package](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
-2. Now we need to setup some VS Code settings. Create a `.vscode` folder at your root project, and create a `settings.json` file in this folder. Then, add this little config:
+1. Install the [ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
+2. Create a `.vscode` folder at your root project, and create a `settings.json` file:
 
 ```json
 {
@@ -261,3 +180,12 @@ Once you have done. You probably want your editor to lint and fix for you.
   }
 }
 ```
+
+## Configuration Order
+
+1. `ignores` (always first)
+2. `typescriptConfig` (base)
+3. `reactConfig` / `nextConfig` / `hooksConfig`
+4. `importsConfig`
+5. `betterTailwindcssConfig`
+6. `prettierConfig` (always last)

package/bin/init.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { createInterface } from 'node:readline'
+import { fileURLToPath } from 'node:url'
+
+const filename = fileURLToPath(import.meta.url)
+const directory = dirname(filename)
+
+const TEMPLATES = {
+  1: { name: 'React + Tailwind', file: 'react.js' },
+  2: { name: 'Next.js + Tailwind', file: 'nextjs.js' },
+  3: { name: 'Pure TypeScript', file: 'typescript.js' }
+}
+
+const rl = createInterface({
+  input: process.stdin,
+  output: process.stdout
+})
+
+function question(query) {
+  return new Promise((resolve) => {
+    rl.question(query, resolve)
+  })
+}
+
+async function main() {
+  console.log('\n@viclafouch/eslint-config-viclafouch\n')
+  console.log('Select your stack:\n')
+
+  for (const [key, value] of Object.entries(TEMPLATES)) {
+    console.log(`  ${key}. ${value.name}`)
+  }
+
+  console.log('')
+
+  const answer = await question('Your choice (1-3): ')
+  const choice = TEMPLATES[answer]
+
+  if (!choice) {
+    console.log('\nInvalid choice. Exiting.\n')
+    rl.close()
+    process.exit(1)
+  }
+
+  const templatePath = join(directory, '..', 'templates', choice.file)
+  const targetPath = join(process.cwd(), 'eslint.config.js')
+
+  if (existsSync(targetPath)) {
+    const overwrite = await question(
+      '\neslint.config.js already exists. Overwrite? (y/N): '
+    )
+
+    if (overwrite.toLowerCase() !== 'y') {
+      console.log('\nAborted.\n')
+      rl.close()
+      process.exit(0)
+    }
+  }
+
+  const template = readFileSync(templatePath, 'utf-8')
+  writeFileSync(targetPath, template)
+
+  console.log(`\neslint.config.js created with ${choice.name} configuration.\n`)
+  console.log('Next steps:')
+  console.log('  1. Run: npm i -D @viclafouch/eslint-config-viclafouch')
+  console.log('  2. Run: npm run lint\n')
+
+  rl.close()
+}
+
+main().catch((error) => {
+  console.error(error)
+  process.exit(1)
+})

package/eslint.config.mjs

@@ -1,4 +1,4 @@
-import { baseConfig, prettierConfig } from './index.mjs'
+import { prettierConfig, typescriptConfig } from './index.mjs'
 
 /**
  * @type {import("eslint").Linter.Config}
@@ -7,7 +7,7 @@ export default [
   {
     ignores: ['**/*.d.ts']
   },
-  ...baseConfig,
+  ...typescriptConfig,
   ...prettierConfig,
   {
     rules: {

package/index.d.ts

@@ -1,6 +1,5 @@
 import type { Linter } from 'eslint'
 
-export declare const baseConfig: Linter.Config[]
 export declare const typescriptConfig: Linter.Config[]
 export declare const reactConfig: Linter.Config[]
 export declare const nextConfig: Linter.Config[]

package/index.mjs

@@ -1,4 +1,3 @@
-export { default as baseConfig } from './base.mjs'
 export { default as betterTailwindcssConfig } from './better-tailwindcss.mjs'
 export { default as hooksConfig } from './hooks.mjs'
 export { default as importsConfig } from './imports.mjs'

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@viclafouch/eslint-config-viclafouch",
-  "version": "4.22.1-beta.3",
+  "version": "4.22.1-beta.5",
   "description": "ESLint and Prettier Config from Victor de la Fouchardiere",
   "type": "module",
   "main": "./index.mjs",
   "types": "./index.d.ts",
+  "bin": {
+    "eslint-config-viclafouch": "./bin/init.js"
+  },
   "exports": {
     ".": {
       "types": "./index.d.ts",

package/rules/react.mjs

@@ -365,7 +365,7 @@ export default [
 
       // Enforce sandbox attribute on iframe elements
       // https://github.com/jsx-eslint/eslint-plugin-react/blob/c8833f301314dab3e79ef7ac4cf863e4d5fa0019/docs/rules/iframe-missing-sandbox.md
-      'react/iframe-missing-sandbox': 'error',
+      'react/iframe-missing-sandbox': 'off',
 
       // Prevent problematic leaked values from being rendered
       // https://github.com/jsx-eslint/eslint-plugin-react/blob/c42b624d0fb9ad647583a775ab9751091eec066f/docs/rules/jsx-no-leaked-render.md