@maz-ui/eslint-config 4.9.1 → 5.0.0-beta.1

package/README.md

@@ -1,15 +1,16 @@
 # @maz-ui/eslint-config
 
-Reusable ESLint configuration for JavaScript/TypeScript projects.
+Reusable ESLint configuration for JavaScript/TypeScript projects, built on top of [`@antfu/eslint-config`](https://github.com/antfu/eslint-config).
 
 ## Features
 
-- 🚀 **Based on @antfu/eslint-config** - Modern and performant configuration
-- 🛡️ **Strict TypeScript** - Full TypeScript support
-- 🎨 **Tailwind CSS** - Rules for Tailwind CSS (with Tailwind CSS plugin)
-- 🔍 **SonarJS** - Code quality with SonarJS (with SonarJS plugin)
-- ⚙️ **Configurable** - Flexible and extensible options
-- 📦 **Production ready** - Optimized for production environments
+- 🚀 **Based on @antfu/eslint-config** — modern, performant, flat-config first
+- 🛡️ **TypeScript-first** — strict mode, sensible defaults
+- 🎨 **Tailwind CSS v3 + v4** — via [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss) (compat ESLint 7→10, both Tailwind versions)
+- 🔍 **SonarJS** — code quality / cognitive complexity
+- ♿ **Vue accessibility** — opt-in `eslint-plugin-vuejs-accessibility`
+- 📐 **Formatters** — Prettier-style formatting via `eslint-plugin-format`
+- ⚙️ **Configurable** — pick presets, add per-file rules, custom ignore globs
 
 ## Installation
 
@@ -26,139 +27,119 @@ import { defineConfig } from '@maz-ui/eslint-config'
 export default defineConfig()
 ```
 
-## Custom configuration
+Vue / Nuxt are auto-detected from your `package.json`.
+
+## Configuration
 
 ```js
 // eslint.config.js
 import { defineConfig } from '@maz-ui/eslint-config'
 
 export default defineConfig({
-  // Environment (affects console rules)
-  env: 'production', // 'development' | 'production'
+  env: 'production', // 'development' | 'production' — affects no-console / no-debugger severity
 
-  // Enable/disable plugins
+  // Antfu options (forwarded as-is)
   typescript: true,
-  tailwindcss: true,
-  sonarjs: true,
   formatters: true,
+  unicorn: true,
+
+  // Maz-UI options
+  sonarjs: true,
+  vueAccessibility: false,
+  tailwindcss: 'recommended', // see "Tailwind support" below
 
-  // Files to ignore
+  // Extra ignore globs (merged with defaults)
   ignores: ['custom-dist/**'],
 
   // Custom rules
   rules: {
     'no-console': 'error',
-    'prefer-const': 'warn'
-  }
+  },
+
+  // 'silent' | 'default' | 'debug' | 'verbose' — see "Logging" below.
+  logLevel: 'default',
 })
 ```
 
-## Available options
-
-```typescript
-interface MazESLintOptions {
-  typescript?: boolean // TypeScript support (default: true)
-  tailwindcss?: boolean // Tailwind CSS rules (default: true)
-  sonarjs?: boolean // SonarJS rules (default: true)
-  formatters?: boolean // Formatters support (default: true)
-  env?: 'development' | 'production' // Environment (default: 'development')
-  ignores?: string[] // Files to ignore
-  rules?: Record<string, any> // Custom ESLint rules
-}
-```
+## Logging
 
-## Advanced usage
+The preset prints a titled box summarizing what it resolved (typescript, vue, tailwindcss preset, sonarjs, …). Powered by `@maz-ui/node`'s consola-based logger.
 
-### Selective rule imports
+| Value                       | What you see                                       |
+| --------------------------- | -------------------------------------------------- |
+| `'silent'`                  | Nothing.                                           |
+| `'default'` _(TTY default)_ | Titled box of resolved feature toggles.            |
+| `'debug'`                   | Above + each plugin / preset / overrides addition. |
+| `'verbose'`                 | Above + final block count and ignore-glob count.   |
 
-```js
-import { baseRules, sonarjsRules, tailwindcssRules } from '@maz-ui/eslint-config'
+The default is **`'default'` in interactive terminals, `'silent'` otherwise** (CI, pipes, JSON / SARIF formatters). This avoids polluting machine-readable ESLint output. Override by passing `logLevel` explicitly.
 
