feat(state): Add State Pattern source generator with deterministic transitions, comprehensive documentation and examples (#117)

* Initial plan

* Add State Pattern attributes and generator implementation

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Add comprehensive unit tests for StateMachineGenerator - all passing

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Add OrderFlow example for State Machine (generator not yet running on Examples project)

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Update AnalyzerReleases.Unshipped.md with State Pattern diagnostics

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Improve comment clarity for async guard in CanFire method

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Address code review feedback: improve documentation and simplify code

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Address PR review feedback: Add diagnostics, fix guards, improve enum handling, add tests

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

* Add comprehensive documentation and expanded examples for State Machine generator

Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: JerrettDavis <2610199+JerrettDavis@users.noreply.github.com>

Author: Copilot

docs/generators/state-machine.md

@@ -19,6 +19,9 @@
 - name: Proxy
   href: proxy.md
 
+- name: State Machine
+  href: state-machine.md
+
 - name: Template Method
   href: template-method-generator.md