Skip to content

feat(cua-driver)!: move cursor context into session badges - #2677

Merged
f-trycua merged 4 commits into
mainfrom
codex/plan-cursor-modifier-badge
Jul 29, 2026
Merged

feat(cua-driver)!: move cursor context into session badges#2677
f-trycua merged 4 commits into
mainfrom
codex/plan-cursor-modifier-badge

Conversation

@f-trycua

@f-trycua f-trycua commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • move delivery and target context from pointer-relative artwork into independently fading session badge chips
  • keep the twelve action animations in the cursor theme while making badge context host-owned
  • replace the cursor theme v1 contract with the action-only v2 source and CUATHEM3 compiled artifact
  • update macOS, Windows, X11, native Wayland, and GNOME geometry and lifecycle adapters
  • add renderer coverage to Linux and Windows CI and update the gallery, maintainer docs, and public personalization guide

Breaking change

Cursor theme v1 sources and compiled artifacts are rejected with rebuild guidance. Custom themes must use:

  • cua.cursor-theme/2
  • semantics version 2
  • profile cua-driver-actions-v2
  • twelve action animations and no modifiers section

Native cursor recordings

These clips come from the overlay-enabled agent_cursor_showcase_test. The test asserts that Cua cursor pixels are externally visible, then records move, click, type, scroll, and drag states. Shared behavior-matrix videos are not used here because those daemons intentionally disable the overlay to protect their action oracles.

macOS

macos-cursor-actions.mp4

Windows

windows-native-cursor-showcase.mp4

Linux X11

linux-x11-native-cursor-showcase.mp4

Linux Wayland

linux-wayland-native-cursor-showcase.mp4

Validation

  • cargo test -p cursor-overlay --lib
  • cargo test -p cursor-theme-cli
  • cargo test -p cursor-overlay -p cursor-theme-cli -p platform-macos -p platform-linux -p platform-windows --lib
  • cargo check -p cursor-overlay --examples
  • node --check libs/cua-driver/wayland-helper/winrects@cua/extension.js
  • live cursor gallery verification through Cua Driver: play, pause, replay, speed, backgrounds, combined context, and independent session-label fade
  • Cua Driver generated docs drift check
  • public docs link and hygiene checks
  • macOS Lume: 151 cells passed, with 143 delivered and 8 expected refusals
  • Windows interactive shared matrix: 83 cells passed, with 61 delivered and 22 expected refusals
  • Linux X11 shared matrix: 82 cells passed, with 47 delivered and 35 expected refusals
  • Linux Wayland on Sway shared matrix: 82 cells passed, with 47 delivered and 35 expected refusals
  • overlay-enabled native cursor showcase passed on Windows, Linux X11, and Linux Wayland at ddc7d5934f4c714093f0bd65ffde22c6078b6a59

The full Next.js docs build compiles successfully, then fails while prerendering the unrelated Lume CLI reference with ReferenceError: vm is not defined.

No release is part of this pull request workflow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant