# Contracts that take over the desktop you are sitting in front of.
#
# Most of the suite is hermetic: stub commands on PATH, a throwaway HOME, or a
# Quickshell harness booted with `qs -p` under its own semantic entry file. Those
# are safe to run mid-session and are not listed here.
#
# The ones below are not. Each drives the LIVE shell, compositor or machine --
# it opens overlays over whatever you were doing, restarts the running shell,
# moves your windows, changes your monitor, or rewrites a real default. Run
# during a working session they are, at best, a series of surprises; at worst
# they leave state behind when interrupted.
#
# `panama test --safe` skips exactly this list, which is why every entry's
# comment says what it does to the session rather than what it proves.
# tests/setup/desktop-hijacking-contract checks each path exists and sweeps
# tests/ for hijacking contracts that are missing from here.
#
# One repo-relative path per line.

# Pushes a fixture privacy state into the running shell and opens the activity
# panel over the desktop.
tests/quickshell/activity-indicator-contract

# Pushes fixture privacy states and Signal Glass events into the running shell,
# and dismisses the live capsule.
tests/quickshell/activity-state-contract

# Opens the live agenda popover and the notification centre, and starts a real
# focus session on the running shell.
tests/quickshell/calendar-agenda-contract

# Opens and closes the cheatsheet overlay on the running shell.
tests/quickshell/cheatsheet-contract

# Changes the real default browser through the default-apps helper -- xdg-mime
# and xdg-settings defaults on this machine -- and puts it back.
tests/quickshell/default-apps-roles-contract

# Changes the real monitor's mode, position, scale and rotation through the live
# compositor, restoring the display it started from.
tests/quickshell/displays-contract

# Starts, pauses, reveals and ends a real focus session, and opens Mission
# Control on the running shell.
tests/quickshell/focus-session-contract

# Restarts panama-quickshell.service (or `qs kill`s the shell when unsupervised)
# with a focus session in flight; an interrupted run leaves caffeine latched on.
tests/quickshell/focus-session-expiry

# Restarts panama-quickshell.service (or `qs kill`s the shell when unsupervised)
# mid-session to prove a paused focus session survives it.
tests/quickshell/focus-session-restart

# Spawns a real kitty window, moves it between your workspaces and into the
# scratchpad, and opens the overview.
tests/quickshell/overview-live-actions

# Opens the overview on the running shell and types a search into it.
tests/quickshell/overview-search-contract

# Toggles the live caffeine inhibitor and Night Light on the running shell.
tests/quickshell/panama-action-ipc-contract

# Opens and closes the live overview.
tests/quickshell/scratchpad-shelf-contract

# Opens the live screen-intelligence and capture overlays and runs an analysis
# through them.
tests/quickshell/screen-intelligence-contract

# Flips real compositor policy -- gaps, blur, inactive opacity, keyboard layout
# -- on the live compositor and restores it.
tests/quickshell/settings-hyprland-write-contract

# Applies compositor policy through the production write path against the live
# compositor, and writes preferences to the real settings store (no isolated
# config home).
tests/quickshell/settings-system-contract

# Opens the real Settings window, routes it between pages, and closes it through
# the compositor.
tests/quickshell/settings-window-contract

# Flips every compositor-backed setting to a value it does not hold, one at a
# time, on the live compositor.
tests/quickshell/settings-write-sweep-contract

# Publishes a critical fixture event into the live Signal Glass capsule.
tests/quickshell/signal-glass-contract

# Publishes fixture events into the live capsule and toggles Do Not Disturb.
tests/quickshell/status-events-contract

# Drives the live window switcher and commits a switch, which moves your focus.
tests/quickshell/switcher-contract

# Opens and closes the welcome overlay on the running shell.
tests/quickshell/welcome-contract