stylelint-no-unresolved-module

Ensures that module (import-like or url) can be resolved to a module on the file system.

Nodes which are considered "modules":

• @import at-rule in CSS and SCSS files (including pkg: URLs)
• @use and @forward at-rule as Sass modules (including pkg: URLs)
• url declaration value for various declaration properties

Features:

• enhanced-resolve to resolve each resource
• Handling partials for Sass files

Install

1npm install stylelint-no-unresolved-module --save

Usage

Add this config to your .stylelintrc:

1{
2	"plugins": ["stylelint-no-unresolved-module"],
3	"rules": {
4		"plugin/no-unresolved-module": {
5			"alias": {
6				"assets": "pebbles"
7			},
8			"modules": ["node_modules", "local_modules"]
9		}
10	}
11}

Assuming file system like this:

.
├── package.json
├── index.css
├── milo/
│   └── macy.css
├── node_modules/
│   └── josie/
│       ├── package.json
│       ├── rusty.css
│       └── index.css
└── local_modules/
    ├── pebbles/
    │   └── tucker.png
    └── shelby/
        └── shelby.css

Assuming code is run from ./index.css:

1/**
2 * These resources can be resolved */
3
4@import url('josie');
5@import url('shelby/shelby.css');
6@import url('./milo/macy.css');
7
8body {
9	background: url('assets/tucker.jpg');
10}
11
12/**
13 * These resources can’t be resolved */
14
15@import url('shelby');
16@import url('josie/misty.css');
17@import url('./milo/index.css');
18
19body {
20	background: url('assets/sandy.jpg');
21}

Options

Plugin accepts either boolean (true) or object configuration.

If boolean, it will use default configuration:

• No aliases
• Look only inside node_modules for non-relative resource paths

If object configuration, following properties are valid:

cwd

Type: string
Default: process.cwd()

Root directory from where to start resolving resources. If it’s not defined, directory of file will be used. Useful for situations where you don’t have original file.

alias

Type: Object

A list of module alias configurations or an object which maps key to value. See original documentation.

modules

Type: string[]

A list of directories to resolve modules from. See original documentation.

roots

Type: string[]

A list of root paths. See original documentation.

License

MIT © Ivan Nikolić