eslint-plugin-filename-export

This plugin enforces that the filename matches to a named export or default export when a name is provided. This can be set to being case sensitive or case insensitive.

Installation

Install with your package manager of choice:

1pnpm i -D eslint-plugin-filename-export

Add to your ESLint config:

1{
2  "plugins": ["eslint-plugin-filename-export"],
3  "rules": {
4    "filename-export/match-named-export": "error",
5    "filename-export/match-default-export": "error"
6  }
7}

Rules

• filename-export/match-named-export - Enforces that the filename matches to a named export.
• filename-export/match-default-export - Enforces that filenames match the name of the default export.

These rules ignore index files, test/spec files, and files that have no relevant exports by default. Additionally, files with a default export will be ignored by the match-named-export rule.

If you want to add additional filename exemptions, use the ESLint's builting filename overrides.

Options

Both of these rules have the following available options:

• casing:

  • strict: Filenames much match in case to the exports
  • loose: Filenames do not need to match case (default)

• stripextra:

  • true: Filenames will be stripped of any non-alphanumeric characters (to allow filenames like great_function.ts to match greatfunction)
  • false: Filenames will not be stripped of any extra characters (default)

These can be passed as a second item in an array to the rule as follows

1"filename-export/match-named-export": [
2  "error",
3  {
4    "casing": "strict",
5    "sripextra": true
6  }
7]

Roadmap

This plugin is mainly being produced for personal use. If you are interested in using it, but need additional features, please open an issue and I will consider adding them.

Pull requests will also be evaluated and merged as appropriate.