knotty

Knotty Framework — Router

Decision Tree

무엇을 만들고 있나?
│
├─ Store 신규 작성                    → Knotty.md
├─ DI 등록 / 플랫폼 bootstrapping    → Knotty.Setup.md
├─ View에 Store 바인딩               → Knotty.Binding.md
├─ XAML Command 생성 / 바인딩        → Knotty.Command.md
├─ 네비게이션 / Toast / Dialog       → Knotty.Effect.md
├─ 검색 debounce / 취소 / 동시 처리  → Knotty.IntentHandling.md
├─ 에러 처리 / HasErrors / 롤백      → Knotty.ErrorHandling.md
├─ Store 간 통신 (Bus)               → Knotty.Bus.md
└─ 디버깅 / 로그                     → Knotty.Debugger.md

Golden Path — 기능 하나 추가할 때 순서

1. State record 정의
       public record MyState(int Count = 0);

2. Intent record 정의
       public abstract record MyIntent
       {
           public record Increment : MyIntent;
       }

3. Store 구현
       public partial class MyStore : KnottyStore<MyState, MyIntent>
       {
           public MyStore() : base(new MyState()) { }
           protected override async Task HandleIntent(MyIntent intent, CancellationToken ct) { ... }
       }

4. DI 등록  →  Knotty.Setup.md 참고 (플랫폼마다 다름)

5. View에서 DataContext 설정 + Effect 구독  →  Knotty.Binding.md 참고

Quick Reference

Rules

Always

• using Knotty; 하나로 모든 타입 접근 가능. 다른 Knotty 하위 namespace 불필요.
• Source Generator 쓸 때는 Store 클래스에 partial 필수
• HandleIntent 내부 모든 await에 ct 전달
• View에서 Effect 구독 시 Unloaded/OnNavigatedFrom에서 반드시 .Dispose()

Never

• [ObservableProperty], [RelayCommand] — CommunityToolkit과 혼용 금지
• State.SomeProperty = value — 직접 mutation. 반드시 State = State with { ... }
• State record 안에 bool ShowToast, string NavigateTo 같은 일회성 플래그
• State 필드에 IEffect 인스턴스 저장
• HandleIntent 안에서 _ = SomeAsync() fire-and-forget (ct 전파 끊김)

Common Mistakes (에이전트가 자주 저지르는 실수)