Fix java doc, add kotlin docs

Author: michalchudziak

docs/JAVA.md

@@ -121,7 +121,7 @@ Examples:
 
 ```java
   List<ReactPackage> packages = new PackageList(this).getPackages();
-  HashMap<String, Object> options = new HashMap<>();
+  HashMap<String, Object> options = new HashMap<String, Any>();
   options.put("packages", packages);
   options.put("mainModuleName", "example/index");
 

docs/KOTLIN.md

@@ -0,0 +1,274 @@
+## Kotlin
+
+React Native Brownfield provides first-class support for Kotlin.
+
+### Linking
+
+The library is meant to work with [auto linking](https://github.com/react-native-community/cli/blob/master/docs/autolinking.md). In case you can't use this feature, please check out the following options:
+
+<details>
+<summary>react-native link</summary>
+Run the following command in your terminal:
+
+```bash
+  react-native link @callstack/react-native-brownfield
+```
+</details>
+
+<details>
+<summary>Manually link the library on Android</summary>
+
+#### `android/settings.gradle`
+```groovy
+include ':react-native-brownfield'
+project(':react-native-brownfield').projectDir = new File(rootProject.projectDir, '../node_modules/@callstack/react-native-brownfield/android')
+```
+
+#### `android/app/build.gradle`
+```groovy
+dependencies {
+   ...
+   implementation project(':react-native-brownfield')
+}
+```
+
+#### `android/app/src/main/.../MainApplication.kt`
+On top, where imports are:
+
+```kotlin
+import com.callstack.reactnativebrownfield.ReactNativeBrownfieldPackage
+```
+
+Add the `ReactNativeBrownfieldPackage` class to your list of exported packages.
+
+```kotlin
+val packages = listOf<ReactPackage>(MainReactPackage(), ReactNativeBrownfieldPackage()) 
+```
+</details>
+
+### API Reference
+
+#### ReactNativeBrownfield
+
+You can import the object from:
+
+```java
+  import com.callstack.reactnativebrownfield.ReactNativeBrownfield
+```
+
+---
+
+**Statics:**
+
+`initialize`
+
+A function used to initialize a React Native Brownfield singleton. Keep in mind that it **doesn't** load React Native bundle.
+
+Params:
+
+| Param                   | Required | Type                 | Description                                               |
+| ----------------------- | -------- | -------------------- | --------------------------------------------------------- |
+| application             | Yes      | Application          | Main application.                                         |
+| rnHost                  | No*      | ReactNativeHost      | An instance of [ReactNativeHost](https://bit.ly/2ZnwgnA). |
+| packages                | No*      | List<ReactPackage>   | List of your React Native Native modules.                 |
+| options                 | No*      | HashMap<String, Any> | Map of initial options. __Options listed below.__         |
+
+> * - Those fields aren't itself required, but at least one of them is. See examples below.
+
+Available options:
+- useDeveloperSupport: Boolean - Flag to use dev support.
+- packages: List<ReactPackage> - List of your React Native Native modules.
+- mainModuleName: String - Path to react native entry file.
+
+Examples:
+
+```kotlin
+  val mReactNativeHost = object : ReactNativeHost(application) {
+    override fun getUseDeveloperSupport(): Boolean {
+      return BuildConfig.DEBUG
+    }
+
+    override fun getPackages(): List<ReactPackage> {
+      return listOf<ReactPackage>(PackageList(this).getPackages())
+    }
+
+    override fun getJSMainModuleName(): String {
+      return "index"
+    }
+  }
+
+  ReactNativeBrownfield.initialize(this, mReactNativeHost)
+```
+
+```kotlin
+  val packages = PackageList(this).getPackages()
+
+  ReactNativeBrownfield.initialize(this, packages)
+```
+
+```kotlin
+  val packages = PackageList(this).getPackages()
+  val options = hashMapOf<String, Any>(
+    "packages" to packages, 
+    "mainModuleName" to "example/index"
+  )
+
+  ReactNativeBrownfield.initialize(this, options)
+```
+
+---
+
+`shared`
+
+A singleton that keeps an instance of ReactNativeBrownfield object.
+
+Examples: 
+
+```kotlin
+  ReactNativeBrownfield.shared
+```
+
+---
+
+**Properties:**
+
+| Property        | Type            | Default        | Description                                               |
+| --------------- | --------------- | -------------- | --------------------------------------------------------- |
+| reactNativeHost | ReactNativeHost | null           | An instance of [ReactNativeHost](https://bit.ly/2ZnwgnA). |
+
+---
+
+**Methods:**
+
+`startReactNative`
+
+Starts React Native, produces an instance of a bridge. You can use it to initialize React Native in your app.
+
+Params:
+
+| Param                   | Required | Type          | Description                                           |
+| ----------------------- | -------- | ------------- | ----------------------------------------------------- |
+| startReactNative        | No       | (loaded: boolean) -> Unit | Callback invoked after JS bundle is fully loaded.     |
+
+Examples:
+
+```kotlin
+    ReactNativeBrownfield.shared.startReactNative()
+```
+
+```kotlin
+    ReactNativeBrownfield.shared.startReactNative {
+        Log.d("loaded", "React Native loaded");
+    }
+```
+
+---
+
+#### ReactNativeActivity
+
+An activity rendering `ReactRootView` with a given module name.  It automatically uses an instance of a bridge created in `startReactNative` method. It works well with exposed JavaScript module. All the lifecycles are proxied to `ReactInstanceManager`.
+
+```kotlin
+  import com.callstack.reactnativebrownfield.ReactNativeActivity
+```
+
+---
+
+**Statics:**
+
+`createReactActivityIntent`
+
+Creates an Intent with ReactNativeActivity, you can use it as a parameter in the `startActivity` method in order to push a new activity with embedded React Native.
+
+Params:
+
+| Param                   | Required | Type                 | Description                                                 |
+| ----------------------- | -------- | ------------------------------------------- | ----------------------------------------------------------- |
+| context                 | Yes      | Context                                     | Application context.                                        |
+| moduleName              | Yes      | String                                      | Name of React Native component registered to `AppRegistry`. |
+| initialProps            | No       | Bundle || HashMap<String, *> || ReadableMap | Initial properties to be passed to React Native component.  |
+
+Examples: 
+
+```kotlin
+  ReactNativeActivity.createReactActivityIntent(context, "ReactNative")
+```
+
+```kotlin
+  val bundle = Bundle()
+  bundle.putInt("score", 12)
+
+  ReactNativeActivity.createReactActivityIntent(context, "ReactNative", bundle)
+```
+
+```kotlin
+  val map =  hasnMapOf<String, *>("score" to 12)
+
+  ReactNativeActivity.createReactActivityIntent(context, "ReactNative", map)
+```
+
+```kotlin
+  val map = WritableMap();
+  map.putInt("score", 12);
+
+  ReactNativeActivity.createReactActivityIntent(context, "ReactNative", map)
+```
+
+---
+
+#### ReactNativeFragment
+
+An fragment rendering `ReactRootView` with a given module name.  It automatically uses an instance of a bridge created in `startReactNative` method. It works well with exposed JavaScript module. All the lifecycles are proxied to `ReactInstanceManager`. It's the simplest way to embed React Native into your navigation stack.
+
+```kotlin
+  import com.callstack.reactnativebrownfield.ReactNativeActivity
+```
+
+---
+
+**Statics:**
+
+`createReactNativeFragment`
+
+Creates a Fragment with ReactNativeActivity, you can use it as a parameter in the `startActivity` method in order to push a new activity with embedded React Native.
+
+Params:
+
+| Param                   | Required | Type                 | Description                                                 |
+| ----------------------- | -------- | ------------------------------------------- | ----------------------------------------------------------- |
+| moduleName              | Yes      | String                                      | Name of React Native component registered to `AppRegistry`. |
+| initialProps            | No       | Bundle || HashMap<String, *> || ReadableMap | Initial properties to be passed to React Native component.  |
+
+Examples: 
+
+```kotlin
+  ReactNativeActivity.createReactNativeFragment("ReactNative")
+```
+
+```kotlin
+  val bundle = new Bundle()
+  bundle.putInt("score", 12)
+
+  ReactNativeActivity.createReactNativeFragment("ReactNative", bundle)
+```
+
+```kotlin
+  val map = hashMapOf<String, *>("score" to 12)
+
+  ReactNativeActivity.createReactNativeFragment("ReactNative", map)
+```
+
+```kotlin
+  val map = WritableMap()
+  map.putInt("score", 12)
+
+  ReactNativeActivity.createReactActivityIntent(context, "ReactNative", map)
+```
+
+---
+
+### Linking
+
+You can find an example app [here](../example/java).
+
+