Swift Composable Undo
A library that provides undo semantics for the Composable Architecture with optional bridging with UndoManager.
Motivation
It is hard to use UndoManager API with state that uses value sematics. Furthermore, the instance provided by SwiftUI may not be available in all contexts. There have been previous discussions which resulted in solutions that were not generic. This library provides a way to scope Undo/Redo operations within a View with minimal efforts.
Example
The workspace ComposableUndo contains the TicTacToe demo from ComposableArchitecture repository. Open the GameCore.swift file to see how Composable Undo is integrated.
Basic Usage
To use ComposableUndo in your project, you need to annotate the state fields that needs undo tracking:
struct Person: Equatable {
var firstName: String
var lastName: String
var phoneNumber: String
}
struct AppState: Equatable {
@CheckpointState var person: Person
}
You also need to add checkpoint action to your domain. It is advisable to confirm the domain action enum to SingleCheckpointAction protocol when only one of the states fields is annotated:
enum AppAction: Equatable, SingleCheckpointAction {
case checkpoint(CheckpointAction)
// Your domain's other actions:
...
}
If you are planning to use UndoManager, it must be registered using view lifecycle methods:
struct AppView: View {
@Environment(\.undoManager) var undoManager
// Store declarations
...
var body: some View {
WithViewStore(store) { viewStore in
SomeView {
...
}
.onAppear { viewStore.send(.checkpoint(.attachManager(undoManager))) }
.onDisappear { viewStore.send(.checkpoint(.detachManager)) }
}
}
}
If this view's state is computed by a super view, make sure that the detach happens before clearing the state. See NewGameCore.swift in the example on how to do this.
With this initial setup out of the way, each state change that can be undone must be registered by returning effect from the reducer:
case .updatePerson:
// ... code to update state
return .checkpoint(.register("Change person"))
Note that the register string is passed on to UndoManager and appears in the menu on macOS.
1.2k Dec 29, 2022
0 Nov 23, 2021
17 Dec 7, 2022
1 Jan 27, 2022
160 Oct 17, 2022
4k Jan 8, 2023
55 Dec 19, 2022
107 Jan 2, 2023
5 Nov 23, 2022
3 Dec 16, 2022
129 Dec 14, 2022
0 Oct 2, 2022
2.1k Jan 1, 2023
3 May 29, 2022
9 Nov 29, 2022
3 Sep 1, 2022
12 Dec 7, 2022
21 Dec 14, 2022
2 Nov 23, 2021