substate-connect

Higher Order Functions to use substate with React (soon Preact and Inferno)

Demo repo

Example usage

mapping state to props in component

import {connect} from 'substate-connect';
import substateInstance from './mystate.js';
/**
    MyComponent
*/

export default connect(substateinstance, {
    prop1: 'path.to.prop',
    prop2: 'name',
    prop3: 'location' 
    })(MyComponent);

### wrapping App in store instance
// App.js
import { Provide } from 'substate-connect';
import substateIntsance from './mystate.js';

/*

App Component MUST be wired with connect

*/
const WiredApp = Provide(substateInstance, ["STATE_UPDATED"], onMount)(App);

export default WiredApp;

What the H does this do?

Similar to react-redux connect method.

You pass in a reference to the substate instance, so we can wire up the props, and you pass in an object mapping the prop names for the component (the keys), to the prop values you want (the path -- as a string -- to the chunk of state you need). Then it returns a function which needs your component as an argument.

The Provide HOC needs the substate instance as a first argument. The second argument is an array of substate $types you want the App to setState too. It's recommended to at least have "STATE_UPDATED" passed in the array.

onMount is a function that will fire when the Provide higher order component mounts. The signature: onMount(store, triggers) So you have access to the store and triggers passed in. Note: this is bound to the HOC.

Now it's all wired up.

Why map the props?

Mapping props allows your component to have its own prop structure and not care what the global state structure is like. This allows for component reusability.

What about props through composition?

Pass those in as you normally would. They will be alongside the props from the connect method. This way you can pass functions into the component during normal composition.