# import-js/eslint-plugin-import architecture

> Architecture diagram of the GitHub repository import-js/eslint-plugin-import, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/import-js/eslint-plugin-import
- Repository: https://github.com/import-js/eslint-plugin-import

## Overview

eslint-plugin-import is an ESLint plugin for checking JavaScript and TypeScript module imports and exports. ESLint invokes the registered rules on source files; the rules inspect syntax and settings, resolve module paths where needed, and report or autofix violations. Export analysis parses modules into cached maps of exported names and dependencies, enabling checks such as named-export validity, cycles, and unused modules. The README documents broad rule families and legacy/flat configurations; the graph groups those capabilities without enumerating every rule. Unsampled subsystems are represented only where the tree or README supports them; edges cite shown imports or documented product behavior.

Main entry points: [`src/exportMap/builder.js`](https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/builder.js) (Export map builder), [`src/core/importType.js`](https://github.com/import-js/eslint-plugin-import/blob/main/src/core/importType.js) (Import classification), [`src/rules/no-unused-modules.js`](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/no-unused-modules.js) (Unused module analysis), [`src/index.js`](https://github.com/import-js/eslint-plugin-import/blob/main/src/index.js) (Plugin entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin interface"]
  node_plugin_entry["Plugin entry<br/>[index.js]"]
end

subgraph group_analysis["Module analysis"]
  node_export_builder["Export map builder<br/>[builder.js]"]
  node_export_visitor["Export visitor<br/>[visitor.js]"]
  node_export_map["Export map<br/>[index.js]"]
  node_export_context["Analysis context<br/>[childContext.js]"]
  node_file_listing["File enumeration"]
  node_parser["Source parser<br/>[parse.js]"]
  node_module_graph["Cycle analysis<br/>[scc.js]"]
end

subgraph group_rules["Lint rules"]
  node_rule_suite["Import rules"]
  node_unused_analysis["Unused module analysis"]
  node_order_rule["Import ordering<br/>[order.js]"]
  node_dependency_rule["Dependency policy"]
  node_export_rule["Export validation<br/>[export.js]"]
  node_default_rule["Default validation<br/>[default.js]"]
  node_rule_capabilities["Other rule families"]
end

subgraph group_configuration["Configurations"]
  node_configs["Rule presets"]
end

subgraph group_resolution["Module resolution"]
  node_resolver_core["Import classification<br/>[importType.js]"]
  node_node_resolver["Node resolver<br/>[index.js]"]
  node_webpack_resolver["Webpack resolver<br/>[index.js]"]
end

node_eslint(("ESLint"))

node_eslint -->|"loads plugin"| node_plugin_entry
node_plugin_entry -->|"registers rules"| node_rule_suite
node_plugin_entry -->|"exports presets"| node_configs
node_rule_suite -.->|"analyzes exports"| node_export_builder
node_export_builder -->|"builds context"| node_export_context
node_export_builder -->|"parses source"| node_parser
node_export_builder -->|"visits syntax"| node_export_visitor
node_export_visitor -->|"records exports"| node_export_map
node_export_builder -->|"creates map"| node_export_map
node_export_rule -->|"queries map"| node_export_builder
node_default_rule -->|"queries map"| node_export_builder
node_unused_analysis -->|"reads exports"| node_export_builder
node_unused_analysis -->|"lists files"| node_file_listing
node_unused_analysis -.->|"classifies imports"| node_resolver_core
node_resolver_core -->|"resolves paths"| node_node_resolver
node_order_rule -->|"classifies imports"| node_resolver_core
node_dependency_rule -->|"classifies dependencies"| node_resolver_core
node_webpack_resolver -.->|"extends resolution"| node_node_resolver
node_rule_capabilities -.->|"covers rule families"| node_rule_suite
node_module_graph -->|"uses export maps"| node_export_builder

click node_plugin_entry "https://github.com/import-js/eslint-plugin-import/blob/main/src/index.js"
click node_configs "https://github.com/import-js/eslint-plugin-import/tree/main/config"
click node_rule_suite "https://github.com/import-js/eslint-plugin-import/tree/main/src/rules"
click node_export_builder "https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/builder.js"
click node_export_visitor "https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/visitor.js"
click node_export_map "https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/index.js"
click node_export_context "https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/childContext.js"
click node_unused_analysis "https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/no-unused-modules.js"
click node_order_rule "https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/order.js"
click node_dependency_rule "https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/no-extraneous-dependencies.js"
click node_export_rule "https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/export.js"
click node_default_rule "https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/default.js"
click node_resolver_core "https://github.com/import-js/eslint-plugin-import/blob/main/src/core/importType.js"
click node_node_resolver "https://github.com/import-js/eslint-plugin-import/blob/main/resolvers/node/index.js"
click node_webpack_resolver "https://github.com/import-js/eslint-plugin-import/blob/main/resolvers/webpack/index.js"
click node_file_listing "https://github.com/import-js/eslint-plugin-import/blob/main/src/core/listFilesToProcess.js"
click node_parser "https://github.com/import-js/eslint-plugin-import/blob/main/utils/parse.js"
click node_module_graph "https://github.com/import-js/eslint-plugin-import/blob/main/src/scc.js"
click node_rule_capabilities "https://github.com/import-js/eslint-plugin-import/tree/main/src/rules"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin_entry toneBlue
class node_export_builder,node_export_visitor,node_export_map,node_export_context,node_file_listing,node_parser,node_module_graph toneAmber
class node_rule_suite,node_unused_analysis,node_order_rule,node_dependency_rule,node_export_rule,node_default_rule,node_rule_capabilities toneMint
class node_configs toneRose
class node_resolver_core,node_node_resolver,node_webpack_resolver,node_eslint toneIndigo
```

## Components

### Plugin interface

- [Plugin entry](https://github.com/import-js/eslint-plugin-import/blob/main/src/index.js): `src/index.js`

### Module analysis

- [Export map builder](https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/builder.js): `src/exportMap/builder.js`
- [Export visitor](https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/visitor.js): `src/exportMap/visitor.js`
- [Export map](https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/index.js): `src/exportMap/index.js`
- [Analysis context](https://github.com/import-js/eslint-plugin-import/blob/main/src/exportMap/childContext.js): `src/exportMap/childContext.js`
- [File enumeration](https://github.com/import-js/eslint-plugin-import/blob/main/src/core/listFilesToProcess.js): `src/core/listFilesToProcess.js`
- [Source parser](https://github.com/import-js/eslint-plugin-import/blob/main/utils/parse.js): `utils/parse.js`
- [Cycle analysis](https://github.com/import-js/eslint-plugin-import/blob/main/src/scc.js): `src/scc.js`

### Lint rules

- [Import rules](https://github.com/import-js/eslint-plugin-import/tree/main/src/rules): `src/rules`
- [Unused module analysis](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/no-unused-modules.js): `src/rules/no-unused-modules.js`
- [Import ordering](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/order.js): `src/rules/order.js`
- [Dependency policy](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/no-extraneous-dependencies.js): `src/rules/no-extraneous-dependencies.js`
- [Export validation](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/export.js): `src/rules/export.js`
- [Default validation](https://github.com/import-js/eslint-plugin-import/blob/main/src/rules/default.js): `src/rules/default.js`
- [Other rule families](https://github.com/import-js/eslint-plugin-import/tree/main/src/rules): `src/rules`

### Configurations

- [Rule presets](https://github.com/import-js/eslint-plugin-import/tree/main/config): `config`

### Module resolution

- [Import classification](https://github.com/import-js/eslint-plugin-import/blob/main/src/core/importType.js): `src/core/importType.js`
- [Node resolver](https://github.com/import-js/eslint-plugin-import/blob/main/resolvers/node/index.js): `resolvers/node/index.js`
- [Webpack resolver](https://github.com/import-js/eslint-plugin-import/blob/main/resolvers/webpack/index.js): `resolvers/webpack/index.js`

### Other components

- **ESLint**

## Connections

- ESLint → Plugin entry: loads plugin (evidence: `src/index.js`)
- Plugin entry → Import rules: registers rules (evidence: `src/index.js`)
- Plugin entry → Rule presets: exports presets (evidence: `src/index.js`)
- Import rules → Export map builder: analyzes exports (evidence: `src/rules/no-unused-modules.js`)
- Export map builder → Analysis context: builds context (evidence: `src/exportMap/builder.js`)
- Export map builder → Source parser: parses source (evidence: `src/exportMap/builder.js`)
- Export map builder → Export visitor: visits syntax (evidence: `src/exportMap/builder.js`)
- Export visitor → Export map: records exports (evidence: `src/exportMap/visitor.js`)
- Export map builder → Export map: creates map (evidence: `src/exportMap/builder.js`)
- Export validation → Export map builder: queries map (evidence: `src/rules/export.js`)
- Default validation → Export map builder: queries map (evidence: `src/rules/default.js`)
- Unused module analysis → Export map builder: reads exports (evidence: `src/rules/no-unused-modules.js`)
- Unused module analysis → File enumeration: lists files (evidence: `src/rules/no-unused-modules.js`)
- Unused module analysis → Import classification: classifies imports
- Import classification → Node resolver: resolves paths (evidence: `src/core/importType.js`)
- Import ordering → Import classification: classifies imports (evidence: `src/rules/order.js`)
- Dependency policy → Import classification: classifies dependencies (evidence: `src/rules/no-extraneous-dependencies.js`)
- Webpack resolver → Node resolver: extends resolution
- Other rule families → Import rules: covers rule families
- Cycle analysis → Export map builder: uses export maps (evidence: `src/scc.js`)
