Composes several Commands into a single, atomic history entry — one
undo/redo step for a whole gesture (e.g. dragging a multi-selection, or a
batch delete). Sub-commands run in order; if any execute fails, the ones
that already ran are rolled back (undone in reverse) and the failure is
returned, so the aggregate is never left half-applied. undo reverses every
sub-command; redo re-runs the macro, which is deterministic because each
sub-command captured its identity on first execute.
An empty macro is a no-op that succeeds — callers can build one from a
filtered list without special-casing the empty case.
Composes several Commands into a single, atomic history entry — one undo/redo step for a whole gesture (e.g. dragging a multi-selection, or a batch delete). Sub-commands run in order; if any
executefails, the ones that already ran are rolled back (undone in reverse) and the failure is returned, so the aggregate is never left half-applied.undoreverses every sub-command; redo re-runs the macro, which is deterministic because each sub-command captured its identity on first execute.An empty macro is a no-op that succeeds — callers can build one from a filtered list without special-casing the empty case.