@xstate/fsm

This package contains a minimal, 1kb implementation of XState for finite state machines.

Features

	@xstate/fsm	XState
Finite states	✅	✅
Initial state	✅	✅
Transitions (object)	✅	✅
Transitions (string target)	✅	✅
Delayed transitions	❌	✅
Eventless transitions	❌	✅
Nested states	❌	✅
Parallel states	❌	✅
History states	❌	✅
Final states	❌	✅
Context	✅	✅
Entry actions	✅	✅
Exit actions	✅	✅
Transition actions	✅	✅
Parameterized actions	❌	✅
Transition guards	✅	✅
Parameterized guards	❌	✅
Spawned actors	❌	✅
Invoked actors	❌	✅

Finite states (non-nested)
Initial state
Transitions (object or strings)
Context
Entry actions
Exit actions
Transition actions
state.changed

If you want to use statechart features such as nested states, parallel states, history states, activities, invoked services, delayed transitions, transient transitions, etc. please use XState.

Quick start

Installation

npm i @xstate/fsm

Usage (machine)

import { createMachine } from '@xstate/fsm';

const toggleMachine = createMachine({
  id: 'toggle',
  initial: 'inactive',
  states: {
    inactive: { on: { TOGGLE: 'active' } },
    active: { on: { TOGGLE: 'inactive' } }
  }
});

const { initialState } = toggleMachine;

const toggledState = toggleMachine.transition(initialState, { type: 'TOGGLE' });
toggledState.value;
const untoggledState = toggleMachine.transition(toggledState, {
  type: 'TOGGLE'
});
untoggledState.value;
// => 'inactive'

Usage (service)

import { createMachine, interpret } from '@xstate/fsm';

const toggleMachine = createMachine({});

const toggleService = interpret(toggleMachine).start();

toggleService.subscribe((state) => {
  console.log(state.value);
});

toggleService.send({ type: 'TOGGLE' });
toggleService.send({ type: 'TOGGLE' });
toggleService.stop();

Current Tags

3.0.0-alpha.1 ... alpha (2 years ago)
3.0.0-beta.3 ... beta (a year ago)
2.1.0 ... latest (2 years ago)