@fabdeh/eslint-config 0.2.3 → 0.4.0

package/README.md

@@ -9,14 +9,14 @@
 - Designed to work with TypeScript, JSX, etc. Out-of-box.
 - Opinionated, but [very customizable](#customization)
 - [ESLint Flat config](https://eslint.org/docs/latest/use/configure/configuration-files-new), compose easily!
-- Automatic [Angular](#angular), [NGRX](#ngrx), [TailwindCSS](#tailwindcc), [Vitest](#vitest) support when the corresponding dependency is detected.
-<!--- - Optional [formatters](#formatters) support for formatting CSS, HTML, XML, etc. --->
+- Automatic [Angular](#angular), [NGRX](#ngrx), [TypeScript](#typescript), [Vitest](#vitest) support when the corresponding dependency is detected.
+- Optional [formatters](#formatters) support for formatting CSS, HTML, XML, etc.
 - **Style principle**: Minimal for reading, stable for diff, consistent
   - Sorted imports, dangling commas
   - Single quotes, no semi
   - Using [ESLint Stylistic](https://github.com/eslint-stylistic/eslint-stylistic)
 - Respects `.gitignore` by default
-- Requires ESLint v9.5.0+
+- Requires ESLint v9.21.0+
 
 > [!WARNING]
 > Please keep in mind that this is **_a personal config_** with a lot opinions. Changes might not always be pleased by everyone and every use cases.
@@ -49,8 +49,8 @@ For example:
 ```json
 {
   "scripts": {
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint": "eslint . --fix",
+    "lint:ci": "eslint ."
   }
 }
 ```
@@ -78,11 +78,27 @@ Add the following settings to your `.vscode/settings.json`:
     "source.organizeImports": "never"
   },
 
-  // Silent the stylistic rules in you IDE, but still auto fix them
+  // Silence the style rules in you IDE, but still fix them automatically
   "eslint.rules.customizations": [{ "rule": "@stylistic/*", "severity": "off", "fixable": true }],
 
   // Enable eslint for all supported languages
-  "eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact", "html"]
+  "eslint.validate": [
+    "css",
+    "html",
+    "javascript",
+    "javascriptreact",
+    "json",
+    "jsonc",
+    "json5",
+    "less",
+    "markdown",
+    "scss",
+    "typescript",
+    "typescriptreact",
+    "toml",
+    "yaml",
+    "xml"
+  ]
 }
 ```
 
@@ -202,6 +218,242 @@ Check out the [configs](https://github.com/FabienDehopre/eslint-config/blob/main
 
 > Thanks to [antfu/eslint-config](https://github.com/antfu/eslint-config) for the inspiration and reference.
 
+### Rules Overrides
+
+All the rules are always bound to one or more file extensions (via minimatch pattern. i.e.: \*_/_.?([cm])[jt]s?(x) for all JS and TS file types including JSX syntax).
+If you want to override the rules, you need to specify the file extension:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig(
+  {
+    typescript: true,
+    vitest: true
+  },
+  {
+    // Remember to specify the file glob here, otherwise it might cause the vitest plugin to handle non-spec files
+    files: ['**/*.spec.?([cm])[jt]s', '**/*.test.?([cm])[jt]s'],
+    rules: {
+      'vitest/consistent-test-it': ['error', { fn: 'it' }],
+    }
+  },
+  {
+    // Without `files`, they are general rules for all files
+    rules: {
+      '@stylistic/semi': ['error', 'never']
+    }
+  }
+);
+```
+
+We also provide the `overrides` option in each integration to make it easier:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  typescript: {
+    overrides: {
+      '@typescript-eslint/consisten-type-definitions': ['error', 'interface'],
+    },
+  },
+  angular: {
+    tsOverrides: {
+      '@angular-eslint/prefer-signals': 'off',
+    },
+    htmlOverrides: {
+      '@angular-eslint/template/no-any': 'warn',
+    },
+  },
+  yaml: {
+    overrides: {
+      // ...
+    }
+  }
+});
+```
+
+### Auto-detected integrations
+
+The following integrations are automatically enabled if the corresponding package is installed in your project:
+
+- [TypeScript](#typescript)
+- [Angular](#angular)
+- [NgRx](#ngrx)
+- [Vitest](#vitest)
+
+#### TypeScript
+
+Most of TypeScript rules are enable automatically if `typescript` package is installed in you project. Some `@typescript-eslint` rules are also enabled by default for JavaScript files.
+You can explicitly enable/disable TypeScript integration manually:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  typescript: true,
+});
+```
+
+##### Erasable Syntax Only
+
+The TypeScript integration also allow you to turn on/off rules that will report on using syntax that will not be allowed by TypeScript's [--erasableSyntaxOnly option](https://devblogs.microsoft.com/typescript/announcing-typescript-5-8-beta/#the---erasablesyntaxonly-option):
+
+> Recently, Node.js 23.6 unflagged [experimental support for running TypeScript files directly](https://nodejs.org/api/typescript.html#type-stripping); however, only certain constructs are supported under this mode.
+>
+> ...
+>
+> TypeScript 5.8 introduces the `--erasableSyntaxOnly` flag. When this flag is enabled, TypeScript will only allow you to use constructs that can be erased from a file, and will issue an error if it encounters any constructs that cannot be erased.
+
+You can enable these rules as follow:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  typescript: {
+    enableErasableSyntaxOnly: true,
+  },
+});
+```
+
+These rules are disabled by default and therefore the associated ESLint plugin is also not installed by default.
+Running `pnpx eslint` should prompt you to install the required plugin; otherwise, you can install it manually:
+
+```bash
+pnpm add -D eslint-plugin-erasable-syntax-only
+```
+
+#### Angular
+
+Angular support is detected automatically by checking if `@angular/core` is installed in your project. You can also explicitly enable/disable it:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  angular: true,
+});
+```
+
+#### NgRx
+
+NgRx support is also detected automatically if any of the following package is installed in your project.
+
+- `@ngrx/store`
+- `@ngrx/effects`
+- `@ngrx/signals`
+- `@ngrx/operators`
+
+As the Angular integration is can be explicitly enabled/disabled:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  ngrx: true,
+});
+```
+
+> Of course, NgRx depends on Angular so the Angular integration will be enabled as well.
+
+#### Vitest
+
+The vitest integration is detected automatically by checking if `vitest` is installed in your project. It can be enable/disable manually in the configuration:
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  vitest: true,
+});
+```
+
+### Optional integrations
+
+We provide some optional integrations for specific use cases, that we don't include their dependencies by default.
+
+#### Formatters
+
+Use external formatters to format files that ESLint cannot handle yet (`.css`, `.html`, etc). Powered by [`eslint-plugin-format`](https://github.com/antfu/eslint-plugin-format).
+
+```js
+// eslint.config.js
+import { createConfig } from '@fabdeh/eslint-config';
+
+export default createConfig({
+  formatters: {
+    /**
+     * Format CSS, LESS, SCSS files
+     */
+    css: true,
+    /**
+     * Format HTML files
+     */
+    html: true,
+    /**
+     * Format Markdown files
+     */
+    markdown: true,
+  }
+});
+```
+
+Running `npx eslint` should prompt you to install the required dependencies; otherwise, you can install them manually:
+
+```bash
+pnpm add -D eslint-plugin-format
+```
+
+### Lint Staged
+
+If you want to apply lint and auto-fix before every commit, you can add the following to your `package.json`:
+
+```json
+{
+  "simple-git-hooks": {
+    "pre-commit": "pnpm nano-staged"
+  },
+  "nano-staged": {
+    "*": "eslint --fix"
+  }
+}
+```
+
+and then
+
+```bash
+pnpm add -D nano-staged simple-git-hooks
+
+# then, to activate the hooks
+pnpm simple-git-hooks
+```
+
+## Versioning Policy
+
+This project follows [Semantic Versioning](https://semver.org/) for releases. However, since this is just a config and involves opinions and many moving parts, we don't treat rules changes as breaking changes.
+
+### Changes Considered as Breaking Changes
+
+- Node.js version requirement changes
+- Huge refactors that might break the config
+- Plugins made major changes that might break the config
+- Changes that might affect most of the codebases
+
+### Changes Considered as Non-breaking Changes
+
+- Enable/disable rules and plugins (that might become stricter)
+- Rules options changes
+- Version bumps of dependencies
+
 ## License
 
 [MIT](./LICENSE) License &copy; 2025-PRESENT [Fabien Dehopré](https://github.com/FabienDehopre)

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { ConfigArray, ConfigWithExtends } from 'typescript-eslint';
-import { StylisticCustomizeOptions } from '@stylistic/eslint-plugin';
-import { TSESLint } from '@typescript-eslint/utils';
-import { FlatGitignoreOptions } from 'eslint-config-flat-gitignore';
+import type { ConfigArray, ConfigWithExtends } from 'typescript-eslint';
+import type { StylisticCustomizeOptions } from '@stylistic/eslint-plugin';
+import type { TSESLint } from '@typescript-eslint/utils';
+import type { FlatGitignoreOptions } from 'eslint-config-flat-gitignore';
 
 /**
  * Vendor types from Prettier so we don't rely on the dependency.
@@ -136,6 +136,11 @@ interface VendoredPrettierOptionsRequired {
     xmlWhitespaceSensitivity: 'ignore' | 'preserve' | 'strict';
 }
 
+
+
+
+
+
 /**
  * A type that can be awaited. Promise<T> or T.
  */
@@ -170,9 +175,9 @@ interface UnicornOptions {
     allRecommended?: boolean;
 }
 /**
- * An alias for the `StylisticCustomizeOptions` type without the `flat`, `name`, and `pluginName` properties.
+ * An alias for the `StylisticCustomizeOptions` type without the `pluginName` property.
  */
-type StylisticConfig = Omit<StylisticCustomizeOptions, 'flat' | 'name' | 'pluginName'>;
+type StylisticConfig = Omit<StylisticCustomizeOptions, 'pluginName'>;
 /**
  * Interface representing the stylistic options.
  */
@@ -191,6 +196,14 @@ interface TypeScriptParserOptions {
      */
     parserOptions?: TSESLint.FlatConfig.ParserOptions;
 }
+interface TypeScriptErasableSyntaxOnlyOptions {
+    /**
+     * Indicates whether the erasable syntax only rules should be enabled or not.
+     *
+     * @default false
+     */
+    enableErasableSyntaxOnly?: boolean;
+}
 /**
  * Options for configuring Angular-specific linting rules.
  */
@@ -289,6 +302,13 @@ interface RegExpOptions {
      */
     level?: 'error' | 'warn';
 }
+interface TailwindcssParserPerGlobOptions {
+    /**
+     * Provides a specific ESLint parser per glob pattern.
+     * This is only needed if you want to lint tailwindcss without using Angular and TypeScript.
+     */
+    parsers?: Record<string, TSESLint.FlatConfig.Parser>;
+}
 /**
  * Options for creating an ESLint configuration.
  *
@@ -313,7 +333,7 @@ interface CreateConfigOptions {
      *
      * @default auto-detected
      */
-    typescript?: boolean | (OverridesOptions & TypeScriptParserOptions);
+    typescript?: boolean | (OverridesOptions & TypeScriptErasableSyntaxOnlyOptions & TypeScriptParserOptions);
     /**
      * Enable stylistic rules.
      *
@@ -321,6 +341,12 @@ interface CreateConfigOptions {
      * @default true
      */
     stylistic?: boolean | (OverridesOptions & StylisticConfig);
+    /**
+     * Enable or disable JSDoc rules.
+     *
+     * @default true
+     */
+    jsdoc?: boolean;
     /**
      * Enable regexp rules.
      *
@@ -355,9 +381,9 @@ interface CreateConfigOptions {
     /**
      * Options for the TailwindCSS linting rules.
      *
-     * @default auto-detect based on dependencies.
+     * @default false
      */
-    tailwindcss?: OverridesOptions | boolean;
+    tailwindcss?: boolean | (FilesOptions & OverridesOptions) | (OverridesOptions & TailwindcssParserPerGlobOptions);
     /**
      * Enable JSONC support.
      *
@@ -397,6 +423,9 @@ interface CreateConfigOptions {
     formatters?: FormattersOptions | boolean;
 }
 
+
+
+
 /**
  * Generates an ESLint configuration for Angular projects.
  *
@@ -409,6 +438,8 @@ interface CreateConfigOptions {
  */
 declare function angular(options?: AngularOptions): Promise<ConfigArray>;
 
+
+
 /**
  * Generates a configuration array for ESLint comments rules.
  *
@@ -420,6 +451,8 @@ declare function angular(options?: AngularOptions): Promise<ConfigArray>;
  */
 declare function comments(): ConfigArray;
 
+
+
 /**
  * Generates a configuration array for ESLint with default and user-defined ignore patterns.
  *
@@ -428,6 +461,9 @@ declare function comments(): ConfigArray;
  */
 declare function ignores(userIgnores?: string[]): ConfigArray;
 
+
+
+
 /**
  * Generates an ESLint configuration array for import rules.
  *
@@ -437,6 +473,9 @@ declare function ignores(userIgnores?: string[]): ConfigArray;
  */
 declare function imports(options?: StylisticOptions): ConfigArray;
 
+
+
+
 /**
  * Generates a configuration array for JavaScript projects with ESLint.
  *
@@ -455,6 +494,9 @@ declare function imports(options?: StylisticOptions): ConfigArray;
  */
 declare function javascript(options?: OverridesOptions): ConfigArray;
 
+
+
+
 /**
  * Generates a configuration array for JSDoc rules.
  *
@@ -464,6 +506,13 @@ declare function javascript(options?: OverridesOptions): ConfigArray;
  */
 declare function jsdoc(options?: StylisticOptions): ConfigArray;
 
+
+
+
+
+
+
+
 /**
  * Generates an ESLint configuration for JSONC files.
  *
@@ -484,6 +533,11 @@ declare function jsdoc(options?: StylisticOptions): ConfigArray;
  */
 declare function jsonc(options?: FilesOptions & OverridesOptions & StylisticOptions): Promise<ConfigArray>;
 
+
+
+
+
+
 /**
  * Configures ESLint for Markdown files.
  *
@@ -506,6 +560,9 @@ declare function jsonc(options?: FilesOptions & OverridesOptions & StylisticOpti
  */
 declare function markdown(options?: FilesOptions & OverridesOptions): Promise<ConfigArray>;
 
+
+
+
 /**
  * Generates an ESLint configuration array for NgRx based on the provided options.
  *
@@ -529,6 +586,8 @@ declare function markdown(options?: FilesOptions & OverridesOptions): Promise<Co
  */
 declare function ngrx(options?: NgrxOptions): Promise<ConfigArray>;
 
+
+
 /**
  * Generates a configuration array for the "perfectionist" ESLint plugin.
  *
@@ -542,12 +601,21 @@ declare function ngrx(options?: NgrxOptions): Promise<ConfigArray>;
  */
 declare function perfectionist(): Promise<ConfigArray>;
 
+
+
+
+
+
 /**
+ * Configure the recommended regexp rules.
  *
- * @param options
+ * @param options - The options
+ * @returns The ESLint configuration for regexp linting
  */
 declare function regexp(options?: OverridesOptions & RegExpOptions): ConfigArray;
 
+
+
 /**
  * Configures ESLint rules for sorting keys and array values in `package.json` files.
  *
@@ -573,6 +641,11 @@ declare function sortPackageJson(): ConfigArray;
  */
 declare function sortTsConfig(): ConfigArray;
 
+
+
+
+
+
 declare const STYLISTIC_CONFIG_DEFAULT: StylisticConfig;
 /**
  * Generates a stylistic ESLint configuration.
@@ -584,6 +657,13 @@ declare const STYLISTIC_CONFIG_DEFAULT: StylisticConfig;
  */
 declare function stylistic(options?: StylisticOptions): Promise<ConfigArray>;
 
+
+
+
+
+
+
+
 /**
  * Generates an ESLint configuration array for Tailwind CSS.
  *
@@ -596,7 +676,14 @@ declare function stylistic(options?: StylisticOptions): Promise<ConfigArray>;
  *   },
  * });
  */
-declare function tailwindcss(options?: OverridesOptions): Promise<ConfigArray>;
+declare function tailwindcss(options?: (FilesOptions & OverridesOptions) | (OverridesOptions & TailwindcssParserPerGlobOptions)): Promise<ConfigArray>;
+
+
+
+
+
+
+
 
 /**
  * Generates an ESLint configuration for TOML files.
@@ -610,6 +697,15 @@ declare function tailwindcss(options?: OverridesOptions): Promise<ConfigArray>;
  */
 declare function toml(options?: FilesOptions & OverridesOptions & StylisticOptions): Promise<ConfigArray>;
 
+
+
+
+
+
+
+
+
+
 /**
  * Generates a TypeScript ESLint configuration.
  *
@@ -619,7 +715,10 @@ declare function toml(options?: FilesOptions & OverridesOptions & StylisticOptio
  * @param options.overrides - Additional rule overrides.
  * @returns A ConfigArray containing the TypeScript ESLint configuration.
  */
-declare function typescript(options?: OverridesOptions & StylisticOptions & TypeScriptParserOptions): ConfigArray;
+declare function typescript(options?: OverridesOptions & StylisticOptions & TypeScriptErasableSyntaxOnlyOptions & TypeScriptParserOptions): Promise<ConfigArray>;
+
+
+
 
 /**
  * Generates a configuration array for the Unicorn plugin with the specified options.
@@ -629,6 +728,11 @@ declare function typescript(options?: OverridesOptions & StylisticOptions & Type
  */
 declare function unicorn(options?: UnicornOptions): ConfigArray;
 
+
+
+
+
+
 /**
  * Configures and returns an ESLint configuration array for Vitest.
  *
@@ -648,6 +752,13 @@ declare function unicorn(options?: UnicornOptions): ConfigArray;
  */
 declare function vitest(options?: OverridesOptions & TestingOptions): Promise<ConfigArray>;
 
+
+
+
+
+
+
+
 /**
  * Generates an ESLint configuration for YAML files.
  *
@@ -661,6 +772,13 @@ declare function vitest(options?: OverridesOptions & TestingOptions): Promise<Co
  */
 declare function yaml(options?: FilesOptions & OverridesOptions & StylisticOptions): Promise<ConfigArray>;
 
+
+
+
+
+
+
+
 /**
  * Creates an ESLint configuration array based on the provided options and user configurations.
  *
@@ -672,7 +790,7 @@ declare function yaml(options?: FilesOptions & OverridesOptions & StylisticOptio
  * const config = await createConfig({ vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
  * ```
  */
-declare function createConfig(options?: ConfigWithExtends & CreateConfigOptions, ...userConfigs: Awaitable<ConfigWithExtends | ConfigWithExtends[]>[]): Promise<ConfigArray>;
+declare function defineConfig(options?: ConfigWithExtends & CreateConfigOptions, ...userConfigs: Awaitable<ConfigWithExtends | ConfigWithExtends[]>[]): Promise<ConfigArray>;
 
 /**
  * A glob pattern that matches JavaScript and TypeScript source files (including JSX/TSX).
@@ -695,6 +813,10 @@ declare const GLOB_HTML = "**/*.htm?(l)";
  */
 declare const GLOB_TESTS: string[];
 
+
+
+
+
 /**
  * A utility function to handle the default export of a module.
  *
@@ -758,4 +880,5 @@ type ResolvedOptions<T> = T extends boolean ? never : NonNullable<T>;
  */
 declare function resolveSubOptions<K extends keyof CreateConfigOptions>(options: CreateConfigOptions, key: K): ResolvedOptions<CreateConfigOptions[K]>;
 
-export { type AngularOptions, type Awaitable, type CreateConfigOptions, type FilesOptions, type FormattersOptions, GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, type NgrxOperators, type NgrxOptions, type OverridesOptions, type RegExpOptions, type ResolvedOptions, STYLISTIC_CONFIG_DEFAULT, type StylisticConfig, type StylisticOptions, type TestingOptions, type TypeScriptParserOptions, type UnicornOptions, angular, comments, createConfig, ensurePackages, findNearestPackageJsonName, getWorkspaceRoot, ignores, imports, interopDefault, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, perfectionist, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };
+export { GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, STYLISTIC_CONFIG_DEFAULT, angular, comments, defineConfig, ensurePackages, findNearestPackageJsonName, getWorkspaceRoot, ignores, imports, interopDefault, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, perfectionist, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };
+export type { AngularOptions, Awaitable, CreateConfigOptions, FilesOptions, FormattersOptions, NgrxOperators, NgrxOptions, OverridesOptions, RegExpOptions, ResolvedOptions, StylisticConfig, StylisticOptions, TailwindcssParserPerGlobOptions, TestingOptions, TypeScriptErasableSyntaxOnlyOptions, TypeScriptParserOptions, UnicornOptions };

package/dist/index.mjs

@@ -10,9 +10,9 @@ import preferArrowFunctions from 'eslint-plugin-prefer-arrow-functions';
 import unusedImports from 'eslint-plugin-unused-imports';
 import globals from 'globals';
 import eslintComments from '@eslint-community/eslint-plugin-eslint-comments';
-import jsdocPlugin from 'eslint-plugin-jsdoc';
 import * as importX from 'eslint-plugin-import-x';
 import perfectionistPlugin from 'eslint-plugin-perfectionist';
+import jsdocPlugin from 'eslint-plugin-jsdoc';
 import unicornPlugin from 'eslint-plugin-unicorn';
 import { configs } from 'eslint-plugin-regexp';
 import { mergeProcessors, processorPassThrough } from 'eslint-merge-processors';
@@ -38,7 +38,7 @@ const GLOB_XML = "**/*.xml";
 const GLOB_SVG = "**/*.svg";
 const GLOB_GRAPHQL = "**/*.{g,graph}ql";
 const GLOB_HTML = "**/*.htm?(l)";
-const GLOB_TESTS = [`**/*.spec.${GLOB_SRC_EXT}`, `**/*.test.${GLOB_SRC_EXT}`, `**/test-setup.${GLOB_SRC_EXT}`];
+const GLOB_TESTS = [`**/*.spec.?([cm])[jt]s`, `**/*.test.?([cm])[jt]s`, `**/test-setup.?([cm])[jt]s`];
 const GLOB_EXCLUDE = [
   "**/node_modules",
   "**/dist",
@@ -470,6 +470,54 @@ function javascript(options = {}) {
   );
 }
 
+function getJsDocRules(level, stylistic, mode) {
+  return {
+    ...mode === "both" || mode === "jsOnly" ? {
+      "jsdoc/check-access": level,
+      "jsdoc/check-param-names": level,
+      "jsdoc/check-property-names": level,
+      "jsdoc/check-tag-names": level,
+      "jsdoc/check-types": level,
+      "jsdoc/check-values": level,
+      "jsdoc/empty-tags": level,
+      "jsdoc/implements-on-classes": level,
+      "jsdoc/no-defaults": level,
+      "jsdoc/no-undefined-types": level,
+      "jsdoc/require-jsdoc": level,
+      "jsdoc/require-param": level,
+      "jsdoc/require-param-description": level,
+      "jsdoc/require-param-name": level,
+      "jsdoc/require-param-type": level,
+      "jsdoc/require-property": level,
+      "jsdoc/require-property-description": level,
+      "jsdoc/require-property-name": level,
+      "jsdoc/require-property-type": level,
+      "jsdoc/require-returns": level,
+      "jsdoc/require-returns-check": level,
+      "jsdoc/require-returns-description": level,
+      "jsdoc/require-returns-type": level,
+      "jsdoc/require-yields": level,
+      "jsdoc/require-yields-check": level,
+      "jsdoc/valid-types": level,
+      ...stylistic ? {
+        "jsdoc/check-alignment": level,
+        "jsdoc/multiline-blocks": level,
+        "jsdoc/no-multi-asterisks": level,
+        "jsdoc/require-asterisk-prefix": level,
+        "jsdoc/require-hyphen-before-param-description": level,
+        "jsdoc/tag-lines": [level, "never", { startLines: 1 }]
+      } : {}
+    } : {},
+    ...mode === "both" || mode === "tsOnly" ? {
+      "jsdoc/check-tag-names": [level, { typed: true }],
+      "jsdoc/no-types": level,
+      "jsdoc/no-undefined-types": "off",
+      "jsdoc/require-param-type": "off",
+      "jsdoc/require-property-type": "off",
+      "jsdoc/require-returns-type": "off"
+    } : {}
+  };
+}
 function jsdoc(options = {}) {
   const { stylistic = true } = options;
   return tseslint.config(
@@ -477,52 +525,12 @@ function jsdoc(options = {}) {
       name: "fabdeh/jsdoc/rules",
       files: [GLOB_SRC],
       plugins: { jsdoc: jsdocPlugin },
-      rules: {
-        "jsdoc/check-access": "warn",
-        "jsdoc/check-param-names": "warn",
-        "jsdoc/check-property-names": "warn",
-        "jsdoc/check-tag-names": "warn",
-        "jsdoc/check-types": "warn",
-        "jsdoc/check-values": "warn",
-        "jsdoc/empty-tags": "warn",
-        "jsdoc/implements-on-classes": "warn",
-        "jsdoc/no-defaults": "warn",
-        "jsdoc/no-multi-asterisks": "warn",
-        "jsdoc/no-undefined-types": "warn",
-        "jsdoc/require-jsdoc": "warn",
-        "jsdoc/require-param": "warn",
-        "jsdoc/require-param-description": "warn",
-        "jsdoc/require-param-name": "warn",
-        "jsdoc/require-param-type": "warn",
-        "jsdoc/require-property": "warn",
-        "jsdoc/require-property-description": "warn",
-        "jsdoc/require-property-name": "warn",
-        "jsdoc/require-property-type": "warn",
-        "jsdoc/require-returns": "warn",
-        "jsdoc/require-returns-check": "warn",
-        "jsdoc/require-returns-description": "warn",
-        "jsdoc/require-returns-type": "warn",
-        "jsdoc/require-yields": "warn",
-        "jsdoc/require-yields-check": "warn",
-        "jsdoc/tag-lines": ["warn", "never", { startLines: 1 }],
-        "jsdoc/valid-types": "warn",
-        ...stylistic ? {
-          "jsdoc/check-alignment": "warn",
-          "jsdoc/multiline-blocks": "warn"
-        } : {}
-      }
+      rules: getJsDocRules("warn", !!stylistic, "jsOnly")
     },
     {
       name: "fabdeh/jsdoc/ts-only/rules",
       files: [GLOB_TS],
-      rules: {
-        "jsdoc/check-tag-names": ["warn", { typed: true }],
-        "jsdoc/no-types": "warn",
-        "jsdoc/no-undefined-types": "off",
-        "jsdoc/require-param-type": "off",
-        "jsdoc/require-property-type": "off",
-        "jsdoc/require-returns-type": "off"
-      }
+      rules: getJsDocRules("warn", !!stylistic, "tsOnly")
     }
   );
 }
@@ -1190,9 +1198,12 @@ const STYLISTIC_CONFIG_DEFAULT = {
   quoteProps: "as-needed"
 };
 async function stylistic(options = {}) {
-  const stylisticOptions = { ...STYLISTIC_CONFIG_DEFAULT, ...options };
+  const stylisticOptions = {
+    ...STYLISTIC_CONFIG_DEFAULT,
+    ...typeof options.stylistic === "boolean" ? {} : options.stylistic
+  };
   const stylisticPlugin = await interopDefault(import('@stylistic/eslint-plugin'));
-  const config = stylisticPlugin.configs.customize({ ...stylisticOptions, flat: true });
+  const config = stylisticPlugin.configs.customize(stylisticOptions);
   return tseslint.config({
     name: "fabdeh/stylistic/rules",
     files: [GLOB_SRC],
@@ -1208,22 +1219,45 @@ async function stylistic(options = {}) {
   });
 }
 
+function isTailwindcssParserPerGlobOptions(options) {
+  return "parsers" in options && options.parsers !== void 0;
+}
 async function tailwindcss(options = {}) {
+  await ensurePackages(["eslint-plugin-tailwindcss"]);
   const tailwindcssPlugin = await interopDefault(import('eslint-plugin-tailwindcss'));
-  const { overrides } = options;
-  return tseslint.config({
-    name: "fabdeh/tailwindcss/rules",
-    plugins: { tailwindcss: tailwindcssPlugin },
-    files: [GLOB_SRC, GLOB_HTML],
-    rules: {
-      "tailwindcss/classnames-order": "error",
-      "tailwindcss/enforces-negative-arbitrary-values": "error",
-      "tailwindcss/enforces-shorthand": "error",
-      "tailwindcss/no-contradicting-classname": "error",
-      "tailwindcss/no-unnecessary-arbitrary-value": "error",
-      ...overrides
+  let files;
+  let parserConfigs;
+  const { overrides = {} } = options;
+  if (isTailwindcssParserPerGlobOptions(options)) {
+    const parsers = options.parsers ?? {};
+    files = { files: [...new Set(Object.keys(parsers))] };
+    parserConfigs = Object.entries(parsers).map(([glob, parser], index) => ({
+      name: `fabdeh/tailwindcss/parser-${index + 1}`,
+      file: [glob],
+      languageOptions: {
+        parser
+      }
+    }));
+  } else {
+    files = { files: options.files ?? [GLOB_SRC, GLOB_HTML] };
+    parserConfigs = [];
+  }
+  return tseslint.config(
+    ...parserConfigs,
+    {
+      name: "fabdeh/tailwindcss/rules",
+      plugins: { tailwindcss: tailwindcssPlugin },
+      ...files,
+      rules: {
+        "tailwindcss/classnames-order": "error",
+        "tailwindcss/enforces-negative-arbitrary-values": "error",
+        "tailwindcss/enforces-shorthand": "error",
+        "tailwindcss/no-contradicting-classname": "error",
+        "tailwindcss/no-unnecessary-arbitrary-value": "error",
+        ...overrides
+      }
     }
-  });
+  );
 }
 
 async function toml(options = {}) {
@@ -1300,8 +1334,16 @@ const memberOrdering = {
   ]
 };
 
-function typescript(options = {}) {
-  const { stylistic = true, parserOptions = {}, overrides = {} } = options;
+async function typescript(options = {}) {
+  const { stylistic = true, parserOptions = {}, overrides = {}, enableErasableSyntaxOnly = false } = options;
+  let erasableSyntaxOnlyPlugin;
+  let erasableSyntaxOnlyRules;
+  if (enableErasableSyntaxOnly) {
+    await ensurePackages(["eslint-plugin-erasable-syntax-only"]);
+    const erasableSyntaxOnly = await interopDefault(import('eslint-plugin-erasable-syntax-only'));
+    erasableSyntaxOnlyPlugin = erasableSyntaxOnly;
+    erasableSyntaxOnlyRules = erasableSyntaxOnly.configs.recommended.rules;
+  }
   return tseslint.config(
     {
       name: "fabdeh/typescript/setup",
@@ -1326,7 +1368,8 @@ function typescript(options = {}) {
       ignores: [`${GLOB_MARKDOWN}/**`],
       plugins: {
         "@typescript-eslint": tseslint.plugin,
-        "unused-imports": unusedImports
+        "unused-imports": unusedImports,
+        ...erasableSyntaxOnlyPlugin ? { "erasable-syntax-only": erasableSyntaxOnlyPlugin } : {}
       },
       rules: {
         ...tseslint.configs.strictTypeChecked.find((c) => c.name === "typescript-eslint/eslint-recommended")?.rules,
@@ -1393,6 +1436,7 @@ function typescript(options = {}) {
         "@typescript-eslint/unbound-method": ["error", { ignoreStatic: true }],
         "@typescript-eslint/unified-signatures": "error",
         "@typescript-eslint/no-unused-vars": "off",
+        ...erasableSyntaxOnlyRules,
         ...overrides
       }
     }
@@ -1560,6 +1604,7 @@ async function vitest(options = {}) {
       "vitest/prefer-todo": "error",
       "vitest/prefer-vi-mocked": "error",
       "vitest/require-top-level-describe": "error",
+      ...getJsDocRules("off", true, "both"),
       ...overrides
     }
   });
@@ -1632,7 +1677,7 @@ function mergePrettierOptions(options, overrides = {}) {
     /* eslint-enable @typescript-eslint/no-unsafe-assignment */
   };
 }
-async function formatters(options = {}, stylistic = {}) {
+async function formatters(options = {}, stylistic = {}, hasAngularTemplateParser = false) {
   if (options === true) {
     const isPrettierPluginXmlInScope = isPackageInScope("@prettier/plugin-xml");
     options = {
@@ -1729,8 +1774,10 @@ async function formatters(options = {}, stylistic = {}) {
   if (options.html) {
     configs.push({
       name: "fabdeh/formatter/html",
-      languageOptions: {
-        parser: formatPlugin.parserPlain
+      ...hasAngularTemplateParser ? {} : {
+        languageOptions: {
+          parser: formatPlugin.parserPlain
+        }
       },
       files: [GLOB_HTML],
       rules: {
@@ -1845,17 +1892,21 @@ const FLAT_CONFIG_PROPS = [
   "extends"
 ];
 const NGRX_PACKAGES = ["@ngrx/store", "@ngrx/effects", "@ngrx/signals", "@ngrx/operators"];
-async function createConfig(options = {}, ...userConfigs) {
+async function defineConfig(options = {}, ...userConfigs) {
   const {
     angular: enableAngular = isPackageExists("@angular/core"),
     gitignore: enableGitignore = true,
+    jsdoc: enableJsdoc = true,
     ngrx: enableNgrx = NGRX_PACKAGES.some((p) => isPackageExists(p)),
     regexp: enableRegexp = true,
-    tailwindcss: enableTailwind = isPackageExists("tailwindcss"),
+    tailwindcss: enableTailwind = false,
     typescript: enableTypescript = isPackageExists("typescript"),
     unicorn: enableUnicorn = true,
     vitest: enableVitest = isPackageExists("vitest")
   } = options;
+  if (enableNgrx && !enableAngular) {
+    throw new Error("NgRx rules can only be enabled if Angular rules are also enabled.");
+  }
   const stylisticOptions = options.stylistic === false ? false : typeof options.stylistic === "object" ? options.stylistic : {};
   const configs = [];
   if (enableGitignore) {
@@ -1877,11 +1928,12 @@ async function createConfig(options = {}, ...userConfigs) {
     ignores(options.ignores),
     javascript({ overrides: options.javascript?.overrides }),
     comments(),
-    // TODO: add node rules ???
-    jsdoc({ stylistic: stylisticOptions }),
     imports({ stylistic: stylisticOptions }),
     perfectionist()
   );
+  if (enableJsdoc) {
+    configs.push(jsdoc({ stylistic: stylisticOptions }));
+  }
   if (enableUnicorn) {
     const unicornOptions = resolveSubOptions(options, "unicorn");
     configs.push(unicorn(unicornOptions));
@@ -1946,7 +1998,11 @@ async function createConfig(options = {}, ...userConfigs) {
     configs.push(markdown(markdownOptions));
   }
   if (options.formatters) {
-    configs.push(formatters(options.formatters, typeof stylisticOptions === "boolean" ? {} : stylisticOptions));
+    configs.push(formatters(
+      options.formatters,
+      typeof stylisticOptions === "boolean" ? {} : stylisticOptions,
+      Boolean(enableAngular)
+    ));
   }
   if ("files" in options) {
     throw new Error('[@fabdeh/eslint-config] The first argument should not contain the "files" property as the options are supposed to be global. Place it in the second or later config instead.');
@@ -1960,4 +2016,4 @@ async function createConfig(options = {}, ...userConfigs) {
   return tseslint.config(...await Promise.all(configs), ...await Promise.all(userConfigs));
 }
 
-export { GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, STYLISTIC_CONFIG_DEFAULT, angular, comments, createConfig, ensurePackages, findNearestPackageJsonName, getWorkspaceRoot, ignores, imports, interopDefault, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, perfectionist, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };
+export { GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, STYLISTIC_CONFIG_DEFAULT, angular, comments, defineConfig, ensurePackages, findNearestPackageJsonName, getWorkspaceRoot, ignores, imports, interopDefault, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, perfectionist, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@fabdeh/eslint-config",
   "type": "module",
-  "version": "0.2.3",
-  "packageManager": "pnpm@10.4.1",
+  "version": "0.4.0",
+  "packageManager": "pnpm@10.6.5+sha512.cdf928fca20832cd59ec53826492b7dc25dc524d4370b6b4adbf65803d32efaa6c1c88147c0ae4e8d579a6c9eec715757b50d4fa35eea179d868eada4ed043af",
   "description": "My personal eslint config preset",
   "author": {
     "name": "Fabien Dehopré",
@@ -54,17 +54,25 @@
   },
   "peerDependencies": {
     "@prettier/plugin-xml": "^3.4.1",
-    "eslint": "^9.20.0",
+    "eslint": "^9.21.0",
+    "eslint-plugin-erasable-syntax-only": "^0.3.0",
     "eslint-plugin-format": "^1.0.1",
+    "eslint-plugin-tailwindcss": "^3.18.0",
     "prettier-plugin-slidev": "^1.0.5"
   },
   "peerDependenciesMeta": {
     "@prettier/plugin-xml": {
       "optional": true
     },
+    "eslint-plugin-erasable-syntax-only": {
+      "optional": true
+    },
     "eslint-plugin-format": {
       "optional": true
     },
+    "eslint-plugin-tailwindcss": {
+      "optional": true
+    },
     "prettier-plugin-slidev": {
       "optional": true
     }
@@ -73,43 +81,42 @@
     "@antfu/install-pkg": "^1.0.0",
     "@clack/prompts": "^0.10.0",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.4.1",
-    "@eslint/js": "^9.20.0",
-    "@eslint/markdown": "^6.2.2",
+    "@eslint/js": "^9.22.0",
+    "@eslint/markdown": "^6.3.0",
     "@ngrx/eslint-plugin": "^19.0.1",
-    "@stylistic/eslint-plugin": "^3.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.24.1",
-    "@typescript-eslint/parser": "^8.24.1",
-    "@typescript-eslint/utils": "^8.24.1",
-    "@vitest/eslint-plugin": "^1.1.31",
-    "angular-eslint": "^19.1.0",
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.26.1",
+    "@typescript-eslint/parser": "^8.26.1",
+    "@typescript-eslint/utils": "^8.26.1",
+    "@vitest/eslint-plugin": "^1.1.38",
+    "angular-eslint": "^19.2.1",
     "eslint-config-flat-gitignore": "^2.1.0",
     "eslint-flat-config-utils": "^2.0.1",
     "eslint-merge-processors": "^2.0.0",
-    "eslint-plugin-import-x": "^4.6.1",
+    "eslint-plugin-import-x": "^4.9.0",
     "eslint-plugin-jest-dom": "^5.5.0",
-    "eslint-plugin-jsdoc": "^50.6.3",
+    "eslint-plugin-jsdoc": "^50.6.8",
     "eslint-plugin-jsonc": "^2.19.1",
-    "eslint-plugin-perfectionist": "^4.9.0",
+    "eslint-plugin-perfectionist": "^4.10.1",
     "eslint-plugin-prefer-arrow-functions": "^3.6.2",
     "eslint-plugin-regexp": "^2.7.0",
-    "eslint-plugin-tailwindcss": "^3.18.0",
     "eslint-plugin-testing-library": "^7.1.1",
     "eslint-plugin-toml": "^0.12.0",
     "eslint-plugin-unicorn": "^57.0.0",
     "eslint-plugin-unused-imports": "^4.1.4",
     "eslint-plugin-yml": "^1.17.0",
-    "globals": "^15.15.0",
+    "globals": "^16.0.0",
     "jsonc-eslint-parser": "^2.4.0",
-    "local-pkg": "^1.0.0",
+    "local-pkg": "^1.1.1",
     "toml-eslint-parser": "^0.10.0",
-    "typescript-eslint": "^8.24.1",
-    "yaml-eslint-parser": "^1.2.3"
+    "typescript-eslint": "^8.26.1",
+    "yaml-eslint-parser": "^1.3.0"
   },
   "devDependencies": {
-    "@angular/core": "^19.1.7",
-    "@commitlint/cli": "^19.7.1",
-    "@commitlint/config-conventional": "^19.7.1",
-    "@commitlint/cz-commitlint": "^19.6.1",
+    "@angular/core": "^19.2.2",
+    "@commitlint/cli": "^19.8.0",
+    "@commitlint/config-conventional": "^19.8.0",
+    "@commitlint/cz-commitlint": "^19.8.0",
     "@fabdeh/eslint-config": "workspace:*",
     "@ngrx/effects": "^19.0.1",
     "@ngrx/operators": "^19.0.1",
@@ -119,12 +126,14 @@
     "@testing-library/angular": "^17.3.6",
     "@testing-library/jest-dom": "^6.6.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.13.4",
-    "bumpp": "^10.0.3",
-    "changelogithub": "^13.12.1",
+    "@types/node": "^22.13.10",
+    "bumpp": "^10.1.0",
+    "changelogithub": "^13.13.0",
     "commitizen": "^4.3.1",
-    "eslint": "^9.20.1",
+    "eslint": "^9.22.0",
+    "eslint-plugin-erasable-syntax-only": "^0.3.0",
     "eslint-plugin-format": "^1.0.1",
+    "eslint-plugin-tailwindcss": "^3.18.0",
     "execa": "^9.5.2",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.0",
@@ -135,9 +144,9 @@
     "prettier-plugin-slidev": "^1.0.5",
     "simple-git-hooks": "^2.11.1",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.7.3",
-    "unbuild": "^3.3.1",
-    "vitest": "^3.0.6"
+    "typescript": "^5.8.2",
+    "unbuild": "^3.5.0",
+    "vitest": "^3.0.9"
   },
   "pnpm": {
     "overrides": {