Minimal external-state primitives with typed events
npm install @wasdadeel/stateMinimal external-state primitives with typed events:
- createState — state container with getState, setState, and typed events.
- createBoolean() — boolean helper on top of createState.
- createCounter() — counter with increment/decrement/reset events.
---
``bash`
npm i @wasdadeel/stateor
yarn add @wasdadeel/state
`
import { createState } from '@wasdadeel/state';
const $user = createState({ id: '1', name: 'Andrei' });
$user.on('change', ({ prevState, newState }) => {
console.log(prevState, '→', newState);
});
$user.setState({ id: '2', name: 'Andrew' });
console.log($user.getState()); // { id: '2', name: 'Andrew' }
`
import { createBoolean } from '@wasdadeel/state';const $flag = createBoolean(false);
$flag.on('setTrue', ({ prevState, newState }) => {});
$flag.on('setFalse', ({ prevState, newState }) => {});
$flag.on('change', ({ prevState, newState }) => {});
$flag.setTrue();
$flag.setFalse();
$flag.toggle();
// read synchronously
const v = $flag.getState();
$3
import { createCounter } from '@wasdadeel/state';const counter = createCounter(0);
counter.on('increment', ({ prevState, newState }) => {});
counter.on('decrement', ({ prevState, newState }) => {}); // note: event name matches code
counter.on('reset', ({ prevState, newState }) => {});
counter.increment(); // 1
counter.decrement(); // 0
counter.getState();
counter.reset(); // back to initial
API Reference
Returns:
-
— current value, always fresh
- setState(next: T | (prev: T) => T, options?: { shouldEmit?: boolean | (event: 'setState' | 'change') => boolean }): void
- — subscribe to 'setState' | 'change'Event payload shapes:
`
type SetStateEvent = { newState: T };
type ChangeEvent = { prevState: T; newState: T };
####
- , setState(next), setTrue(), setFalse(), toggle()
- ####
- , increment(), decrement(), reset()
-
- also available
Why this library?
- External state first — read without waiting for React render
- Typed events — predictable side-effects
- Zero deps — easy to audit
- Small surface — primitives only
Types & Utilities
`
import type { CreatedState, CreatedStateReader, CreatedStateInfer } from '@wasdadeel/state';// Example:
const $user = createState({ id: '1', name: 'A' });
type User = CreatedStateInfer; // { id: string; name: string }
$3
- lets you suppress setState/change` notifications, or only allow specific ones.MIT © Andrei Balashov