From 7171f99539c86d79420bb6a098c76c17fcb1bbf6 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Thu, 29 Oct 2026 09:31:12 +0100 Subject: hyprland: keyboard shortcuts and options pages in the settings window Keyboard shortcuts lists every bind hyprctl reports, joined to the hl.bind call in ~/.config/hypr that made it: hyprctl gives every Lua action as an opaque __lua number, so the action and file:line only exist in the source. The join is by description, then combo, then the longest literal head of a description built in a loop. List, Source and Clashes tabs. A combo the source writes as a plain string (or from file-level string locals) can be changed: hyprctl eval of a do-nothing bind checks it first, refusing an unknown modifier or keysym, then the call's first argument is rewritten and Hyprland autoreloads. Options lists all 353 options from hyprctl descriptions, with values from one batched getoption, since descriptions' own "current" field is stale. Filters for everything, set in the config, and changed from the default. A change is one line in hypr-theme's sections/keystone.lua, required last, and is run through hyprctl eval first, which refuses an unknown key or a wrongly shaped value without changing anything. Both modules keep their own copy of the file text: FileView.text() returns the old text right after setText(), and a second quick edit built from it dropped the first. The AGENTS.md notes record that and the hyprctl quirks found on the way. Check: node desktop/modules/hyprland/test_hypr.js Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md index 1c2e39b..a4d23c1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,7 +15,8 @@ modules. performance, clipboard, updates; and the settings window for pages set once: wallpaper, theme, theme status, icons, sunset, idle (the former appearance shell), notifications, autostart, shells, - the assistant's daemon and presets, qtmaildir, git + the assistant's daemon and presets, qtmaildir, git, + Hyprland's keyboard shortcuts and options island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy, calendar, OBS assistant/ the assistant canvas on SUPER+Home, a view over desktop-assistant @@ -197,6 +198,22 @@ changing that component. The ones that generalise: one landed in `db.json` with no file beside it. Content that may be empty goes through a `Process` running `cat > ` with the text on stdin, whose exit code is the outcome; `notes` writes bodies that way. +- **`FileView.text()` lags `setText()`.** Read straight after a write, it + returns the text from before it (measured), so a second edit built from it + silently drops the first. A view that is edited more than once keeps its + own copy of the text, set on load and on write; `modules/hyprland` does. +- **`hyprctl eval` is a dry run that is not dry.** It refuses an unknown + option key, a value of the wrong shape, or a combo with an unknown + modifier or keysym, exits 7 and changes nothing, which makes it the check + before a config write. A line that passes is applied at once, and a probe + `hl.bind(combo, function() end)` stays registered until the next reload. + Its error also lingers in `hyprctl configerrors` until then. +- **`hyprctl binds -j` reports a `code:49` bind with an empty key and + keycode 0**, and every Lua action as `__lua` with an opaque number: the + combo and action are only readable from the `hl.bind` call in the source. +- **`hyprctl descriptions -j` has a `current` field that is stale**: it read + `border_size` 1 while `getoption` read 2. Values come from `getoption`, all + 353 in one `hyprctl -j --batch`, which takes a few milliseconds. - **khal 0.11 has no JSON output**, which is why the calendar reads the vdir itself through `desktop/island/calendar/calctl` rather than parsing `khal list -f`. A month list over the 281 live event files measured 0.11s. khal -- cgit v1.2.3