npmpackage.info

Gathering detailed insights and metrics for @dword-design/eslint-plugin-import-alias

@dword-design/eslint-plugin-import-alias - 6.0.3 | npmpackage.info

@dword-design/eslint-plugin-import-alias

An ESLint plugin that enforces the use of import aliases. Also supports autofixing.

6.0.3

NOASSERTION

TypeScript

327.20 kB

3,640,802 3.8

Installations

npm install @dword-design/eslint-plugin-import-alias

Developer Guide

BETA

Typescript

No

Module System

ESM

Min. Node Version

>=18

Node Version

20.19.2

NPM Version

10.9.2 Score

86.2

Supply Chain

97.8

Quality

87.3

Maintenance

100

Vulnerability

99.3

License

Pull Requests

Open

4

Total

191

Closed

29

Merged

158

Issues

Open

1

Total

8

Closed

7

Releases

v6.0.3

Updated on Jun 05, 2025

v6.0.2

Updated on Jun 05, 2025

v5.1.2

Updated on Apr 13, 2025

v5.1.1

Updated on Aug 18, 2024

v5.1.0

Updated on Aug 17, 2024

v5.0.2

Updated on Aug 17, 2024

View All 56 releases

Languages

TypeScript

Shell

TypeScript (99.27%)

Shell (0.73%)

Developer

dword-design

Download Statistics

Total Downloads

3,640,802

Last Day

4,146

Last Week

98,118

Last Month

357,616

Last Year

2,763,250

GitHub Statistics

NOASSERTION License

84 Stars

278 Commits

12 Forks

2 Watchers

3 Branches

7 Contributors

Updated on Jun 29, 2025

Bundle Size

1.29 MB

Minified

327.20 kB

Minified + Gzipped

Bundlephobia

Sponsor this package

https://github.com/sponsors/dword-design

Maintainers

View All 7 Contributors

Package Meta Information

Latest Version

6.0.3

Package Id

@dword-design/eslint-plugin-import-alias@6.0.3

Unpacked Size

13.05 kB

Size

4.65 kB

File Count

NPM Version

10.9.2

Node Version

20.19.2

Published on

Jun 05, 2025

Total Downloads

Cumulative downloads

Total Downloads

3,640,802

Last Day

294.5%

4,146

Compared to previous day

Last Week

24.3%

98,118

Compared to previous week

Last Month

-21.1%

357,616

Compared to previous month

Last Year

345.7%

2,763,250

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@babel/core @dword-design/defu babel-plugin-module-resolver

Dev Dependencies

@dword-design/base @playwright/test depcheck-package-name endent eslint lodash-es output-files typescript-eslint

@dword-design/eslint-plugin-import-alias

An ESLint plugin that enforces the use of import aliases. Also supports autofixing.

Aliases are a great thing to make imports more readable and you do not have to change import paths that often when a file path is changed.

1import foo from '../../model/sub/foo';
2import bar from '../other/bar';

changes to

1import foo from '@/model/sub/foo';
2import bar from '@/sub/other/bar';

Now what if you are in a bigger team or you have a lot of projects to update. Or you just want to make sure that everything is consistent. This is where a linter comes into the play. This rule allows you to detect inconsistent imports and even autofix them. This works by matching alias paths agains the imports and replacing the import paths with the first matching aliased path.

Install

1# npm
2$ npm install @dword-design/eslint-plugin-import-alias
3
4# Yarn
5$ yarn add @dword-design/eslint-plugin-import-alias

Usage

Add the plugin to your ESLint config:

1import { defineConfig } from 'eslint/config';
2import importAlias from '@dword-design/import-alias';
3
4export default defineConfig([
5  importAlias.configs.recommended,
6]);

Alright, now you have to tell the plugin which aliases to use. In the simplest case, you are already using babel-plugin-module-resolver for your aliases. Your babel config would look something like this:

1{
2  "plugins": {
3    ["module-resolver", {
4      "alias": {
5        "@": ".",
6      },
7    }]
8  }
9}

In this case lucky you, you don't have to do anything else. The plugin should work out of the box.

If you have a special project setup that does not have a babel config in the project path, you can still use the plugin by passing the aliases directly to the rule. In this case you define the rule additionally in the rules section:

1"rules": {
2  "@dword-design/import-alias/prefer-alias": [
3    "error",
4    {
5      "alias": {
6        "@": "./src",
7        "@components": "./src/components"
8      }
9    }
10  ]
11}

By default, the plugin will convert parent paths to aliases (like ../model/foo), but will keep subpath imports relative. You can change that to also convert subpaths to aliased imports by passing the aliasForSubpaths option to the rule like so:

1"rules": {
2  "@dword-design/import-alias/prefer-alias": ["error", { "aliasForSubpaths": true }]
3}

Contribute

Are you missing something or want to contribute? Feel free to file an issue or a pull request! ⚙️

Support

Hey, I am Sebastian Landwehr, a freelance web developer, and I love developing web apps and open source packages. If you want to support me so that I can keep packages up to date and build more helpful tools, you can donate here:

If you want to send me a one time donation. The coffee is pretty good 😊.
Also for one time donations if you like PayPal.
Here you can support me regularly, which is great so I can steadily work on projects.

Thanks a lot for your support! ❤️

License

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

9

License

Determines if the project has defined a license.

4

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deprecated-dependencies.yml:5: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/deprecated-dependencies.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deprecated-dependencies.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/deprecated-dependencies.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deprecated-dependencies.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/deprecated-dependencies.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deprecated-dependencies.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/deprecated-dependencies.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deprecated-dependencies.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/deprecated-dependencies.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/sync-labels.yml:5: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/sync-labels.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/sync-labels.yml:8: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/sync-labels.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/sync-metadata.yml:5: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/sync-metadata.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/sync-metadata.yml:6: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/sync-metadata.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/sync-metadata.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/dword-design/eslint-plugin-import-alias/sync-metadata.yml/master?enable=pin
Warn: containerImage not pinned by hash: .gitpod.Dockerfile:2: pin your Docker image by updating gitpod/workspace-full-vnc:latest to gitpod/workspace-full-vnc:latest@sha256:f81841b8299823e97e00a1f39dec6dc57d3b0cb6bcc79161a5d155b29ad34b8b
Warn: downloadThenRun not pinned by hash: .gitpod.Dockerfile:4
Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 8 third-party GitHubAction dependencies pinned
Info: 0 out of 1 downloadThenRun dependencies pinned
Info: 0 out of 1 containerImage dependencies pinned

0

SAST

Determines if the project uses static code analysis.

Score

3.8

/10

Last Scanned on 2025-06-23

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More