1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
#pragma once
#include "policy.hpp"
#include <string>
#include <string_view>
#include <vector>
// Pure decision core: the toml loader. Parses an unbox.toml document (as TEXT —
// file discovery/reading is an effect kept in the glue) into a list of
// policy::Binding, skipping malformed entries and recording a human-readable
// warning for each skip. toml++ is the only dependency; no wlroots, no kernel.
// Doctest-covered in tests/test_policy.cpp.
namespace unbox::ext_keybindings::config {
// The outcome of loading. `bindings` holds every well-formed [[keybind]] (in
// document order). `warnings` holds one message per skipped/ill-formed entry or
// a single parse-error message. `parse_error` is true iff the document itself
// failed to parse (toml syntax error) — in that case `bindings` is empty and
// `warnings` has the parser's message.
//
// NOTE: an empty document, or one with zero valid bindings, is NOT a parse
// error — it returns empty `bindings` with parse_error=false. The glue decides
// to fall back to compiled defaults when `bindings` ends up empty (whatever the
// cause), and logs every warning.
struct LoadResult {
std::vector<policy::Binding> bindings;
std::vector<std::string> warnings;
bool parse_error = false;
};
// Parse `toml_text` and extract the [[keybind]] array-of-tables per the
// USER-APPROVED schema:
// keys = "Mod+...+Key" | "Mod" (required, string)
// action = "spawn" | "focus-next" | "focus-prev" | "close-active" | "quit"
// | "dock-toggle-visible"
// command = "..." (required for action="spawn")
// Each entry is validated independently: a malformed combo, unknown action,
// missing/empty keys, missing command for spawn, or wrong value types skip that
// ONE entry (with a warning) and never abort the rest.
[[nodiscard]] auto load_from_string(std::string_view toml_text) -> LoadResult;
// The PURE reload decision (the swap-or-keep-old policy of hot-reload, with no
// file I/O and no event loop). Re-parse `toml_text` via load_from_string and
// decide which binding table stays LIVE:
// * SUCCESS -> the file parsed AND yielded at least one usable binding:
// `bindings` is the NEW table (the swap), `swapped` is true.
// * KEEP-OLD -> a toml parse error, OR zero usable bindings: `bindings` is a
// COPY of `current` unchanged (`swapped` false). A half-saved or
// broken edit must never drop the user's working keys.
// `warnings` carries every per-entry / parse warning from the underlying load so
// the glue can log exactly one summarizing line. NEVER throws (the toml parse
// error is caught inside load_from_string). The glue applies the SAME keep-old
// rule when the file is merely unreadable (it then does not call this at all).
struct ReloadDecision {
std::vector<policy::Binding> bindings; // the table to install (new or kept)
std::vector<std::string> warnings; // diagnostics from the parse
bool swapped = false; // true iff a new table replaced current
};
[[nodiscard]] auto reload_bindings(const std::vector<policy::Binding>& current,
std::string_view toml_text) -> ReloadDecision;
} // namespace unbox::ext_keybindings::config
|
