eslint-config-axkit 1.2.0 → 1.3.0

package/README.md

@@ -83,14 +83,17 @@ export default [
 
 ## Options
 
-| Option          | Type     | Description                                                                |
-| --------------- | -------- | -------------------------------------------------------------------------- |
-| `gitignorePath` | `string` | Path to `.gitignore` file. Patterns will be added to ESLint's ignore list. |
+| Option          | Type      | Description                                                                                                                                                                                                                               |
+| --------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gitignorePath` | `string`  | Path to `.gitignore` file. Patterns will be added to ESLint's ignore list.                                                                                                                                                                |
+| `nextjs`        | `boolean` | Enable Next.js rules (`eslint-config-next` core-web-vitals + typescript). Requires `eslint-config-next` to be installed.                                                                                                                  |
+| `storybook`     | `boolean` | Enable Storybook rules (`eslint-plugin-storybook` flat/recommended). Requires `eslint-plugin-storybook` to be installed.                                                                                                                  |
+| `tailwindcss`   | `string`  | Path to the Tailwind CSS entry point (e.g. `"src/app/globals.css"`). Enables `eslint-plugin-better-tailwindcss` recommended rules enforcing stylistic and correctness rules. Requires `eslint-plugin-better-tailwindcss` to be installed. |
 
 ## Requirements
 
 - Node.js >= 22.14.0
-- ESLint >= 9
+- ESLint >= 10
 
 ## License
 

package/dist/import-optional.js

@@ -8,6 +8,11 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
+const consumerRequire = createRequire(`${process.cwd()}/`);
+async function dynamicImport(resolvedPath) {
+    const imported = (await import(__rewriteRelativeImportExtension(pathToFileURL(resolvedPath).href)));
+    return imported["default"] ?? imported;
+}
 /**
  * Dynamically import an optional dependency from the consumer's project.
  *
@@ -17,14 +22,12 @@ import { pathToFileURL } from "node:url";
  * are accessible.
  */
 export async function importOptional(name) {
-    const require = createRequire(`${process.cwd()}/`);
     let resolvedPath;
     try {
-        resolvedPath = require.resolve(name);
+        resolvedPath = consumerRequire.resolve(name);
     }
     catch {
         throw new Error(`eslint-config-axkit: "${name}" must be installed to use this option. Run: pnpm add -D ${name}`);
     }
-    const imported = (await import(__rewriteRelativeImportExtension(pathToFileURL(resolvedPath).href)));
-    return imported["default"] ?? imported;
+    return dynamicImport(resolvedPath);
 }

package/dist/index.d.ts

@@ -16,6 +16,13 @@ export type Options = {
      * Requires `eslint-plugin-storybook` to be installed.
      */
     storybook?: boolean;
+    /**
+     * Path to the Tailwind CSS entry point (e.g. `"src/app/globals.css"`).
+     * Enables eslint-plugin-better-tailwindcss recommended rules and configures
+     * the plugin to resolve project-specific classes, variants, and plugins.
+     * Requires `eslint-plugin-better-tailwindcss` to be installed.
+     */
+    tailwindcss?: string;
 };
 /**
  * Creates a complete ESLint flat config for TypeScript projects.
@@ -30,5 +37,6 @@ export type Options = {
  * Optional:
  * - Next.js rules (core-web-vitals + typescript) via `nextjs: true`
  * - Storybook rules (flat/recommended) via `storybook: true`
+ * - Tailwind CSS rules (better-tailwindcss/recommended) via `tailwindcss: "path/to/entry.css"`
  */
 export declare function axkit(options?: Options): Promise<Linter.Config[]>;

package/dist/index.js

@@ -19,23 +19,17 @@ import { vitestConfig } from "./vitest-config.js";
  * Optional:
  * - Next.js rules (core-web-vitals + typescript) via `nextjs: true`
  * - Storybook rules (flat/recommended) via `storybook: true`
+ * - Tailwind CSS rules (better-tailwindcss/recommended) via `tailwindcss: "path/to/entry.css"`
  */
 export async function axkit(options = {}) {
-    const { gitignorePath, nextjs, storybook } = options;
+    const { gitignorePath, nextjs, storybook, tailwindcss } = options;
     const configs = [];
     // ── Gitignore ──────────────────────────────────────────────────────
     if (gitignorePath) {
         configs.push(includeIgnoreFile(gitignorePath, "Copy patterns from .gitignore"));
     }
     // ── Next.js (before base so axkit's strict rules override) ─────────
-    //
-    // When nextjs is enabled, we must use the consumer's typescript-eslint
-    // instance (resolved from CWD) rather than our own bundled copy.
-    // eslint-config-next registers the @typescript-eslint plugin, and ESLint
-    // forbids redefining a plugin with a different object identity.
-    let tseslintModule = tseslint;
     if (nextjs) {
-        tseslintModule = (await importOptional("typescript-eslint"));
         const [nextVitals, nextTs] = await Promise.all([
             importOptional("eslint-config-next/core-web-vitals"),
             importOptional("eslint-config-next/typescript"),
@@ -43,7 +37,7 @@ export async function axkit(options = {}) {
         configs.push(...nextVitals, ...nextTs);
     }
     // ── Core configs ───────────────────────────────────────────────────
-    configs.push(js.configs.recommended, ...tseslintModule.configs.strictTypeChecked, baseConfig, eslintPluginUnicorn.configs.recommended, 
+    configs.push(js.configs.recommended, ...tseslint.configs.strictTypeChecked, baseConfig, eslintPluginUnicorn.configs.recommended, 
     // Unicorn rules that are off by default
     {
         name: "axkit/unicorn-extras",
@@ -58,13 +52,26 @@ export async function axkit(options = {}) {
     }, {
         name: "axkit/config-files",
         files: ["*.config.{js,ts,mjs,mts}"],
-        ...tseslintModule.configs.disableTypeChecked,
+        ...tseslint.configs.disableTypeChecked,
     }, vitestConfig);
     // ── Storybook (after base, before Prettier) ────────────────────────
     if (storybook) {
         const storybookPlugin = (await importOptional("eslint-plugin-storybook"));
         configs.push(...storybookPlugin.configs["flat/recommended"]);
     }
+    // ── Tailwind CSS (before Prettier) ─────────────────────────────────
+    if (tailwindcss) {
+        const tailwindPlugin = (await importOptional("eslint-plugin-better-tailwindcss"));
+        const tailwindConfig = tailwindPlugin.configs.recommended;
+        configs.push(...(Array.isArray(tailwindConfig) ? tailwindConfig : [tailwindConfig]), {
+            name: "axkit/tailwindcss-entry-point",
+            settings: {
+                "better-tailwindcss": {
+                    entryPoint: tailwindcss,
+                },
+            },
+        });
+    }
     // ── Prettier compatibility (must be last) ──────────────────────────
     configs.push(eslintConfigPrettier);
     return configs;

package/package.json

@@ -2,7 +2,7 @@
   "name": "eslint-config-axkit",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Reusable ESLint flat config for TypeScript + Node.js projects with strict type checking, Prettier, Unicorn, and Vitest",
   "repository": {
     "type": "git",
@@ -60,12 +60,16 @@
   "peerDependencies": {
     "eslint": ">=10",
     "eslint-config-next": ">=16",
+    "eslint-plugin-better-tailwindcss": ">=4",
     "eslint-plugin-storybook": ">=10"
   },
   "peerDependenciesMeta": {
     "eslint-config-next": {
       "optional": true
     },
+    "eslint-plugin-better-tailwindcss": {
+      "optional": true
+    },
     "eslint-plugin-storybook": {
       "optional": true
     }