Give a laptop its first week: the keys, the lid, the battery's endgame

The audit's fourth tier -- what a Framework owner reaches for in the first
week and found missing.

The power button stops being an instant, unconfirmed poweroff: a shipped
logind drop-in tells the daemon to stand down and the compositor binds the
key to the power menu, the way GNOME turns it into a question. Holding it
still hard-cuts through firmware. change-settings restarts logind so the
change applies without waiting for a boot, and the Power page says what the
button does now.

The function row fills in: F10 (XF86RFKill) toggles airplane mode through a
new panama-osd verb that blocks or unblocks every radio and says which way it
went; F9 (XF86Display) opens the Displays page, the honest action until
mirroring exists. And the lid becomes a switch bind: closing a docked lid
turns the internal panel off so nothing renders inside a closed shell and no
workspace strands on an invisible output, and opening it restores the panel
with the mode and scale chosen in Settings. panama-lid owns both decisions;
undocked machines suspend via logind before any of it matters.

The battery gets an endgame. On battery the screen dims to 30% two-thirds of
the way to blanking -- GNOME's single largest idle battery saver -- and
restores exactly the level it saved. At the urgent threshold the machine
suspends after a fifteen-second grace, cancelled by plugging in, because a
suspend preserves the session for days and a hard cut at 0% preserves
nothing; "Only warn" remains a choice on the Power page. Hibernate joins the
power menu, but only where logind answers CanHibernate with yes -- an entry
that fails silently is worse than none.

And brightness stops being two code paths: the Displays page now embeds the
same control the quick-settings panel uses, so the built-in backlight and
DDC/CI monitors share one surface that withdraws itself where neither
exists. The lid contract narrows to what its principle protects -- a
HandleLidSwitch drop-in -- so deliberate policy for other keys can ship.

Claude-Session: https://claude.ai/code/session_01Epx9ZC1gwm81K3jm9x9CKh

config/dot/quickshell/modules/settings/DisplaysPage.qml

@@ -12,6 +12,7 @@
 import QtQuick
 import qs.config
 import qs.services
+import qs.modules.quicksettings
 import qs.widgets
 
 SettingsPage {
@@ -289,35 +290,21 @@ SettingsPage {
     // writing it into settings.json would mean restoring a value the panel had
     // already moved on from. So there is no schema key here and no SliderRow --
     // the rows read and write the display directly.
+    // One brightness surface for both kinds this machine may have, shared
+    // with the quick-settings panel so the two can never disagree. This card
+    // was DDC/CI-only for a while, which on a laptop meant Settings showed
+    // an error about external-monitor brightness while the panel's backlight
+    // worked fine one panel over.
     SettingsCard {
-        visible: Brightness.available || Brightness.lastError !== ""
+        visible: pageBrightness.visible || Brightness.lastError !== ""
         title: "Brightness"
-        subtitle: Brightness.available
-            ? "Sent to the monitor over DDC/CI, the same channel its buttons use."
+        subtitle: pageBrightness.visible
+            ? "The built-in panel through its backlight; external monitors over DDC/CI, the same channel their buttons use."
             : Brightness.lastError
 
-        Repeater {
-            model: Brightness.displays
-
-            SettingRow {
-                id: brightnessRow
-                required property var modelData
-                required property int index
-
-                label: Displays.monitorNamed(modelData.connector)?.description || modelData.connector
-                detail: modelData.connector ? modelData.connector + " · " + modelData.value + "%"
-                                            : modelData.value + "%"
-                divider: brightnessRow.index < Brightness.displays.length - 1
-                controlWidth: 190
-
-                ValueSlider {
-                    anchors.verticalCenter: parent.verticalCenter
-                    anchors.right: parent.right
-                    width: parent.width
-                    value: brightnessRow.modelData.value / 100
-                    onMoved: v => Brightness.set(brightnessRow.modelData.bus, Math.round(v * 100))
-                }
-            }
+        BrightnessControl {
+            id: pageBrightness
+            width: parent.width
         }
     }