deepstate.action — com.github.mccraigmccraig/deepstate 0.0.6

action-context-provider clj/s macro

(action-context-provider & args)

uses a use-reducer hook to encapsulate state and propagates it with a ContextProvider

• context - the action-context React context
• initial-arg - the initial state value
• child - content to include inside the ContextProvider element

ActionContextProvider cljs

apply-effects-loop cljs

(apply-effects-loop {react-dispatch :deepstate.action/dispatch
                     :as action-context-val}
                    update-spec)

given an update-spec from a (handle action), apply ActionEffects, looping until all promises are resolved

3 effects are currently supported ... ::update-now - a fn to apply to state to update it ::navigate - a fn to apply to state to get a url to navigate to ::update-later - a promise of further effects, possibly recursive

create-action-context cljs

(create-action-context)

create the React Context object

def-action clj/s macro

(def-action key [action-bindings] & body)

define a generic action

• key : the action key
• action-bindings : fn bindings to destructure the action
• body : any forms which return an action handle ActionEffects or a promise thereof. can use the action-bindings

dispatch cljs

(dispatch action-context-val action)

dispatch an action to update the state

• action-context-val : the value from an action-context provided by action-context-provider

• action : the action. must have key ::action which identifies the handler multimethod. if the action is just a keyword it will be treated as the ::action key

handle cljs multimethod

handle a possibly asynchronous action

• action : the action. must have key ::action which identifies the handler multimethod

returns: ActionEffects = (f state) | Promise<(f <state>)> | {::update-now (f state) ::navigate (f state) ::update-later Promise<ActionEffects>}

i.e. handle returns fns of state which will be used to update the state. If the action is asynchronous it can return one fn to update the state now and return another when action has completed, potentially recursively

sig5005 cljs

use-action cljs

(use-action ctx)

get the value from an action-context

use-action-state cljs

(use-action-state ctx)

(use-action-state ctx path)

extract the value at path (default nil) in the current state from an action-context