aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/2026-07-02-desktop-settings-panel-spec.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-04 13:04:32 -0500
committerCraig Jennings <c@cjennings.net>2026-07-04 13:04:32 -0500
commit331db64c4836e94319398cc205903a6e967b3db0 (patch)
treeac5b5ca68d731bbef6356f55437d604a8398ddf0 /docs/specs/2026-07-02-desktop-settings-panel-spec.org
parent22101e1f1bc846885798b5815318a41110110a1c (diff)
downloadarchsetup-331db64c4836e94319398cc205903a6e967b3db0.tar.gz
archsetup-331db64c4836e94319398cc205903a6e967b3db0.zip
docs(spec): resolve timer and desktop-settings panel decisions
Both DRAFT panel specs had open design decisions blocking their builds. I resolved them. Timer panel: standalone rather than folded into desktop-settings, the fuzzel flow retires once the panel lands, the preset chips gain 10m/30m/2h, and live state comes from a new wtimer watch mode instead of 1s polling. Desktop-settings panel: auto-dim and airplane collapse into the panel while touchpad and caffeine stay on the bar, Super+Shift+G opens it, the code lives in dotfiles settings/ beside net/, and the brightness slider floors at 5%. Both stay DRAFT and decision-complete, ready for a spec-review before build.
Diffstat (limited to 'docs/specs/2026-07-02-desktop-settings-panel-spec.org')
-rw-r--r--docs/specs/2026-07-02-desktop-settings-panel-spec.org35
1 files changed, 17 insertions, 18 deletions
diff --git a/docs/specs/2026-07-02-desktop-settings-panel-spec.org b/docs/specs/2026-07-02-desktop-settings-panel-spec.org
index d147249..a8150ee 100644
--- a/docs/specs/2026-07-02-desktop-settings-panel-spec.org
+++ b/docs/specs/2026-07-02-desktop-settings-panel-spec.org
@@ -14,6 +14,7 @@
:PROPERTIES:
:ID: fb7eec22-a214-4568-82c4-903612f4832f
:END:
+- [2026-07-04 Sat] DRAFT — all four decisions resolved by Craig (dim + airplane collapse into the panel, touchpad + caffeine stay on the bar; Super+Shift+G keybind; code in dotfiles settings/ beside net/; 5% brightness floor). Decision-complete; ready for a spec-review to flip it READY before build.
- [2026-07-02 Thu] DRAFT — initial spec from the todo.org task "Desktop-settings
dropdown panel" (2026-06-24 review), updated for the Blueprint/GTK4 pipeline
the net panel stood up 2026-07-01.
@@ -99,28 +100,25 @@ signals so both surfaces agree.
Gear glyph module on the bar right cluster; click toggles the panel
(layer-shell anchored under the bar, right-aligned). Focus-out auto-hide +
-Close button, matching the net panel. Keybind decision below.
+Close button, matching the net panel. Keybind: Super+Shift+G (decision B).
* Decisions (Craig)
-** TODO Which standalone bar indicators collapse into the panel?
-Options per module (dim, touchpad, caffeine): keep on bar + mirrored in
-panel; or panel-only (frees bar width). Recommendation: keep touchpad and
-caffeine visible on the bar (state you glance at), move dim into the panel
-(you set it rarely), keep airplane where it is.
+** DONE Which standalone bar indicators collapse into the panel?
+CLOSED: [2026-07-04 Sat]
+Resolved (Craig, 2026-07-04): touchpad and caffeine stay on the bar (glanceable state); auto-dim and airplane move into the panel (panel-only, freeing bar width). The airplane Super+Shift+A toggle keybind stays as the quick lane — only its bar indicator collapses in.
-** TODO Keybind for the panel?
-Super+Shift+G (gear) is free. Or no keybind — mouse-only surface.
+** DONE Keybind for the panel?
+CLOSED: [2026-07-04 Sat]
+Resolved (Craig, 2026-07-04): Super+Shift+G (gear), for parity with the other panels' fast path.
-** TODO Where does the code live?
-Recommendation: dotfiles =settings/= sibling to =net/= (same src-layout,
-tests in tests/settings/), sharing the palette css. In-tree pocketbook-style
-was the old note; the net panel is the better donor now.
+** DONE Where does the code live?
+CLOSED: [2026-07-04 Sat]
+Resolved (Craig, 2026-07-04): dotfiles =settings/= sibling to =net/= (same src-layout, tests in tests/settings/), sharing the palette css. The net panel is the architecture donor; the old in-tree pocketbook-style note is out.
-** TODO Slider granularity and floor
-brightnessctl exposes 0-100%; a 5% floor stops "screen went black in a dark
-room" lockouts. Confirm the floor (or allow 0 with a long-press escape
-hatch).
+** DONE Slider granularity and floor
+CLOSED: [2026-07-04 Sat]
+Resolved (Craig, 2026-07-04): 5% floor on the brightness slider, so a dark-room drag can't black the screen out and lock you out. brightnessctl's 0-100% range clamps to a 5% minimum.
* Implementation phases
@@ -130,5 +128,6 @@ hatch).
semantics) — unit-tested, no GTK.
3. Blueprint UI + gear bar module + open/close wiring; palette css factored
to a shared asset; AT-SPI smoke.
-4. Bar-module consolidation per the decision above (drop/keep indicators,
- refresh-signal wiring, keybind).
+4. Bar-module consolidation per decision A: drop the dim and airplane bar
+ modules (now panel-only), keep touchpad and caffeine on the bar, wire the
+ refresh signals so bar and panel agree, and bind Super+Shift+G.