DStateMachine

DStateMachine is a powerful and flexible asynchronous state machine library for .NET, designed with a clean, fluent API and production-ready architecture. It supports dynamic transitions, guard conditions, entry/exit hooks, and internal transitions, making it ideal for complex stateful workflows.

---

✨ Features

• Generic Support: Works with any type for states and triggers (e.g., string, int, enum).
• Fluent API: Concise and expressive DSL for configuration.
• Asynchronous Execution: Seamless async/await support for transitions and actions.
• Entry and Exit Hooks: Configure entry/exit actions per state.
• Guard Clauses: Conditionally block transitions.
• Internal Transitions: Perform side-effect actions without state change.
• Dynamic Transitions: Determine the destination state at runtime.
• DOT Export: Generate DOT-format graphs for visualization.

---

📚 Example Usage

var sm = new DStateMachine<string, string>("A"); sm.Configure("A") .OnEntry(() => Console.WriteLine("Entering A")) .OnExit(() => Console.WriteLine("Exiting A")) .OnTrigger("toB", tb => tb.ChangeState("B")); sm.Configure("B").OnEntry(() => Console.WriteLine("Entered B")); await sm.FireAsync("toB"); Console.WriteLine(sm.CurrentState); // Output: B

---

✅ Feature Examples

✅ Generic Type Support

var sm = new DStateMachine<int, int>(0); sm.Configure(0).OnTrigger(1, tb => tb.ChangeState(2)); sm.Fire(1); Console.WriteLine(sm.CurrentState); // Output: 2

🔁 Entry and Exit Actions

var sm = new DStateMachine<string, string>("Init"); bool entered = false, exited = false; sm.Configure("Init") .OnEntry(() => { entered = true; return Task.CompletedTask; }) .OnExit(() => { exited = true; return Task.CompletedTask; }) .OnTrigger("go", tb => tb.ChangeState("Done")); sm.Configure("Done").OnEntry(() => Task.CompletedTask); sm.Fire("go"); Console.WriteLine($"Entered: {entered}, Exited: {exited}"); // Output: Entered: False, Exited: True