postcss-simple-import

!node

Consume @import in css recursively.

* @import node-style modules
* Resolve the module entry according to the style field of package.json rather than main
* Files are imported only once

Options

$3

Specify the name of at-rules to be processed.

Type: String

Default: import

$3

Specify how to load files when processing @import.

Type: Function

Signature: importer(url, from, opts)

* url: @import "url";
* from: the absolute path of the current css file
* opts: the options object

opts.postcssOpts is accessible.

Should return an array of objects (or promises) with the following fields:
from: String required* the resolved file path
source: String optional* the contents of the file

If undefined returned, the importer will be ignored.

$3

File contents cache.

$3

Specify how to read file contents.

Type: Function

Signature: readFile(filename)

Should return a string (or promise) of contents of the file.

$3

Specify how to resolve globs.

It should have glob.hasMagic(url) to check whether globs exist.

Type: Function

Receives the glob string, and an object { cwd: dirname_of_the_processed_file }.

Should return an array (or a promise) of file paths.

Type: true
A promisified version of glob is used.

$3

Specify how to resolve file paths.

Type: Function

Receives the import string, and an object { basedir: dirname_of_the_processed_file }.

Should return an absolute file path (or promise).

Type: Object

Passed to custom-resolve to create the resolve function.

``javascript
var resolver = require('custom-resolve')
opts.resolve = promisify(resolver(mix({
packageEntry: 'style',
extensions: '.css',
symlinks: true, // resolve all soft links to their real paths
}, opts.resolve)))

`

$3

Specify how to build an AST from the source.

Type: Function

Signature: parse(source, from)

Should return the AST object (or promise).

$3

Deprecated

Use the imports event instead.

Type: Function

Signature: onImport(from, imports, postcssOpts)

* from: the css file
* imports: files directly imported by from
* postcssOpts: postcssOpts

$3

Event listeners.

Type: Object

#### import
Fired right after file path resolved, but before compilation.

Listener signature: fn(importedFile, from, opts)

opts.postcssOpts is accessible.


#### imports
Fired right after compilation.

Listener signature: fn(imports, from, opts)

* imports: Array

opts.postcssOpts is accessible.

$3

Type: Object

Options passed to process(source, postcssOpts)`