feat: add support for bob.config.js and update docs

Author: satya164

README.md

@@ -6,11 +6,11 @@
 
 The CLI can build code for following targets:
 
-- Android AAR files
 - Generic CommonJS build
 - ES modules build for bundlers such as webpack
 - Flow definitions (copies .js files to .flow files)
-- TypeScript definitions (uses tsc to generate declaration files)
+- TypeScript definitions (uses `tsc` to generate declaration files)
+- Android AAR files
 
 ## Why?
 
@@ -72,6 +72,12 @@ To configure your project manually, follow these steps:
    ]
    ```
 
+   Make sure to change specify correct files according to the targets you have enabled.
+
+   It's usually good to point to your source code with the `react-native` field to make debugging easier. Metro already supports compiling a lot of new syntaxes including JSX, Flow and TypeScript and it will use this field if present.
+
+   If you're building TypeScript definition files, also make sure that the `types` field points to a correct path. Depending on the project configuration, the path can be different for you than the example snippet.
+
 1. Add the output directory to `.gitignore` and `.eslintignore`
 
    ```gitignore
@@ -87,6 +93,75 @@ To configure your project manually, follow these steps:
 
 And we're done 🎉
 
+## Options
+
+The options can be specified in the `package.json` file under the `@react-native-community/bob` property, or in a `bob.config.js` file in your project directory.
+
+### `source`
+
+The name of the folder with the source code which should be compiled. The folder should include an `index` file.
+
+### `output`
+
+The name of the folder where the compiled files should be output to. It will contain separate folder for each target.
+
+### `targets`
+
+Various targets to build for. The available targets are:
+
+#### `commonjs`
+
+Enable compiling source files with Babel and use commonjs module system.
+
+This is useful for running the code in Node (SSR, tests etc.). The output file should be referenced in the `main` field of `package.json`.
+
+By default, this will compile the code for last 2 versions of modern browsers, as well as JSX. It'll also strip TypeScript and Flow annotations. To customize the babel config used, you can pass the [`configFile`](https://babeljs.io/docs/en/options#configfile) or [`babelrc`](https://babeljs.io/docs/en/options#babelrc) options.
+
+If your source code is written in [Flow](http://www.typescriptlang.org/), You can also specify the `copyFlow` option to copy the source files as `.js.flow` to the output folder. If the `main` entry in `package.json` points to the `index` file in the output folder, the flow type checker will pick these files up to use for type definitions.
+
+Example:
+
+```json
+["commonjs", { "babelrc": true, "copyFlow": true }]
+```
+
+#### `module`
+
+Enable compiling source files with Babel and use ES module system. This is essentially same as the `commonjs` target and accepts the same options, but leaves the `import`/`export` statements in your code.
+
+This is useful for bundlers which understand ES modules and can tree-shake. The output file should be referenced in the `module` field of `package.json`.
+
+Example:
+
+```json
+["commonjs", { "babelrc": true, "copyFlow": true }]
+```
+
+#### `typescript`
+
+Enable generating type definitions with `tsc` if your source code is written in [TypeScript](http://www.typescriptlang.org/).
+
+By default, it'll use the `tsconfig.json` file in your project root. If you want to use a different config, you can specify it using the `project` option.
+
+Example:
+
+```json
+["typescript", { "project": "tsconfig.build.json" }]
+```
+
+#### `aar`
+
+Enable assembling Android AAR files for a library for React Native modules including native code.
+
+It's also possible to convert the AAR with the `reverseJetify` option to use the [Android support Library](https://developer.android.com/topic/libraries/support-library) using the [`jetifier`](https://www.npmjs.com/package/jetifier) package if your package is using [AndroidX](https://developer.android.com/jetpack/androidx). This is useful to publish packages for older projects which haven't migrated to AndroidX.
+
+You can also specify the `androidPath` (defaults to `android`) to specify the `android` directory and `androidBundleName` (defaults to `android.aar`) to customize the name of AAR file.
+Example:
+
+```json
+["aar", { "reverseJetify": true }]
+```
+
 ## LICENSE
 
 MIT

src/cli.ts

@@ -16,7 +16,9 @@ import { Options } from './types';
 const { name } = require('../package.json');
 
 const root = process.cwd();
-const explorer = cosmiconfigSync(name);
+const explorer = cosmiconfigSync(name, {
+  searchPlaces: ['package.json', `bob.config.js`],
+});
 
 const FLOW_PRGAMA_REGEX = /\*?\s*@(flow)\b/m;