Function createMachine

Returns ChainableStateMachine<TState, TContext>

A chainable state machine instance with the following methods:

Core API

• moveTo(state, payload?) - Transition to a new state
• isIn(state) - Check if machine is in a specific state
• canMoveTo(state) - Check if transition to a specific state is allowed
• getStore() - Get the internal Valtio store for use with useSnapshot
• resetContext() - Reset context to initial values

Event System

• on(eventName, handler) - Register event handler
• once(eventName, handler) - Register one-time event handler
• off(eventName, handler?) - Remove event handler(s)
• fire(eventName, payload?) - Fire an event

Listeners and Callbacks

• onTransition(listener) - Add a listener for state transitions
• whenIn(state, callback) - Register a callback for a specific state
• onContextChange(listener) - Add a listener for context changes

Runtime Configuration

• setTransitions(state, transitions) - Set allowed transitions for a state
• addTransition(state, transition) - Add a single allowed transition
• removeTransition(state, transition) - Remove an allowed transition
• setHandler(state, type, handler) - Set a state handler (onEnter or onExit)

History Management

• getHistory() - Get the transition history array
• clearHistory() - Clear transition history
• enableHistory(enable?) - Enable or disable history tracking
• setHistorySize(size) - Set maximum history size

const machine = createMachine(
  'idle',
  {
    idle: { transitions: ['loading'] },
    loading: { transitions: ['success', 'error'] },
    success: { transitions: ['idle'] },
    error: { transitions: ['idle'] }
  },
  { data: null, error: null }
);
Copy