fix: align press/click behavior and honor fast press cadence on iOS

[thymikee]

Summary

Align press and click interaction semantics so both commands support coordinate targets (x y), @ref, and selector expressions in the same handler flow.

Introduce explicit --double-tap series behavior for press/click and apply it consistently across platforms:

• iOS runner fast path uses XCTest tapSeries with doubleTap gesture semantics.
• non-runner path performs two taps per iteration when --double-tap is set (including Android).
• reject unsupported combinations (--double-tap with --hold-ms or --jitter-px).

Improve iOS tap cadence by skipping per-command waitForExistence unless the active app actually switched.

Update replay/session script handling and tests for the new flag and unified behavior.

Update docs and skills content to match shipped behavior:

• document --double-tap
• document press/click targeting parity
• include gesture-series examples and constraints

Validation

• pnpm typecheck
• pnpm test:unit
• pnpm test:smoke
• pnpm build:xcuitest

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-02-18 15:02 UTC