[mgradwohl]

Description

Fixes #2724, with #2978 (the on-display tests on native Wayland). tools/wayland-matrix.sh runs TaskSmack on a headless sway and a headless labwc and drives it with a real pointer, checking each result against the compositor's own idea of the window.

sway

• The on-display suites, and the UI scenarios, on native Wayland.
• A title-bar drag, which the compositor runs (DRAGGABLE): the window must move by exactly the pointer's travel, (150, 100).
• A right-edge resize (RESIZE_RIGHT): about 120 px wider, with the left edge kept.
• A second output at scale 1.5: the window moves onto it, then the output is unplugged under it. TaskSmack must survive, back on HEADLESS-1.
• Persistence: the size at a close the compositor asks for (kill) is saved and restored on the next start.

labwc (sway never maximizes)

• TitleBarButtonsDoWhatTheySay now checks Maximize and Restore on native Wayland when TASKSMACK_COMPOSITOR_MAXIMIZES=1. TheHitTestCallbackAnswersForTheRealWindow's maximized round runs too, instead of skipping.

Why a virtual-pointer tool: a headless seat has no input device, so it offers clients no pointer (seat capabilities: 0). Then neither swaymsg seat … cursor nor wlrctl pointer reaches TaskSmack, and wlrctl's device lives for only one command. tools/wayland/virtual-pointer.c (~120 lines of C) holds one zwlr_virtual_pointer_v1 and takes abs / move / press / release / quit on stdin, answering ok after each. The script builds it with wayland-scanner and cc. Its protocol XML is vendored from wlr-protocols (MIT, pinned commit, REUSE entry).

labwc on WSLg: labwc always starts Xwayland, which needs a sticky /tmp/.X11-unix. Where it isn't (WSLg), the script gives labwc its own in an unprivileged mount namespace (unshare -rm). CI runners don't need that.

docs/dev/wayland-test-matrix.md describes the script.

The nightly job: Heavy Checks gains wayland-matrix. It runs nightly, and on a dispatch with scope all. Ubuntu 24.04 installs sway, labwc and libwayland-dev, builds the debug preset, runs the script, and uploads its logs when a check fails. The maintainer approved merging this workflow change on green. Verified: dispatched run 40265404539's wayland-matrix job passed. That run's win-coverage failure was this PR's compositorMaximizes() calling std::getenv on Windows, where the CRT deprecates it; that's fixed in ce13f2c.

PR Size

⚠️ Medium (~470 lines: the script ~300, the C tool ~120, docs, a 4-line test change, and the vendored 152-line XML).

Type of Change

• Build/CI improvement (tests and tooling)

Checklist

• I have read the CONTRIBUTING guidelines
• My code follows the project's coding standards
• I have run clang-format on my changes
• I have run pre-commit run --all-files or installed pre-commit hooks (REUSE and shellcheck included)
• All new and existing tests pass
• I have updated documentation as needed

Testing

tools/wayland-matrix.sh on WSL Ubuntu 26.04 with sway 1.11 and labwc 0.9.3, all checks passing:

== sway (headless) ==
  PASS  on-display tests
  PASS  UI scenarios
  PASS  title-bar drag moved the window by (150, 100)
  PASS  right-edge resize widened it by 120 px
  PASS  moved onto a second output at scale 1.5
  PASS  survived its output being unplugged, back on HEADLESS-1
  PASS  reopened at the 1400x720 it was closed at
== labwc (headless) ==
  PASS  Maximize and Restore, and the maximized window's hit test

shellcheck is clean. Xvfb runs are unaffected: the new environment switch is unset there.

Additional Notes

Found along the way: synthetic runs called themselves Administrator (#3004, fixed in #3005). Tooling and tests only, so no shipped code.

🤖 Generated with Claude Code

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None