-export default [
-  {
-    rules: {
-      ...baseRules,
-      ...sonarjsRules,
-      // Your custom rules
-    }
-  }
-]
-```
+## Tailwind support
 
-### Example for Vue project
+Powered by [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss) — compatible with ESLint 7→10 and Tailwind v3 + v4.
 
-```js
-// eslint.config.js
-import { defineConfig } from '@maz-ui/eslint-config'
+| Value                   | Behavior                                                                |
+| ----------------------- | ----------------------------------------------------------------------- |
+| `false` _(default)_     | Disabled.                                                               |
+| `true`                  | Same as `'recommended'` with default settings.                          |
+| `'recommended'`         | Stylistic + correctness rules.                                          |
+| `'stylistic'`           | Formatting rules only (class order, line wrapping, …).                  |
+| `'correctness'`         | Validation rules only (`no-unknown-classes`, `no-conflicting-classes`). |
+| `MazTailwindcssOptions` | Pick a preset and pass plugin settings.                                 |
 
-export default defineConfig({
-  env: 'production',
-  rules: {
-    'vue/custom-event-name-casing': ['error', 'kebab-case'],
-    'vue/no-undef-components': ['error', {
-      ignorePatterns: ['RouterView', 'RouterLink']
-    }]
-  }
+```js
+defineConfig({
+  tailwindcss: {
+    preset: 'recommended',
+    // Tailwind v4: path to the CSS that does `@import "tailwindcss" prefix(maz)`
+    entryPoint: 'src/main.css',
+    // Tailwind v3 instead:
+    // tailwindConfig: 'tailwind.config.ts',
+    detectComponentClasses: true,
+  },
 })
 ```
 
-## Included rules
-
-### Base (JavaScript/TypeScript)
-
-- Console management by environment
-- Code quality rules
-- Optimized TypeScript support
-
-### SonarJS
-
-- Limited cognitive complexity
-- Duplicate code detection
-- Security best practices
+> [!IMPORTANT]
+> The plugin's `no-unknown-classes` rule needs to know about your Tailwind setup (prefix, custom utilities, theme tokens). Without `entryPoint` (v4) or `tailwindConfig` (v3), it falls back to the default Tailwind config and will flood with false positives in projects that customize either. **Pass the path explicitly** if your Tailwind setup is non-standard.
 
-### Tailwind CSS
+## Advanced
 
-- Consistent class ordering
-- Contradictory class detection
-- Valid Tailwind syntax
-
-## Compatibility
-
-- **ESLint** ^9.0.0
-- **Node.js** >=18.0.0
-- **TypeScript** ^5.0.0
-
-## Usage examples
-
-### Simple JavaScript project
+### Compose your own config
 
 ```js
-export default defineConfig({
-  typescript: false,
-  tailwindcss: false
-})
+import {
+  baseRules,
+  sonarjsRules,
+  tailwindcssConfigs,
+  vueRules,
+} from '@maz-ui/eslint-config'
+
+export default [
+  {
+    rules: {
+      ...baseRules(true), // production = true
+      ...sonarjsRules,
+      ...vueRules,
+    },
+  },
+  ...tailwindcssConfigs('stylistic', { entryPoint: 'src/main.css' }),
+]
 ```
 
-### Project with Tailwind
+### Vue project
 
 ```js
-export default defineConfig({
-  tailwindcss: true,
+defineConfig({
+  vue: true, // auto-detected if `vue` / `nuxt` is in deps
+  tailwindcss: 'recommended',
   rules: {
-    'tailwindcss/classnames-order': 'error'
-  }
+    'vue/custom-event-name-casing': ['error', 'kebab-case'],
+  },
 })
 ```
 
-### Production project
+## Compatibility
 
-```js
-export default defineConfig({
-  env: 'production',
-  sonarjs: true,
-  rules: {
-    'no-console': 'error',
-    'no-debugger': 'error'
-  }
-})
-```
+- **ESLint** `^9.0.0 || ^10.0.0`
+- **Node.js** `>=20.19.0`

package/dist/index.d.mts

@@ -1,13 +1,73 @@
 import { antfu, OptionsConfig, Rules, TypedFlatConfigItem } from '@antfu/eslint-config';
 import { Linter } from 'eslint';
 
+/**
+ * Mirror of `@maz-ui/node`'s LogLevel — kept inline here to avoid making this
+ * preset depend on `@maz-ui/node`, which would create a build cycle (the
+ * `eslint.config.ts` of `@maz-ui/node` imports `@maz-ui/eslint-config`, which
+ * itself would depend on `@maz-ui/node` for the same logger). Direct usage of
+ * `consola` keeps the dependency graph acyclic.
+ */
+type LogLevel = 'silent' | 'error' | 'warning' | 'normal' | 'default' | 'debug' | 'trace' | 'verbose';
+
 type MazESLintUserConfig = TypedFlatConfigItem | TypedFlatConfigItem[] | Linter.Config | Linter.Config[];
+type TailwindcssPreset = 'recommended' | 'stylistic' | 'correctness';
+/**
+ * Settings forwarded to `eslint-plugin-better-tailwindcss` under
+ * `settings['better-tailwindcss']`. See the plugin docs for the canonical
+ * meaning of each field.
+ */
+interface MazTailwindcssOptions {
+    /**
+     * Which preset to load. Each one comes in `*-warn` and `*-error` flavors
+     * (defaults match the plugin's defaults: stylistic→warn, correctness→error).
+     *
+     * @default 'recommended'
+     */
+    preset?: TailwindcssPreset;
+    /**
+     * Tailwind v4: path to the CSS entry file (the one that does
+     * `@import "tailwindcss"`, possibly with `prefix(...)`). Required for the
+     * plugin to know about your prefix and `@theme` tokens.
+     */
+    entryPoint?: string;
+    /**
+     * Tailwind v3: path to `tailwind.config.{js,ts,cjs,mjs}`. Use `entryPoint`
+     * for v4 instead.
+     */
+    tailwindConfig?: string;
+    /**
+     * Tailwind v4: enable detection of custom component classes (`@layer
+     * components { … }`) so they are not reported as unknown.
+     *
+     * @default false
+     */
+    detectComponentClasses?: boolean;
+    /**
+     * Working directory used to resolve `tailwindcss` and the config files
+     * above. Useful in monorepos when ESLint runs from the repo root.
+     */
+    cwd?: string;
+    /**
+     * Path to a `tsconfig.json` used to resolve `paths` aliases inside the
+     * Tailwind config.
+     */
+    tsconfig?: string;
+}
 interface MazESLintOptions extends OptionsConfig {
     /**
-     * Enable Tailwind CSS support
+     * Tailwind CSS support — wires `eslint-plugin-better-tailwindcss`.
+     *
+     * - `false` *(default)*: disabled.
+     * - `true`: load the `'recommended'` preset with default settings.
+     * - `'recommended' | 'stylistic' | 'correctness'`: pick a preset, default
+     *   settings.
+     * - `MazTailwindcssOptions`: pick a preset and pass settings (e.g.
+     *   `entryPoint` so the plugin learns your v4 prefix).
+     *
      * @default false
      */
-    tailwindcss?: boolean;
+    tailwindcss?: boolean | TailwindcssPreset | MazTailwindcssOptions;
     /**
      * Enable SonarJS rules for code quality
      * @default true
@@ -32,6 +92,19 @@ interface MazESLintOptions extends OptionsConfig {
      * Additional rules to merge
      */
     rules?: Partial<Rules>;
+    /**
+     * Verbosity of the logs emitted while resolving the config. Defaults to
+     * `'default'` so the resolved-configuration box is shown when the preset
+     * loads. Set to `'silent'` to hide it, or `'debug'` / `'verbose'` to dig
+     * deeper.
+     *
+     * - `'silent'`: nothing is printed.
+     * - `'default'` *(default)*: a titled box summarizing the resolved feature
+     *   toggles.
+     * - `'debug'`: also logs each plugin / preset / overrides addition.
+     * - `'verbose'`: also logs the final shape (config block count, etc.).
+     */
+    logLevel?: LogLevel;
 }
 type MazESLintConfig = ReturnType<typeof antfu>;
 
@@ -68,15 +141,17 @@ declare const sonarjsTestRules: {
 };
 
 /**
- * Tailwind CSS ESLint rules configuration
+ * Files where Tailwind classes commonly live. Exposed for users who want to
+ * compose their own config.
  */
-declare const tailwindcssRules: {
-    readonly 'tailwindcss/no-custom-classname': "off";
-    readonly 'tailwindcss/classnames-order': "warn";
-    readonly 'tailwindcss/no-contradicting-classname': "error";
-    readonly 'tailwindcss/enforces-negative-arbitrary-values': "error";
-    readonly 'tailwindcss/enforces-shorthand': "warn";
-};
+declare const TAILWINDCSS_DEFAULT_FILES: string[];
+/**
+ * Build the flat-config block(s) that wire up
+ * `eslint-plugin-better-tailwindcss`. The plugin already ships preset
+ * objects with `plugins` + `rules`; we spread them and add `files` plus
+ * `settings['better-tailwindcss']` so the user's options reach the plugin.
+ */
+declare function tailwindcssConfigs(preset: TailwindcssPreset, settings: MazTailwindcssOptions): Linter.Config[];
 
 declare const vueRules: {
     'vue/custom-event-name-casing': ["error", "kebab-case"];
@@ -102,5 +177,5 @@ declare const vueRules: {
  */
 declare function defineConfig(options?: MazESLintOptions, ...userConfigs: MazESLintUserConfig[]): MazESLintConfig;
 
-export { baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssRules, vueRules };
-export type { MazESLintConfig, MazESLintOptions };
+export { TAILWINDCSS_DEFAULT_FILES, baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssConfigs, vueRules };
+export type { MazESLintConfig, MazESLintOptions, MazTailwindcssOptions, TailwindcssPreset };

package/dist/index.d.ts

@@ -1,13 +1,73 @@
 import { antfu, OptionsConfig, Rules, TypedFlatConfigItem } from '@antfu/eslint-config';
 import { Linter } from 'eslint';
 
+/**
+ * Mirror of `@maz-ui/node`'s LogLevel — kept inline here to avoid making this
+ * preset depend on `@maz-ui/node`, which would create a build cycle (the
+ * `eslint.config.ts` of `@maz-ui/node` imports `@maz-ui/eslint-config`, which
+ * itself would depend on `@maz-ui/node` for the same logger). Direct usage of
+ * `consola` keeps the dependency graph acyclic.
+ */
+type LogLevel = 'silent' | 'error' | 'warning' | 'normal' | 'default' | 'debug' | 'trace' | 'verbose';
+
 type MazESLintUserConfig = TypedFlatConfigItem | TypedFlatConfigItem[] | Linter.Config | Linter.Config[];
+type TailwindcssPreset = 'recommended' | 'stylistic' | 'correctness';
+/**
+ * Settings forwarded to `eslint-plugin-better-tailwindcss` under
+ * `settings['better-tailwindcss']`. See the plugin docs for the canonical
+ * meaning of each field.
+ */
+interface MazTailwindcssOptions {
+    /**
+     * Which preset to load. Each one comes in `*-warn` and `*-error` flavors
+     * (defaults match the plugin's defaults: stylistic→warn, correctness→error).
+     *
+     * @default 'recommended'
+     */
+    preset?: TailwindcssPreset;
+    /**
+     * Tailwind v4: path to the CSS entry file (the one that does
+     * `@import "tailwindcss"`, possibly with `prefix(...)`). Required for the
+     * plugin to know about your prefix and `@theme` tokens.
+     */
+    entryPoint?: string;
+    /**
+     * Tailwind v3: path to `tailwind.config.{js,ts,cjs,mjs}`. Use `entryPoint`
+     * for v4 instead.
+     */
+    tailwindConfig?: string;
+    /**
+     * Tailwind v4: enable detection of custom component classes (`@layer
+     * components { … }`) so they are not reported as unknown.
+     *
+     * @default false
+     */
+    detectComponentClasses?: boolean;
+    /**
+     * Working directory used to resolve `tailwindcss` and the config files
+     * above. Useful in monorepos when ESLint runs from the repo root.
+     */
+    cwd?: string;
+    /**
+     * Path to a `tsconfig.json` used to resolve `paths` aliases inside the
+     * Tailwind config.
+     */
+    tsconfig?: string;
+}
 interface MazESLintOptions extends OptionsConfig {
     /**
-     * Enable Tailwind CSS support
+     * Tailwind CSS support — wires `eslint-plugin-better-tailwindcss`.
+     *
+     * - `false` *(default)*: disabled.
+     * - `true`: load the `'recommended'` preset with default settings.
+     * - `'recommended' | 'stylistic' | 'correctness'`: pick a preset, default
+     *   settings.
+     * - `MazTailwindcssOptions`: pick a preset and pass settings (e.g.
+     *   `entryPoint` so the plugin learns your v4 prefix).
+     *
      * @default false
      */
-    tailwindcss?: boolean;
+    tailwindcss?: boolean | TailwindcssPreset | MazTailwindcssOptions;
     /**
      * Enable SonarJS rules for code quality
      * @default true
@@ -32,6 +92,19 @@ interface MazESLintOptions extends OptionsConfig {
      * Additional rules to merge
      */
     rules?: Partial<Rules>;
+    /**
+     * Verbosity of the logs emitted while resolving the config. Defaults to
+     * `'default'` so the resolved-configuration box is shown when the preset
+     * loads. Set to `'silent'` to hide it, or `'debug'` / `'verbose'` to dig
+     * deeper.
+     *
+     * - `'silent'`: nothing is printed.
+     * - `'default'` *(default)*: a titled box summarizing the resolved feature
+     *   toggles.
+     * - `'debug'`: also logs each plugin / preset / overrides addition.
+     * - `'verbose'`: also logs the final shape (config block count, etc.).
+     */
+    logLevel?: LogLevel;
 }
 type MazESLintConfig = ReturnType<typeof antfu>;
 
@@ -68,15 +141,17 @@ declare const sonarjsTestRules: {
 };
 
 /**
- * Tailwind CSS ESLint rules configuration
+ * Files where Tailwind classes commonly live. Exposed for users who want to
+ * compose their own config.
  */
-declare const tailwindcssRules: {
-    readonly 'tailwindcss/no-custom-classname': "off";
-    readonly 'tailwindcss/classnames-order': "warn";
-    readonly 'tailwindcss/no-contradicting-classname': "error";
-    readonly 'tailwindcss/enforces-negative-arbitrary-values': "error";
-    readonly 'tailwindcss/enforces-shorthand': "warn";
-};
+declare const TAILWINDCSS_DEFAULT_FILES: string[];
+/**
+ * Build the flat-config block(s) that wire up
+ * `eslint-plugin-better-tailwindcss`. The plugin already ships preset
+ * objects with `plugins` + `rules`; we spread them and add `files` plus
+ * `settings['better-tailwindcss']` so the user's options reach the plugin.
+ */
+declare function tailwindcssConfigs(preset: TailwindcssPreset, settings: MazTailwindcssOptions): Linter.Config[];
 
 declare const vueRules: {
     'vue/custom-event-name-casing': ["error", "kebab-case"];
@@ -102,5 +177,5 @@ declare const vueRules: {
  */
 declare function defineConfig(options?: MazESLintOptions, ...userConfigs: MazESLintUserConfig[]): MazESLintConfig;
 
-export { baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssRules, vueRules };
-export type { MazESLintConfig, MazESLintOptions };
+export { TAILWINDCSS_DEFAULT_FILES, baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssConfigs, vueRules };
+export type { MazESLintConfig, MazESLintOptions, MazTailwindcssOptions, TailwindcssPreset };

package/dist/index.mjs

@@ -1,10 +1,10 @@
 import { readFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
 import { join } from 'node:path';
 import antfu from '@antfu/eslint-config';
 import { configs } from 'eslint-plugin-sonarjs';
-import tailwind from 'eslint-plugin-tailwindcss';
 import vueA11y from 'eslint-plugin-vuejs-accessibility';
+import { createConsola } from 'consola';
+import betterTailwindcss from 'eslint-plugin-better-tailwindcss';
 
 function baseRules(isProduction) {
   return {
@@ -72,6 +72,29 @@ const GLOBAL_IGNORES = [
   "**/components.d.ts"
 ];
 
+const LEVELS = {
+  silent: Number.NEGATIVE_INFINITY,
+  error: 0,
+  warning: 1,
+  normal: 2,
+  default: 3,
+  debug: 4,
+  trace: 5,
+  verbose: Number.POSITIVE_INFINITY
+};
+function createLogger() {
+  const consola = createConsola();
+  return {
+    setLevel: (level) => {
+      consola.level = LEVELS[level];
+    },
+    info: (msg) => consola.info(msg),
+    debug: (msg) => consola.debug(msg),
+    verbose: (msg) => consola.verbose(msg),
+    box: (opts) => consola.box(opts)
+  };
+}
+
 const markdown = {
   files: ["**/*.md/**"],
   rules: {
@@ -104,17 +127,34 @@ const sonarjsTestRules = {
   "sonarjs/no-duplicate-string": "off"
 };
 
-const tailwindcssRules = {
-  // Allow custom class names (useful for component libraries)
-  "tailwindcss/no-custom-classname": "off",
-  // Enforce consistent class ordering
-  "tailwindcss/classnames-order": "warn",
-  // Prevent contradicting classes
-  "tailwindcss/no-contradicting-classname": "error",
-  // Enforce valid Tailwind syntax
-  "tailwindcss/enforces-negative-arbitrary-values": "error",
-  "tailwindcss/enforces-shorthand": "warn"
-};
+const TAILWINDCSS_FILES = ["**/*.{js,jsx,cjs,mjs,ts,mts,cts,tsx,vue,html,svelte,astro,astrojs,css,scss}"];
+const TAILWINDCSS_DEFAULT_FILES = TAILWINDCSS_FILES;
+function tailwindcssConfigs(preset, settings) {
+  const presetConfig = betterTailwindcss.configs[preset];
+  const tailwindSettings = {};
+  if (settings.entryPoint)
+    tailwindSettings.entryPoint = settings.entryPoint;
+  if (settings.tailwindConfig)
+    tailwindSettings.tailwindConfig = settings.tailwindConfig;
+  if (settings.detectComponentClasses !== void 0)
+    tailwindSettings.detectComponentClasses = settings.detectComponentClasses;
+  if (settings.cwd)
+    tailwindSettings.cwd = settings.cwd;
+  if (settings.tsconfig)
+    tailwindSettings.tsconfig = settings.tsconfig;
+  return [{
+    ...presetConfig,
+    files: TAILWINDCSS_FILES,
+    settings: {
+      "better-tailwindcss": tailwindSettings
+    },
+    rules: {
+      ...presetConfig.rules,
+      "better-tailwindcss/no-unknown-classes": "off",
+      "better-tailwindcss/enforce-consistent-line-wrapping": "off"
+    }
+  }];
+}
 
 const testRules = {
   "max-nested-callbacks": "off"
@@ -124,6 +164,7 @@ const vueRules = {
   "vue/custom-event-name-casing": ["error", "kebab-case"]
 };
 
+const TAG = "[@maz-ui/eslint-config]";
 const defaultOptions = {
   formatters: true,
   typescript: true,
@@ -140,30 +181,89 @@ function getPackageJson() {
     return void 0;
   }
 }
-function getEslintMajorVersion() {
-  try {
-    const _require = createRequire(import.meta.url);
-    const eslintPkg = _require("eslint/package.json");
-    return Number(eslintPkg.version.split(".")[0]);
-  } catch {
-    return 0;
-  }
+function hasDependency(pkg, ...names) {
+  if (!pkg)
+    return false;
+  const buckets = [pkg.dependencies, pkg.devDependencies, pkg.peerDependencies];
+  return names.some((name) => buckets.some((bucket) => bucket && name in bucket));
 }
-function isVueOrNuxtProject() {
-  const packageJson = getPackageJson();
-  return packageJson?.dependencies?.vue || packageJson?.devDependencies?.vue || packageJson?.peerDependencies?.vue || packageJson?.dependencies?.nuxt || packageJson?.devDependencies?.nuxt || packageJson?.peerDependencies?.nuxt;
+function resolveVue(option) {
+  if (option === true)
+    return { value: true, source: "explicit" };
+  if (option === false)
+    return { value: false, source: "explicit" };
+  return { value: hasDependency(getPackageJson(), "vue", "nuxt"), source: "auto-detected" };
+}
+function resolveTailwindcss(option) {
+  if (option === void 0)
+    return { value: false, source: "default" };
+  if (option === false)
+    return { value: false, source: "explicit" };
+  if (option === true)
+    return { value: { preset: "recommended", settings: {} }, source: "explicit" };
+  if (typeof option === "string")
+    return { value: { preset: option, settings: {} }, source: "explicit" };
+  return { value: { preset: option.preset ?? "recommended", settings: option }, source: "explicit" };
+}
+function resolveOptions(opts, env) {
+  const vue = resolveVue(opts.vue);
+  const tailwind = resolveTailwindcss(opts.tailwindcss);
+  return {
+    typescript: opts.typescript !== false,
+    formatters: opts.formatters !== false,
+    unicorn: opts.unicorn !== false,
+    sonarjs: opts.sonarjs !== false,
+    vue: vue.value,
+    vueSource: vue.source,
+    vueAccessibility: opts.vueAccessibility === true,
+    tailwindcss: tailwind.value,
+    tailwindcssSource: tailwind.source,
+    env
+  };
+}
+function formatSourceTag(source) {
+  if (source === "auto-detected")
+    return " (auto-detected)";
+  if (source === "default")
+    return " (default)";
+  return "";
+}
+function formatResolutionBox(r) {
+  const tailwindLabel = r.tailwindcss === false ? "off" : r.tailwindcss.preset;
+  const rows = [
+    ["typescript", String(r.typescript)],
+    ["vue", `${r.vue}${formatSourceTag(r.vueSource)}`],
+    ["vueAccessibility", String(r.vueAccessibility)],
+    ["sonarjs", String(r.sonarjs)],
+    ["tailwindcss", `${tailwindLabel}${formatSourceTag(r.tailwindcssSource)}`],
+    ["formatters", String(r.formatters)],
+    ["unicorn", String(r.unicorn)],
+    ["env", r.env]
+  ];
+  const labelWidth = Math.max(...rows.map(([k]) => k.length));
+  return rows.map(([k, v]) => `${k.padEnd(labelWidth)}  ${v}`).join("\n");
 }
 function defineConfig(options = {}, ...userConfigs) {
+  const log = createLogger();
+  const defaultLogLevel = process.stdout.isTTY ? "default" : "silent";
+  log.setLevel(options.logLevel ?? defaultLogLevel);
   const opts = { ...defaultOptions, ...options, ignores: [...GLOBAL_IGNORES, ...options.ignores || []] };
   const env = opts.env || process.env.NODE_ENV || "production";
+  const resolved = resolveOptions(opts, env);
+  log.box({
+    title: "@maz-ui/eslint-config",
+    message: formatResolutionBox(resolved),
+    style: { borderColor: "cyan", padding: 1 }
+  });
   const additionalConfigs = [];
-  if (opts.vue || isVueOrNuxtProject()) {
+  if (resolved.vue) {
     additionalConfigs.push({
       files: ["**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue}"],
       rules: vueRules
     });
+    log.debug(`${TAG} Vue: applied vueRules to JS/TS/Vue files`);
   }
-  if (opts.sonarjs) {
+  if (resolved.sonarjs) {
     const sonarjsFiles = ["**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue}"];
     additionalConfigs.push({
       ...configs.recommended,
@@ -177,8 +277,9 @@ function defineConfig(options = {}, ...userConfigs) {
       files: ["**/*.spec.ts", "**/*.test.ts", "**/*.spec.js", "**/*.test.js"],
       rules: sonarjsTestRules
     });
+    log.debug(`${TAG} SonarJS: applied recommended preset + ${Object.keys(sonarjsRules).length} extra rules + test-file relaxations`);
   }
-  if (opts.vueAccessibility) {
+  if (resolved.vueAccessibility) {
     const vueA11yConfigs = vueA11y.configs["flat/recommended"];
     const configsArray = Array.isArray(vueA11yConfigs) ? vueA11yConfigs : [vueA11yConfigs];
     const fixedConfigs = configsArray.map((config) => {
@@ -199,21 +300,26 @@ function defineConfig(options = {}, ...userConfigs) {
       return config;
     });
     additionalConfigs.push(...fixedConfigs);
+    log.debug(`${TAG} Vue a11y: applied ${fixedConfigs.length} flat-config block(s) from eslint-plugin-vuejs-accessibility`);
   }
-  if (opts.tailwindcss) {
-    if (getEslintMajorVersion() >= 10) {
-      console.warn("[maz-eslint-config] eslint-plugin-tailwindcss is not compatible with ESLint 10+ (uses removed context.getSourceCode API). Tailwind CSS rules are disabled.");
-    } else {
-      additionalConfigs.push(...tailwind.configs["flat/recommended"]);
-      additionalConfigs.push({
-        rules: tailwindcssRules
-      });
-    }
+  if (resolved.tailwindcss) {
+    const blocks = tailwindcssConfigs(resolved.tailwindcss.preset, resolved.tailwindcss.settings);
+    additionalConfigs.push(...blocks);
+    const settingKeys = Object.keys(resolved.tailwindcss.settings).filter((k) => k !== "preset");
+    const settingsHint = settingKeys.length > 0 ? ` with settings (${settingKeys.join(", ")})` : "";
+    log.debug(`${TAG} Tailwind: loaded "${resolved.tailwindcss.preset}" preset${settingsHint}`);
   }
   additionalConfigs.push({
     files: ["**/*.spec.ts", "**/*.test.ts", "**/*.spec.js", "**/*.test.js"],
     rules: testRules
   });
+  log.debug(`${TAG} Tests: relaxed rules applied to *.spec.{ts,js} / *.test.{ts,js}`);
+  if (options.rules && Object.keys(options.rules).length > 0)
+    log.debug(`${TAG} User: merged ${Object.keys(options.rules).length} rule override(s)`);
+  if (userConfigs.length > 0)
+    log.debug(`${TAG} User: appended ${userConfigs.length} flat-config argument(s)`);
+  log.verbose(`${TAG} Final config block count: ${additionalConfigs.length + userConfigs.length + 1} (additional: ${additionalConfigs.length}, user: ${userConfigs.length}, +markdown)`);
+  log.verbose(`${TAG} Ignore globs: ${opts.ignores.length}`);
   return antfu({
     formatters: opts.formatters,
     ...opts,
@@ -227,4 +333,4 @@ function defineConfig(options = {}, ...userConfigs) {
   }, ...additionalConfigs, ...userConfigs, markdown);
 }
 
-export { baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssRules, vueRules };
+export { TAILWINDCSS_DEFAULT_FILES, baseRules, defineConfig, sonarjsRules, sonarjsTestRules, tailwindcssConfigs, vueRules };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maz-ui/eslint-config",
   "type": "module",
-  "version": "4.9.1",
+  "version": "5.0.0-beta.1",
   "description": "ESLint configuration for JavaScript/TypeScript projects",
   "author": "Louis Mazel <me@loicmazuel.com>",
   "license": "MIT",
@@ -43,14 +43,14 @@
   },
   "dependencies": {
     "@antfu/eslint-config": "^8.2.0",
+    "consola": "^3.4.2",
+    "eslint-plugin-better-tailwindcss": "^4.5.0",
     "eslint-plugin-format": "^2.0.1",
-    "eslint-plugin-sonarjs": "^4.0.2",
-    "eslint-plugin-tailwindcss": "^3.18.3",
+    "eslint-plugin-sonarjs": "^4.0.3",
     "eslint-plugin-vuejs-accessibility": "^2.5.0"
   },
   "devDependencies": {
-    "@types/eslint-plugin-tailwindcss": "^3.17.0",
-    "eslint": "^10.1.0",
+    "eslint": "^10.3.0",
     "unbuild": "^3.6.1"
   },
   "lint-staged": {
@@ -59,6 +59,7 @@
     ]
   },
   "scripts": {
+    "codegen": "nx build",
     "build": "unbuild",
     "dev": "unbuild --stub",
     "typecheck": "tsc --noEmit --skipLibCheck",