gentleduck state

Philosophy

@gentleduck/state keeps state modeling explicit with an atom/store API. It is optimized for predictable dependency tracking and small runtime surface area.

Installation

npm install @gentleduck/state

npm install @gentleduck/state

Usage

import { atom, createStore } from '@gentleduck/state'
 
const count = atom(0)
const double = atom((get) => get(count) * 2)
 
const store = createStore()
store.set(count, (prev) => prev + 1)
console.log(store.get(double))

import { atom, createStore } from '@gentleduck/state'
 
const count = atom(0)
const double = atom((get) => get(count) * 2)
 
const store = createStore()
store.set(count, (prev) => prev + 1)
console.log(store.get(double))

API Reference

atom(initialValue)

Creates a primitive writable atom.

atom(read)

Creates a derived read-only atom.

atom(read, write)

Creates a writable derived atom.

createStore()

Creates a store instance with:

• get(atom)
• set(atom, valueOrUpdater)
• subscribe(atom, callback)