@a-latte/vue2-helpers/README.md

A util package to use Vue 2 with Composition API easily

# Vue2 Helpers
A util package to use Vue 2 with Composition API easily.

> NOTE: 
> - vue2-helpers@**1** is for vue2.5 and 2.6
> - vue2-helpers@**2** is for vue2.7


## ⬇️ Install
```
npm i -S vue2-helpers
```

## 📃 Usage
```javascript
import { createVuexHelpers } from 'vue2-helpers';
import { useRouter } from 'vue2-helpers/vue-router';

const { useState } = createVuexHelpers<
    RootState, RootGetters, RootMutations, RootActions
>();
// Get a reactive and mutable ref object "stateA"
const { stateA } = useState('module', ['stateA']);

const router = useRouter();
router.push('/login');
```


## ✨ API
### vue2-helpers
|Features|Description|
|-|-|
|`createVuexHelpers`&lt;<br>&nbsp;&nbsp;&nbsp;&nbsp;RootState, RootGetters, RootMutations, RootActions<br>&gt;(): {<br>&nbsp;&nbsp;&nbsp;&nbsp;`useState`, `useGetters`, `useMutations`, `useActions`<br>}|The helper methods in return value are<br>used to replace `mapState`, `mapGetters`,<br>`mapMutations`, `mapActions`|

### vue2-helpers/vuex
|Features|Description|
|-|-|
|`createStore`&lt;S&gt;(options: StoreOptions&lt;S&gt;): Store&lt;S&gt;||
|`useStore`&lt;S = any&gt;(): Store&lt;S&gt;|

### vue2-helpers/vue-router
|Features|Description|
|-|-|
|`createRouter`(options: RouterOptions): Router||
|`onBeforeRouteLeave`(leaveGuard: NavigationGuard): void||
|`onBeforeRouteUpdate`(updateGuard: NavigationGuard): void||
|`useRoute`(): RouteLocationNormalized||
|`useRouter`(): Router||
|router.`isReady`(): Promise\<void\>||


## ☎️ Contact
1. WeChat: cai_fanwei
1. QQ Group: 663286147
1. E-mail: ambit_tsai@qq.com