Update our Master with Wix Master

.gitignore

@@ -28,14 +28,33 @@ project.xcworkspace
 .idea
 .gradle
 local.properties
+android/.settings/*
+android/.project
+lib/android/.project
+playground/android/app/.project
+playground/android/.project
 
 # node.js
 #
 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
+*.keystore
+!debug.keystore
+
+# Bundle artifact
+*.jsbundle
+
+# CocoaPods
+playground/ios/Pods

.npmignore

@@ -1,8 +1,12 @@
-example
-real-life-example
+.ghp/
+
+
+playground
+e2e
 logos
 ./index.ios.js
 ./index.android.js
+./rn-cli.config.js
 
 #################
 # from .gitignore:
@@ -83,6 +87,9 @@ fabric.properties
 #
 # gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
 
+#Cocoapods
+# *.podspec
+
 ## Build generated
 ios/build/
 ios/DerivedData/
@@ -152,6 +159,7 @@ android/bin/
 android/gen/
 android/out/
 android/app/build/
+lib/android/gradle/
 
 # Gradle files
 android/.gradle/

Interactable.podspec

@@ -10,7 +10,7 @@ Pod::Spec.new do |s|
   s.homepage     = "https://github.com/wix/react-native-interactable"
 
   s.license      = "MIT"
-  s.authors      = { "Tal Kol" => "talkol@gmail.com" }
+  s.authors      = package["author"]
   s.platform     = :ios, "7.0"
 
   s.source       = { :git => "https://github.com/wix/react-native-interactable.git" }

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
@@ -131,7 +140,18 @@ Optional, an object providing limits to movement relative to the view's center (
 onSnap={this.onDrawerSnap}
 ```
 
-Optional, a function called whenever the view snaps to a `snapPoints` point (after being dragged). Example for [drawer](https://github.com/wix/react-native-interactable/blob/b72eff0649b48dd50548593e5ecfe4c42b026a02/example/src/IconDrawer.js#L63). When the function is called, an event object is passed as argument, containing the following properties:
+Optional, a function called whenever the view finishes snapping to a `snapPoints` point (after being dragged). Example for [drawer](https://github.com/wix/react-native-interactable/blob/b72eff0649b48dd50548593e5ecfe4c42b026a02/example/src/IconDrawer.js#L63). When the function is called, an event object is passed as argument, containing the following properties:
+
+* `index` - The zero-based index of the point in the `snapPoints` array.
+* `id` - The string `id` of the point in the `snapPoints` array (assuming it was provided).
+
+#### `onSnapStart` (function)
+
+```jsx
+onSnapStart={this.onDrawerSnapStart}
+```
+
+Optional, a function called whenever the view starts snapping to a `snapPoints` point (after being dragged). When the function is called, an event object is passed as argument, containing the following properties:
 
 * `index` - The zero-based index of the point in the `snapPoints` array.
 * `id` - The string `id` of the point in the `snapPoints` array (assuming it was provided).
@@ -158,7 +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). Otherwise, empty string.
+* `targetSnapPointId` - For `end` state, the string `id` of the target point in the `snapPoints` array (assuming it was provided).
 
 #### `onAlert` (function)
 

README.md

@@ -8,10 +8,13 @@
 
 <br>
 
+[![NPM Version](https://img.shields.io/npm/v/react-native-interactable.svg?style=flat)](https://www.npmjs.com/package/react-native-interactable)
+[![Build Status](https://img.shields.io/jenkins/s/http/jenkins-oss.wixpress.com:8080/job/multi-react-native-interactable-master.svg)](https://jenkins-oss.wixpress.com/job/multi-react-native-interactable-master/)
+[![NPM Downloads](https://img.shields.io/npm/dm/react-native-interactable.svg?style=flat)](https://www.npmjs.com/package/react-native-interactable)
 
 ### LOOKING FOR A MAINTAINER
 
-We love this project, but currently we don’t have enough time to work on it. So we are looking for a maintainer. If you have enough time and knowledge and want to become one - please let us know (levv@wix.com, sergeyi@wix.com)
+We love this project, but currently we don’t have enough time to work on it. So we are looking for a maintainer. If you have enough time and knowledge and want to become one - please let us know (levv@wix.com)
 
 <br>
 
@@ -80,36 +83,18 @@ pod 'Interactable', :path => '../node_modules/react-native-interactable'
 
 ## Example
 
-To see the library in action you have several options:
+<br><br>The [playground](https://github.com/wix/react-native-interactable/tree/master/playground) project has few use-cases implemented like: *swipeable card*, *drawer*, *collapsible header* and *chat heads* under the "Basic examples" section. It's simplistic but easy to learn from.
+<br><br>Under the "Real life example" you'll find more complex demonstrations. They're harder to learn from, but they're cool to watch. More info about the [UX inspirations](https://github.com/wix/react-native-interactable/blob/master/UX-INSPIRATIONS.md) for the demo app.
 
-* **Build and run the example project on your computer**
-<br><br>The [example](example) project has 4 use-cases implemented: *swipeable card*, *drawer*, *collapsible header* and *chat heads*. It's simplistic but easy to learn from.
-<br><br>*Note: It's recommended to experience it on a [real device](http://facebook.github.io/react-native/docs/running-on-device.html) and not on a simulator. The simulator has poor performance so the framerate isn't like the real thing.*
-<br><br>
-To run the example, clone the repo and run from the root folder:<br>
+* **Build and run the example project**
+To see the library in action, clone the repo and run the playground from the root folder:<br>
 ```
-  cd real-life-example
-  npm install
-  react-native run-ios
+  npm start
+  npm run ios
 ```
-
-* **Install and run the demo app from the App Store/Google Play on your phone**
-<br><br>If you don't want to mess with building yourself, you can play with a pre-built demo on your phone.
-<br><br>Download from [Apple App Store (iOS)](https://itunes.apple.com/us/app/react-native-interactions/id1209875831?ls=1&mt=8)<br>Download from [Google Play Store (Android)](https://play.google.com/store/apps/details?id=com.wix.interactions&hl=en)
-<br><br><img src="http://i.imgur.com/VpSsavS.gif" width=200 />&nbsp;&nbsp;&nbsp;&nbsp;<img src="http://i.imgur.com/O7ulJa1.gif" width=200 />&nbsp;&nbsp;&nbsp;&nbsp;<img src="http://i.imgur.com/2mrUNIM.gif" width=200 />
-
-* **Build and run the demo app on your computer**
-<br><br>The [demo app](real-life-example) contains more complex demonstrations than the [example](example) project. They're harder to learn from, but they're cool to watch. More info about the [UX inspirations](https://github.com/wix/react-native-interactable/blob/master/UX-INSPIRATIONS.md) for the demo app.
 <br><br>*Note: It's recommended to experience it on a [real device](http://facebook.github.io/react-native/docs/running-on-device.html) and not on a simulator. The simulator has poor performance so the framerate isn't like the real thing.*
 <br><br>
-To run the demo app, clone the repo and run from the root folder:
-```
-  cd real-life-example
-  npm install
-  react-native run-ios
-```
 
-<br>
 
 ## Usage
 
@@ -169,6 +154,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
@@ -181,12 +172,18 @@ verticalOnly={true}
 boundaries={{left: -100, right: 100, bounce: 0.5}}
 ```
 
-* [`onSnap`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#onsnap-function) - a function called whenever the view snaps to a `snapPoints` point (after dragging)
+* [`onSnap`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#onsnap-function) - a function called whenever the view finishes snapping to a `snapPoints` point (after dragging)
 
 ```jsx
 onSnap={this.onDrawerSnap}
 ```
 
+* [`onSnapStart`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#onsnapstart-function) - a function called whenever the view starts snapping to a `snapPoints` point (after dragging)
+
+```jsx
+onSnapStart={this.onDrawerSnapStart}
+```
+
 * [`onStop`](https://github.com/wix/react-native-interactable/blob/master/PROPS.md#onstop-function) - a function called whenever the interaction stops (views freeze momentarily)
 
 ```jsx
@@ -273,7 +270,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:
@@ -282,6 +279,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