align postcss config API with postcss-loader

Author: yyx990803

docs/LANGS.md

@@ -1,6 +1 @@
 * [English](en/)
-* [한국어](kr/)
-* [Русский](ru/)
-* [Português](pt_BR/)
-* [日本語](ja/)
-* [中文](zh-cn/)

docs/en/SUMMARY.md

@@ -23,6 +23,7 @@
   - [preLoaders](options.md#preloaders)
   - [postLoaders](options.md#postloaders)
   - [postcss](options.md#postcss)
+  - [postcss.config](options.md#postcssconfig)
   - [cssSourceMap](options.md#csssourcemap)
   - [esModule](options.md#esmodule)
   - [preserveWhitespace](options.md#preservewhitespace)
@@ -32,3 +33,4 @@
   - [buble](options.md#buble)
   - [extractCSS](options.md#extractcss)
   - [optimizeSSR](options.md#optimizessr)
+  - [cacheBusting](options.md#cachebusting)

docs/en/options.md

@@ -112,20 +112,30 @@ module.exports = {
   }
   ```
 
-### postcss.configRoot
+### postcss.config
 
-> New in 13.2.0
+> New in 13.2.1
 
-- type: `string`
-- default: `process.cwd()`
+- type: `Object`
+- default: `undefined`
 
-  Specify an alternative root directory for [postcss-load-config](https://github.com/michael-ciniawsky/postcss-load-config) to search for PostCSS config files in.
+  This field allows customizing PostCSS config in the same way as [postcss-loader](https://github.com/postcss/postcss-loader#config-1).
 
-  ``` js
-  postcss: {
-    configRoot: path.resolve('./src')
-  }
-  ```
+  - **postcss.config.path**
+
+    Specify a path (file or directory) to load the PostCSS config file from.
+
+    ``` js
+    postcss: {
+      config: {
+        path: path.resolve('./src')
+      }
+    }
+    ```
+
+  - **postcss.config.ctx**
+
+    Provide context to PostCSS plugins. See [postcss-loader docs](https://github.com/postcss/postcss-loader#context-ctx) for more details.
 
 ### cssSourceMap
 

lib/style-compiler/load-postcss-config.js

@@ -6,15 +6,19 @@ function isObject (val) {
   return val && typeof val === 'object'
 }
 
-module.exports = function loadPostcssConfig (loaderContext, inlineConfig) {
+module.exports = function loadPostcssConfig (loaderContext, inlineConfig = {}) {
   if (process.env.VUE_LOADER_TEST || !loaded) {
-    loaded = load(
-      { webpack: loaderContext },
-      isObject(inlineConfig) && inlineConfig.configRoot,
-      { argv: false }
-    ).catch(() => {
+    const config = inlineConfig.config || {}
+    const ctx = { webpack: loaderContext }
+    if (config.ctx) {
+      ctx.options = config.ctx
+    }
+    loaded = load(ctx, config.path, { argv: false }).catch(err => {
       // postcss-load-config throws error when no config file is found,
-      // but for us it's optional.
+      // but for us it's optional. only emit other errors
+      if (err.message.indexOf('No PostCSS Config found') < 0) {
+        loaderContext.emitError(err)
+      }
     })
   }
 

test/test.js

@@ -487,7 +487,9 @@ describe('vue-loader', function () {
       entry: './test/fixtures/postcss.vue',
       vue: {
         postcss: {
-          configRoot: path.resolve('test')
+          config: {
+            path: path.resolve('test')
+          }
         }
       }
     }, (window) => {