See https://github.com/wix/react-native-navigation/issues/1446#issuecomment-319858633

Fixes #1609

* update docs for ios drawer animations in top-level-api section

* update docs for ios drawer animations in top-level-api section

https://github.com/wix/react-native-navigation/issues/1446

To prevent race condition happening when the event was sent before the screen was mounted

* Update top-level-api.md (Added forgotten styles)

Added forgotten drawer style props.

* Added iOS only words to style objects

fixes #1586 #1585 #1584

* added method for getting the currently visible screen ID. Can be useful to decide if logic should be applied according to screen visibility, for example: set buttons/title dynamically, or even determine that you don’t need to show the same screen again if it’s the current one that’s showing

* Implement getCurrentlyVisibleScreenId on Android

Can be used statically:
Navigation.getCurrentlyVisibleScreenId() - returns the unique screen
instance id

With a navigator instance:
await this.props.navigator.screenIsCurrentlyVisible() - resolves a
promise that checks if the current screen is visible

* Remove extra line-break to fix rendering list in doc site.

* Add In-App Notification

* Add screen visibility listener which can be registered globally

API
new ScreenVisibilityListener({
    willAppear: ({screen, timestamp}) => console.log(`Displaying screen ${screen}`),
    didAppear: ({screen, timestamp}) => console.log(`Screen ${screen} displayed in ${Date.now() - timestamp} millis`)
  }).register();

todo
* Add timestamp to modal, resetTo
* implement unregister
* implement iOS

* Add global screen visibility listener to example app

* Think I better assign a value to emitter

* Send timestamp in resetTo

* Moved listener to library, it can be deleted from the app

* Add push and resetTo buttons to pushed screens

* Send appear/disappear events after animation ends

* Pass pop timestamp from js

* Send timestamp in popToRoot

* Add popToRoot button in push screen

* Add few navigation buttons to modal screen

* Pass timestamp to tabs

relevant only to first/initial tab

* Update timestamp when navigating between BottomTabs

* Send screen visible events after modal dismiss

* log willDisappear and didDisappear

* Report both start and end timestamps

* Implement unregister

* Send NavigationType parameter in visibilityEvent

This indicates the type of the navigation command that triggered the visibility change

* Rename pushInitialScreen to more explicit name

* Fix duplicate initialScreen visibility events

* Update screen visibility log statement

* Show popToRoot in modal screen only if screens were pushed

* implement global screen event for iOS

* fix lint issues

Fix url to the example demo. Please, only pull after accepting this PR: https://github.com/wix/react-native/pull/2

Add demo for example app.

Mention that the GIF demo is the real Wix app and remove the old example demo until we have an updated version.

relates to #1555

Usage:
    navBarCustomView: 'example.CustomTopBar', // registered component name
    navBarComponentAlignment: 'center' // 'center'/'fill'

* add v2 link to readme

* Update README.md

* Add font family support on bottom tabs

* import missing classes

* import missing class

* update document

* Support customize icon for left nav button in android

* Add navBar navBarTextFontSize support for android

This reverts commit 36d2c7e35c.

This uses the proper methods for instantiating the initial view on iOS.
By utilizing these methods, we can stand up the initial view controller
from the storyboard.

See also:
https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW41

[iOS] Added ability to set static(root) background image

Currently startApp is called from global context which results in the
app being launched when headlessJs tasks run in the background.
In order to support this use case, while not breaking existing users,
this commit adds two mechanisms which should help users detrmine if
the native Activity is running and startApp can be called safely.

1. RNN.appLaunched event is emitted is SplashActivity starts and react
   context has already been created. This is the use case of openeing
   the app while headless js task was started or has just finished and
   react context is in a "pasued" state.

2. Navigation.isAppLaunched() convenience method has been added.
   It returns a promise which when resolved, indicates if the app
   is launched and we should show the ui or not.

Usage

import {Navigation, NativeEventsReceiver} from 'react-native-navigation';

Promise.resolve(Navigation.isAppLaunched())
  .then(appLaunched => {
    if (appLaunched) {
      startApp();
    } else {
      new NativeEventsReceiver().appLaunched(startApp);
    }
  });

function startApp() {
  Navigation.startTabBasedApp({ ... });
}

This fixes issues with other React Native views which rely on the view controller hierarchy.

* Move logic for tap background to dismiss out of background color view

This allows for tapping the background without setting a color here, meaning this feature can be enabled with one less view in the view hierarchy

* Only allow taps on views that aren't the React view

This allows for taps on any background view, visual effect view, color tint view, etc, but not on the content.