State Machine

Лёгкие реактивные конечные автоматы (FSM / statechart) для Vue 3 — декларативные состояния и переходы, параллельные регионы, guards, actions, персистентность и composable-API — с единственной peer-зависимостью.

Возможности

• defineMachine() — чистая фабрика конфигурации с валидацией в dev-режиме; без зависимости от Vue — тестируется в Node
• useMachine() — composable, оборачивающий машину в реактивность Vue; реактивные state, context, send(), matches(), can()
• Guards — синхронные предикаты, блокирующие переходы; исключение трактуется как false
• Actions — синхронные или асинхронные побочные эффекты на входе, выходе или переходе; возвращают Partial<context> для обновления состояния
• Очередь событий — send() добавляет в очередь и обрабатывает события последовательно; никаких состояний гонки с асинхронными actions
• Параллельные регионы — несколько независимых под-машин, активных одновременно внутри состояния
• useWizard() — построен поверх useMachine; next(), prev(), goTo(), асинхронный canProceed, хуки onEnter/onLeave, умеющие писать в контекст, циклический режим
• Персистентность — опциональная сериализация снапшота в localStorage (или любое кастомное Storage) для каждого инстанса машины
• История переходов — настраиваемая глубина, полезно для отладки и сценариев отмены
• useSharedMachine() — singleton-машина, общая для несвязанных компонентов без Pinia
• DevTools — отдельная точка входа /devtools; кастомная панель в Vue DevTools, показывающая состояние и контекст каждой зарегистрированной машины
• Полный TypeScript — дженерики TState, TEvent, TContext выводятся автоматически из конфига
• Совместимое подмножество XState v5 — миграция заменой createMachine → defineMachine и assign() → обычное возвращаемое значение
• SSR-безопасность — никаких window / localStorage в ядре; персистентность молча пропускается на сервере
• ≤ 4 КБ gzip для ядра (defineMachine + useMachine)