docs(mobile): say which actions settle

Merged
KA
5d ago
+28-17

What and why

  • The settle JSDoc and its copy in the mobile reference said the wait follows any tap, fill, scroll, or back. A test's own steps never settle (surface.ts, engine.test.ts), as the options table and the package README already say.
  • The Detox and Maestro guides pointed deterministic suites at settle; they now point at transition.

Issue

None (docs change).

Verified

Ran it locally: yes

  • pnpm check green; pnpm --filter @e2e-dev/mobile run test:unit 518 passed (Node 24).
  • tests/login-form.e2e.ts on an iOS 26.3 simulator with settle: 3000 vs 150: test taps took 1.8–2.8 s in both, so no 3 s settle was added. The sign-in test hit iOS's "Save Password?" sheet in some runs, with either value.

Checklist

  • Changeset added (pnpm changeset) for any change to a published package, or the change is testbed, docs, or CI only.
  • Breaking change: title carries !, the changeset body names what breaks and what replaces it, and the deprecation warning landed a window earlier (stability policy in CONTRIBUTING.md).
  • Docs updated in the same PR: the docs/**/*.mdx page for the behavior, and skills/e2e/ if the skill describes it.
  • Contract change: emitted .d.ts reviewed, tests/types/sdk-types.ts updated; wire change edits the schema and both fixtures.
  • Engine contract change (e2e/engine): changesets for e2e, @e2e-dev/web, and @e2e-dev/mobile.