No non-sense global state management for SolidJS, inspired by Zustand.
import { state } from "solid-sm"
type TaskState = {
name: string
done: boolean
complete(): void
}
type RootState = {
tasks: TaskState[]
addTask(name: string): void
}
const createTask = (name: string) => {
return state<TaskState>((set) => ({
name,
done: false,
complete() {
set("done", true)
},
}))
}
const rootState = state<RootState>((set) => ({
tasks: [],
addTask(name) {
set("tasks", (t) => [...t, createTask(name)])
},
}))
- Only one function, for creating a state. That's it.
- Compatible with SolidJS functions and design patterns.
- Nestable. Create and update nested states easily.
Although Solid provides global state out of the box, dealing with nested states is complex and requires a lot of boilerplate. This module aims to simplify that, reducing the necessary effort to create idiomatic and performant designs.
A state is a reactive object with data and actions that can mutate this data. Having actions mixed
with data is important because it allows consumers to handle the data without having to known how
the data was created. To create a new state, use the state
function. It takes setup a callback
that returns the initial value.
type CounterState = {
value: number
}
const counter = state<Counter>(() => ({
value: 0,
}))
Inside components, states behaves as any other reactive object. You can access its properties inside a reactive scope to subscribe it to changes in the property.
function Counter() {
return <div>Counter: {counter.value}</div>
}
The state setup callback takes as parameter a set
function that can update the state value after
it's initialized. With it, you can create actions that will allow the state to be updated by
consumers.
type CounterState = {
value: number
inc(): void
}
const counter = state<Counter>((set) => ({
value: 0,
inc(): {
// The passed object will be shallowly merged with the current value
set((s) => ({ value: s.value + 1 }))
// You can also pass the property that will be updated instead
set("value", (v) => v + 1)
}
}))
Solid SM provides a helper function to unwarp actions from the state object. This is useful when using the action directly as a event handler.
type CounterState = {
value: number
inc(): void
}
const counter = state<Counter>((set) => ({
value: 0,
inc(): {
set("value", (v) => v + 1)
}
}))
function Counter() {
const [inc] = useActions(counter, "inc")
return (
<div>
{counter.value}{" "}
<button onClick={inc}>Increment</button>
</div>
)
}
Nested states are a way of updating part of a object inside a state without updating the parent state. This simplifies the handling of complex data involving array of objects.
type BookState = {
title: string
score: number | null
setScore(score: number): void
}
type AuthorState = {
books: BookState[]
addBook(title: string): void
}
const author = state<AuthorState>((set) => ({
books: [],
addBook(title) {
set("books", (b) => [
...b,
state<BookState>((setBook) => ({
title,
score: null,
setScore(score) {
setBook("score", score)
},
})),
])
},
}))