Every source file in ui, app, game, formats, cli, audio and launch that had none now starts with a short English comment: what it implements, what state it owns and how it relates to its neighbours (request/acknowledge flow, pairs of files, random generator use). Comment lines only; the full build and the runnable tests are unchanged. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
43 lines
1.5 KiB
C++
43 lines
1.5 KiB
C++
// SPDX-License-Identifier: GPL-3.0-only
|
|
// All-or-nothing wrapper for one UI window action on a CareerSession (used by
|
|
// desktop_actions.cpp and window_actions.cpp). It snapshots the game state, the RNG and the
|
|
// revision counter, runs the action and, if the action returns false or throws, restores
|
|
// all three, so a rejected action leaves no half-applied change behind.
|
|
// apply_native() is the variant for owners that keep their state in CareerSession::state().
|
|
// Header-only; owns no state of its own.
|
|
#pragma once
|
|
|
|
#include "app/career_session.hpp"
|
|
|
|
namespace bmh::app::detail {
|
|
|
|
template<class Checkpoint, class Restore>
|
|
bool apply_window(CareerSession& session, uint64_t& revision, Checkpoint before,
|
|
Restore restore_checkpoint, const std::function<bool()>& action) {
|
|
const auto game = session.game();
|
|
const auto rand = session.rand();
|
|
const auto old_revision = revision;
|
|
const auto restore = [&] {
|
|
session.game() = game;
|
|
session.rand() = rand;
|
|
// Some owners reconstruct their saved RNG identity during restore.
|
|
restore_checkpoint(std::move(before));
|
|
revision = old_revision;
|
|
};
|
|
try {
|
|
if (action()) return true;
|
|
} catch (...) {
|
|
restore();
|
|
throw;
|
|
}
|
|
restore();
|
|
return false;
|
|
}
|
|
|
|
inline bool apply_native(CareerSession& session, uint64_t& revision, const std::function<bool()>& action) {
|
|
return apply_window(session, revision, session.state(),
|
|
[&](GameState before) { session.state() = std::move(before); }, action);
|
|
}
|
|
|
|
} // namespace bmh::app::detail
|