https://github.com/creeperyang/universal-css-processor
The universal style processor and sourcemap generator.
https://github.com/creeperyang/universal-css-processor
Last synced: 9 days ago
JSON representation
The universal style processor and sourcemap generator.
- Host: GitHub
- URL: https://github.com/creeperyang/universal-css-processor
- Owner: creeperyang
- License: mit
- Created: 2016-10-25T14:57:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-01-19T13:11:22.000Z (over 9 years ago)
- Last Synced: 2025-10-02T18:00:42.046Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 39.1 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# universal-css-processor [](https://travis-ci.org/creeperyang/universal-css-processor)
> Process sass/less/postcss and generate sourcemap correctly.
## Installation
```bash
npm i --save universal-css-processor
```
## Usage
`universal-css-processor` offers a simple and universal API to handle `less/sass/postcss` and generate sourcemap.
### process(glob, processors, options)
- `glob` is array of globs, such as `[styles/**/*.less]`, used to find/locate files to be processed.
- `processors` is array of processor configs. Every config is like `{ name: String, options: Object}`, and the `option` will be passed to processor. And built-in processors include `less/sass/scss/postcss/autoprefixer/minify/concat/css`.
- `options` is the config for all processors, such as `{ map: Boolean, base: String}`.
The typical usage is below:
```js
const ucprocessor = require('universal-css-processor')
ucprocessor.process(
// glob to list files you want to handle
['test/resource/sass/*.scss', '!test/resource/sass/_*.scss'],
[
'sass', // directly specify sass processor
{
name: 'autoprefixer' // use name to specify processor
},
{
name: 'concat',
// offer options
options: {
destFile: 'all.css',
rebaseUrl: true
}
},
{
name: 'minify',
options: {
rename: true
}
}
],
{
map: true // generate map
}
).then(file => {
// regroup map file
return ucprocessor.writeMap(file, '.', {
destPath: 'dest'
}).then(mapFile => {
// write map file and processed style file to disk
mapFile.dest('dest')
file.dest('dest')
})
})
```
## Credits
Surely inspired by `gulp` and its plugins like `gulp-sourcemaps`, `gulp-postcss`, `gulp-sass` and `gulp-concat`. Most part of code is rewrited based on their codebase, and thanks for their great work.
The goal for this lib is integrating and simplifying the process of style and sourcemap.