eslint-plugin-import-next 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Documentation
+
+- 📘 Launched new documentation site: [eslint.interlace.tools](https://eslint.interlace.tools/)
+
 ## [2.0.0] - 2025-12-30
 
 ### Changed

package/README.md

@@ -1,256 +1,47 @@
-# eslint-plugin-import-next
+<p align="center">
+  <a href="https://eslint.interlace.tools" target="blank"><img src="https://eslint.interlace.tools/eslint-interlace-logo-light.svg" alt="ESLint Interlace Logo" width="120" /></a>
+</p>
 
-> 🔥 **Drop-in replacement for `eslint-plugin-import`.** 100% backwards compatible, 100x faster, zero false positives, AI-optimized fixes.
+<p align="center">
+  Next-generation import sorting, validation, and architectural boundaries.
+</p>
 
-[![npm version](https://img.shields.io/npm/v/eslint-plugin-import-next.svg)](https://www.npmjs.com/package/eslint-plugin-import-next)
-[![npm downloads](https://img.shields.io/npm/dm/eslint-plugin-import-next.svg)](https://www.npmjs.com/package/eslint-plugin-import-next)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![codecov](https://codecov.io/gh/ofri-peretz/eslint/graph/badge.svg?component=import_next)](https://app.codecov.io/gh/ofri-peretz/eslint/components?components%5B0%5D=import_next)
-[![Dec 2025](https://img.shields.io/badge/Dec_2025-blue?logo=rocket&logoColor=white)](https://github.com/ofri-peretz/eslint)
+<p align="center">
+  <a href="https://www.npmjs.com/package/eslint-plugin-import-next" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-import-next.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/eslint-plugin-import-next" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-import-next.svg" alt="NPM Downloads" /></a>
+  <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
+  <a href="https://app.codecov.io/gh/ofri-peretz/eslint/components?components%5B0%5D=import-next" target="_blank"><img src="https://codecov.io/gh/ofri-peretz/eslint/graph/badge.svg?component=import-next" alt="Codecov" /></a>
+  <a href="https://github.com/ofri-peretz/eslint" target="_blank"><img src="https://img.shields.io/badge/Since-Dec_2025-blue?logo=rocket&logoColor=white" alt="Since Dec 2025" /></a>
+</p>
 
----
-
-## 💡 What you get
-
-- **100x faster cycle detection** - Incremental caching means re-runs are near-instant
-- **Zero false positives** - Tested against real-world monorepos with zero noise
-- **LLM-optimized messages** - Structured errors with CWE + OWASP + specific fix guidance
-- **Unlimited `maxDepth`** - No artificial limits on cycle detection depth
-- **ESLint 9 native** - First-class flat config support
-- **TypeScript ready** - Works out of the box, no extra resolver config
-
----
-
-## 🚀 Migrate from `eslint-plugin-import` in 60 Seconds
-
-**Step 1: Install**
-
-```bash
-npm uninstall eslint-plugin-import
-npm install --save-dev eslint-plugin-import-next
-```
-
-**Step 2: Find & Replace in your ESLint config**
-
-```diff
-- import importPlugin from 'eslint-plugin-import';
-+ import importPlugin from 'eslint-plugin-import-next';
-```
-
-```diff
-- 'import/no-cycle': 'error',
-+ 'import-next/no-cycle': 'error',
-```
-
-**That's it.** All rule names are identical. All options are compatible. Your existing configuration works out of the box.
-
----
-
-## 🎯 The `no-cycle` Problem (Why This Plugin Exists)
-
-### The `maxDepth` Limitation in `eslint-plugin-import`
-
-The original `eslint-plugin-import` has a critical limitation: the `maxDepth` option defaults to `Infinity` in theory, but **in practice, many projects are forced to set `maxDepth: 1` or `maxDepth: 2`** because:
-
-```javascript
-// eslint.config.js - Common workaround in legacy projects
-{
-  rules: {
-    // ❌ PROBLEM: Had to limit maxDepth due to performance
-    'import/no-cycle': ['error', { maxDepth: 1 }]
-  }
-}
-```
-
-**Why this happens:**
-
-1. **Performance** - Full graph analysis on every lint run (no caching)
-2. **Memory** - Large codebases exhaust memory with deep traversal
-3. **Timeout** - CI/CD pipelines timeout on large monorepos
-
-**The consequence:** Cycles at depth 3+ go undetected, causing:
-
-### Real-World Impact on Bundlers
-
-| Bundler     | Symptom                                                   | Cause                          |
-| ----------- | --------------------------------------------------------- | ------------------------------ |
-| **Vite**    | `ReferenceError: Cannot access 'X' before initialization` | Circular import race condition |
-| **Next.js** | Build hangs, OOM errors                                   | Infinite resolution loop       |
-| **Webpack** | Incorrect tree-shaking, larger bundles                    | Dependency graph confusion     |
-| **esbuild** | Silent failures in production                             | Module order ambiguity         |
-
-### Example: Hidden Deep Cycle
+## Description
 
-```
-// With maxDepth: 2, this cycle is UNDETECTED:
-
-src/
-├── features/
-│   └── auth/
-│       └── AuthProvider.tsx
-│           └── imports useUser from →
-│               src/hooks/useUser.ts
-│                   └── imports fetchUser from →
-│                       src/api/user.ts
-│                           └── imports authConfig from →
-│                               src/config/auth.ts
-│                                   └── imports AuthProvider from → (CYCLE at depth 4!)
-│                                       src/features/auth/AuthProvider.tsx
-```
-
-**With `import/no-cycle` maxDepth: 2** → ❌ Not detected  
-**With `import-next/no-cycle`** → ✅ Detected instantly (cached)
-
----
-
-## ⚡ Performance: The `no-cycle` Benchmark
-
-| Scenario                    | `eslint-plugin-import` | `eslint-plugin-import-next` |
-| --------------------------- | ---------------------- | --------------------------- |
-| **First run (10k files)**   | ~45s                   | ~45s                        |
-| **Subsequent runs**         | ~45s (re-analyzes)     | **~0.4s** (cached)          |
-| **Memory (large monorepo)** | 2-4 GB                 | ~500 MB                     |
-| **maxDepth: Infinity**      | Often crashes          | ✅ Works                    |
-
-### How It Works
+This plugin represents the next evolution of import validation, offering advanced features like granular import sorting and strictly enforced architectural boundaries. It is designed to modernize your development workflow by providing tools that prevent circular dependencies and enforce clean module structures. By integrating these rules, you can maintain a scalable and organized codebase that is easy to navigate and refactor.
 
-```typescript
-// Incremental file-system cache
-// Only re-analyzes files that changed
-import { clearCircularDependencyCache } from 'eslint-plugin-import-next';
+## Philosophy
 
-// Clear cache on demand (e.g., for CI fresh runs)
-clearCircularDependencyCache();
-```
-
----
-
-## 🔄 Full Compatibility Matrix
-
-Every rule from `eslint-plugin-import` is implemented with **the same name** and **compatible options**:
-
-### ✅ Static Analysis (13 rules)
-
-| Rule                         | Description                       | 💼  | 🔧  | 💡  |
-| ---------------------------- | --------------------------------- | :-: | :-: | :-: |
-| `no-unresolved`              | Ensure imports resolve            | 💼  |     | 💡  |
-| `named`                      | Ensure named imports exist        | 💼  |     |     |
-| `default`                    | Ensure default export exists      | 💼  |     |     |
-| `namespace`                  | Ensure namespace properties exist | 💼  |     |     |
-| `no-absolute-path`           | Forbid absolute paths             |     | 🔧  |     |
-| `no-dynamic-require`         | Forbid dynamic require()          |     |     |     |
-| `no-internal-modules`        | Enforce entry points only         |     |     | 💡  |
-| `no-relative-packages`       | Use package names                 |     | 🔧  |     |
-| `no-relative-parent-imports` | Prevent `../` imports             |     |     |     |
-| `no-self-import`             | Prevent self-imports              | 💼  |     | 💡  |
-| `no-cycle`                   | **100x faster** cycle detection   | 💼  |     | 💡  |
-| `no-useless-path-segments`   | Simplify paths                    |     | 🔧  |     |
-| `no-restricted-paths`        | Custom path restrictions          |     |     |     |
-
-### ✅ Helpful Warnings (8 rules)
-
-| Rule                         | Description                   | 💼  | 🔧  | 💡  |
-| ---------------------------- | ----------------------------- | :-: | :-: | :-: |
-| `export`                     | Forbid duplicate exports      | 💼  |     |     |
-| `no-deprecated`              | Warn on `@deprecated` imports |     |     |     |
-| `no-empty-named-blocks`      | Forbid empty `{}` imports     |     | 🔧  | 💡  |
-| `no-extraneous-dependencies` | Prevent unlisted deps         | 💼  |     | 💡  |
-| `no-mutable-exports`         | Forbid `let`/`var` exports    |     |     |     |
-| `no-named-as-default`        | Warn on default shadowing     | 💼  |     |     |
-| `no-named-as-default-member` | Warn on property access       | 💼  |     |     |
-| `no-unused-modules`          | Find dead code                |     |     | 💡  |
-
-### ✅ Module Systems (5 rules)
-
-| Rule                       | Description               | 💼  | 🔧  | 💡  |
-| -------------------------- | ------------------------- | :-: | :-: | :-: |
-| `no-amd`                   | Forbid AMD require/define |     |     |     |
-| `no-commonjs`              | Forbid CommonJS           |     |     |     |
-| `no-nodejs-modules`        | Forbid Node.js builtins   |     |     |     |
-| `no-import-module-exports` | No mixed ES/CJS           |     |     |     |
-| `unambiguous`              | Warn on ambiguous modules |     |     |     |
-
-### ✅ Style Guide (17 rules)
-
-| Rule                              | Description                       | 💼  | 🔧  | 💡  |
-| --------------------------------- | --------------------------------- | :-: | :-: | :-: |
-| `consistent-type-specifier-style` | Type import style                 |     | 🔧  |     |
-| `dynamic-import-chunkname`        | Require webpack chunk names       |     |     | 💡  |
-| `exports-last`                    | Exports at end of file            |     |     |     |
-| `extensions`                      | Enforce file extension usage      |     |     |     |
-| `first`                           | Imports must be first             |     | 🔧  |     |
-| `group-exports`                   | Group exports together            |     |     |     |
-| `max-dependencies`                | Limit module dependencies         |     |     |     |
-| `newline-after-import`            | Newline after imports             |     | 🔧  |     |
-| `no-anonymous-default-export`     | Require named default exports     |     |     |     |
-| `no-default-export`               | Forbid default exports            |     |     | 💡  |
-| `no-duplicates`                   | Merge duplicate imports           | 💼  | 🔧  |     |
-| `no-named-default`                | Use default import syntax         |     |     |     |
-| `no-named-export`                 | Forbid named exports              |     |     |     |
-| `no-namespace`                    | Forbid `* as` imports             |     |     |     |
-| `no-unassigned-import`            | Forbid side-effect imports        |     |     |     |
-| `order`                           | Sort and group imports            | 💼  | 🔧  |     |
-| `prefer-default-export`           | Prefer default for single exports |     |     |     |
-
-### 🆕 Exclusive to `import-next` (3 rules)
-
-| Rule                           | Description                                         |
-| ------------------------------ | --------------------------------------------------- |
-| `no-cross-domain-imports`      | Enforce clean architecture boundaries               |
-| `enforce-dependency-direction` | Enforce layered architecture (UI → Services → Data) |
-| `prefer-node-protocol`         | Prefer `node:fs` over `fs`                          |
+**Interlace** fosters **strength through integration**. Instead of stacking isolated rules, we **interlace** security directly into your workflow to create a resilient fabric of code. We believe tools should **guide rather than gatekeep**, providing educational feedback that strengthens the developer with every interaction.
 
----
+## Getting Started
 
-## 📦 Installation
+- To check out the [guide](https://eslint.interlace.tools/docs/import-next), visit [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- 要查看中文 [指南](https://eslint.interlace.tools/docs/import-next), 请访问 [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- [가이드](https://eslint.interlace.tools/docs/import-next) 문서는 [eslint.interlace.tools](https://eslint.interlace.tools)에서 확인하실 수 있습니다. 📚
+- [ガイド](https://eslint.interlace.tools/docs/import-next)は [eslint.interlace.tools](https://eslint.interlace.tools)でご確認ください。 📚
+- Para ver la [guía](https://eslint.interlace.tools/docs/import-next), visita [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+- للاطلاع على [الدليل](https://eslint.interlace.tools/docs/import-next)، قم بزيارة [eslint.interlace.tools](https://eslint.interlace.tools). 📚
 
 ```bash
-npm install --save-dev eslint-plugin-import-next
-# or
-pnpm add -D eslint-plugin-import-next
-```
-
-## 🚀 Quick Start (Flat Config)
-
-```javascript
-// eslint.config.js
-import importNext from 'eslint-plugin-import-next';
-
-export default [
-  // Use recommended preset (most common rules)
-  importNext.configs.recommended,
-
-  // Or customize individual rules
-  {
-    plugins: { 'import-next': importNext },
-    rules: {
-      'import-next/no-cycle': 'error', // No maxDepth needed!
-      'import-next/no-duplicates': 'error',
-      'import-next/order': 'warn',
-    },
-  },
-];
+npm install eslint-plugin-import-next --save-dev
 ```
 
----
-
-## � Available Presets
-
-| Preset              | Description                                  |
-| ------------------- | -------------------------------------------- |
-| `recommended`       | Essential rules for most projects            |
-| `strict`            | All rules enabled as errors                  |
-| `typescript`        | Optimized for TypeScript projects            |
-| `module-resolution` | Focus on import resolution                   |
-| `import-style`      | Focus on import formatting                   |
-| `esm`               | Enforce ES Modules only                      |
-| `architecture`      | Clean architecture boundaries                |
-| `errors`            | Matches eslint-plugin-import errors preset   |
-| `warnings`          | Matches eslint-plugin-import warnings preset |
+## AI-Optimized Messages
 
----
+This plugin is optimized for ESLint's [Model Context Protocol (MCP)](https://eslint.org/docs/latest/use/mcp), enabling AI assistants like **Cursor**, **GitHub Copilot**, and **Claude** to:
 
-## 🤖 Smart Fixes (LLM-Optimized)
+- Understand the exact vulnerability type via CWE references
+- Apply the correct fix using structured guidance
+- Provide educational context to developers
 
 Unlike legacy plugins, we analyze the _type_ of issue and suggest the correct fix:
 
@@ -272,13 +63,8 @@ Unlike legacy plugins, we analyze the _type_ of issue and suggest the correct fi
    Fix: Introduce an abstraction layer between A and G
 ```
 
----
-
-## 🤖 LLM & MCP Integration
-
-Optimized for **Cursor**, **GitHub Copilot**, and other AI coding tools:
-
 ```json
+// .cursor/mcp.json
 {
   "mcpServers": {
     "eslint": {
@@ -289,26 +75,123 @@ Optimized for **Cursor**, **GitHub Copilot**, and other AI coding tools:
 }
 ```
 
+By providing this structured context (CWE, OWASP, Fix), we enable AI tools to **reason** about the security flaw rather than hallucinating. This allows Copilot/Cursor to suggest the _exact_ correct fix immediately.
+
 ---
 
-## 🔗 Related Packages
+## Rules
+
+**Legend**
+
+| Icon | Description                                                        |
+| :--: | :----------------------------------------------------------------- |
+|  💼  | **Recommended**: Included in the recommended preset.               |
+|  ⚠️  | **Warns**: Set to warn in recommended preset.                      |
+|  🔧  | **Auto-fixable**: Automatically fixable by the `--fix` CLI option. |
+|  💡  | **Suggestions**: Providing code suggestions in IDE.                |
+|  🚫  | **Deprecated**: This rule is deprecated.                           |
+
+| Rule                                                                                                                       | Pattern/Concept  | Description                                         | 💼  | ⚠️  | 🔧  | 💡  | 🚫  |
+| :------------------------------------------------------------------------------------------------------------------------- | :--------------- | :-------------------------------------------------- | :-: | :-: | :-: | :-: | :-: |
+| [`no-unresolved`](https://eslint.interlace.tools/docs/import-next/rules/no-unresolved)                                     | Static Analysis  | Ensure imports resolve                              | 💼  |     |     | 💡  |     |
+| [`named`](https://eslint.interlace.tools/docs/import-next/rules/named)                                                     | Static Analysis  | Ensure named imports exist                          | 💼  |     |     |     |     |
+| [`default`](https://eslint.interlace.tools/docs/import-next/rules/default)                                                 | Static Analysis  | Ensure default export exists                        | 💼  |     |     |     |     |
+| [`namespace`](https://eslint.interlace.tools/docs/import-next/rules/namespace)                                             | Static Analysis  | Ensure namespace properties exist                   | 💼  |     |     |     |     |
+| [`no-absolute-path`](https://eslint.interlace.tools/docs/import-next/rules/no-absolute-path)                               | Static Analysis  | Forbid absolute paths                               |     |     | 🔧  |     |     |
+| [`no-dynamic-require`](https://eslint.interlace.tools/docs/import-next/rules/no-dynamic-require)                           | Static Analysis  | Forbid dynamic require()                            |     |     |     |     |     |
+| [`no-internal-modules`](https://eslint.interlace.tools/docs/import-next/rules/no-internal-modules)                         | Static Analysis  | Enforce entry points only                           |     |     |     | 💡  |     |
+| [`no-relative-packages`](https://eslint.interlace.tools/docs/import-next/rules/no-relative-packages)                       | Static Analysis  | Use package names                                   |     |     | 🔧  |     |     |
+| [`no-relative-parent-imports`](https://eslint.interlace.tools/docs/import-next/rules/no-relative-parent-imports)           | Static Analysis  | Prevent `../` imports                               |     |     |     |     |     |
+| [`no-self-import`](https://eslint.interlace.tools/docs/import-next/rules/no-self-import)                                   | Static Analysis  | Prevent self-imports                                | 💼  |     |     | 💡  |     |
+| [`no-cycle`](https://eslint.interlace.tools/docs/import-next/rules/no-cycle)                                               | Static Analysis  | **100x faster** cycle detection                     | 💼  |     |     | 💡  |     |
+| [`no-useless-path-segments`](https://eslint.interlace.tools/docs/import-next/rules/no-useless-path-segments)               | Static Analysis  | Simplify paths                                      |     |     | 🔧  |     |     |
+| [`no-restricted-paths`](https://eslint.interlace.tools/docs/import-next/rules/no-restricted-paths)                         | Static Analysis  | Custom path restrictions                            |     |     |     |     |     |
+| [`export`](https://eslint.interlace.tools/docs/import-next/rules/export)                                                   | Helpful Warnings | Forbid duplicate exports                            | 💼  |     |     |     |     |
+| [`no-deprecated`](https://eslint.interlace.tools/docs/import-next/rules/no-deprecated)                                     | Helpful Warnings | Warn on `@deprecated` imports                       |     |     |     |     |     |
+| [`no-empty-named-blocks`](https://eslint.interlace.tools/docs/import-next/rules/no-empty-named-blocks)                     | Helpful Warnings | Forbid empty `{}` imports                           |     |     | 🔧  | 💡  |     |
+| [`no-extraneous-dependencies`](https://eslint.interlace.tools/docs/import-next/rules/no-extraneous-dependencies)           | Helpful Warnings | Prevent unlisted deps                               | 💼  |     |     | 💡  |     |
+| [`no-mutable-exports`](https://eslint.interlace.tools/docs/import-next/rules/no-mutable-exports)                           | Helpful Warnings | Forbid `let`/`var` exports                          |     |     |     |     |     |
+| [`no-named-as-default`](https://eslint.interlace.tools/docs/import-next/rules/no-named-as-default)                         | Helpful Warnings | Warn on default shadowing                           | 💼  |     |     |     |     |
+| [`no-named-as-default-member`](https://eslint.interlace.tools/docs/import-next/rules/no-named-as-default-member)           | Helpful Warnings | Warn on property access                             | 💼  |     |     |     |     |
+| [`no-unused-modules`](https://eslint.interlace.tools/docs/import-next/rules/no-unused-modules)                             | Helpful Warnings | Find dead code                                      |     |     |     | 💡  |     |
+| [`no-amd`](https://eslint.interlace.tools/docs/import-next/rules/no-amd)                                                   | Module Systems   | Forbid AMD require/define                           |     |     |     |     |     |
+| [`no-commonjs`](https://eslint.interlace.tools/docs/import-next/rules/no-commonjs)                                         | Module Systems   | Forbid CommonJS                                     |     |     |     |     |     |
+| [`no-nodejs-modules`](https://eslint.interlace.tools/docs/import-next/rules/no-nodejs-modules)                             | Module Systems   | Forbid Node.js builtins                             |     |     |     |     |     |
+| [`no-import-module-exports`](https://eslint.interlace.tools/docs/import-next/rules/no-import-module-exports)               | Module Systems   | No mixed ES/CJS                                     |     |     |     |     |     |
+| [`unambiguous`](https://eslint.interlace.tools/docs/import-next/rules/unambiguous)                                         | Module Systems   | Warn on ambiguous modules                           |     |     |     |     |     |
+| [`consistent-type-specifier-style`](https://eslint.interlace.tools/docs/import-next/rules/consistent-type-specifier-style) | Style Guide      | Type import style                                   |     |     | 🔧  |     |     |
+| [`dynamic-import-chunkname`](https://eslint.interlace.tools/docs/import-next/rules/dynamic-import-chunkname)               | Style Guide      | Require webpack chunk names                         |     |     |     | 💡  |     |
+| [`exports-last`](https://eslint.interlace.tools/docs/import-next/rules/exports-last)                                       | Style Guide      | Exports at end of file                              |     |     |     |     |     |
+| [`extensions`](https://eslint.interlace.tools/docs/import-next/rules/extensions)                                           | Style Guide      | Enforce file extension usage                        |     |     |     |     |     |
+| [`first`](https://eslint.interlace.tools/docs/import-next/rules/first)                                                     | Style Guide      | Imports must be first                               |     |     | 🔧  |     |     |
+| [`group-exports`](https://eslint.interlace.tools/docs/import-next/rules/group-exports)                                     | Style Guide      | Group exports together                              |     |     |     |     |     |
+| [`max-dependencies`](https://eslint.interlace.tools/docs/import-next/rules/max-dependencies)                               | Style Guide      | Limit module dependencies                           |     |     |     |     |     |
+| [`newline-after-import`](https://eslint.interlace.tools/docs/import-next/rules/newline-after-import)                       | Style Guide      | Newline after imports                               |     |     | 🔧  |     |     |
+| [`no-anonymous-default-export`](https://eslint.interlace.tools/docs/import-next/rules/no-anonymous-default-export)         | Style Guide      | Require named default exports                       |     |     |     |     |     |
+| [`no-default-export`](https://eslint.interlace.tools/docs/import-next/rules/no-default-export)                             | Style Guide      | Forbid default exports                              |     |     |     | 💡  |     |
+| [`no-duplicates`](https://eslint.interlace.tools/docs/import-next/rules/no-duplicates)                                     | Style Guide      | Merge duplicate imports                             | 💼  |     | 🔧  |     |     |
+| [`no-named-default`](https://eslint.interlace.tools/docs/import-next/rules/no-named-default)                               | Style Guide      | Use default import syntax                           |     |     |     |     |     |
+| [`no-named-export`](https://eslint.interlace.tools/docs/import-next/rules/no-named-export)                                 | Style Guide      | Forbid named exports                                |     |     |     |     |     |
+| [`no-namespace`](https://eslint.interlace.tools/docs/import-next/rules/no-namespace)                                       | Style Guide      | Forbid `* as` imports                               |     |     |     |     |     |
+| [`no-unassigned-import`](https://eslint.interlace.tools/docs/import-next/rules/no-unassigned-import)                       | Style Guide      | Forbid side-effect imports                          |     |     |     |     |     |
+| [`order`](https://eslint.interlace.tools/docs/import-next/rules/order)                                                     | Style Guide      | Sort and group imports                              | 💼  |     | 🔧  |     |     |
+| [`prefer-default-export`](https://eslint.interlace.tools/docs/import-next/rules/prefer-default-export)                     | Style Guide      | Prefer default for single exports                   |     |     |     |     |     |
+| [`no-cross-domain-imports`](https://eslint.interlace.tools/docs/import-next/rules/no-cross-domain-imports)                 | Architecture     | Enforce clean architecture boundaries               |     |     |     |     |     |
+| [`enforce-dependency-direction`](https://eslint.interlace.tools/docs/import-next/rules/enforce-dependency-direction)       | Architecture     | Enforce layered architecture (UI → Services → Data) |     |     |     |     |     |
+| [`prefer-node-protocol`](https://eslint.interlace.tools/docs/import-next/rules/prefer-node-protocol)                       | Architecture     | Prefer `node:fs` over `fs`                          |     |     |     |     |     |
+| [`no-barrel-file`](https://eslint.interlace.tools/docs/import-next/rules/no-barrel-file)                                   | Architecture     | Detect barrel files that harm build performance     |     |     |     |     |     |
+| [`no-barrel-import`](https://eslint.interlace.tools/docs/import-next/rules/no-barrel-import)                               | Architecture     | Flag imports from barrel files                      |     |     |     |     |     |
+| [`prefer-tree-shakeable-imports`](https://eslint.interlace.tools/docs/import-next/rules/prefer-tree-shakeable-imports)     | Architecture     | Enforce tree-shakeable import patterns              |     |     |     |     |     |
+| [`prefer-direct-import`](https://eslint.interlace.tools/docs/import-next/rules/prefer-direct-import)                       | Architecture     | Suggest direct imports with autofix                 |     |     |     |     |     |
+| [`no-full-package-import`](https://eslint.interlace.tools/docs/import-next/rules/no-full-package-import)                   | Architecture     | Block full imports from large packages              |     |     |     |     |     |
+| [`enforce-team-boundaries`](https://eslint.interlace.tools/docs/import-next/rules/enforce-team-boundaries)                 | Architecture     | Prevent unauthorized cross-team imports             |     |     |     |     |     |
+| [`no-legacy-imports`](https://eslint.interlace.tools/docs/import-next/rules/no-legacy-imports)                             | Architecture     | Detect deprecated imports with autofix              |     |     |     |     |     |
+
+## 🔄 Compatibility Matrix
+
+| Rule      | Original Plugin                                                                                                                                                                                                    | Status       | Notes                    |
+| :-------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------- | :----------------------- |
+| All Rules | [`eslint-plugin-import`](https://www.npmjs.com/package/eslint-plugin-import) [![npm](https://img.shields.io/npm/v/eslint-plugin-import.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-import) | ✅ Supported | Full drop-in replacement |
 
-Part of the **Interlace ESLint Ecosystem** — AI-native security plugins with LLM-optimized error messages:
+---
 
-| Plugin                                                                                               |                                                                Downloads                                                                 | Description                                                  | Rules |
-| ---------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------ | :---: |
-| [`eslint-plugin-secure-coding`](https://www.npmjs.com/package/eslint-plugin-secure-coding)           |      [![npm](https://img.shields.io/npm/dm/eslint-plugin-secure-coding.svg)](https://npmjs.com/package/eslint-plugin-secure-coding)      | Universal security (OWASP Top 10 Web + Mobile)               |  89   |
-| [`eslint-plugin-jwt`](https://www.npmjs.com/package/eslint-plugin-jwt)                               |                [![npm](https://img.shields.io/npm/dm/eslint-plugin-jwt.svg)](https://npmjs.com/package/eslint-plugin-jwt)                | JWT security (algorithm confusion, weak secrets, claims)     |  13   |
-| [`eslint-plugin-crypto`](https://www.npmjs.com/package/eslint-plugin-crypto)                         |             [![npm](https://img.shields.io/npm/dm/eslint-plugin-crypto.svg)](https://npmjs.com/package/eslint-plugin-crypto)             | Cryptographic best practices (weak algorithms, key handling) |  24   |
-| [`eslint-plugin-pg`](https://www.npmjs.com/package/eslint-plugin-pg)                                 |                 [![npm](https://img.shields.io/npm/dm/eslint-plugin-pg.svg)](https://npmjs.com/package/eslint-plugin-pg)                 | PostgreSQL/node-postgres security                            |  13   |
-| [`eslint-plugin-express-security`](https://www.npmjs.com/package/eslint-plugin-express-security)     |   [![npm](https://img.shields.io/npm/dm/eslint-plugin-express-security.svg)](https://npmjs.com/package/eslint-plugin-express-security)   | Express.js security (CORS, cookies, CSRF, helmet)            |   8   |
-| [`eslint-plugin-nestjs-security`](https://www.npmjs.com/package/eslint-plugin-nestjs-security)       |    [![npm](https://img.shields.io/npm/dm/eslint-plugin-nestjs-security.svg)](https://npmjs.com/package/eslint-plugin-nestjs-security)    | NestJS security (guards, validation pipes, throttler)        |   5   |
-| [`eslint-plugin-lambda-security`](https://www.npmjs.com/package/eslint-plugin-lambda-security)       |    [![npm](https://img.shields.io/npm/dm/eslint-plugin-lambda-security.svg)](https://npmjs.com/package/eslint-plugin-lambda-security)    | AWS Lambda/Middy security (API Gateway, CORS, secrets)       |   5   |
-| [`eslint-plugin-browser-security`](https://www.npmjs.com/package/eslint-plugin-browser-security)     |   [![npm](https://img.shields.io/npm/dm/eslint-plugin-browser-security.svg)](https://npmjs.com/package/eslint-plugin-browser-security)   | Browser security (XSS, postMessage, storage, cookies)        |  21   |
-| [`eslint-plugin-vercel-ai-security`](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | [![npm](https://img.shields.io/npm/dm/eslint-plugin-vercel-ai-security.svg)](https://npmjs.com/package/eslint-plugin-vercel-ai-security) | Vercel AI SDK security (OWASP LLM + Agentic Top 10)          |  19   |
+## ⚙️ Configuration Presets
 
----
+| Preset              | Description                                      |
+| :------------------ | :----------------------------------------------- |
+| `recommended`       | Warns on import order issues                     |
+| `strict`            | All rules set to error for production-ready code |
+| `typescript`        | Optimized for TypeScript projects                |
+| `module-resolution` | Focus on import resolution                       |
+| `import-style`      | Focus on import formatting                       |
+| `esm`               | Enforce ES Modules only                          |
+| `architecture`      | Clean architecture boundaries                    |
+| `performance`       | Bundle optimization (barrel detection)           |
+| `enterprise`        | Team boundaries & legacy import tracking         |
+| `errors`            | Matches eslint-plugin-import errors preset       |
+| `warnings`          | Matches eslint-plugin-import warnings preset     |
+
+## 🔗 Related ESLint Plugins
+
+Part of the **Interlace ESLint Ecosystem** — AI-native security plugins with LLM-optimized error messages:
+
+| Plugin                                                                                               |                                                                              Downloads                                                                               | Description                                 |
+| :--------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------ |
+| [`eslint-plugin-secure-coding`](https://www.npmjs.com/package/eslint-plugin-secure-coding)           |      [![downloads](https://img.shields.io/npm/dt/eslint-plugin-secure-coding.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-secure-coding)      | General security rules & OWASP guidelines.  |
+| [`eslint-plugin-pg`](https://www.npmjs.com/package/eslint-plugin-pg)                                 |                 [![downloads](https://img.shields.io/npm/dt/eslint-plugin-pg.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-pg)                 | PostgreSQL security & best practices.       |
+| [`eslint-plugin-crypto`](https://www.npmjs.com/package/eslint-plugin-crypto)                         |             [![downloads](https://img.shields.io/npm/dt/eslint-plugin-crypto.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-crypto)             | NodeJS Cryptography security rules.         |
+| [`eslint-plugin-jwt`](https://www.npmjs.com/package/eslint-plugin-jwt)                               |                [![downloads](https://img.shields.io/npm/dt/eslint-plugin-jwt.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-jwt)                | JWT security & best practices.              |
+| [`eslint-plugin-browser-security`](https://www.npmjs.com/package/eslint-plugin-browser-security)     |   [![downloads](https://img.shields.io/npm/dt/eslint-plugin-browser-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-browser-security)   | Browser-specific security & XSS prevention. |
+| [`eslint-plugin-vercel-ai-security`](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | [![downloads](https://img.shields.io/npm/dt/eslint-plugin-vercel-ai-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | Vercel AI SDK security rules.               |
+| [`eslint-plugin-express-security`](https://www.npmjs.com/package/eslint-plugin-express-security)     |   [![downloads](https://img.shields.io/npm/dt/eslint-plugin-express-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-express-security)   | Express.js security hardening rules.        |
+| [`eslint-plugin-lambda-security`](https://www.npmjs.com/package/eslint-plugin-lambda-security)       |    [![downloads](https://img.shields.io/npm/dt/eslint-plugin-lambda-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-lambda-security)    | AWS Lambda security best practices.         |
+| [`eslint-plugin-nestjs-security`](https://www.npmjs.com/package/eslint-plugin-nestjs-security)       |    [![downloads](https://img.shields.io/npm/dt/eslint-plugin-nestjs-security.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-nestjs-security)    | NestJS security rules & patterns.           |
+| [`eslint-plugin-import-next`](https://www.npmjs.com/package/eslint-plugin-import-next)               |        [![downloads](https://img.shields.io/npm/dt/eslint-plugin-import-next.svg?style=flat-square)](https://www.npmjs.com/package/eslint-plugin-import-next)        | Next-gen import sorting & architecture.     |
 
 ## 📄 License
 
 MIT © [Ofri Peretz](https://github.com/ofri-peretz)
+
+<p align="center">
+  <a href="https://eslint.interlace.tools/docs/import-next"><img src="https://eslint.interlace.tools/images/og-import-next.png" alt="ESLint Interlace Plugin" width="300" /></a>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-import-next",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Drop-in replacement for eslint-plugin-import. 100x faster no-cycle detection, AI-optimized fixes, zero config migration.",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/files/foo.d.ts

@@ -1,2 +1,7 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
 export default function foo(): string;
 export declare const bar = "baz";

package/src/files/foo.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bar = void 0;
 exports.default = foo;

package/src/files/no-default.d.ts

@@ -1 +1,6 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
 export declare const foo = "bar";

package/src/files/no-default.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.foo = void 0;
 exports.foo = 'bar';