This PR adds support for setting stack root with multiple children, which is to be expected as stack can be initialised with multiple children.
Closes #4441

Initialize and pass mainWindow to commandsHandler

* Fixes overlays level - #4145

* Disable overlay unmounts when dismissed

* Fixes e2e

* Handle pop and dismissModal rejections - #3914

* Added e2e

* Update TextScreen.js

* bind viewController to presenters using bindViewController

* Merge options to the specific provided layout

* Moved custom titleView creation to RNNRootViewController

* Moved default options to presenters, moved options applying to presenters, resolved options in RNNOptionsResolver

* Fixes merge options

* Fixes topBar transition on pop

* Prevent titleView creation when react titleView exists

* Fixed unit tests

* Options refactor WIP

* Detach applied options from DTO - WIP

* Added option types and option parsers

* Unit test passes

* Added presenters for each parent type

* Fixes unit tests

* Rename StringParam to Text, changed bottomTabs.drawBehind and topBar.drawBehind default to false

* set layout.backgroundColor default to white

* Added unit tests for RNNViewControllerPresenter

* Set layout.backgroundColor default nil

* Fixes buttons color missing options

* Fix unit test

* fix button color parsing

* Moved default options to presenters

* default options fixes

* Fixes e2e

* Fixes unit tests

* Resolve child options on childWillAppear

* Recrusively setDefaultOptions on rootViewController tree

* Fixes default values

* Fixes tests

* Detached options from presenters, design improvments for LayoutProtocol

* fixes topBar.background.clipToBounds

* Fixes e2e

* Fixes unit tests

* Homogeneous constructors for parent and child view controllers

* Handle parent options merging with children in optionsResolver

* Fix topBar.background.clipToBounds

* Removed unnecessary options merging

* Fixes shared element transition

* Fixed sideMenu inside bottomTabs

* Renamed RNNRootViewProtocol to RNNParentProtocol and added RNNLeafProtocol

* fixed unit test

* Better options resolving

* Revert "Revert "Refactor options (#3962)""

This reverts commit c266041b85.

* Revert "Revert "Fixes shared element transition""

This reverts commit 005f039f7c.

* Revert "Revert "Adresses #3963 - stack options applied to children""

This reverts commit be09cb0e9a.

* Revert "Revert "Added unit test coverage for RNNNavigationController""

This reverts commit 199cebd221.

* Merge stack options

This commits adds support for merging stack options by the stack’s componentId

Also while I’m at it - use fade animation when setting root

* Merge BottomTabs options

Merge BottomTabs options when calling mergeOptions with BottomTabs componentId

* Fixes options

This reverts commit 29faa36ddf.

* Refactred options and added tests

* fixes tabBarItem

* tests fix

* Better namings

* Clean overlay creation

* Refactor peek and pop

* Rollback some XCode stuff

* Added tests for touchablePreview event

* Also fixing searchbarcancelpressed event

* Making sure tests work

* Closes #3787

* Merge options only when viewController conforms to RNNRootViewProtocol

* better practice

* Fixes e2e

mergeOptions support for commands

* Refactored modals

* Added unit tests for modals

* fixes unknown modal dismissing and added tests

This reverts commit e1ee3d5f99.

This reverts commit 2d879ccd0c.

This reverts commit 4c519acae8.

* Refactor peek and pop

* Rollback some XCode stuff

* Added tests for touchablePreview event

* Also fixing searchbarcancelpressed event

[BREAKING] Call Navigation.events().bindComponent(this) to listen to lifecycle events

This commit introduces breaking changes to the way components listen to RNN events.


Background

Up until now, components could handle navigation events by implemented a set of callbacks:
* componentDidAppear
* componentDidDisappear
* onNavigationButtonPressed
* onSearchBarUpdated
* onSearchBarCancelPressed

While this worked fine for the most part, this was completely broken for HOCs as RNN invoked these methods only on the registered component (top most HOC), leaving it to the user to propagate these events down the HOC chain. See the discussion in #1642 for more details.


Solution

In order to support HOC use case, we're introducing a new api which will let any Component bind itself to receive navigation events:

```js
class LifecycleScreen extends Component {
  constructor(props) {
    super(props);
    this.subscription = Navigation.events().bindComponent(this);
  }

  componentWillUnmount() {
    // The subscription is removed automatically when components unmount, but they can be explicitly removed as well by calling `this.subscription.remove(); `
  }
}
```

It's still the users responsibility to propagate the `componentId` down the HOC chain, but by binding a component to RNN, it will be able to handle events as expected. Multiple components can be bound for the same `componentId`.


Consolidate event names

* onNavigationButtonPressed -> navigationButtonPressed
* onSearchBarUpdated -> searchBarUpdated
* onSearchBarCancelPressed -> searchBarCancelPressed

* V2: Peek and pop

* Add event when preview is dismissed in non commit mode

* tslint

* Refactor playground. Document preview api

* Added width prop

* Implement hybrid push/preview button

* Fixing small linting errors

* Work in progress

* Arbitary changes

* Improvements on API

* Cleanup RNNSplitViewController, allow mergeOptions

* Added documentation and better playground example

* Adding tests for coverage

* Find out why this test is failing.

* Only show split view on iOS

* Add test back in

* setRoot({root:{}})

* support setRoot with root, modals, overlays

* Update setRoot calls in playground app to new api

* Update setRoot on Android to new api

currently only supporting root node

* Update setRoot on iOS to new api

* fix unit tests