Merge remote-tracking branch 'upstream/dev' into working

Author: MachinisteWeb

build/build.main.js

@@ -0,0 +1,81 @@
+const fs = require('fs')
+const path = require('path')
+const zlib = require('zlib')
+const uglify = require('uglify-js')
+const rollup = require('rollup')
+const configs = require('./configs')
+
+if (!fs.existsSync('dist')) {
+  fs.mkdirSync('dist')
+}
+
+build(Object.keys(configs).map(key => configs[key]))
+
+function build (builds) {
+  let built = 0
+  const total = builds.length
+  const next = () => {
+    buildEntry(builds[built]).then(() => {
+      built++
+      if (built < total) {
+        next()
+      }
+    }).catch(logError)
+  }
+
+  next()
+}
+
+function buildEntry (config) {
+  const isProd = /min\.js$/.test(config.dest)
+  return rollup.rollup(config).then(bundle => {
+    const code = bundle.generate(config).code
+    if (isProd) {
+      var minified = (config.banner ? config.banner + '\n' : '') + uglify.minify(code, {
+        fromString: true,
+        output: {
+          /* eslint-disable camelcase */
+          screw_ie8: true,
+          ascii_only: true
+          /* eslint-enable camelcase */
+        }
+      }).code
+      return write(config.dest, minified, true)
+    } else {
+      return write(config.dest, code)
+    }
+  })
+}
+
+function write (dest, code, zip) {
+  return new Promise((resolve, reject) => {
+    function report (extra) {
+      console.log(blue(path.relative(process.cwd(), dest)) + ' ' + getSize(code) + (extra || ''))
+      resolve()
+    }
+
+    fs.writeFile(dest, code, err => {
+      if (err) return reject(err)
+      if (zip) {
+        zlib.gzip(code, (err, zipped) => {
+          if (err) return reject(err)
+          report(' (gzipped: ' + getSize(zipped) + ')')
+        })
+      } else {
+        report()
+      }
+    })
+  })
+}
+
+function getSize (code) {
+  return (code.length / 1024).toFixed(2) + 'kb'
+}
+
+function logError (e) {
+  console.log(e)
+}
+
+function blue (str) {
+  return '\x1b[1m\x1b[34m' + str + '\x1b[39m\x1b[22m'
+}

build/configs.js

@@ -0,0 +1,71 @@
+const path = require('path')
+const buble = require('rollup-plugin-buble')
+const replace = require('rollup-plugin-replace')
+const version = process.env.VERSION || require('../package.json').version
+const banner =
+`/**
+ * vuex v${version}
+ * (c) ${new Date().getFullYear()} Evan You
+ * @license MIT
+ */`
+
+const resolve = _path => path.resolve(__dirname, '../', _path)
+
+const configs = {
+  umdDev: {
+    entry: resolve('src/index.js'),
+    dest: resolve('dist/vuex.js'),
+    format: 'umd',
+    env: 'development'
+  },
+  umdProd: {
+    entry: resolve('src/index.js'),
+    dest: resolve('dist/vuex.min.js'),
+    format: 'umd',
+    env: 'production'
+  },
+  commonjs: {
+    entry: resolve('src/index.js'),
+    dest: resolve('dist/vuex.common.js'),
+    format: 'cjs'
+  },
+  esm: {
+    entry: resolve('src/index.esm.js'),
+    dest: resolve('dist/vuex.esm.js'),
+    format: 'es'
+  }
+}
+
+function genConfig (opts) {
+  const config = {
+    entry: opts.entry,
+    dest: opts.dest,
+    format: opts.format,
+    banner,
+    moduleName: 'Vuex',
+    plugins: [
+      replace({
+        __VERSION__: version
+      }),
+      buble()
+    ]
+  }
+
+  if (opts.env) {
+    config.plugins.unshift(replace({
+      'process.env.NODE_ENV': JSON.stringify(opts.env)
+    }))
+  }
+
+  return config
+}
+
+function mapValues (obj, fn) {
+  const res = {}
+  Object.keys(obj).forEach(key => {
+    res[key] = fn(obj[key], key)
+  })
+  return res
+}
+
+module.exports = mapValues(configs, genConfig)

build/rollup.config.js

@@ -0,0 +1 @@
+module.exports = require('./configs').commonjs

build/rollup.dev.config.js

