Gabriel Brown
f8f5b25510
Desktop & Dock becomes Shell — Bar, Dock, Control Center, Tiling, Workspaces — the home for everything Quickshell draws. The settings- management cluster moves to System as Sync & Backup, Appearance's Shell tab dissolves, and 24-hour time finally lives on Date & Time, which always owned it. The bar gets what it never had: a way to survive the wallpaper. A second neutral text family (follow theme, or forced light or dark), a one-layer shadow under every glyph, and a gradient scrim for wallpapers nothing else survives — all off by default, pixel-identical until asked. Widgets earn toggles (weather, media, clipboard, calendar countdown), the vitals cluster stops leaving a dead pill behind, and Control Center's sections learn to step aside. The dock graduates from MVP: a context menu with window rows, pin, unpin, quit and new-window; scroll an icon to cycle its windows; drag to reorder on the dock itself; hover previews with one-shot captures; and "Add App to Dock" in the launcher. Three real bugs died en route — menus that slid away with the autohide, a readonly-property crash on every menu open, and a drag that drifted half a slot per icon on side docks. The pinned-apps editor in Settings becomes a drag strip. 166 contracts; the full suite is green except two live display and switcher tests that cannot run behind a locked session — re-verified on unlock. Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8
90 lines
4.4 KiB
Bash
Executable File
90 lines
4.4 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
|
|
# Every "open the settings for this" jump must land somewhere real.
|
|
#
|
|
# ShellState.openSettings() hands its argument to SettingsRoutes.resolve(),
|
|
# which falls back to Home for anything it does not recognise. That fallback is
|
|
# sensible and it is also completely silent: a typo, or a page renamed later,
|
|
# turns a right-click into "opens Settings on the wrong page" with nothing
|
|
# logged and no error.
|
|
#
|
|
# Before this, exactly four places in the entire shell could reach Settings, so
|
|
# the risk was small. The bar now offers a jump on every widget, which makes the
|
|
# fallback worth guarding.
|
|
#
|
|
# A jump may name either a leaf ("firewall") or a category ("network"), since
|
|
# resolve() opens a category at its first available tab. Anything else is a
|
|
# typo, and SettingsRoutes.qml is the only place that knows which is which.
|
|
|
|
set -uo pipefail
|
|
|
|
repo_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
|
routes="$repo_dir/config/dot/quickshell/services/SettingsRoutes.qml"
|
|
modules="$repo_dir/config/dot/quickshell/modules"
|
|
dock_menu="$modules/dock/DockContextMenu.qml"
|
|
notification_card="$modules/notifications/NotificationCard.qml"
|
|
osd="$modules/osd/Osd.qml"
|
|
|
|
fail() {
|
|
printf 'settings jump contract: %s\n' "$1" >&2
|
|
exit 1
|
|
}
|
|
|
|
[[ -r "$routes" ]] || fail "cannot read $routes"
|
|
|
|
# Every id SettingsRoutes recognises: the categories (which carry an icon) and
|
|
# the tabs inside them (which do not).
|
|
known="$(grep -oE '\{ page: "[a-z-]+"' "$routes" | sed 's/.*"\(.*\)"/\1/' | sort -u)"
|
|
[[ -n "$known" ]] || fail 'no pages found in SettingsRoutes -- this contract is not reading it correctly'
|
|
|
|
jumps="$(grep -rhoE 'openSettings\("[a-z-]+"\)' "$modules" 2>/dev/null \
|
|
| sed 's/openSettings("//; s/")//' | sort -u)"
|
|
[[ -n "$jumps" ]] || fail 'found no settings jumps at all -- this contract is not reading the modules correctly'
|
|
|
|
count=0
|
|
while read -r page; do
|
|
[[ -n "$page" ]] || continue
|
|
grep -qx "$page" <<<"$known" \
|
|
|| fail "a jump opens \"$page\", which is neither a leaf nor a category in SettingsRoutes -- resolve() falls back to Home silently, so this reads as a right-click that goes to the wrong page"
|
|
count=$((count + 1))
|
|
done <<<"$jumps"
|
|
|
|
# The bar is where a person looks first, and Pill has offered a right-click
|
|
# signal all along that nothing connected -- so the gesture did nothing on every
|
|
# widget in the bar. Anything built on Pill that can be configured should say so.
|
|
for widget in Clock WeatherWidget VitalsWidget StatusCluster MediaWidget; do
|
|
file="$modules/bar/$widget.qml"
|
|
[[ -r "$file" ]] || continue
|
|
grep -q 'onSecondaryActivated' "$file" \
|
|
|| fail "$widget has no right-click jump; Pill routes right-click to secondaryActivated, so leaving it unconnected makes the gesture silently inert"
|
|
done
|
|
|
|
# These surfaces do not have a bar-style secondary-click signal. Their
|
|
# contextual affordances must retain the original interaction and route to the
|
|
# setting page that owns the controls.
|
|
[[ -r "$dock_menu" ]] || fail 'dock has no contextual menu, so application actions cannot keep a final Dock settings action'
|
|
grep -qF 'ShellState.openSettings("dock")' "$dock_menu" \
|
|
|| fail 'dock context menu does not open Dock settings'
|
|
grep -qF 'entry.actions' "$dock_menu" \
|
|
|| fail 'dock context menu dropped application actions'
|
|
actions_line="$(grep -nF 'entry.actions' "$dock_menu" | head -1 | cut -d: -f1)"
|
|
settings_line="$(grep -nF 'Dock settings' "$dock_menu" | head -1 | cut -d: -f1)"
|
|
[[ -n "$actions_line" && -n "$settings_line" && "$actions_line" -lt "$settings_line" ]] \
|
|
|| fail 'Dock settings is not the final contextual action after application actions'
|
|
|
|
grep -qF 'Notification settings' "$notification_card" \
|
|
|| fail 'notification card has no overflow Settings action'
|
|
grep -qF 'ShellState.openSettings("notifications")' "$notification_card" \
|
|
|| fail 'notification overflow does not open Notifications settings'
|
|
grep -qF 'Popover {' "$notification_card" \
|
|
|| fail 'notification Settings action is not contained in an overflow menu'
|
|
|
|
grep -qF 'acceptedButtons: Qt.RightButton' "$osd" \
|
|
|| fail 'OSD does not accept its contextual secondary click'
|
|
grep -qF 'ShellState.openSettings("accessibility")' "$osd" \
|
|
|| fail 'OSD secondary click does not open Accessibility settings'
|
|
grep -qF 'OsdState.hide()' "$osd" \
|
|
|| fail 'OSD remains visible after its Settings jump'
|
|
|
|
printf 'settings jump contract: PASS (%d distinct destinations)\n' "$count"
|