@fabdeh/eslint-config 0.3.0 → 0.5.0

package/README.md

@@ -16,7 +16,7 @@
   - 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.
@@ -37,9 +37,9 @@ And create an `eslint.config.mjs` in you project root:
 
 ```js
 // eslint.config.mjs
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig();
+export default defineConfig();
 ```
 
 ### Add script for package.json
@@ -108,22 +108,22 @@ Add the following settings to your `.vscode/settings.json`:
 
 Since the beginning, we used [ESLint Flat config](https://eslint.org/docs/latest/use/configure/configuration-files-new). It provides much better organization and composition.
 
-Normally you only need to import the `createConfig` function:
+Normally you only need to import the `defineConfig` function:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig();
+export default defineConfig();
 ```
 
 And that's it! Or you can configure each integration individually, for example:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   // Enable stylistic formatting rules
   // stylistic: true,
 
@@ -148,13 +148,13 @@ export default createConfig({
 });
 ```
 
-The `createConfig` factory function also accepts any number of arbitrary custom config overrides:
+The `defineConfig` factory function also accepts any number of arbitrary custom config overrides:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig(
+export default defineConfig(
   {
     // Configure the fabdeh's config
   },
@@ -225,9 +225,9 @@ If you want to override the rules, you need to specify the file extension:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig(
+export default defineConfig(
   {
     typescript: true,
     vitest: true
@@ -252,9 +252,9 @@ We also provide the `overrides` option in each integration to make it easier:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   typescript: {
     overrides: {
       '@typescript-eslint/consisten-type-definitions': ['error', 'interface'],
@@ -292,9 +292,9 @@ You can explicitly enable/disable TypeScript integration manually:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   typescript: true,
 });
 ```
@@ -313,9 +313,9 @@ You can enable these rules as follow:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   typescript: {
     enableErasableSyntaxOnly: true,
   },
@@ -335,9 +335,9 @@ Angular support is detected automatically by checking if `@angular/core` is inst
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   angular: true,
 });
 ```
@@ -355,9 +355,9 @@ As the Angular integration is can be explicitly enabled/disabled:
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   ngrx: true,
 });
 ```
@@ -370,9 +370,9 @@ The vitest integration is detected automatically by checking if `vitest` is inst
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   vitest: true,
 });
 ```
@@ -387,9 +387,9 @@ Use external formatters to format files that ESLint cannot handle yet (`.css`, `
 
 ```js
 // eslint.config.js
-import { createConfig } from '@fabdeh/eslint-config';
+import { defineConfig } from '@fabdeh/eslint-config';
 
-export default createConfig({
+export default defineConfig({
   formatters: {
     /**
      * Format CSS, LESS, SCSS files

package/dist/index.d.mts

@@ -224,6 +224,22 @@ interface AngularOptions {
      * HTML-specific linting rule overrides.
      */
     htmlOverrides?: TSESLint.FlatConfig.Config['rules'];
+    /**
+     * A class name pattern that allows service using `@Injectable` decorator to not use `providedIn` option.
+     */
+    ignoreClassNamePatternForInjectableProvidedIn?: string;
+    /**
+     * Defines whether the `styles`, `styleUrl`, `styleUrls` must be used.
+     *
+     * @default 'string'
+     */
+    componentStylesMode?: 'array' | 'string';
+    /**
+     * Indicates whether all component should use `OnPush` change strategy or not.
+     *
+     * @default true
+     */
+    preferOnPushOnly?: boolean;
 }
 /**
  * Interface representing configuration options for enforcing NgRx operators rules.
@@ -336,6 +352,12 @@ interface CreateConfigOptions {
      * @default true
      */
     stylistic?: boolean | (OverridesOptions & StylisticConfig);
+    /**
+     * Enable or disable JSDoc rules.
+     *
+     * @default true
+     */
+    jsdoc?: boolean;
     /**
      * Enable regexp rules.
      *
@@ -689,7 +711,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).
@@ -738,6 +760,13 @@ declare function interopDefault<T>(m: Awaitable<T>): Promise<T extends {
  * @returns The root directory of the workspace.
  */
 declare function getWorkspaceRoot(dir: string, candidateRoot: string): string;
+/**
+ * Returns the most probable filename for the TsConfig.
+ *
+ * @param dir - The directory into which the tsconfig.json is located.
+ * @returns The tsconfig.*.json file
+ */
+declare function getTsConfigFileName(dir: string): string | undefined;
 /**
  * Checks if a package is within the specified scope.
  *
@@ -775,4 +804,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 TailwindcssParserPerGlobOptions, type TestingOptions, type TypeScriptErasableSyntaxOnlyOptions, 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, getTsConfigFileName, 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

@@ -4,15 +4,14 @@ import { statSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { resolve, dirname, join } from 'node:path';
 import process from 'node:process';
-import { fileURLToPath } from 'node:url';
 import eslint from '@eslint/js';
 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';
@@ -75,7 +74,7 @@ const GLOB_EXCLUDE = [
   "**/prettier-types.ts"
 ];
 
-const SCOPE_URL = fileURLToPath(new URL(".", import.meta.url));
+const SCOPE_URL = import.meta.dirname;
 const IS_CWD_IN_SCOPE = isPackageExists("@fabdeh/eslint-config");
 async function interopDefault(m) {
   const resolved = await m;
@@ -89,8 +88,8 @@ function fileExists(path) {
   }
 }
 function getWorkspaceRoot(dir, candidateRoot) {
-  if (process.env.NX_WORKSPACE_ROOT_PATH) {
-    return process.env.NX_WORKSPACE_ROOT_PATH;
+  if (process.env.NX_WORKSPACE_ROOT) {
+    return process.env.NX_WORKSPACE_ROOT;
   }
   if (dirname(dir) === dir) {
     return candidateRoot;
@@ -104,6 +103,9 @@ function getWorkspaceRoot(dir, candidateRoot) {
     return getWorkspaceRoot(dirname(dir), candidateRoot);
   }
 }
+function getTsConfigFileName(dir) {
+  return ["tsconfig.base.json", "tsconfig.json"].map((filename) => ({ filename, path: join(dir, filename) })).filter(({ path }) => fileExists(path)).map(({ filename }) => filename).at(0);
+}
 function isPackageInScope(name) {
   return isPackageExists(name, { paths: [SCOPE_URL] });
 }
@@ -145,7 +147,7 @@ function resolveSubOptions(options, key) {
 
 async function angular(options = {}) {
   const angularEslint = await interopDefault(import('angular-eslint'));
-  const { enableAccessibilityRules = true, tsOverrides = {}, htmlOverrides = {}, prefix = "app" } = options;
+  const { enableAccessibilityRules = true, tsOverrides = {}, htmlOverrides = {}, prefix = "app", ignoreClassNamePatternForInjectableProvidedIn: ignoreClassNamePattern, componentStylesMode = "string", preferOnPushOnly = true } = options;
   return tseslint.config(
     {
       name: "fabdeh/angular/rules",
@@ -193,6 +195,7 @@ async function angular(options = {}) {
             style: "kebab-case"
           }
         ],
+        "@angular-eslint/consistent-component-styles": ["error", componentStylesMode],
         "@angular-eslint/contextual-decorator": "error",
         "@angular-eslint/directive-selector": [
           "error",
@@ -210,12 +213,18 @@ async function angular(options = {}) {
         "@angular-eslint/no-lifecycle-call": "error",
         "@angular-eslint/no-pipe-impure": "error",
         "@angular-eslint/no-queries-metadata-property": "error",
+        "@angular-eslint/no-uncalled-signals": "error",
+        "@angular-eslint/prefer-output-emitter-ref": "error",
         "@angular-eslint/prefer-output-readonly": "error",
         "@angular-eslint/prefer-signals": "error",
+        ...preferOnPushOnly ? { "@angular-eslint/prefer-on-push-component-change-detection": "error" } : {},
         "@angular-eslint/relative-url-prefix": "error",
+        "@angular-eslint/require-lifecycle-on-prototype": "error",
+        "@angular-eslint/sort-keys-in-type-decorator": "error",
         "@angular-eslint/sort-lifecycle-methods": "error",
         "@angular-eslint/use-component-selector": "error",
         "@angular-eslint/use-component-view-encapsulation": "error",
+        "@angular-eslint/use-injectable-provided-in": ignoreClassNamePattern ? ["error", { ignoreClassNamePattern }] : "error",
         "@angular-eslint/use-lifecycle-interface": "error",
         ...tsOverrides
       }
@@ -470,6 +479,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 +534,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")
     }
   );
 }
@@ -893,7 +910,7 @@ const SORT_UNION_OR_INTERSECTION_GROUPS = [
 ];
 
 async function perfectionist() {
-  const tsconfigRootDir = await findNearestPackageJsonName() === "@fabdeh/eslint-config" ? void 0 : getWorkspaceRoot(process.cwd(), process.cwd());
+  const rootDir = await findNearestPackageJsonName() === "@fabdeh/eslint-config" ? void 0 : getWorkspaceRoot(process.cwd(), process.cwd());
   return tseslint.config({
     name: "fabdeh/perfectionist/rules",
     files: [GLOB_SRC],
@@ -906,7 +923,10 @@ async function perfectionist() {
         "error",
         {
           groups: SORT_IMPORT_GROUPS,
-          tsconfigRootDir,
+          tsconfig: rootDir ? {
+            rootDir,
+            filename: getTsConfigFileName(rootDir)
+          } : void 0,
           order: "asc",
           type: "natural",
           newlinesBetween: "never"
@@ -1336,6 +1356,8 @@ async function typescript(options = {}) {
     erasableSyntaxOnlyPlugin = erasableSyntaxOnly;
     erasableSyntaxOnlyRules = erasableSyntaxOnly.configs.recommended.rules;
   }
+  const tsconfigRootDir = getWorkspaceRoot(process.cwd(), process.cwd());
+  const defaultProject = getTsConfigFileName(tsconfigRootDir);
   return tseslint.config(
     {
       name: "fabdeh/typescript/setup",
@@ -1347,9 +1369,9 @@ async function typescript(options = {}) {
           sourceType: "module",
           projectService: {
             allowDefaultProject: ["*.js"],
-            defaultProject: "tsconfig.json"
+            defaultProject
           },
-          tsconfigRootDir: getWorkspaceRoot(process.cwd(), process.cwd()),
+          tsconfigRootDir,
           ...parserOptions
         }
       }
@@ -1457,7 +1479,6 @@ function unicorn(options = {}) {
         "unicorn/no-anonymous-default-export": "error",
         "unicorn/no-array-for-each": "error",
         "unicorn/no-array-method-this-argument": "error",
-        "unicorn/no-array-push-push": "error",
         "unicorn/no-array-reduce": "error",
         "unicorn/no-await-expression-member": "error",
         "unicorn/no-await-in-promise-methods": "error",
@@ -1468,7 +1489,6 @@ function unicorn(options = {}) {
         "unicorn/no-instanceof-builtins": "error",
         "unicorn/no-invalid-fetch-options": "error",
         "unicorn/no-invalid-remove-event-listener": "error",
-        "unicorn/no-length-as-slice-end": "error",
         "unicorn/no-lonely-if": "error",
         "unicorn/no-magic-array-flat-depth": "error",
         "unicorn/no-negated-condition": "error",
@@ -1482,6 +1502,9 @@ function unicorn(options = {}) {
         "unicorn/no-this-assignment": "error",
         "unicorn/no-typeof-undefined": "error",
         "unicorn/no-unnecessary-await": "error",
+        "unicorn/no-unnecessary-array-flat-depth": "error",
+        "unicorn/no-unnecessary-array-splice-count": "error",
+        "unicorn/no-unnecessary-slice-end": "error",
         "unicorn/no-unused-properties": "warn",
         "unicorn/no-useless-fallback-in-spread": "error",
         "unicorn/no-useless-length-check": "error",
@@ -1502,6 +1525,7 @@ function unicorn(options = {}) {
         "unicorn/prefer-date-now": "error",
         "unicorn/prefer-default-parameters": "error",
         "unicorn/prefer-export-from": "error",
+        "unicorn/prefer-import-meta-properties": "error",
         "unicorn/prefer-includes": "error",
         "unicorn/prefer-keyboard-event-key": "error",
         "unicorn/prefer-logical-operator-over-ternary": "error",
@@ -1517,6 +1541,7 @@ function unicorn(options = {}) {
         "unicorn/prefer-regexp-test": "error",
         "unicorn/prefer-set-has": "error",
         "unicorn/prefer-set-size": "error",
+        "unicorn/prefer-single-call": "error",
         "unicorn/prefer-spread": "error",
         "unicorn/prefer-string-raw": "error",
         "unicorn/prefer-string-replace-all": "error",
@@ -1596,6 +1621,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
     }
   });
@@ -1883,10 +1909,11 @@ 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 = false,
@@ -1894,6 +1921,9 @@ async function createConfig(options = {}, ...userConfigs) {
     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) {
@@ -1915,11 +1945,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));
@@ -2002,4 +2033,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, getTsConfigFileName, 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.3.0",
-  "packageManager": "pnpm@10.4.1",
+  "version": "0.5.0",
+  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39",
   "description": "My personal eslint config preset",
   "author": {
     "name": "Fabien Dehopré",
@@ -37,7 +37,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18.18"
+    "node": "^20.11.1 || ^22.11.0"
   },
   "scripts": {
     "build": "unbuild",
@@ -54,8 +54,8 @@
   },
   "peerDependencies": {
     "@prettier/plugin-xml": "^3.4.1",
-    "eslint": "^9.20.0",
-    "eslint-plugin-erasable-syntax-only": "^0.2.1",
+    "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"
@@ -78,63 +78,63 @@
     }
   },
   "dependencies": {
-    "@antfu/install-pkg": "^1.0.0",
-    "@clack/prompts": "^0.10.0",
-    "@eslint-community/eslint-plugin-eslint-comments": "^4.4.1",
-    "@eslint/js": "^9.21.0",
-    "@eslint/markdown": "^6.2.2",
-    "@ngrx/eslint-plugin": "^19.0.1",
-    "@stylistic/eslint-plugin": "^4.0.1",
-    "@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",
+    "@antfu/install-pkg": "^1.1.0",
+    "@clack/prompts": "^0.10.1",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.5.0",
+    "@eslint/js": "^9.28.0",
+    "@eslint/markdown": "^6.5.0",
+    "@ngrx/eslint-plugin": "^19.2.1",
+    "@stylistic/eslint-plugin": "^4.4.1",
+    "@typescript-eslint/eslint-plugin": "^8.33.1",
+    "@typescript-eslint/parser": "^8.33.1",
+    "@typescript-eslint/utils": "^8.33.1",
+    "@vitest/eslint-plugin": "^1.2.1",
+    "angular-eslint": "^20.0.0",
     "eslint-config-flat-gitignore": "^2.1.0",
-    "eslint-flat-config-utils": "^2.0.1",
+    "eslint-flat-config-utils": "^2.1.0",
     "eslint-merge-processors": "^2.0.0",
-    "eslint-plugin-import-x": "^4.6.1",
+    "eslint-plugin-import-x": "^4.15.1",
     "eslint-plugin-jest-dom": "^5.5.0",
-    "eslint-plugin-jsdoc": "^50.6.3",
-    "eslint-plugin-jsonc": "^2.19.1",
-    "eslint-plugin-perfectionist": "^4.9.0",
+    "eslint-plugin-jsdoc": "^50.7.1",
+    "eslint-plugin-jsonc": "^2.20.1",
+    "eslint-plugin-perfectionist": "^4.14.0",
     "eslint-plugin-prefer-arrow-functions": "^3.6.2",
-    "eslint-plugin-regexp": "^2.7.0",
-    "eslint-plugin-testing-library": "^7.1.1",
+    "eslint-plugin-regexp": "^2.8.0",
+    "eslint-plugin-testing-library": "^7.4.0",
     "eslint-plugin-toml": "^0.12.0",
-    "eslint-plugin-unicorn": "^57.0.0",
+    "eslint-plugin-unicorn": "^59.0.1",
     "eslint-plugin-unused-imports": "^4.1.4",
-    "eslint-plugin-yml": "^1.17.0",
-    "globals": "^16.0.0",
+    "eslint-plugin-yml": "^1.18.0",
+    "globals": "^16.2.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.33.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": "^20.0.2",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/cz-commitlint": "^19.8.1",
     "@fabdeh/eslint-config": "workspace:*",
-    "@ngrx/effects": "^19.0.1",
-    "@ngrx/operators": "^19.0.1",
-    "@ngrx/signals": "^19.0.1",
-    "@ngrx/store": "^19.0.1",
+    "@ngrx/effects": "^19.2.1",
+    "@ngrx/operators": "^19.2.1",
+    "@ngrx/signals": "^19.2.1",
+    "@ngrx/store": "^19.2.1",
     "@prettier/plugin-xml": "^3.4.1",
-    "@testing-library/angular": "^17.3.6",
+    "@testing-library/angular": "^17.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.13.5",
-    "bumpp": "^10.0.3",
-    "changelogithub": "^13.12.1",
+    "@types/node": "^22.15.30",
+    "bumpp": "^10.1.1",
+    "changelogithub": "^13.15.0",
     "commitizen": "^4.3.1",
-    "eslint": "^9.21.0",
-    "eslint-plugin-erasable-syntax-only": "^0.2.1",
+    "eslint": "^9.28.0",
+    "eslint-plugin-erasable-syntax-only": "^0.3.1",
     "eslint-plugin-format": "^1.0.1",
     "eslint-plugin-tailwindcss": "^3.18.0",
-    "execa": "^9.5.2",
+    "execa": "^9.6.0",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.0",
     "inquirer": "^9.3.7",
@@ -142,11 +142,11 @@
     "jiti": "^2.4.2",
     "nano-staged": "^0.8.0",
     "prettier-plugin-slidev": "^1.0.5",
-    "simple-git-hooks": "^2.11.1",
+    "simple-git-hooks": "^2.13.0",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.7.3",
-    "unbuild": "^3.3.1",
-    "vitest": "^3.0.6"
+    "typescript": "^5.8.3",
+    "unbuild": "^3.5.0",
+    "vitest": "^3.2.2"
   },
   "pnpm": {
     "overrides": {