postcss/lib/postcss.js

var Declaration = require('./declaration');
var Comment     = require('./comment');
var AtRule      = require('./at-rule');
var Result      = require('./result');
var Rule        = require('./rule');
var Root        = require('./root');

// List of functions to process CSS
class PostCSS {
    constructor(processors = []) {
        this.processors = processors.map( (i) => this.normalize(i) );
    }

    // Add another function to CSS processors
    use(plugin) {
        plugin = this.normalize(plugin);
        if ( typeof(plugin) == 'object' && Array.isArray(plugin.processors) ) {
            this.processors = this.processors.concat(plugin.processors);
        } else {
            this.processors.push(plugin);
        }
        return this;
    }

    // Process CSS throw installed processors
    process(css, opts = { }) {
        if ( opts.map == 'inline' ) {
            opts.map = { inline: true };
            console.warn('Shortcut map: "inline" is deprecated ' +
                         'and will be remove in 3.1');
        }

        var parsed;
        if ( css instanceof Root ) {
            parsed = css;
        } else if ( css instanceof Result ) {
            parsed = css.root;
            if ( css.map && typeof(opts.map) == 'undefined' ) {
                opts.map = { prev: css.map };
            }
        } else {
            parsed = postcss.parse(css, opts);
        }

        for ( var i = 0; i < this.processors.length; i++ ) {
            var returned = this.processors[i](parsed, opts);
            if ( returned instanceof Root ) parsed = returned;
        }

        return parsed.toResult(opts);
    }

    // Return processor function
    normalize(plugin) {
        var type = typeof(plugin);
        if ( (type == 'object' || type == 'function') && plugin.postcss ) {
            return plugin.postcss;
        } else {
            return plugin;
        }
    }
}

// Framework for CSS postprocessors
//
//   var processor = postcss(function (css) {
//       // Change nodes in css
//   });
//   processor.process(css)
var postcss = function (...processors) {
    if ( processors.length == 1 && Array.isArray(processors[0]) ) {
        processors = processors[0];
    }
    return new PostCSS(processors);
};

// Compile CSS to nodes
postcss.parse = require('./parse');

// Nodes shortcuts
postcss.comment = function (defaults) {
    return new Comment(defaults);
};
postcss.atRule = function (defaults) {
    return new AtRule(defaults);
};
postcss.decl = function (defaults) {
    return new Declaration(defaults);
};
postcss.rule = function (defaults) {
    return new Rule(defaults);
};
postcss.root = function (defaults) {
    return new Root(defaults);
};

module.exports = postcss;