From 9de89ae1512928283c1de7360e0313e1e2975b47 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Tue, 13 Oct 2026 09:57:22 +0200 Subject: docs: the controls panel, its preferences file and bind The island README gains the panel. AGENTS.md records that a bare SUPER release bind is cancelled by drag and scroll on Hyprland 0.56.2, which was the open risk in the spec, and that FileView creates parent directories while Quickshell.stateDir is per-shell. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md index 2d7c950..82b73e0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,7 +12,8 @@ running one does not require the others. `desktop/` is itself a host for modules. desktop/ the drawer: sound, mail, VMs, appearance - island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy + island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy, + controls panel (SUPER alone) appearance/ wallpaper picker and colour scheme switcher window-switcher/ open windows as live previews in a grid, on ALT+TAB keybinds/ live keybind reminder, on SUPER+k @@ -145,6 +146,15 @@ changing that component. The ones that generalise: - **`hyprctl switchxkblayout current next|prev` targets the main keyboard**, so no device lookup is needed. Hyprland's `activelayout` raw event fires on every switch, so the layout flag is event-driven rather than polled. +- **A bare-modifier release bind works on Hyprland 0.56.2.** `hl.bind("SUPER + + Super_L", ..., { release = true })` fires on SUPER pressed and released + alone, and is cancelled by any key in between and by `SUPER`+drag and + `SUPER`+scroll; all checked by hand. That is how SUPER alone opens the + island's controls panel. +- **`FileView.setText` creates missing parent directories**, so `Prefs.qml` + has no mkdir step. `Quickshell.stateDir` is a per-shell hashed directory + (`by-shell/`), not `~/.local/state/quickshell`, which is why the + preferences path is built from `XDG_STATE_HOME` instead. - **Waybar is gone, both bars.** Its DP-3 functions moved to the island. The mail count is drawer-only: `Accounts.qml` watches the xapian directory itself, and `waybar-mail.sh` was deleted. -- cgit v1.2.3