Statelet — Typed Finite State Machines for TypeScript

Statelet is built with tsc and outputs ESM modules with full .d.ts type declarations, so you need a TypeScript project that supports ESM and a modern enough TypeScript version to benefit from the config-level type inference (TypeScript 4.7+ recommended). No specific Node.js version is enforced, but the built-in test suite uses node:test, so Node.js 18+ is recommended for running the tests locally.

Yes — Statelet is framework-agnostic and has zero runtime dependencies, so it works with any frontend framework (React, Vue, Svelte, etc.) or in plain browser environments. Because it builds to ESM, it integrates cleanly with modern bundlers like Vite, Rollup, and esbuild without any extra configuration.

You get the Statelet source library, ESM build output with TypeScript declaration files (.d.ts), a node:test suite (no external test-framework needed), and a set of runnable real-world examples covering a fetch flow, a traffic-light, and a checkout process — all of which double as type-level correctness tests.

Statelet intentionally keeps the core pure: the transition() function is side-effect free and actions are pure context reducers, making them trivial to unit-test. Side effects like API calls should be triggered outside the state machine in response to state changes, which you can observe via the createActor interpreter's subscribe() method.

They are caught at compile time, not at runtime. Statelet infers all state names and event types directly from your config, so sending an undeclared event or targeting a non-existent state is a TypeScript compile error — bugs are surfaced before your code ever runs.

The product listing does not specify a license explicitly, so please check the included license file or the repository before use in a commercial project. If you have licensing questions, contact the seller directly through the marketplace before purchasing.