@fabdeh/eslint-config 0.5.0 → 0.6.1

package/dist/index.d.mts

@@ -2,6 +2,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 { Attributes, Callees, Variables, Tags } from 'eslint-plugin-better-tailwindcss/api/types';
 
 /**
  * Vendor types from Prettier so we don't rely on the dependency.
@@ -240,6 +241,18 @@ interface AngularOptions {
      * @default true
      */
     preferOnPushOnly?: boolean;
+    /**
+     * Disallow using code which is marked as experimental.
+     *
+     * @default true
+     */
+    banExperimentalApi?: boolean;
+    /**
+     * Disallow using code which is marked as developer preview.
+     *
+     * @default true
+     */
+    banDeveloperPreviewApi?: boolean;
 }
 /**
  * Interface representing configuration options for enforcing NgRx operators rules.
@@ -313,19 +326,70 @@ interface RegExpOptions {
      */
     level?: 'error' | 'warn';
 }
-interface TailwindcssParserPerGlobOptions {
+/**
+ * Interface for better-tailwindcss specific options.
+ */
+interface TailwindCssOptions {
     /**
      * 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>;
+    /**
+     * Use all better-tailwindcss rules or only recommended ones.
+     *
+     * @default false
+     */
+    enableAllRules?: boolean;
+    /**
+     * The path to the entry file of the CSS-based tailwind config (eg: `src/global.css`). If not specified, the plugin will fall back to the default configuration.
+     * The tailwind config is used to determine the sorting order.
+     */
+    entryPoint?: string;
+    /**
+     * The path to the `tailwind.config.js` file. If not specified, the plugin will try to find it automatically or falls back to the default configuration.
+     * The tailwind config is used to determine the sorting order.
+     */
+    tailwindConfig?: string;
+    /**
+     * The name of the attribute that contains the tailwind classes.
+     *
+     * @default Name for `"class"` and strings Matcher for `"class", "className"`.
+     */
+    attributes?: Attributes;
+    /**
+     * List of function names which arguments should also get linted.
+     *
+     * @default  Matchers for `"cc", "clb", "clsx", "cn", "cnb", "ctl", "cva", "cx", "dcnb", "objstr", "tv", "twJoin", "twMerge"`.
+     */
+    callees?: Callees;
+    /**
+     * List of variable names whose initializer should also get linted.
+     *
+     * @default strings Matcher for `"className", "classNames", "classes", "style", "styles"`.
+     */
+    variables?: Variables;
+    /**
+     * List of template literal tag names whose content should get linted.
+     * When using the `tags` option, it is recommended to use the strings Matcher for your tag names. This will ensure that nested expressions get linted correctly.
+     *
+     * @default None
+     */
+    tags?: Tags;
+}
+interface ProjectTypeOptions {
+    /**
+     * Type of the project. `lib` will enable more strict rules for libraries.
+     *
+     * @default 'app'
+     */
+    type?: 'app' | 'lib';
 }
 /**
  * Options for creating an ESLint configuration.
  *
  * @see createConfig function
  */
-interface CreateConfigOptions {
+interface CreateConfigOptions extends ProjectTypeOptions {
     /**
      * Enable gitignore support.
      *
@@ -394,7 +458,7 @@ interface CreateConfigOptions {
      *
      * @default false
      */
-    tailwindcss?: boolean | (FilesOptions & OverridesOptions) | (OverridesOptions & TailwindcssParserPerGlobOptions);
+    tailwindcss?: boolean | (FilesOptions & OverridesOptions & TailwindCssOptions);
     /**
      * Enable JSONC support.
      *
@@ -483,11 +547,10 @@ declare function imports(options?: StylisticOptions): ConfigArray;
  *
  * @param options - Configuration options for the JavaScript setup.
  * @param options.overrides - Additional rule overrides.
- * @param options.allowAngularDecorator - Allows specific Angular decorators to be used without new-cap errors.
  * @returns A configuration array for ESLint.
  * @example
  * ```typescript
- * const config = javascript({ allowAngularDecorator: true });
+ * const config = javascript();
  * ```
  */
 declare function javascript(options?: OverridesOptions): ConfigArray;
@@ -624,18 +687,19 @@ declare const STYLISTIC_CONFIG_DEFAULT: StylisticConfig;
 declare function stylistic(options?: StylisticOptions): Promise<ConfigArray>;
 
 /**
- * Generates an ESLint configuration array for Tailwind CSS.
+ * Generates an ESLint configuration array for Tailwind CSS using better-tailwindcss plugin.
  *
  * @param [options] - Optional overrides for the configuration.
  * @returns  A promise that resolves to the ESLint configuration array.
  * @example
  * const config = await tailwindcss({
+ *   enableAllRules: true,
  *   overrides: {
- *     'tailwindcss/classnames-order': 'warn',
+ *     'better-tailwindcss/recommended': 'warn',
  *   },
  * });
  */
-declare function tailwindcss(options?: (FilesOptions & OverridesOptions) | (OverridesOptions & TailwindcssParserPerGlobOptions)): Promise<ConfigArray>;
+declare function tailwindcss(options?: (FilesOptions & OverridesOptions & TailwindCssOptions)): Promise<ConfigArray>;
 
 /**
  * Generates an ESLint configuration for TOML files.
@@ -658,7 +722,7 @@ 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 & TypeScriptErasableSyntaxOnlyOptions & TypeScriptParserOptions): Promise<ConfigArray>;
+declare function typescript(options?: OverridesOptions & ProjectTypeOptions & StylisticOptions & TypeScriptErasableSyntaxOnlyOptions & TypeScriptParserOptions): Promise<ConfigArray>;
 
 /**
  * Generates a configuration array for the Unicorn plugin with the specified options.
@@ -805,4 +869,4 @@ type ResolvedOptions<T> = T extends boolean ? never : NonNullable<T>;
 declare function resolveSubOptions<K extends keyof CreateConfigOptions>(options: CreateConfigOptions, key: K): ResolvedOptions<CreateConfigOptions[K]>;
 
 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 };
+export type { AngularOptions, Awaitable, CreateConfigOptions, FilesOptions, FormattersOptions, NgrxOperators, NgrxOptions, OverridesOptions, ProjectTypeOptions, RegExpOptions, ResolvedOptions, StylisticConfig, StylisticOptions, TailwindCssOptions, TestingOptions, TypeScriptErasableSyntaxOnlyOptions, TypeScriptParserOptions, UnicornOptions };

package/dist/index.mjs

@@ -139,15 +139,26 @@ async function findNearestPackageJsonName(directoryPath = resolve()) {
   }
 }
 function resolveSubOptions(options, key) {
-  if (typeof options[key] === "boolean") {
-    return {};
+  const option = options[key];
+  if (typeof option === "boolean") {
+    throw new TypeError(`Option ${String(key)} should not be boolean.`);
   }
-  return options[key] ?? {};
+  return option ?? {};
 }
 
 async function angular(options = {}) {
   const angularEslint = await interopDefault(import('angular-eslint'));
-  const { enableAccessibilityRules = true, tsOverrides = {}, htmlOverrides = {}, prefix = "app", ignoreClassNamePatternForInjectableProvidedIn: ignoreClassNamePattern, componentStylesMode = "string", preferOnPushOnly = true } = options;
+  const {
+    enableAccessibilityRules = true,
+    tsOverrides = {},
+    htmlOverrides = {},
+    prefix = "app",
+    ignoreClassNamePatternForInjectableProvidedIn: ignoreClassNamePattern,
+    componentStylesMode = "string",
+    preferOnPushOnly = true,
+    banExperimentalApi = true,
+    banDeveloperPreviewApi = true
+  } = options;
   return tseslint.config(
     {
       name: "fabdeh/angular/rules",
@@ -208,7 +219,9 @@ async function angular(options = {}) {
         "@angular-eslint/no-async-lifecycle-method": "error",
         "@angular-eslint/no-attribute-decorator": "error",
         "@angular-eslint/no-conflicting-lifecycle": "error",
+        ...banDeveloperPreviewApi ? { "@angular-eslint/no-developer-preview": "error" } : {},
         "@angular-eslint/no-duplicates-in-metadata-arrays": "error",
+        ...banExperimentalApi ? { "@angular-eslint/no-experimental": "error" } : {},
         "@angular-eslint/no-forward-ref": "error",
         "@angular-eslint/no-lifecycle-call": "error",
         "@angular-eslint/no-pipe-impure": "error",
@@ -404,7 +417,27 @@ function javascript(options = {}) {
         "no-octal-escape": "error",
         "no-plusplus": ["error", { allowForLoopAfterthoughts: true }],
         "no-proto": "error",
-        "no-restricted-syntax": ["error", "TSEnumDeclaration[const=true]", "TSExportAssignment", "ForInStatement"],
+        /*
+        'no-restricted-syntax': [
+          'error',
+          {
+            selector: 'TSEnumDeclaration',
+            message: '',
+          },
+          {
+            selector: 'TSExportAssignment',
+            message: '',
+          },
+          {
+            selector: 'ForInStatement',
+            message: '',
+          },
+          {
+            selector: ':matches(PropertyDefinition, MethodDefinition)[accessibility="private"]',
+            message: 'Use `#private` members instead.',
+          },
+        ],
+        */
         "no-self-compare": "error",
         "no-sequences": "error",
         "no-template-curly-in-string": "error",
@@ -1231,42 +1264,43 @@ 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'));
+  await ensurePackages(["eslint-plugin-better-tailwindcss"]);
+  const betterTailwindcssPlugin = await interopDefault(import('eslint-plugin-better-tailwindcss'));
+  const { files: filesGlob, overrides, enableAllRules, parsers, ...settings } = options;
   let files;
   let parserConfigs;
-  const { overrides = {} } = options;
-  if (isTailwindcssParserPerGlobOptions(options)) {
-    const parsers = options.parsers ?? {};
+  if (parsers) {
     files = { files: [...new Set(Object.keys(parsers))] };
     parserConfigs = Object.entries(parsers).map(([glob, parser], index) => ({
       name: `fabdeh/tailwindcss/parser-${index + 1}`,
-      file: [glob],
+      files: [glob],
       languageOptions: {
         parser
       }
     }));
   } else {
-    files = { files: options.files ?? [GLOB_SRC, GLOB_HTML] };
+    files = { files: filesGlob ?? [GLOB_SRC, GLOB_HTML] };
     parserConfigs = [];
   }
   return tseslint.config(
     ...parserConfigs,
     {
-      name: "fabdeh/tailwindcss/rules",
-      plugins: { tailwindcss: tailwindcssPlugin },
+      name: "@fabdeh/tailwindcss/rules",
       ...files,
+      plugins: {
+        "better-tailwindcss": betterTailwindcssPlugin
+      },
+      settings: {
+        "better-tailwindcss": settings
+      },
       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
+        ...betterTailwindcssPlugin.configs.recommended.rules,
+        ...enableAllRules ? {
+          "better-tailwindcss/enforce-consistent-variable-syntax": "warn",
+          "better-tailwindcss/no-conflicting-classes": "error",
+          "better-tailwindcss/no-restricted-classes": "error"
+        } : {}
       }
     }
   );
@@ -1347,7 +1381,7 @@ const memberOrdering = {
 };
 
 async function typescript(options = {}) {
-  const { stylistic = true, parserOptions = {}, overrides = {}, enableErasableSyntaxOnly = false } = options;
+  const { stylistic = true, parserOptions = {}, overrides = {}, enableErasableSyntaxOnly = false, type = "app" } = options;
   let erasableSyntaxOnlyPlugin;
   let erasableSyntaxOnlyRules;
   if (enableErasableSyntaxOnly) {
@@ -1403,17 +1437,15 @@ async function typescript(options = {}) {
           prefer: "type-imports"
         }],
         "@typescript-eslint/dot-notation": "error",
-        "@typescript-eslint/explicit-module-boundary-types": "error",
-        "@typescript-eslint/explicit-function-return-type": [
-          "error",
-          {
-            allowExpressions: true,
-            allowTypedFunctionExpressions: true,
-            allowHigherOrderFunctions: true,
-            allowDirectConstAssertionInArrowFunctions: true,
-            allowConciseArrowFunctionExpressionsStartingWithVoid: true
-          }
-        ],
+        ...type === "lib" ? {
+          "@typescript-eslint/explicit-function-return-type": [
+            "error",
+            {
+              allowExpressions: true,
+              allowIIFEs: true
+            }
+          ]
+        } : { "@typescript-eslint/explicit-module-boundary-types": "error" },
         "@typescript-eslint/explicit-member-accessibility": ["error", { accessibility: "no-public" }],
         "@typescript-eslint/member-ordering": ["error", memberOrdering],
         "@typescript-eslint/method-signature-style": "error",
@@ -1959,7 +1991,8 @@ async function defineConfig(options = {}, ...userConfigs) {
     const typescriptOptions = resolveSubOptions(options, "typescript");
     configs.push(typescript({
       ...typescriptOptions,
-      stylistic: stylisticOptions
+      stylistic: stylisticOptions,
+      type: options.type
     }));
   }
   if (stylisticOptions) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@fabdeh/eslint-config",
   "type": "module",
-  "version": "0.5.0",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39",
+  "version": "0.6.1",
+  "packageManager": "pnpm@10.12.4+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184",
   "description": "My personal eslint config preset",
   "author": {
     "name": "Fabien Dehopré",
@@ -55,22 +55,22 @@
   "peerDependencies": {
     "@prettier/plugin-xml": "^3.4.1",
     "eslint": "^9.21.0",
+    "eslint-plugin-better-tailwindcss": "^3.4.1",
     "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": {
+    "eslint-plugin-better-tailwindcss": {
       "optional": true
     },
-    "eslint-plugin-format": {
+    "eslint-plugin-erasable-syntax-only": {
       "optional": true
     },
-    "eslint-plugin-tailwindcss": {
+    "eslint-plugin-format": {
       "optional": true
     },
     "prettier-plugin-slidev": {
@@ -81,39 +81,39 @@
     "@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",
+    "@eslint/js": "^9.30.1",
+    "@eslint/markdown": "^6.6.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",
+    "@typescript-eslint/eslint-plugin": "^8.35.1",
+    "@typescript-eslint/parser": "^8.35.1",
+    "@typescript-eslint/utils": "^8.35.1",
+    "@vitest/eslint-plugin": "^1.3.4",
+    "angular-eslint": "^20.1.1",
     "eslint-config-flat-gitignore": "^2.1.0",
     "eslint-flat-config-utils": "^2.1.0",
     "eslint-merge-processors": "^2.0.0",
-    "eslint-plugin-import-x": "^4.15.1",
+    "eslint-plugin-import-x": "^4.16.1",
     "eslint-plugin-jest-dom": "^5.5.0",
-    "eslint-plugin-jsdoc": "^50.7.1",
+    "eslint-plugin-jsdoc": "^50.8.0",
     "eslint-plugin-jsonc": "^2.20.1",
-    "eslint-plugin-perfectionist": "^4.14.0",
+    "eslint-plugin-perfectionist": "^4.15.0",
     "eslint-plugin-prefer-arrow-functions": "^3.6.2",
-    "eslint-plugin-regexp": "^2.8.0",
-    "eslint-plugin-testing-library": "^7.4.0",
+    "eslint-plugin-regexp": "^2.9.0",
+    "eslint-plugin-testing-library": "^7.5.3",
     "eslint-plugin-toml": "^0.12.0",
     "eslint-plugin-unicorn": "^59.0.1",
     "eslint-plugin-unused-imports": "^4.1.4",
     "eslint-plugin-yml": "^1.18.0",
-    "globals": "^16.2.0",
+    "globals": "^16.3.0",
     "jsonc-eslint-parser": "^2.4.0",
     "local-pkg": "^1.1.1",
     "toml-eslint-parser": "^0.10.0",
-    "typescript-eslint": "^8.33.1",
+    "typescript-eslint": "^8.35.1",
     "yaml-eslint-parser": "^1.3.0"
   },
   "devDependencies": {
-    "@angular/core": "^20.0.2",
+    "@angular/core": "^20.0.6",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@commitlint/cz-commitlint": "^19.8.1",
@@ -126,14 +126,14 @@
     "@testing-library/angular": "^17.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.15.30",
-    "bumpp": "^10.1.1",
-    "changelogithub": "^13.15.0",
+    "@types/node": "^22.16.0",
+    "bumpp": "^10.2.0",
+    "changelogithub": "^13.16.0",
     "commitizen": "^4.3.1",
-    "eslint": "^9.28.0",
+    "eslint": "^9.30.1",
+    "eslint-plugin-better-tailwindcss": "^3.4.3",
     "eslint-plugin-erasable-syntax-only": "^0.3.1",
     "eslint-plugin-format": "^1.0.1",
-    "eslint-plugin-tailwindcss": "^3.18.0",
     "execa": "^9.6.0",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.0",
@@ -143,10 +143,10 @@
     "nano-staged": "^0.8.0",
     "prettier-plugin-slidev": "^1.0.5",
     "simple-git-hooks": "^2.13.0",
-    "tailwindcss": "^3.4.17",
+    "tailwindcss": "^4.1.11",
     "typescript": "^5.8.3",
     "unbuild": "^3.5.0",
-    "vitest": "^3.2.2"
+    "vitest": "^3.2.4"
   },
   "pnpm": {
     "overrides": {