Skip to content

Commit f4b1066

Browse files
committed
Added rest of generated docs
1 parent 3e8897b commit f4b1066

File tree

6 files changed

+247
-1
lines changed

6 files changed

+247
-1
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
/generated-docs/*
66
!/generated-docs/md
77
/generated-docs/md/*
8-
!/generated-docs/md/React.Halo.md
8+
!/generated-docs/md/React.Halo.*
99
/.psc-package/
1010
/.psc*
1111
/.purs*

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,10 @@ Then install with Spago:
2727

2828
`$ spago install react-halo`
2929

30+
## Generated documentation
31+
32+
See [here](https://github.com/robertdp/purescript-react-halo/blob/master/generated-docs/md/React.Halo.md)
33+
3034
## What does Halo provide?
3135

3236
Whether you are using the hook or one of the component helpers, the main feature that Halo provides is the `eval` function. It looks like:
@@ -108,3 +112,4 @@ kill :: forall m action state props. ForkId -> HaloM props state action m Unit
108112
```
109113

110114
Similarly to subscriptions, when the component unmounts all still-running forks will be killed.
115+
Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
## Module React.Halo.Component.Control
2+
3+
#### `HaloF`
4+
5+
``` purescript
6+
data HaloF props state action m a
7+
= Props (props -> a)
8+
| State (state -> Tuple a state)
9+
| Subscribe (SubscriptionId -> Event action) (SubscriptionId -> a)
10+
| Unsubscribe SubscriptionId a
11+
| Lift (m a)
12+
| Par (HaloAp props state action m a)
13+
| Fork (HaloM props state action m Unit) (ForkId -> a)
14+
| Kill ForkId a
15+
```
16+
17+
##### Instances
18+
``` purescript
19+
(Functor m) => Functor (HaloF props state action m)
20+
```
21+
22+
#### `HaloM`
23+
24+
``` purescript
25+
newtype HaloM props state action m a
26+
= HaloM (Free (HaloF props state action m) a)
27+
```
28+
29+
##### Instances
30+
``` purescript
31+
Functor (HaloM props state action m)
32+
Apply (HaloM props state action m)
33+
Applicative (HaloM props state action m)
34+
Bind (HaloM props state action m)
35+
Monad (HaloM props state action m)
36+
(Semigroup a) => Semigroup (HaloM props state action m a)
37+
(Monoid a) => Monoid (HaloM props state action m a)
38+
MonadTrans (HaloM props state action)
39+
(MonadEffect m) => MonadEffect (HaloM props state action m)
40+
(MonadAff m) => MonadAff (HaloM props state action m)
41+
MonadState state (HaloM props state action m)
42+
MonadRec (HaloM props state action m)
43+
(MonadAsk r m) => MonadAsk r (HaloM props state action m)
44+
(MonadTell w m) => MonadTell w (HaloM props state action m)
45+
(MonadThrow e m) => MonadThrow e (HaloM props state action m)
46+
```
47+
48+
#### `HaloAp`
49+
50+
``` purescript
51+
newtype HaloAp props state action m a
52+
= HaloAp (FreeAp (HaloM props state action m) a)
53+
```
54+
55+
##### Instances
56+
``` purescript
57+
Newtype (HaloAp props state action m a) _
58+
Functor (HaloAp props state action m)
59+
Apply (HaloAp props state action m)
60+
Applicative (HaloAp props state action m)
61+
```
62+
63+
#### `SubscriptionId`
64+
65+
``` purescript
66+
newtype SubscriptionId
67+
= SubscriptionId Int
68+
```
69+
70+
##### Instances
71+
``` purescript
72+
Eq SubscriptionId
73+
Ord SubscriptionId
74+
```
75+
76+
#### `ForkId`
77+
78+
``` purescript
79+
newtype ForkId
80+
= ForkId Int
81+
```
82+
83+
##### Instances
84+
``` purescript
85+
Eq ForkId
86+
Ord ForkId
87+
```
88+
89+
#### `hoist`
90+
91+
``` purescript
92+
hoist :: forall props state action m m'. Functor m => (m ~> m') -> (HaloM props state action m) ~> (HaloM props state action m')
93+
```
94+
95+
#### `props`
96+
97+
``` purescript
98+
props :: forall props m action state. HaloM props state action m props
99+
```
100+
101+
#### `subscribe'`
102+
103+
``` purescript
104+
subscribe' :: forall m action state props. (SubscriptionId -> Event action) -> HaloM props state action m SubscriptionId
105+
```
106+
107+
#### `subscribe`
108+
109+
``` purescript
110+
subscribe :: forall props state action m. Event action -> HaloM props state action m SubscriptionId
111+
```
112+
113+
#### `unsubscribe`
114+
115+
``` purescript
116+
unsubscribe :: forall m action state props. SubscriptionId -> HaloM props state action m Unit
117+
```
118+
119+
#### `fork`
120+
121+
``` purescript
122+
fork :: forall m action state props. HaloM props state action m Unit -> HaloM props state action m ForkId
123+
```
124+
125+
#### `kill`
126+
127+
``` purescript
128+
kill :: forall m action state props. ForkId -> HaloM props state action m Unit
129+
```
130+
131+
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## Module React.Halo.Component.State
2+
3+
#### `HaloState`
4+
5+
``` purescript
6+
newtype HaloState props state action
7+
= HaloState { eval :: Lifecycle props action -> HaloM props state action Aff Unit, forks :: Ref (Map ForkId (Fiber Unit)), fresh :: Ref Int, props :: Ref props, render :: state -> Effect Unit, state :: Ref state, subscriptions :: Ref (Map SubscriptionId (Effect Unit)), unmounted :: Ref Boolean }
8+
```
9+
10+
#### `createInitialState`
11+
12+
``` purescript
13+
createInitialState :: forall props state action. state -> (Lifecycle props action -> HaloM props state action Aff Unit) -> (state -> Effect Unit) -> props -> Effect (HaloState props state action)
14+
```
15+
16+
#### `fresh`
17+
18+
``` purescript
19+
fresh :: forall props state action a. (Int -> a) -> HaloState props state action -> Effect a
20+
```
21+
22+
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
## Module React.Halo.Component
2+
3+
#### `Lifecycle`
4+
5+
``` purescript
6+
data Lifecycle props action
7+
= Initialize props
8+
| Update props props
9+
| Action action
10+
| Finalize
11+
```
12+
13+
#### `ComponentSpec`
14+
15+
``` purescript
16+
type ComponentSpec props state action m = { eval :: Lifecycle props action -> HaloM props state action m Unit, initialState :: state, render :: { props :: props, send :: action -> Effect Unit, state :: state } -> JSX }
17+
```
18+
19+
#### `HookSpec`
20+
21+
``` purescript
22+
type HookSpec props state action m = { eval :: Lifecycle props action -> HaloM props state action m Unit, initialState :: state, props :: props }
23+
```
24+
25+
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
## Module React.Halo.Eval
2+
3+
#### `evalHaloM`
4+
5+
``` purescript
6+
evalHaloM :: forall props state action. HaloState props state action -> (HaloM props state action Aff) ~> Aff
7+
```
8+
9+
#### `evalHaloF`
10+
11+
``` purescript
12+
evalHaloF :: forall props state action. HaloState props state action -> (HaloF props state action Aff) ~> Aff
13+
```
14+
15+
#### `EvalSpec`
16+
17+
``` purescript
18+
type EvalSpec props action state m = { onAction :: action -> HaloM props state action m Unit, onFinalize :: Maybe action, onInitialize :: props -> Maybe action, onUpdate :: props -> props -> Maybe action }
19+
```
20+
21+
#### `defaultEval`
22+
23+
``` purescript
24+
defaultEval :: forall props action state m. EvalSpec props action state m
25+
```
26+
27+
#### `makeEval`
28+
29+
``` purescript
30+
makeEval :: forall props action state m. EvalSpec props action state m -> Lifecycle props action -> HaloM props state action m Unit
31+
```
32+
33+
#### `runAff`
34+
35+
``` purescript
36+
runAff :: Aff Unit -> Effect Unit
37+
```
38+
39+
#### `runInitialize`
40+
41+
``` purescript
42+
runInitialize :: forall props state action. HaloState props action state -> props -> Effect Unit
43+
```
44+
45+
#### `handleUpdate`
46+
47+
``` purescript
48+
handleUpdate :: forall props state action. HaloState props action state -> props -> Effect Unit
49+
```
50+
51+
#### `handleAction`
52+
53+
``` purescript
54+
handleAction :: forall props state action. HaloState props state action -> action -> Effect Unit
55+
```
56+
57+
#### `runFinalize`
58+
59+
``` purescript
60+
runFinalize :: forall props state action. HaloState props state action -> Effect Unit
61+
```
62+
63+

0 commit comments

Comments
 (0)