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:

npm install -D eslint-import-resolver-next

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

Example config:

module.exports = {
  // ... other configuration options
  settings: {
    "import/resolver": {
      next: {
        // Options for the resolver
      },
    },
  },
};

with Mono-repo:

module.exports = {
  // ... other configuration options
  settings: {
    "import/resolver": {
      next: {
        packages: ["packages/*"],
      },
    },
  },
};

pnpm-workspaces:

module.exports = {
  // ... other configuration options
  settings: {
    "import/resolver": {
      next: {
        packages: {
          pnpmWorkspace: true,
          includeRoot: true,
        },
      },
    },
  },
};

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

const { createNextImportResolver } = require("eslint-import-resolver-next");

module.exports = {
  // ... other configuration options
  settings: {
    "import-x/resolver-next": [createNextImportResolver({
      // Options for the resolver
    })],
  },
};

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.