doc

README.md

@@ -393,3 +393,46 @@ RunGroup {
   }
 }
 ```
+
+### Combined Stores
+
+Support for children store (similar to Redux `combineStores`).
+
+```swift
+struct Root {
+  struct Todo {
+    var name: String = "Untitled"
+    var done: Bool = false
+  }
+  struct Note {
+    var text: String = ""
+    var upvotes: Int = 0
+  }
+  var todo: Todo = Todo()
+  var note: Note = Note()
+}
+
+class RootStore: Store<Root> {
+  lazy var todoStore = makeChildStore(keyPath: \.todo)
+  lazy var noteStore = makeChildStore(keyPath: \.note)
+}
+
+extension Root.Todo {
+  struct Action_MarkAsDone: ActionProtocol {
+    func reduce(context: TransactionContext<Store<Root.Todo>, Self>) {
+      defer { context.fulfill() }
+      context.reduceModel { $0.done = true }
+    }
+  }
+}
+
+extension Root.Note {
+  struct Action_IncreaseUpvotes: ActionProtocol {
+    func reduce(context: TransactionContext<Store<Root.Note>, Self>) {
+      defer { context.fulfill() }
+      context.reduceModel { $0.upvotes += 1 }
+    }
+  }
+}
+
+```

Tests/StoreTests/CombinedStores.swift

@@ -25,7 +25,7 @@ class RootStore: Store<Root> {
 extension Root.Todo {
   struct Action_MarkAsDone: ActionProtocol {
     func reduce(context: TransactionContext<Store<Root.Todo>, Self>) {
-      defer {  context.fulfill() }
+      defer { context.fulfill() }
       context.reduceModel { $0.done = true }
     }
   }
@@ -34,7 +34,7 @@ extension Root.Todo {
 extension Root.Note {
   struct Action_IncreaseUpvotes: ActionProtocol {
     func reduce(context: TransactionContext<Store<Root.Note>, Self>) {
-      defer {  context.fulfill() }
+      defer { context.fulfill() }
       context.reduceModel { $0.upvotes += 1 }
     }
   }