Merge branch 'master' into master

Author: yershalom

.gitignore

@@ -34,8 +34,18 @@ local.properties
 node_modules/
 npm-debug.log
 
+# npm
+package-lock.json
+
+# yarn
+yarn.lock
+yarn-error.log
+
 # BUCK
 buck-out/
 \.buckd/
 android/app/libs
 android/keystores/debug.keystore
+
+# Bundle artifact
+*.jsbundle

.npmignore

@@ -1,5 +1,5 @@
-example
-real-life-example
+playground
+e2e
 logos
 ./index.ios.js
 ./index.android.js

PROPS.md

@@ -102,6 +102,15 @@ horizontalOnly={true}
 
 Optional, whether the view should be locked to horizontal movement only. Default `false`.
 
+#### `startOnFront` (boolean) **[Android Only]**
+
+```jsx
+startOnFront
+```
+
+Optional, whether the view should call `view.bringToFront()` when the view is first loaded.
+*Usually using zIndex does the trick. Use this in cases it doesn't*
+
 #### `verticalOnly` (boolean)
 
 ```jsx
@@ -169,6 +178,7 @@ Optional, a function called whenever the user starts or stops dragging the view.
 * `state` - `start` or `end`, whether the user started or finished dragging.
 * `x` - The horizontal position of the view (relative to the center).
 * `y` - The vertical position of the view (relative to the center).
+* `targetSnapPointId` - For `end` state, the string `id` of the target point in the `snapPoints` array (assuming it was provided).
 
 #### `onAlert` (function)
 

README.md

@@ -89,7 +89,7 @@ To see the library in action you have several options:
 To run the example, clone the repo and run from the root folder:<br>
 ```
   cd real-life-example
-  npm install
+  yarn
   react-native run-ios
 ```
 
@@ -169,6 +169,12 @@ alertAreas={[{id: 'myArea', influenceArea: {top: 0}}]}
 horizontalOnly={true}
 ```
 
+* [`startOnFront`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#startOnFront-boolean) - [ANDROID ONLY] whether the view should call `bringToFront`
+
+```jsx
+startOnFront
+```
+
 * [`verticalOnly`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#verticalonly-boolean) - whether the view should be locked to vertical movement only
 
 ```jsx
@@ -279,7 +285,7 @@ Takes a single argument, which is a params object containing:
 ##### `changePosition(params)` - used to imperatively set the view's position
 
 ```jsx
-instance.setPosition({x: 120, y: 40});
+instance.changePosition({x: 120, y: 40});
 ```
 
 Takes a single argument, which is a params object containing:
@@ -288,6 +294,12 @@ Takes a single argument, which is a params object containing:
 
 <br>
 
+##### `bringToFront()` - bring view to front (Android Only)
+
+```jsx
+instance.bringToFront();
+```
+
 ## Animating other views according to `Interactable.View` position
 
 This library is integrated with the [Animated](https://facebook.github.io/react-native/docs/animated.html) library in order to support performant animations of other views according to the movement of the `Interactable.View`.

android

@@ -0,0 +1 @@
+lib/android

e2e/firstTest.spec.js

@@ -0,0 +1,14 @@
+describe('Example', () => {
+  beforeEach(async () => {
+    await device.reloadReactNative();
+  });
+
+  it('should show Overview screen', async () => {
+    await expect(element(by.id('Overview'))).toBeVisible();
+  });
+
+  it('Chat Heads is clickable', async () => {
+    await element(by.text('Chat Heads')).tap();
+  });
+
+})

e2e/init.js

@@ -0,0 +1,19 @@
+const detox = require('detox');
+const config = require('../package.json').detox;
+const adapter = require('detox/runners/mocha/adapter');
+
+before(async () => {
+  await detox.init(config);
+});
+
+beforeEach(async function () {
+  await adapter.beforeEach(this);
+});
+
+afterEach(async function () {
+  await adapter.afterEach(this);
+});
+
+after(async () => {
+  await detox.cleanup();
+});

e2e/mocha.opts

@@ -0,0 +1 @@
+--recursive --timeout 120000 --bail