feat(utils): support plugins with configuration objects

docs/configuration.md

@@ -208,7 +208,7 @@ Default configuration:
 {
   postcss: {
     // Default plugins
-    plugins: ['autoprefixer'],
+    plugins: ['autoprefixer', ['another-postcss-plugin',{ foo: 'bar'}]],
     // Stops the build if an error is found
     failOnError: true
   }

utils/getPlugins.js

@@ -0,0 +1,17 @@
+module.exports = function getPlugins(plugins = []) {
+    return plugins
+        .filter(Boolean)
+        .map(function (entry) {
+            if (Array.isArray(entry)) {
+                const [pluginName, pluginOptions] = entry;
+                const pluginModule = require(pluginName);
+                const pluginFn = pluginModule.default || pluginModule;
+                return pluginFn(pluginOptions);
+            } else if (typeof entry === 'string') {
+                const pluginModule = require(entry);
+                return pluginModule.default || pluginModule;
+            } else {
+                throw new Error(`Invalid plugin entry: ${JSON.stringify(entry)}`);
+            }
+        });
+};

utils/getPlugins.test.js

@@ -0,0 +1,52 @@
+process.argv.push('--quiet');
+
+describe('Test getPlugins.js', () => {
+  beforeEach(() => {
+    jest.resetModules();
+  });
+
+  it('Should load a plugin from string', () => {
+    jest.mock('postcss-fe-build-test-a', () => () => 'mocked-plugin-a', { virtual: true });
+
+    const getPlugins = require('./getPlugins');
+    const plugins = ['postcss-fe-build-test-a'];
+    const result = getPlugins(plugins);
+
+    expect(result).toHaveLength(1);
+    expect(result[0]()).toBe('mocked-plugin-a');
+  });
+
+  it('Should load a plugin from [plugin, options] format', () => {
+    jest.mock('postcss-fe-build-test-b', () => ({
+      default: (opts) => `mocked-plugin-b:${JSON.stringify(opts)}`
+    }), { virtual: true });
+
+    const getPlugins = require('./getPlugins');
+    const plugins = [['postcss-fe-build-test-b', { extractAll: false }]];
+    const result = getPlugins(plugins);
+
+    expect(result).toHaveLength(1);
+    expect(result[0]).toBe('mocked-plugin-b:{"extractAll":false}');
+  });
+
+
+  it('Should ignore falsy values in plugin list', () => {
+    jest.mock('postcss-fe-build-test-c', () => () => 'mocked-plugin-a', { virtual: true });
+
+    const getPlugins = require('./getPlugins');
+    const plugins = [null, undefined, false, 'postcss-fe-build-test-c'];
+    const result = getPlugins(plugins);
+
+    expect(result).toHaveLength(1);
+    expect(result[0]()).toBe('mocked-plugin-a');
+  });
+
+  it('Should throw on invalid plugin entry', () => {
+    const getPlugins = require('./getPlugins');
+
+    const invalidPlugins = [{ foo: 'bar' }, 123, true];
+    invalidPlugins.forEach(plugin => {
+      expect(() => getPlugins([plugin])).toThrow('Invalid plugin entry');
+    });
+  });
+});

utils/renderPostcss.js

@@ -1,16 +1,15 @@
 const postcss = require('postcss');
 const { log } = require('./log');
+const getPlugins = require('./getPlugins');
 
 module.exports = function renderPostcss(input, outFile, config, cb) {
   const { plugins, failOnError } = config.postcss;
 
   try {
     // try to dynamic load of postcss plugins
-    /* eslint-disable */
-    const runPlugins = plugins.map(plugin => require(plugin));
-    const map = config.general.isProduction ? false : { inline: true, prev: input.sourceMap } ;
+    const runPlugins = getPlugins(plugins);
+    const map = config.general.isProduction ? false : { inline: true, prev: input.sourceMap };
 
-    /* eslint-enable */
     // run postcss plugins at sass output
     postcss(runPlugins).process(input.css.toString(), { from: outFile, map })
       .then((result) => {
@@ -29,7 +28,11 @@ module.exports = function renderPostcss(input, outFile, config, cb) {
         }
 
         // success and return
-        log(__filename, `Postcss applied ${plugins.join(',')} - `, input.destFile, 'success');
+        log(__filename,
+          `PostCSS applied: ${plugins.map(ent => (Array.isArray(ent) ? ent[0] : ent)).join(', ')}`,
+          input.destFile,
+          'success');
+
         return cb(result);
       });
   } catch (error) {