feat: return new object for webpack config and upgrade Readme.md

Author: justquanyin

packages/beidou-webpack/README-ZH.md

@@ -79,6 +79,8 @@ exports.webpack = {
 
 **custom.configPath**: 先定义 webpack 配置文件路径
 
+#### 配置文件内容示例:
+
 ```js
 // webpack.config.js
 // 配置方案1:
@@ -131,10 +133,8 @@ module.exports = {
     hot: true,
   },
 };
-```
 
-高级自定义配置:
-```js
+// 自定义配置3 :
 // 更多配置方法，可参看单测用例
 module.exports = (app, defaultConfig, dev, target) => {
   const factory = app.webpackFactory;
@@ -187,10 +187,14 @@ module.exports = (app, defaultConfig, dev, target) => {
   return factory.getConfig(); // 返回配置
 
 };
+
 ```
 
+#### 数据结构：
+
 > Class Plugin Struct
-```
+
+```js
 class Plugin {
   object ,      // instance object for webpack plugin
   class,        // class for webpack plugin
@@ -201,15 +205,72 @@ class Plugin {
 ```
 
 > Class Rule Struct
-```
+
+```js
 class Rule {
   opitons,      // initialize config for rule
   alias
 }
+```
+
+## 配置扩展
+
+##### 自定义 Loader:
+```js
+  app.webpackFactory.defineLoader({
+    'babel-loader',
+    require.resolve('babel-loader')
+  })
+```
+
+##### 自定义 Rule:
+```js
+  app.webpackFactory.defineRule({
+      test: /\.tsx?$/,
+      exclude: /node_modules/,
+      use: {
+        loader: app.webpackFactory.useLoader('babel-loader'), //使用自定义loader
+        options: {
+          babelrc: false,
+          presets: ['preset-typescript'],
+        },
+      },
+  },'tsx')
+  // 使用自定义Rule增加到webpack项中
+  app.webpackFactory.addRule(
+    app.webpackFactory.useRule('tsx')
+  )
+  // 获取已配置的Rule
+  app.webpackFactory.getRule('tsx'); // return Rule Object
+```
+
+##### 自定义 Plugin:
+```js
+  app.webpackFactory.definePlugin(webpack.NoEmitOnErrorsPlugin,{},'NoEmitOnErrorsPlugin')
+
+  // 使用自定义Plugin增加到webpack项中
+  app.webpackFactory.addPlugin(
+    app.webpackFactory.usePlugin('NoEmitOnErrorsPlugin')
+  )
+  // 直接增加Plugin到webpack中
+  //方式1：
+  app.webpackFactory.addPlugin(webpack.optimize.UglifyJsPlugin, {
+      compress: {
+        warnings: false,
+      },
+    }, 'UglifyJsPlugin')
+  // 方式2:
+  app.webpackFactory.addPlugin( 
+    new webpack.optimize.UglifyJsPlugin({
+      compress: {
+        warnings: false,
+      },
+    })
+  )
 
 ```
 
-> app.webpackFactory 提供的函数如下:
+## webpackFactory常用函数说明：
 
 ### 重置配置项: reset(value)
 #### Parameters

packages/beidou-webpack/README.md

@@ -134,10 +134,7 @@ module.exports = {
   },
 };
 
-```
-
-> Advanced custom configuration :
-```js
+// Advanced custom configuration :
 // find more example in unittest, please
 module.exports = (app, defaultConfig, dev, target) => {
   const factory = app.webpackFactory;
@@ -192,8 +189,12 @@ module.exports = (app, defaultConfig, dev, target) => {
 };
 
 ```
-> Class Plugin Struct
-```
+
+#### Class Struct
+
+> Class Struct for Plugin
+
+```js
 class Plugin {
   object ,      // instance object for webpack plugin
   class,        // class for webpack plugin
@@ -203,14 +204,74 @@ class Plugin {
 
 ```
 
-> Class Rule Struct
-```
+> Class Struct for Rule
+
+```js
 class Rule {
   opitons,      // initialize config for rule
   alias
 }
 
 ```
+
+## Webpackfactory
+
+##### Define Custom Loader:
+```js
+  app.webpackFactory.defineLoader({
+    'babel-loader',
+    require.resolve('babel-loader')
+  })
+```
+
+##### Define Custom Rule:
+```js
+  app.webpackFactory.defineRule({
+      test: /\.tsx?$/,
+      exclude: /node_modules/,
+      use: {
+        loader: app.webpackFactory.useLoader('babel-loader'), //used the defined loader.
+        options: {
+          babelrc: false,
+          presets: ['preset-typescript'],
+        },
+      },
+  },'tsx')
+  //add the rule config to webpack factory
+  app.webpackFactory.addRule(
+    app.webpackFactory.useRule('tsx')
+  )
+  //add the rule config to webpack factory
+  app.webpackFactory.getRule('tsx'); // return Rule Object
+```
+
+##### Define Custom Plugin:
+```js
+  app.webpackFactory.definePlugin(webpack.NoEmitOnErrorsPlugin,{},'NoEmitOnErrorsPlugin')
+
+  // add defined plugin to webpack factory
+  app.webpackFactory.addPlugin(
+    app.webpackFactory.usePlugin('NoEmitOnErrorsPlugin')
+  )
+
+  //method 1：
+  app.webpackFactory.addPlugin(webpack.optimize.UglifyJsPlugin, {
+      compress: {
+        warnings: false,
+      },
+    }, 'UglifyJsPlugin')
+  //method 2:
+  app.webpackFactory.addPlugin( 
+    new webpack.optimize.UglifyJsPlugin({
+      compress: {
+        warnings: false,
+      },
+    })
+  )
+
+```
+
+
 > app.webpackFactory methods list:
 
 ### reset(value)

packages/beidou-webpack/config/webpack/webpack.browser.js

@@ -67,7 +67,7 @@ module.exports = (app, entry, dev) => {
     app.webpackFactory.addPlugin('UglifyJsPlugin');
     app.webpackFactory.addPlugin('DefinePlugin');
   } else {
-    app.webpackFactory.getConfig().devServer.hot = true;
+    app.webpackFactory.get('devServer').hot = true;
     app.webpackFactory.setPlugin(
       webpack.DefinePlugin, {
         'process.env.NODE_ENV': JSON.stringify('development'),

packages/beidou-webpack/config/webpack/webpack.node.js

@@ -14,13 +14,13 @@ const {
 
 module.exports = (app, entry, dev) => {
   common(app, entry, dev);
-  app.webpackFactory.getConfig().output.libraryTarget = 'commonjs';
-  app.webpackFactory.getConfig().target = 'node';
-  app.webpackFactory.getConfig().externals = /^react(-dom)?$/;
-  app.webpackFactory.getConfig().node = {
+  app.webpackFactory.get('output').libraryTarget = 'commonjs';
+  app.webpackFactory.set('target', 'node');
+  app.webpackFactory.set('externals', /^react(-dom)?$/);
+  app.webpackFactory.set('node', {
     __filename: true,
     __dirname: true,
-  };
+  });
 
   [
     {

packages/beidou-webpack/lib/factory/webpack.js

@@ -87,7 +87,7 @@ class WebpackFactory extends Factory {
     } else {
       this.__webpackConfig.module.rules = rules;
     }
-    return this.__webpackConfig;
+    return Object.assign({}, this.__webpackConfig);
   }
 
 
@@ -268,6 +268,13 @@ class WebpackFactory extends Factory {
     if (is.regexp(filter)) {
       return defineRules[filter.toString()];
     }
+
+    if (is.string(filter)) {
+      const rule = Object.values(defineRules).find(v => v.alias === filter);
+      if (rule) {
+        return rule;
+      }
+    }
     if (is.string(filter)) {
       return Object.values(defineRules).find(v => v.options.test.test(filter));
     }