From 0a6811d5dabf261f5eb4b551b01e523fcf3c315e Mon Sep 17 00:00:00 2001
From: streamich <streamich@gmail.com>
Date: Sun, 28 Oct 2018 10:34:07 +0100
Subject: [PATCH 1/4] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20improve=20docs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/UI.md                         | 3 +++
 docs/useAudio.md                   | 4 +---
 src/__stories__/useAudio.story.tsx | 6 ++----
 3 files changed, 6 insertions(+), 7 deletions(-)
 create mode 100644 docs/UI.md

diff --git a/docs/UI.md b/docs/UI.md
new file mode 100644
index 00000000..c938a430
--- /dev/null
+++ b/docs/UI.md
@@ -0,0 +1,3 @@
+# UI
+
+*"UI Hooks"* allow you to control and subscribe to state changes of UI elements.
diff --git a/docs/useAudio.md b/docs/useAudio.md
index 24fe7475..206681a7 100644
--- a/docs/useAudio.md
+++ b/docs/useAudio.md
@@ -8,11 +8,9 @@ Creates `<audio>` element, tracks its state and exposes playback conrols.
 ```jsx
 import {useAudio} from 'react-use';
 
-const src = 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-2.mp3';
-
 const Demo = () => {
   const [audio, state, controls, ref] = useAudio({
-    src,
+    src: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-2.mp3',
     autoPlay: true,
   });
 
diff --git a/src/__stories__/useAudio.story.tsx b/src/__stories__/useAudio.story.tsx
index c6aa1160..3ab58630 100644
--- a/src/__stories__/useAudio.story.tsx
+++ b/src/__stories__/useAudio.story.tsx
@@ -2,11 +2,9 @@ import * as React from 'react';
 import {storiesOf} from '@storybook/react';
 import {useAudio} from '..';
 
-const src = 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-2.mp3';
-
 const Demo = () => {
-  const [audio, state, controls] = useAudio({
-    src,
+  const [audio, state, controls, ref] = useAudio({
+    src: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-2.mp3',
     autoPlay: true,
   });
 

From 3b971a2297ef5bcc17f9dd6c8b3a65bf6e308ebe Mon Sep 17 00:00:00 2001
From: streamich <streamich@gmail.com>
Date: Sun, 28 Oct 2018 11:26:23 +0100
Subject: [PATCH 2/4] =?UTF-8?q?feat:=20=F0=9F=8E=B8=20add=20useSpeech=20ho?=
 =?UTF-8?q?ok?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                           |  1 +
 docs/useSpeech.md                   | 18 +++++++++++++
 src/__stories__/useSpeech.story.tsx | 16 ++++++++++++
 src/index.ts                        |  2 ++
 src/react.ts                        |  3 +++
 src/useLifecycles.ts                |  2 +-
 src/useMount.ts                     |  6 +----
 src/useSpeech.ts                    | 40 +++++++++++++++++++++++++++++
 8 files changed, 82 insertions(+), 6 deletions(-)
 create mode 100644 docs/useSpeech.md
 create mode 100644 src/__stories__/useSpeech.story.tsx
 create mode 100644 src/useSpeech.ts

diff --git a/README.md b/README.md
index 3d54b8d1..6bbddad0 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,7 @@
      <br/>
 - [__UI__](./docs/UI.md)
    - [`useAudio`](./docs/useAudio.md) &mdash; plays audio and exposes its controls.
+   - [`useSpeech`](./docs/useSpeech.md) &mdash; synthesizes speech from text string.
      <br/>
      <br/>
 - [__Animations__](./docs/Animations.md)
diff --git a/docs/useSpeech.md b/docs/useSpeech.md
new file mode 100644
index 00000000..4af79c63
--- /dev/null
+++ b/docs/useSpeech.md
@@ -0,0 +1,18 @@
+# `useSpeech`
+
+React UI hook that synthesizes human voice that speaks a given string.
+
+
+## Usage
+
+```jsx
+import {useSpeech} from 'react-use';
+
+const Demo = () => {
+  const state = useSpeech('Hello world!');
+
+  return (
+    <pre>{JSON.stringify(state, null, 2)}</pre>  
+  );
+};
+```
diff --git a/src/__stories__/useSpeech.story.tsx b/src/__stories__/useSpeech.story.tsx
new file mode 100644
index 00000000..7433cfad
--- /dev/null
+++ b/src/__stories__/useSpeech.story.tsx
@@ -0,0 +1,16 @@
+import {storiesOf} from '@storybook/react';
+import * as React from 'react';
+import {useSpeech} from '..';
+
+const Demo = () => {
+  const state = useSpeech('Hello world!');
+
+  return (
+    <pre>{JSON.stringify(state, null, 2)}</pre>  
+  );
+};
+
+storiesOf('useSpeech', module)
+  .add('Example', () =>
+    <Demo/>
+  )
diff --git a/src/index.ts b/src/index.ts
index cd2a00b0..e9cf92a5 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -22,6 +22,7 @@ import useOrientation from './useOrientation';
 import useRaf from './useRaf';
 import useSetState from './useSetState';
 import useSize from './useSize';
+import useSpeech from './useSpeech';
 import useSpring from './useSpring';
 import useTimeout from './useTimeout';
 import useTitle from './useTitle';
@@ -55,6 +56,7 @@ export {
   useRaf,
   useSetState,
   useSize,
+  useSpeech,
   useSpring,
   useTimeout,
   useTitle,
diff --git a/src/react.ts b/src/react.ts
index 69defde9..de817490 100644
--- a/src/react.ts
+++ b/src/react.ts
@@ -12,3 +12,6 @@ export const useRef: UseRef = (React as any).useRef;
 
 export type UseCallback = <T extends ((...args: any[]) => any)>(callback: T, args: any[]) => T;
 export const useCallback: UseCallback = (React as any).useCallback;
+
+export type UseMemo = <T>(fn: Function, args: any[]) => T;
+export const useMemo: UseMemo = (React as any).useMemo;
diff --git a/src/useLifecycles.ts b/src/useLifecycles.ts
index b5c7e69b..841ccd47 100644
--- a/src/useLifecycles.ts
+++ b/src/useLifecycles.ts
@@ -1,6 +1,6 @@
 import {useEffect} from './react';
 
-const useLifecycles = (mount, unmount) => {
+const useLifecycles = (mount, unmount?) => {
   useEffect(() => {
     if (mount) mount();
     return () => {
diff --git a/src/useMount.ts b/src/useMount.ts
index 24e72fe5..7ff2edc4 100644
--- a/src/useMount.ts
+++ b/src/useMount.ts
@@ -1,9 +1,5 @@
 import {useEffect} from './react';
 
-const useMount = (mount) => {
-  useEffect(() => {
-    if (mount) mount();
-  }, []);
-};
+const useMount = (mount) => useEffect(mount, []);
 
 export default useMount;
diff --git a/src/useSpeech.ts b/src/useSpeech.ts
new file mode 100644
index 00000000..a7c8a7c3
--- /dev/null
+++ b/src/useSpeech.ts
@@ -0,0 +1,40 @@
+import {useRef} from './react';
+import useSetState from './useSetState';
+import useMount from './useMount';
+
+export interface SpeechState {
+  isPlaying: boolean;
+  volume: number;
+}
+
+export interface SpeechOptions {
+  lang?: any;
+  pitch?: number;
+  rate?: number;
+  voice?: any;
+  volume?: number;
+}
+
+const useSpeech = (text: string, opts: SpeechOptions = {}): SpeechState => {
+  const [state, setState] = useSetState<SpeechState>({
+    isPlaying: false,
+    volume: opts.volume || 1,
+  });
+
+  const uterranceRef = useRef<SpeechSynthesisUtterance | null>(null);
+
+  useMount(() => {
+    const utterance = new SpeechSynthesisUtterance(text);
+    utterance.volume = opts.volume || 1;
+    utterance.onstart = () => setState({isPlaying: true});
+    utterance.onresume = () => setState({isPlaying: true});
+    utterance.onend = () => setState({isPlaying: false});
+    utterance.onpause = () => setState({isPlaying: false});
+    uterranceRef.current = utterance;
+    window.speechSynthesis.speak(uterranceRef.current);
+  });
+
+  return state;
+};
+
+export default useSpeech;

From 2cdb09e8656bc40fed28d8f5750a1930bdfa3f4f Mon Sep 17 00:00:00 2001
From: streamich <streamich@gmail.com>
Date: Sun, 28 Oct 2018 11:28:56 +0100
Subject: [PATCH 3/4] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20improve=20useS?=
 =?UTF-8?q?peech=20docs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                           | 2 +-
 docs/useSpeech.md                   | 4 +++-
 src/__stories__/useSpeech.story.tsx | 4 +++-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 6bbddad0..0c6ce576 100644
--- a/README.md
+++ b/README.md
@@ -47,7 +47,7 @@
      <br/>
 - [__UI__](./docs/UI.md)
    - [`useAudio`](./docs/useAudio.md) &mdash; plays audio and exposes its controls.
-   - [`useSpeech`](./docs/useSpeech.md) &mdash; synthesizes speech from text string.
+   - [`useSpeech`](./docs/useSpeech.md) &mdash; synthesizes speech from a text string.
      <br/>
      <br/>
 - [__Animations__](./docs/Animations.md)
diff --git a/docs/useSpeech.md b/docs/useSpeech.md
index 4af79c63..f94628fe 100644
--- a/docs/useSpeech.md
+++ b/docs/useSpeech.md
@@ -12,7 +12,9 @@ const Demo = () => {
   const state = useSpeech('Hello world!');
 
   return (
-    <pre>{JSON.stringify(state, null, 2)}</pre>  
+    <pre>
+      {JSON.stringify(state, null, 2)}
+    </pre>  
   );
 };
 ```
diff --git a/src/__stories__/useSpeech.story.tsx b/src/__stories__/useSpeech.story.tsx
index 7433cfad..c507d214 100644
--- a/src/__stories__/useSpeech.story.tsx
+++ b/src/__stories__/useSpeech.story.tsx
@@ -6,7 +6,9 @@ const Demo = () => {
   const state = useSpeech('Hello world!');
 
   return (
-    <pre>{JSON.stringify(state, null, 2)}</pre>  
+    <pre>
+      {JSON.stringify(state, null, 2)}
+    </pre>  
   );
 };
 

From e0177d9d576540e83f7cb1404fed3d66de40fc58 Mon Sep 17 00:00:00 2001
From: streamich <streamich@gmail.com>
Date: Sun, 28 Oct 2018 12:46:22 +0100
Subject: [PATCH 4/4] =?UTF-8?q?chore:=20=F0=9F=A4=96=20release=20v1.7.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 7b97deb2..9ae6f789 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "react-use",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Collection of React Hooks",
   "main": "lib/index.js",
   "files": [