eslint-import-resolver-next

The next resolver plugin for eslint-plugin-import or eslint-plugin-import-x that resolves modules with oxc-resolver.

Features

• Resolves modules using the oxc-resolver package.
• Support mono-repos and pnpm-workspaces.yaml.
• Support paths alias defined in tsconfig.compilerOptions.paths or jsconfig.compilerOptions.paths.

Usage

1. Install the package:

1npm install -D eslint-import-resolver-next

2. Add it as a resolver to your ESLint configuration.

Example config:

1module.exports = {
2  // ... other configuration options
3  settings: {
4    "import/resolver": {
5      next: {
6        // Options for the resolver
7      },
8    },
9  },
10};

with Mono-repo:

1module.exports = {
2  // ... other configuration options
3  settings: {
4    "import/resolver": {
5      next: {
6        packages: ["packages/*"],
7      },
8    },
9  },
10};

pnpm-workspaces:

1module.exports = {
2  // ... other configuration options
3  settings: {
4    "import/resolver": {
5      next: {
6        packages: {
7          pnpmWorkspace: true,
8          includeRoot: true,
9        },
10      },
11    },
12  },
13};

3. For eslint-plugin-import-x resolver-next

1const { createNextImportResolver } = require("eslint-import-resolver-next");
2
3module.exports = {
4  // ... other configuration options
5  settings: {
6    "import-x/resolver-next": [createNextImportResolver({
7      // Options for the resolver
8    })],
9  },
10};

Options

• roots (Array): The directories to search for modules. Default: [process.cwd()].

• alias (Record<string, string | string[]>): The paths alias. Default: undefined.

  • The alias can be set as relative paths. relative paths are resolved from the package directory.

• tsconfig (boolean | string | object): Weather to use the tsconfig.json file. Default: true.

  • If true, the resolver will try to find the tsconfig.json file close to the source file.
  • If a string, it's the name of the file to search for.
  • If an object, see the tsconfig option in the oxc-resolver package.

• jsconfig (boolean | string | object): Weather to use the jsconfig.json file. Default: true.

  • If true, the resolver will try to find the jsconfig.json file close to the source file.
  • If a string, it's the name of the file to search for.

• packages (string[] | PackageOptions): The patterns or options to search for packages. Default: undefined.

  • If an array, the resolver will search for packages in the specified patterns.
  • If an object, see the PackageOptions.

All other options are passed to the oxc-resolver package. See the oxc-resolver documentation

PackageOptions

A folder with a package.json file is considered a package. The PackageOptions object can have the following properties:

• patterns (string[]): The patterns to search for packages. Default: ["."].
• ignore (string[]): The directories to ignore. Default: ["**/node_modules/**", "**/test/**", "**/tests/**"].
• includeRoot (boolean): Weather to include the root directory. Default: false.
• pnpmWorkspace (boolean | string): Weather to use the pnpm-workspace.yaml file to find packages. Default: false.
  • If true, the resolver will try to find the pnpm-workspace.yaml file in the package directory.
  • If a string, define the path to the pnpm-workspace.yaml file.