Dotfiles_ArchAP/docs/quickshell-dock-full-width-edge-20261111.md

QuickShell Dock — full-width bottom edge activation (2026-11-11)

Report and root cause

The centered QuickShell Dock used a layer-shell PanelWindow whose width matched its visible row of icons. Its hidden activation sensor was limited to min(360, dock.width). Outside that narrow central region, moving the pointer against the bottom edge of an output could not enter the surface.

Change

dock/Dock.qml now anchors its input surface to the bottom, left and right edges of each output. Only the 4px bottom sensor is interactive while hidden; the panel retains exclusionMode: Ignore, exclusiveZone: 0, WlrKeyboardFocus.None and the existing input Region mask.

The visible body is centered within this full-width surface and preserves its former calculated width, icon geometry, hover scale, 180ms activation dwell, 210ms slide, 450ms hide grace and scroll behavior. Context popup coordinates include the visual body's horizontal offset. This does not affect the top bar, Sway bindings, system shortcuts, favorites persistence or Session Restore V2.

Validation

qmllint quickshell/.config/quickshell/labfy-sway/dock/Dock.qml passed; node tests/dock/test_models.js and the six unit tests in tests/dock/ passed. Full tests/dock/headless.py ran with a private SwayFX and a separate artifacts directory in ~/.cache/labfy-dock-edge-test:

• PASS for activation from the left and right screen corners;
• sensor width equals output width while visual body remains centered;
• all existing favorites, auto-hide, context, scrolling, focus, drag, multi-window, framebuffer, animation and resolution scenarios pass;
• no visual geometry or SVG raster reload during the frame sweep.

No user desktop windows or active Sway compositor were touched by the headless tests. The production QuickShell service must reload the amended QML to receive the new input region; Sway itself does not need a reload.