docs: add section on TransitionStub and TransitionGroupStub

Author: eddyerburgh

docs/en/README.md

@@ -2,10 +2,12 @@
 
 `vue-test-utils` is the official unit testing utility library for Vue.js.
 
+## Table of Contents
+
 * [Guides](guides/README.md)
   * [Getting Started](guides/getting-started.md)
   * [Common Tips](guides/common-tips.md)
-  * [Mouse, Key and other DOM Events](guides/dom-events.md)  
+  * [Mouse, Key and other DOM Events](guides/dom-events.md)
   * [Choosing a test runner](guides/choosing-a-test-runner.md)
   * [Testing SFCs with Jest](guides/testing-SFCs-with-jest.md)
   * [Testing SFCs with Mocha + webpack](guides/testing-SFCs-with-mocha-webpack.md)
@@ -46,6 +48,7 @@
     * [text](api/wrapper/text.md)
     * [trigger](api/wrapper/trigger.md)
     * [update](api/wrapper/update.md)
+    * [destroy](api/wrapper/destroy.md)
   * [WrapperArray](api/wrapper-array/README.md)
     * [at](api/wrapper-array/at.md)
     * [contains](api/wrapper-array/contains.md)
@@ -62,5 +65,9 @@
     * [setProps](api/wrapper-array/setProps.md)
     * [trigger](api/wrapper-array/trigger.md)
     * [update](api/wrapper-array/update.md)
+    * [destroy](api/wrapper-array/destroy.md)
+  * [components](api/components/README.md)
+    * [TransitionStub](api/components/TransitionStub.md)
+    * [TransitionGroupStub](api/components/TransitionGroupStub.md)
   * [Selectors](api/selectors.md)
   * [createLocalVue](api/createLocalVue.md)

docs/en/SUMMARY.md

@@ -62,5 +62,8 @@
     * [trigger](api/wrapper-array/trigger.md)
     * [update](api/wrapper-array/update.md)
     * [destroy](api/wrapper-array/destroy.md)
+  * [components](api/components/README.md)
+    * [TransitionStub](api/components/TransitionStub.md)
+    * [TransitionGroupStub](api/components/TransitionGroupStub.md)
   * [Selectors](api/selectors.md)
   * [createLocalVue](api/createLocalVue.md)

docs/en/api/components/README.md

@@ -0,0 +1,5 @@
+# Components
+
+vue-test-utils includes utility components you can use to stub components.
+
+[TransitionStub](./TransitionStub.md) and [TransitionGroupStub](./TransitionGroupStub.md) are used to stub `transition` and `transition-group` components by default. You can edit the stubs by editing the config.

docs/en/api/components/TransitionGroupStub.md

@@ -0,0 +1,30 @@
+# TransitionGroupStub
+
+A component to stub the `transition-group` wrapper component. Instead of performing transitions asynchronously, it returns the child components synchronously.
+
+This is set to stub all `transition-group` components by default in the vue-test-utils config. To use the built-in `transition-group` wrapper component set `config.stubs[transition-group]` to false:
+
+```js
+import VueTestUtils from 'vue-test-utils'
+
+VueTestUtils.config.stubs.transition = false
+```
+
+To reset it to stub transition components:
+```js
+import VueTestUtils, { TransitionGroupStub } from 'vue-test-utils'
+
+VueTestUtils.config.stubs['transition-group'] = TransitionGroupStub
+```
+
+To set it as a stub in mounting options:
+
+```js
+import { mount, TransitionGroupStub } from 'vue-test-utils'
+
+mount(Component, {
+  stubs: {
+    'transition-group': TransitionGroupStub
+  }
+})
+```

docs/en/api/components/TransitionStub.md

@@ -0,0 +1,30 @@
+# TransitionStub
+
+A component to stub the `transition` wrapper component. Instead of performing transitions asynchronously, it returns the child component synchronously.
+
+This is set to stub all `transition` components by default in the vue-test-utils config. To use the built-in `transition` wrapper component set `config.stubs.transition` to false:
+
+```js
+import VueTestUtils from 'vue-test-utils'
+
+VueTestUtils.config.stubs.transition = false
+```
+
+To reset it to stub transition components:
+```js
+import VueTestUtils, { TransitionStub } from 'vue-test-utils'
+
+VueTestUtils.config.stubs.transition = TransitionStub
+```
+
+To set it as a stub in mounting options:
+
+```js
+import { mount, TransitionStub } from 'vue-test-utils'
+
+mount(Component, {
+  stubs: {
+    transition: TransitionStub
+  }
+})
+```