@@ -61,7 +61,7 @@ const Counter = {
 When a component needs to make use of multiple store state properties or getters, declaring all these computed properties can get repetitive and verbose. To deal with this we can make use of the `mapState` helper which generates computed getter functions for us to help us save some keystrokes:
 
 ``` js
-// in standalone builds helpers are exposed as Vuex.mapState
+// in full builds helpers are exposed as Vuex.mapState
 import { mapState } from 'vuex'
 
 export default {

docs/en/state.md

@@ -92,10 +92,16 @@ const testAction = (action, payload, state, expectedMutations, done) => {
   // mock commit
   const commit = (type, payload) => {
     const mutation = expectedMutations[count]
-    expect(mutation.type).to.equal(type)
-    if (payload) {
-      expect(mutation.payload).to.deep.equal(payload)
+
+    try {
+      expect(mutation.type).to.equal(type)
+      if (payload) {
+        expect(mutation.payload).to.deep.equal(payload)
+      }
+    } catch (error) {
+      done(error)
     }
+
     count++
     if (count >= expectedMutations.length) {
       done()

docs/en/testing.md

@@ -92,10 +92,16 @@ const testAction = (action, args, state, expectedMutations, done) => {
   // mock commit
   const commit = (type, payload) => {
     const mutation = expectedMutations[count]
-    expect(mutation.type).to.equal(type)
-    if (payload) {
-      expect(mutation.payload).to.deep.equal(payload)
+
+    try {
+      expect(mutation.type).to.equal(type)
+      if (payload) {
+        expect(mutation.payload).to.deep.equal(payload)
+      }
+    } catch (error) {
+      done(error)
     }
+
     count++
     if (count >= expectedMutations.length) {
       done()

docs/fr/testing.md

@@ -52,8 +52,16 @@ const store = new Vuex.Store({ ...options })
 
     ```
     state,     // モジュール内で定義されていればモジュールのローカルステート
-    getters,   // store.getters と同じ
-    rootState  // store.state と同じ
+    getters    // store.getters と同じ
+    ```
+
+    モジュールで定義されたときの仕様
+    
+    ```
+    state,       // モジュールで定義された場合、モジュールのローカルステート
+    getters,     // 現在のモジュールのモジュールのローカルゲッター
+    rootState,   // グローバルステート
+    rootGetters  // 全てのゲッター
     ```
 
     登録されたゲッターは `store.getters` 上に公開されます。
@@ -117,13 +125,13 @@ const store = new Vuex.Store({ ...options })
 
 ### Vuex.Store インスタンスメソッド
 
-- **`commit(type: string, payload?: any) | commit(mutation: Object)`**
+- **`commit(type: string, payload?: any, options?: Object) | commit(mutation: Object, options?: Object)`**
 
-  ミューテーションをコミットします。[詳細](mutations.md)
+  ミューテーションをコミットします。`options` は[名前空間付きモジュール](modules.md#名前空間)で root なミューテーションにコミットできる `root: true` を持つことできます。[詳細](mutations.md)
 
-- **`dispatch(type: string, payload?: any) | dispatch(action: Object)`**
+- **`dispatch(type: string, payload?: any, options?: Object) | dispatch(action: Object, options?: Object)`**
 
-  アクションをディスパッチします。すべてのトリガーされたアクションハンドラを解決するPromiseを返します。[詳細](actions.md)
+  アクションをディスパッチします。`options` は[名前空間付きモジュール](modules.md#名前空間)で root なアクションにディスパッチできる `root: true` を持つことできます。 すべてのトリガーされたアクションハンドラを解決するPromiseを返します。[詳細](actions.md)
 
 - **`replaceState(state: Object)`**
 

docs/ja/api.md

@@ -243,3 +243,25 @@ store.registerModule(['nested', 'myModule'], {
 動的なモジュール登録があることで、他の Vue プラグインが、モジュールをアプリケーションのストアに付属させることで、状態の管理に Vuex を活用できることができます。例えば [`vuex-router-sync`](https://github.com/vuejs/vuex-router-sync) ライブラリは、動的に付属させたモジュール内部でアプリケーションのルーティングのステートを管理することで vue-router と vuex を統合しています。
 
 `store.unregisterModule(moduleName)` を呼び出せば、動的に登録したモジュールを削除できます。ただしストア作成（store creation）の際に宣言された、静的なモジュールはこのメソッドで削除できないことに注意してください。
+
+### モジュールの再利用
+
+時どき、モジュールの複数インスタンスを作成する必要があるかもしれません。例えば:
+
+- 同じモジュールを使用する複数のストアを作成する;
+- 同じストアに同じモジュールを複数回登録する
+
+モジュールの状態を宣言するために単純なオブジェクトを使用すると、その状態オブジェクトは参照によって共有され、変更時にクロスストア/モジュールの状態汚染を引き起こします。
+
+これは、実際には Vue コンポーネント内部の `data` と全く同じ問題です。従って解決策も同じです。モジュールの状態を宣言するために関数を使用してください (2.3.0 以降でサポートされます):
+
+``` js
+const MyReusableModule = {
+  state () {
+    return {
+      foo: 'bar'
+    }
+  },
+  // ミューテーション、アクション、ゲッター...
+}
+```

docs/ja/modules.md

@@ -165,7 +165,10 @@ export default {
   // ...
   methods: {
     ...mapMutations([
-      'increment' // this.increment() を this.$store.commit('increment') にマッピングする
+      'increment', // this.increment() を this.$store.commit('increment') にマッピングする
+
+      // mapMutations はペイロードサポートする:
+      'incrementBy' // this.incrementBy(amount) を this.$store.commit('incrementBy', amount) にマッピングする
     ]),
     ...mapMutations({
       add: 'increment' // this.add() を this.$store.commit('increment') にマッピングする

docs/ja/mutations.md

@@ -103,8 +103,9 @@ const store = new Vuex.Store({
 const logger = createLogger({
   collapsed: false, // ログ出力されたミューテーションを自動で展開します
   filter (mutation, stateBefore, stateAfter) {
+    // ミューテーションを記録する必要がある場合は、true を返します
     // returns true if a mutation should be logged
-    // `mutation` is a { type, payload }
+    // `mutation` は { type, payload } です
     return mutation.type !== "aBlacklistedMutation"
   },
   transformer (state) {

docs/ja/plugins.md

@@ -60,7 +60,7 @@ const Counter = {
 コンポーネントが複数のストアのステートプロパティやゲッターを必要としているとき、これらすべてにおいて、算出プロパティを宣言することは繰り返しで冗長です。これに対処するため、算出ゲッター関数を生成し、いくつかのキーストロークを節約するのに役立つ `mapState` ヘルパーを使うことができます:
 
 ```js
-// スタンドアローンビルドでは、ヘルパーは Vuex.mapState として公開されています
+// 完全ビルドでは、ヘルパーは Vuex.mapState として公開されています
 import { mapState } from 'vuex'
 
 export default {

docs/ja/state.md

@@ -91,10 +91,16 @@ const testAction = (action, payload, state, expectedMutations, done) => {
   // コミットをモックする
   const commit = (type, payload) => {
     const mutation = expectedMutations[count]
-    expect(mutation.type).to.equal(type)
-    if (payload) {
-      expect(mutation.payload).to.deep.equal(payload)
+
+    try {
+      expect(mutation.type).to.equal(type)
+      if (payload) {
+        expect(mutation.payload).to.deep.equal(payload)
+      }
+    } catch (error) {
+      done(error)
     }
+
     count++
     if (count >= expectedMutations.length) {
       done()

docs/ja/testing.md

@@ -92,10 +92,16 @@ const testAction = (action, payload, state, expectedMutations, done) => {
   // 모의 커밋
   const commit = (type, payload) => {
     const mutation = expectedMutations[count]
-    expect(mutation.type).to.equal(type)
-    if (payload) {
-      expect(mutation.payload).to.deep.equal(payload)
+
+    try {
+      expect(mutation.type).to.equal(type)
+      if (payload) {
+        expect(mutation.payload).to.deep.equal(payload)
+      }
+    } catch (error) {
+      done(error)
     }
+
     count++
     if (count >= expectedMutations.length) {
       done()

docs/kr/testing.md

@@ -92,10 +92,16 @@ const testAction = (action, payload, state, expectedMutations, done) => {
   // поддельная функция вызова мутаций
   const commit = (type, payload) => {
     const mutation = expectedMutations[count]
-    expect(mutation.type).to.equal(type)
-    if (payload) {
-      expect(mutation.payload).to.deep.equal(payload)
+
+    try {
+      expect(mutation.type).to.equal(type)
+      if (payload) {
+        expect(mutation.payload).to.deep.equal(payload)
+      }
+    } catch (error) {
+      done(error)
     }
+
     count++
     if (count >= expectedMutations.length) {
       done()