refactor(cli): remove coordinate XPath return flag

Merged
SH
2mo ago
+17-62

Summary

Remove the unsupported --return-xpath option from Browse's coordinate click, hover, scroll, and drag commands. The CLI rejects the flag, and strict driver schemas reject stale returnXPath payloads before performing a mouse action. Update the examples and the Browse minor changeset for the V4 migration and flag removal.

XPath selectors and snapshot xpathMap remain supported.

Scope

The cursor overlay (#2869) and network sidecar (#2849) are already merged into main. This branch includes the final parent and reconciles its squash merge, preserving the current cursor fixes. The final diff against main is 8 files, +17/−62, limited to the XPath flag removal, documentation, removal of the obsolete XPath test, and release metadata.

Validation

  • At db5e592ce4359e1340ef4e921aad4b98581ee94a: focused driver-command suite 28 tests passed with an isolated daemon directory; changed-file formatting and ESLint, Browse TypeScript checks, and git diff --check passed.
  • Production code is unchanged from c15d1ef8ca8a53a25a2f5f05722ef45df9a89605, which passed a frozen install, fresh extension/SDK/Browse builds, Browse formatting/lint/type checks, changeset validation, and the full 28-file / 397-test Browse suite.
  • Built CLI smoke checks at that production-code head: --return-xpath was absent from all four mouse help pages; passing it to each command exited 2 with Nonexistent flag, without starting a daemon.
  • Confirmed the final network parent and its squash merge have identical trees, and the squash reconciliation did not change the resolved files.