feat: jest integration (#102)

## 📜 Description

Will fix
#101

## 💡 Motivation and Context

Right now it's not possible to write jest tests for components, that are
using this library. To overcome the limitation I added `mock` and wrote
several test cases as examples.

## 📢 Changelog

### CI
- run `example` tests;

### Docs
- added section about testing;

### Jest
- added mocks;
- added example of tests;

## 🤔 How Has This Been Tested?

Tested locally and on CI that tests are working fine.

## 📝 Checklist

- [x] CI successfully passed

Author: kirillzyusko

Diff for: .github/workflows/verify-js.yml

@@ -48,6 +48,13 @@ jobs:
           node-version: 16.x
           cache: yarn
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
-      - name: Run tests
-        run: yarn test
+        run: |
+          yarn install --frozen-lockfile
+          cd example
+          yarn install --frozen-lockfile
+      - name: Run lib tests
+        run: yarn test src
+      - name: Run example app tests (verify mocks)
+        run: |
+          cd example
+          yarn test

Diff for: docs/docs/recipes/jest-testing-guide.md

@@ -0,0 +1,67 @@
+---
+sidebar_position: 3
+---
+
+# Jest testing guide
+
+## Setting up a mock
+
+This library includes a built in mock for Jest. To use it, add the following code to the [jest setup](https://jestjs.io/docs/configuration#setupfiles-array) file:
+
+```js
+jest.mock('react-native-keyboard-controller', () =>
+  require('react-native-keyboard-controller/jest')
+);
+```
+
+## Test case example
+
+Once you've set up mock - you can write your first test 😊. A sample of test case is shown below. For more test cases please see [this](https://github.com/kirillzyusko/react-native-keyboard-controller/tree/main/example/__tests__) link.
+
+```tsx
+import '@testing-library/jest-native/extend-expect';
+import React from 'react';
+import { Animated } from 'react-native';
+import { render } from '@testing-library/react-native';
+
+import { useKeyboardAnimation } from 'react-native-keyboard-controller';
+
+function TestComponent() {
+  const { height } = useKeyboardAnimation();
+
+  return (
+    <Animated.View
+      testID="view"
+      style={{ transform: [{ translateY: height }] }}
+    />
+  );
+}
+
+describe('basic keyboard interaction', () => {
+  it('should have different styles depends on position', () => {
+    const { getByTestId, update } = render(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({ transform: [{ translateY: 0 }] });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(150),
+      progress: new Animated.Value(0.5),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 150 }],
+    });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(300),
+      progress: new Animated.Value(1),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 300 }],
+    });
+  });
+});
+```

Diff for: docs/versioned_docs/version-1.4.0/recipes/jest-testing-guide.md

@@ -0,0 +1,67 @@
+---
+sidebar_position: 3
+---
+
+# Jest testing guide
+
+## Setting up a mock
+
+This library includes a built in mock for Jest. To use it, add the following code to the [jest setup](https://jestjs.io/docs/configuration#setupfiles-array) file:
+
+```js
+jest.mock('react-native-keyboard-controller', () =>
+  require('react-native-keyboard-controller/jest')
+);
+```
+
+## Test case example
+
+Once you've set up mock - you can write your first test 😊. A sample of test case is shown below. For more test cases please see [this](https://github.com/kirillzyusko/react-native-keyboard-controller/tree/main/example/__tests__) link.
+
+```tsx
+import '@testing-library/jest-native/extend-expect';
+import React from 'react';
+import { Animated } from 'react-native';
+import { render } from '@testing-library/react-native';
+
+import { useKeyboardAnimation } from 'react-native-keyboard-controller';
+
+function TestComponent() {
+  const { height } = useKeyboardAnimation();
+
+  return (
+    <Animated.View
+      testID="view"
+      style={{ transform: [{ translateY: height }] }}
+    />
+  );
+}
+
+describe('basic keyboard interaction', () => {
+  it('should have different styles depends on position', () => {
+    const { getByTestId, update } = render(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({ transform: [{ translateY: 0 }] });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(150),
+      progress: new Animated.Value(0.5),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 150 }],
+    });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(300),
+      progress: new Animated.Value(1),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 300 }],
+    });
+  });
+});
+```

Diff for: example/__tests__/__snapshots__/components-rendering.spec.tsx.snap

@@ -0,0 +1,23 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`components rendering should render \`KeyboardControllerView\` 1`] = `
+<KeyboardControllerView
+  statusBarTranslucent={true}
+/>
+`;
+
+exports[`components rendering should render \`KeyboardProvider\` 1`] = `
+<KeyboardProvider
+  statusBarTranslucent={true}
+>
+  <View
+    style={
+      Object {
+        "backgroundColor": "black",
+        "height": 20,
+        "width": 20,
+      }
+    }
+  />
+</KeyboardProvider>
+`;

Diff for: example/__tests__/basic-interaction.spec.tsx

@@ -0,0 +1,45 @@
+import '@testing-library/jest-native/extend-expect';
+import React from 'react';
+import { Animated } from 'react-native';
+import { render } from '@testing-library/react-native';
+
+import { useKeyboardAnimation } from 'react-native-keyboard-controller';
+
+function TestComponent() {
+  const { height } = useKeyboardAnimation();
+
+  return (
+    <Animated.View
+      testID="view"
+      style={{ transform: [{ translateY: height }] }}
+    />
+  );
+}
+
+describe('basic keyboard interaction', () => {
+  it('should have different styles depends on position', () => {
+    const { getByTestId, update } = render(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({ transform: [{ translateY: 0 }] });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(150),
+      progress: new Animated.Value(0.5),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 150 }],
+    });
+
+    (useKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: new Animated.Value(300),
+      progress: new Animated.Value(1),
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 300 }],
+    });
+  });
+});

Diff for: example/__tests__/components-rendering.spec.tsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import { View } from 'react-native';
+import {
+  KeyboardControllerView,
+  KeyboardProvider,
+} from 'react-native-keyboard-controller';
+import { render } from '@testing-library/react-native';
+
+function KeyboardControllerViewTest() {
+  return <KeyboardControllerView statusBarTranslucent />;
+}
+
+function KeyboardProviderTest() {
+  return (
+    <KeyboardProvider statusBarTranslucent>
+      <View style={{ width: 20, height: 20, backgroundColor: 'black' }} />
+    </KeyboardProvider>
+  );
+}
+
+describe('components rendering', () => {
+  it('should render `KeyboardControllerView`', () => {
+    expect(render(<KeyboardControllerViewTest />)).toMatchSnapshot();
+  });
+
+  it('should render `KeyboardProvider`', () => {
+    expect(render(<KeyboardProviderTest />)).toMatchSnapshot();
+  });
+});

Diff for: example/__tests__/keyboard-handler.spec.tsx

@@ -0,0 +1,88 @@
+jest.unmock('react-native-reanimated');
+jest.useFakeTimers();
+
+global.ReanimatedDataMock = {
+  now: () => 0,
+};
+
+import '@testing-library/jest-native/extend-expect';
+import React from 'react';
+import Reanimated, {
+  useAnimatedStyle,
+  useSharedValue,
+} from 'react-native-reanimated';
+import { render } from '@testing-library/react-native';
+
+import {
+  KeyboardHandler,
+  NativeEvent,
+  useKeyboardHandler,
+} from 'react-native-keyboard-controller';
+
+function TestComponent() {
+  const height = useSharedValue(0);
+  useKeyboardHandler(
+    {
+      onStart: (e) => {
+        'worklet';
+        height.value = e.height;
+      },
+      onMove: (e) => {
+        'worklet';
+        height.value = e.height;
+      },
+      onEnd: (e) => {
+        'worklet';
+        height.value = e.height;
+      },
+    },
+    []
+  );
+  const style = useAnimatedStyle(
+    () => ({
+      width: 20,
+      height: 20,
+      backgroundColor: 'red',
+      transform: [{ translateY: height.value }],
+    }),
+    []
+  );
+
+  return <Reanimated.View testID="view" style={style} />;
+}
+
+describe('keyboard handler specification', () => {
+  it('should execute all handlers and change corresponding style properties', () => {
+    let handlers: KeyboardHandler = {};
+    (useKeyboardHandler as jest.Mock).mockImplementation(
+      (handler) => (handlers = handler)
+    );
+    const onStart = (e: NativeEvent) => handlers.onStart?.(e);
+    const onMove = (e: NativeEvent) => handlers.onMove?.(e);
+    const onEnd = (e: NativeEvent) => handlers.onEnd?.(e);
+    const { getByTestId } = render(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({ transform: [{ translateY: 0 }] });
+
+    onStart({ height: 100, progress: 1 });
+    jest.advanceTimersByTime(100);
+
+    expect(getByTestId('view')).toHaveAnimatedStyle({
+      transform: [{ translateY: 100 }],
+    });
+
+    onMove({ height: 20, progress: 0.2 });
+    jest.advanceTimersByTime(100);
+
+    expect(getByTestId('view')).toHaveAnimatedStyle({
+      transform: [{ translateY: 20 }],
+    });
+
+    onEnd({ height: 100, progress: 1 });
+    jest.advanceTimersByTime(100);
+
+    expect(getByTestId('view')).toHaveAnimatedStyle({
+      transform: [{ translateY: 100 }],
+    });
+  });
+});

Diff for: example/__tests__/reanimated.spec.tsx

@@ -0,0 +1,49 @@
+import '@testing-library/jest-native/extend-expect';
+import React from 'react';
+import Reanimated, { useAnimatedStyle } from 'react-native-reanimated';
+import { render } from '@testing-library/react-native';
+
+import { useReanimatedKeyboardAnimation } from 'react-native-keyboard-controller';
+
+function TestComponent() {
+  const { height } = useReanimatedKeyboardAnimation();
+  const style = useAnimatedStyle(
+    () => ({
+      width: 20,
+      height: 20,
+      backgroundColor: 'red',
+      transform: [{ translateY: height.value }],
+    }),
+    []
+  );
+
+  return <Reanimated.View testID="view" style={style} />;
+}
+
+describe('basic keyboard interaction', () => {
+  it('should have different styles depends on position', () => {
+    const { getByTestId, update } = render(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({ transform: [{ translateY: 0 }] });
+
+    (useReanimatedKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: { value: 150 },
+      progress: { progress: 0.5 },
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 150 }],
+    });
+
+    (useReanimatedKeyboardAnimation as jest.Mock).mockReturnValue({
+      height: { value: 300 },
+      progress: { progress: 1 },
+    });
+    update(<TestComponent />);
+
+    expect(getByTestId('view')).toHaveStyle({
+      transform: [{ translateY: 300 }],
+    });
+  });
+});