Feature: add object shorthand for mapStateToProps in connect

.gitignore

@@ -12,3 +12,5 @@ website/build/
 website/yarn.lock
 website/node_modules
 website/i18n/*
+
+.DS_Store

docs/api/connect.md

@@ -27,7 +27,7 @@ The returns of `mapStateToProps` and `mapDispatchToProps` are referred to intern
 
 `connect` accepts four different parameters, all optional. By convention, they are called:
 
-1. `mapStateToProps?: Function`
+1. `mapStateToProps?: Function | Object`
 2. `mapDispatchToProps?: Function | Object`
 3. `mergeProps?: Function`
 4. `options?: Object`
@@ -73,6 +73,24 @@ For more details on recommended usage of `mapStateToProps`, please refer to [our
 
 > You may define `mapStateToProps` and `mapDispatchToProps` as a factory function, i.e., you return a function instead of an object. In this case your returned function will be treated as the real `mapStateToProps` or `mapDispatchToProps`, and be called in subsequent calls. You may see notes on [Factory Functions](#factory-functions) or our guide on performance optimizations.
 
+#### Object Shorthand Form
+
+`mapStateToProps` may be an object where each field is an [selector](https://redux.js.org/recipes/computing-derived-data#selectorsindexjs).
+
+```js
+import { getTodos } from './selectors'
+
+const mapStateToProps = {
+  todos: getTodos,
+}
+
+export default connect(
+  mapStateToProps,
+)(TodoApp)
+```
+
+In this case, React-Redux binds the `state` and `ownProps` of your store to each of the selector using `createStructuredSelector` from [reselect](https://github.com/reduxjs/reselect).
+
 ### `mapDispatchToProps?: Object | (dispatch, ownProps?) => Object`
 
 Conventionally called `mapDispatchToProps`, this second parameter to `connect()` may either be an object, a function, or not supplied.

docs/introduction/quick-start.md

@@ -35,6 +35,8 @@ yarn add react-redux
 
 You'll also need to [install Redux](https://redux.js.org/introduction/installation) and [set up a Redux store](https://redux.js.org/recipes/configuring-your-store/) in your app.
 
+Also need to [install Reselect](https://github.com/reduxjs/reselect#installation) to use object shorthand for `mapStateToProps` in `connect`.
+
 ## `Provider`
 
 React Redux provides `<Provider />`, which makes the Redux store available to the rest of your app:

package.json

@@ -37,7 +37,8 @@
   },
   "peerDependencies": {
     "react": "^16.8.3",
-    "redux": "^2.0.0 || ^3.0.0 || ^4.0.0-0"
+    "redux": "^2.0.0 || ^3.0.0 || ^4.0.0-0",
+    "reselect": "^4.0.0"
   },
   "peerDependenciesMeta": {
     "react-dom": {

src/connect/mapStateToProps.js

@@ -1,3 +1,5 @@
+import { createStructuredSelector } from 'reselect'
+
 import { wrapMapToPropsConstant, wrapMapToPropsFunc } from './wrapMapToProps'
 
 export function whenMapStateToPropsIsFunction(mapStateToProps) {
@@ -10,4 +12,17 @@ export function whenMapStateToPropsIsMissing(mapStateToProps) {
   return !mapStateToProps ? wrapMapToPropsConstant(() => ({})) : undefined
 }
 
-export default [whenMapStateToPropsIsFunction, whenMapStateToPropsIsMissing]
+export function whenMapStateToPropsIsObject(mapStateToProps) {
+  return mapStateToProps && typeof mapStateToProps === 'object'
+    ? wrapMapToPropsFunc(
+        createStructuredSelector(mapStateToProps),
+        'mapStateToProps'
+      )
+    : undefined
+}
+
+export default [
+  whenMapStateToPropsIsFunction,
+  whenMapStateToPropsIsMissing,
+  whenMapStateToPropsIsObject
+]