docs(mobile): sync the settle, videoTouches and dismissKeyboard blocks with their source JSDoc

Merged
KA
11d ago
+42-13

What and why

  • docs/reference/mobile.mdx says each entry shows its member's declaration, but the settle and videoTouches blocks had drifted from options.ts. They now copy the source JSDoc, which says more (why 150 ms is enough).
  • device.dismissKeyboard() had a one-line JSDoc, so an editor hover hid how it works on an iPhone and when it fails. It now carries the text the docs entry already had.
  • "Expo Simulators" was only in the docs copy of videoTouches; it is in both now. transition is left to #1564.

Issue

None (docs change)

Verified

Ran it locally: yes

  • The emitted packages/mobile/dist/device.d.ts carries the new dismissKeyboard JSDoc; each claim in it was checked against surface.ts and keyboard.ts.
  • pnpm check and pnpm --filter @e2e-dev/mobile run test (500 tests) pass.

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.