@delacour/warden-e2e 0.14.0 → 0.15.0

package/preload.mjs

@@ -30,6 +30,7 @@ import {
   isInteractiveRole,
   resolveRole,
   indexSnapshot,
+  keyboardVisible,
   testIdQuery,
   textQuery,
   roleQuery,
@@ -61,6 +62,10 @@ import {
   createSimdClient,
   spawnSimd,
   connectSimd,
+  KEYBOARD_MODES,
+  DEFAULT_KEYBOARD_MODE,
+  IME_STASH_ENABLED,
+  IME_STASH_DEFAULT,
   CAMERA_FACINGS,
   CONDITION_AREAS,
   resolveNetwork,
@@ -114,7 +119,7 @@ import {
   onlyWasSeen,
   WORKSPACE_VERSION,
   WARDEN_E2E_VERSION2
-} from "./chunk-zk3wxa70.mjs";
+} from "./chunk-e3cry5br.mjs";
 
 // ../../packages/e2e/src/preload.ts
 import { afterAll, setDefaultTimeout } from "bun:test";
@@ -1376,6 +1381,8 @@ function physicalConditionOps(device) {
     locale: () => refuse("locale"),
     a11y: () => refuse("a11y"),
     battery: () => refuse("battery"),
+    keyboard: () => refuse("keyboard"),
+    keyboardState: () => refuse("keyboardState"),
     memoryWarning: () => refuse("memoryWarning"),
     push: () => refuse("push"),
     camera: () => refuse("camera")
@@ -4079,6 +4086,75 @@ function batteryOp(c) {
     };
   };
 }
+var nullable = (value) => value.trim() === "null" ? "" : value.trim();
+async function readIme(c) {
+  const enabled = await c.shell(settingGetArgv("secure", "enabled_input_methods"));
+  const current = await c.shell(settingGetArgv("secure", "default_input_method"));
+  return { enabled: nullable(enabled.stdout), default: nullable(current.stdout) };
+}
+async function readImeStash(c) {
+  const enabled = await c.shell(settingGetArgv("global", IME_STASH_ENABLED));
+  const current = await c.shell(settingGetArgv("global", IME_STASH_DEFAULT));
+  const state = { enabled: nullable(enabled.stdout), default: nullable(current.stdout) };
+  return state.enabled === "" ? undefined : state;
+}
+async function readKeyboardMode(c) {
+  return (await readIme(c)).enabled === "" ? "hardware" : "software";
+}
+function imeVisibleIn(dump) {
+  return /\bisVisible=true\b/.test(dump);
+}
+async function readKeyboardVisible(c) {
+  const read = await c.shell(["dumpsys", "window", "InputMethod"]);
+  return read.ok && imeVisibleIn(read.stdout);
+}
+async function restoreImes(c) {
+  const stash = await readImeStash(c);
+  if (stash !== undefined) {
+    const steps = [
+      ["settings", "put", "secure", "enabled_input_methods", stash.enabled],
+      ...stash.default === "" ? [] : [["settings", "put", "secure", "default_input_method", stash.default]],
+      ["settings", "delete", "global", IME_STASH_ENABLED],
+      ["settings", "delete", "global", IME_STASH_DEFAULT]
+    ];
+    for (const argv of steps) {
+      const done = await c.must(argv);
+      if (!done.success)
+        return done;
+    }
+  }
+  return { success: true, data: { mode: "software" } };
+}
+async function hideImes(c, current) {
+  const listed = await c.shell(["ime", "list", "-s"]);
+  const ids = listed.stdout.split(`
+`).map((line) => line.trim()).filter((line) => line.includes("/"));
+  const steps = [
+    ["settings", "put", "global", IME_STASH_ENABLED, current.enabled],
+    ...current.default === "" ? [] : [["settings", "put", "global", IME_STASH_DEFAULT, current.default]],
+    ...ids.map((id) => ["ime", "disable", id])
+  ];
+  for (const argv of steps) {
+    const done = await c.must(argv);
+    if (!done.success)
+      return done;
+  }
+  if ((await readIme(c)).enabled !== "") {
+    return driverErr("E_IO", "an input method is still enabled after ime disable", { detail: { serial: c.serial } });
+  }
+  return { success: true, data: { mode: "hardware", previousIme: current } };
+}
+function keyboardOp(c) {
+  return async (mode) => {
+    if (mode === "software")
+      return restoreImes(c);
+    const current = await readIme(c);
+    if (current.enabled !== "")
+      return hideImes(c, current);
+    const previous = await readImeStash(c);
+    return { success: true, data: { mode, ...previous === undefined ? {} : { previousIme: previous } } };
+  };
+}
 function memoryWarningOp(c) {
   return async (opts) => {
     const app = c.packageOf(opts?.bundleId, "memoryWarning");
@@ -4153,6 +4229,12 @@ function createAndroidSettings(deps) {
     locale: localeOp(ctx),
     a11y: a11yOp(ctx),
     battery: batteryOp(ctx),
+    keyboard: keyboardOp(ctx),
+    keyboardMode: () => readKeyboardMode(ctx),
+    keyboardVisible: () => readKeyboardVisible(ctx),
+    async keyboardState() {
+      return { success: true, data: { mode: await readKeyboardMode(ctx), visible: await readKeyboardVisible(ctx) } };
+    },
     memoryWarning: memoryWarningOp(ctx),
     async push() {
       return driverErr("E_UNSUPPORTED", "push notifications through the shell are iOS only (`simctl push`); Android needs FCM");
@@ -5840,7 +5922,12 @@ function buildDriver(options, session, baseScreen, clock, execBinary, facts) {
     });
     return { success: true, data: { ...applied.data, condition: op } };
   };
-  const { talkback, ...settings } = createAndroidSettings({
+  const {
+    talkback,
+    keyboardMode: _mode,
+    keyboardVisible: _visible,
+    ...settings
+  } = createAndroidSettings({
     session,
     serial,
     ...options.appPackage ? { appPackage: options.appPackage } : {},
@@ -5958,6 +6045,11 @@ function buildDriver(options, session, baseScreen, clock, execBinary, facts) {
       ...options.cameraHost ?? createAndroidCameraHost({ serial, exec })
     }),
     ...facts.physical ? physicalConditionOps(`physical Android device ${serial}`) : {},
+    keyboardState: settings.keyboardState,
+    async dismissKeyboard() {
+      const pressed = await pressButton("back");
+      return pressed.success ? { success: true, data: { via: "back" } } : pressed;
+    },
     biometrics,
     app: createAppCommands({
       session,
@@ -6036,6 +6128,17 @@ function writeLaunchSettings(path, settings) {
   }
 }
 
+// ../../packages/e2e/src/driver/read-deadline.ts
+import { AsyncLocalStorage } from "async_hooks";
+var deadlines = new AsyncLocalStorage;
+function withReadDeadline(remaining, fn) {
+  return deadlines.run({ remaining }, fn);
+}
+function readDeadlineRemaining() {
+  const deadline = deadlines.getStore();
+  return deadline === undefined ? undefined : Math.max(0, deadline.remaining());
+}
+
 // ../../packages/e2e/src/driver/ios/inject.ts
 import { mkdirSync as mkdirSync7, readFileSync as readFileSync5, renameSync as renameSync6, rmSync as rmSync6, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname3, join as join10, resolve } from "path";
@@ -6056,12 +6159,17 @@ function encodeInjectState(state) {
     clockOffsetMs: Math.trunc(state.clockOffsetMs ?? 0),
     ...state.clockFrozenMs === undefined ? {} : { clockFrozenMs: Math.trunc(state.clockFrozenMs) },
     ...state.a11yRead ? { a11yRead: true } : {},
-    ...state.camera === undefined ? {} : { camera: state.camera }
+    ...state.camera === undefined ? {} : { camera: state.camera },
+    ...state.keyboard === undefined ? {} : { keyboard: state.keyboard },
+    ...state.dismissKeyboard ? { dismissKeyboard: true } : {}
   });
 }
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parseKeyboard(value) {
+  return KEYBOARD_MODES.find((mode) => mode === value);
+}
 function parseFeed(value) {
   if (!isRecord3(value) || typeof value.path !== "string")
     return;
@@ -6089,7 +6197,8 @@ function parseInjectState(text) {
       clockOffsetMs: typeof data.clockOffsetMs === "number" ? data.clockOffsetMs : 0,
       ...typeof data.clockFrozenMs === "number" ? { clockFrozenMs: data.clockFrozenMs } : {},
       ...data.a11yRead === true ? { a11yRead: true } : {},
-      ..."camera" in data ? { camera: parseCamera(data.camera) } : {}
+      ..."camera" in data ? { camera: parseCamera(data.camera) } : {},
+      ...parseKeyboard(data.keyboard) ? { keyboard: parseKeyboard(data.keyboard) } : {}
     };
   } catch {
     return;
@@ -6123,11 +6232,12 @@ function injectLaunchEnv(input) {
     ...input.clockOffsetMs ? { WARDEN_CLOCK_OFFSET_MS: String(Math.trunc(input.clockOffsetMs)) } : {},
     ...input.clockFrozenMs === undefined ? {} : { WARDEN_CLOCK_FROZEN_MS: String(Math.trunc(input.clockFrozenMs)) },
     ...input.camera ? { WARDEN_CAMERA: "1" } : {},
+    ...input.keyboard ? { WARDEN_KEYBOARD: input.keyboard } : {},
     ...input.debug ? { WARDEN_INJECT_DEBUG: "1" } : {}
   };
 }
 function shouldInject(input) {
-  return input.networkActive || input.clockActive || input.cameraActive === true || input.requested;
+  return input.networkActive || input.clockActive || input.cameraActive === true || input.keyboardActive === true || input.requested;
 }
 function locateInjectDylib(input) {
   const tried = [];
@@ -6212,7 +6322,13 @@ function createInjectChannel(input) {
     current: readState,
     write(next) {
       fs.mkdir(dirname3(statePath));
-      const state = { ...next, seq: Math.max(readState().seq + 1, Math.trunc(now())) };
+      const previous = readState();
+      const keyboard = next.keyboard ?? previous.keyboard;
+      const state = {
+        ...next,
+        ...keyboard === undefined ? {} : { keyboard },
+        seq: Math.max(previous.seq + 1, Math.trunc(now()))
+      };
       fs.writeAtomic(statePath, encodeInjectState(state));
       return state;
     },
@@ -6229,9 +6345,14 @@ function createInjectChannel(input) {
       }
     },
     reset() {
+      const keyboard = readState().keyboard;
       fs.remove(ackPath);
       fs.remove(statePath);
       fs.remove(injectEventsPath(statePath));
+      if (keyboard !== undefined) {
+        fs.mkdir(dirname3(statePath));
+        fs.writeAtomic(statePath, encodeInjectState({ seq: 0, keyboard }));
+      }
     }
   };
 }
@@ -6792,8 +6913,14 @@ function defaultBuildCommand(platform, configuration, framework = "expo") {
   if (platform === "ios") {
     return `${IOS_NATIVE_PREPARE} && bunx expo run:ios ${configuration === "Release" ? "--configuration Release " : ""}${flags}`;
   }
-  return `bunx expo run:android ${configuration === "Release" ? "--variant release " : ""}${flags}`;
+  return androidGradleCommand(configuration, framework);
+}
+function androidGradleCommand(configuration, framework = "expo") {
+  const gradle = `cd android && ./gradlew app:assemble${configuration} -PreactNativeArchitectures=${ANDROID_HOST_ABI}`;
+  return framework === "react-native" ? gradle : `${ANDROID_NATIVE_PREPARE} && ${gradle}`;
 }
+var ANDROID_NATIVE_PREPARE = "{ [ -f android/gradlew ] || bunx expo prebuild --platform android --no-install; }";
+var ANDROID_HOST_ABI = '"$([ "$(uname -m)" = arm64 ] && echo arm64-v8a || echo x86_64)"';
 var DEFAULT_BUILD_COMMAND = {
   ios: defaultBuildCommand("ios", "Debug"),
   android: defaultBuildCommand("android", "Debug")
@@ -7370,6 +7497,63 @@ function createIosNativeAudit(o) {
   };
 }
 
+// ../../packages/e2e/src/driver/ios/ios-keyboard.ts
+var okVoid2 = { success: true, data: undefined };
+function createIosKeyboard(deps) {
+  const { channel } = deps;
+  let expectLoad = false;
+  const mode = () => channel.current().keyboard ?? DEFAULT_KEYBOARD_MODE;
+  return {
+    mode,
+    launchEnv() {
+      const dylib = deps.dylib();
+      if (!dylib.success)
+        return;
+      channel.reset();
+      channel.write({});
+      expectLoad = true;
+      return injectLaunchEnv({
+        dylib: dylib.data,
+        statePath: channel.statePath,
+        keyboard: mode(),
+        ...deps.debug ? { debug: true } : {}
+      });
+    },
+    launchMode: () => ({ WARDEN_KEYBOARD: mode() }),
+    async confirmLoaded() {
+      if (!expectLoad)
+        return okVoid2;
+      expectLoad = false;
+      if (await channel.acked(channel.current().seq, INJECT_LOAD_MS))
+        return okVoid2;
+      const error = driverError("E_INTERNAL", `the app did not load libwarden-inject.dylib within ${INJECT_LOAD_MS} ms: the keyboard mode would not reach it. Check the app is a simulator build, and run with WARDEN_E2E_DEBUG=1`, { detail: { statePath: channel.statePath } });
+      return { success: false, error };
+    },
+    async dismiss() {
+      if (!channel.attached())
+        return { success: true, data: { attached: false } };
+      const { seq: _seq, a11yRead: _read, ...rest } = channel.current();
+      const state = channel.write({ ...rest, dismissKeyboard: true });
+      if (await channel.acked(state.seq, INJECT_ACK_MS))
+        return { success: true, data: { attached: true } };
+      return driverErr("E_TIMEOUT", `the app did not acknowledge the keyboard dismissal within ${INJECT_ACK_MS} ms`, {
+        detail: { statePath: channel.statePath }
+      });
+    },
+    async keyboard(next) {
+      const { seq: _seq, a11yRead: _read, ...rest } = channel.current();
+      const state = channel.write({ ...rest, keyboard: next });
+      if (!channel.attached())
+        return { success: true, data: { mode: next, appliesOnLaunch: true } };
+      if (await channel.acked(state.seq, INJECT_ACK_MS))
+        return { success: true, data: { mode: next } };
+      return driverErr("E_TIMEOUT", `the app did not acknowledge the keyboard mode within ${INJECT_ACK_MS} ms`, {
+        detail: { statePath: channel.statePath }
+      });
+    }
+  };
+}
+
 // ../../packages/e2e/src/driver/ios/ios-session.ts
 var SHUTDOWN_TIMEOUT_MS = 500;
 function swappableClient(initial, o) {
@@ -7779,6 +7963,9 @@ function optionalFields(node) {
     fields.pid = node.pid;
   return fields;
 }
+function roleOf(node) {
+  return node.role === "other" && node.identifier === "inputView" ? "keyboard" : node.role;
+}
 function normalizeElements(wire, screen, prefix = "", depth = 0) {
   const flat = [];
   const elements = wire.map((node, index) => {
@@ -7786,7 +7973,7 @@ function normalizeElements(wire, screen, prefix = "", depth = 0) {
     const element = {
       ...optionalFields(node),
       id: node.id ?? path,
-      role: node.role,
+      role: roleOf(node),
       rawType: node.rawType,
       frame: node.frame,
       depth: node.depth ?? depth,
@@ -8459,7 +8646,7 @@ var SOCKET_RETRY_MS = 500;
 function params(values) {
   return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
 }
-var okVoid2 = { success: true, data: undefined };
+var okVoid3 = { success: true, data: undefined };
 function fail2(error) {
   return { success: false, error };
 }
@@ -8574,8 +8761,26 @@ function healthDetail(d) {
     ...d.ax.error !== undefined ? { axError: d.ax.error } : {},
     ...d.socket ? { socket: d.socket } : {},
     ...d.xcode ? { xcode: d.xcode } : {},
-    ...d.state ? { state: d.state } : {}
-  };
+    ...d.state ? { state: d.state } : {},
+    ...d.axWedge ? { axWedge: toAxWedgeState(d.axWedge) } : {}
+  };
+}
+var AX_WEDGE_RECOVER_MS = 75000;
+function toAxWedgeState(d) {
+  const state = {
+    restarts: d.restarts,
+    maxRestarts: d.maxRestarts,
+    recovering: d.recovering,
+    ...d.checked !== undefined ? { checked: d.checked } : {}
+  };
+  const last = d.last;
+  if (last?.outcome === "restarted")
+    state.last = { outcome: "restarted", agoMs: last.agoMs, ...last.ms !== undefined ? { ms: last.ms } : {} };
+  else if (last?.outcome === "not-wedged")
+    state.last = { outcome: "not-wedged", agoMs: last.agoMs };
+  else if (last?.outcome === "failed")
+    state.last = { outcome: "failed", agoMs: last.agoMs, error: last.error };
+  return state;
 }
 
 class DriverFailure extends Error {
@@ -8598,14 +8803,15 @@ function decodeBase64(png) {
 function predatesOp(error) {
   return error.code === "E_UNSUPPORTED" || error.code === "E_BAD_REQUEST" && /unknown (input )?op/.test(error.message);
 }
-async function launchWithInjection(net, a11y, requested) {
+async function launchWithInjection(net, a11y, keyboard, requested) {
   const injected = net ? await net.launchEnv(requested ?? {}) : undefined;
   if (injected && !injected.success)
     return injected;
   const forA11y = injected?.data || !a11y ? undefined : await a11y.launchEnv(requested ?? {});
   if (forA11y && !forA11y.success)
     return forA11y;
-  const env = injected?.data ?? forA11y?.data;
+  const carried = injected?.data ?? forA11y?.data;
+  const env = keyboard ? carried ? { ...carried, ...keyboard.launchMode() } : keyboard.launchEnv() : carried;
   return { success: true, data: env ? { ...requested, env: { ...requested?.env, ...env } } : requested };
 }
 function createIosDriver(swap, simctl, opts) {
@@ -8620,6 +8826,7 @@ function createIosDriver(swap, simctl, opts) {
     relaunch: (bundleId) => driverRef ? driverRef.app.launch(bundleId, { relaunch: true, inject: true }) : noLeaseProxy()
   });
   const a11y = opts.a11y?.();
+  const kbd = opts.keyboard?.();
   const nativeAudit = opts.nativeAudit?.({ lastBundle: () => lastLaunched });
   const { client } = swap;
   let axFailures = 0;
@@ -8686,7 +8893,7 @@ function createIosDriver(swap, simctl, opts) {
   const send = (op, p = {}, timeoutMs) => request(op, p, timeoutMs === undefined ? {} : { timeoutMs });
   const sendVoid = async (op, p = {}, timeoutMs) => {
     const result = await send(op, p, timeoutMs);
-    return result.success ? okVoid2 : result;
+    return result.success ? okVoid3 : result;
   };
   const gestureTimeout = (durationMs, base = 0) => (durationMs ?? 0) + base + GESTURE_MARGIN_MS;
   const helperOutdated = () => fail2(driverError("E_UNSUPPORTED", `this warden-simd predates the gesture op: restart the helper (warden ui close --udid ${udid}) or rebuild it (bun run --cwd packages/e2e native:build)`, { detail: { reason: "helper_outdated" } }));
@@ -8725,7 +8932,7 @@ function createIosDriver(swap, simctl, opts) {
     if (!viaHelper.success)
       return viaHelper;
     note(viaHelper.data);
-    return okVoid2;
+    return okVoid3;
   }
   let failureDiagnosed = false;
   const fetchSnapshot = async (o) => {
@@ -8775,10 +8982,11 @@ function createIosDriver(swap, simctl, opts) {
   async function snapshot(o) {
     if (bridgeProven)
       return snapshotOnce(o);
+    const budgetMs = opts.coldBridgeBudgetMs ?? COLD_BRIDGE_BUDGET_MS;
     const result = await retryColdSnapshot(() => snapshotOnce(o), {
       now,
       sleep,
-      budgetMs: opts.coldBridgeBudgetMs ?? COLD_BRIDGE_BUDGET_MS,
+      budgetMs: Math.min(budgetMs, readDeadlineRemaining() ?? budgetMs),
       ...opts.log ? { log: opts.log } : {}
     });
     if (result.success)
@@ -8832,6 +9040,9 @@ function createIosDriver(swap, simctl, opts) {
     const a11yLoaded = await a11y?.confirmLoaded();
     if (a11yLoaded && !a11yLoaded.success)
       return a11yLoaded.error;
+    const kbdLoaded = await kbd?.confirmLoaded();
+    if (kbdLoaded && !kbdLoaded.success)
+      return kbdLoaded.error;
     return;
   }
   async function rebind(bundleId) {
@@ -8846,8 +9057,6 @@ function createIosDriver(swap, simctl, opts) {
       return false;
     }
     noteRebind(reply.data);
-    if (reply.data.bound)
-      bridgeProven = true;
     return reply.data.bound;
   }
   function noteSettleAxFailure(message) {
@@ -8933,6 +9142,18 @@ function createIosDriver(swap, simctl, opts) {
     const result = await request("frontmost", { bundleId }, { timeoutMs: FRONTMOST_TIMEOUT_MS });
     return result.success ? { success: true, data: result.data.frontmost } : result;
   }
+  async function axWedge(o) {
+    const recover = o?.recover === true;
+    const result = await request("axWedge", { recover }, { timeoutMs: recover ? AX_WEDGE_RECOVER_MS : 5000 });
+    if (result.success)
+      return { success: true, data: toAxWedgeState(result.data) };
+    if (predatesOp(result.error)) {
+      return driverErr("E_UNSUPPORTED", "this warden-simd predates the axWedge op", {
+        detail: { reason: "helper_outdated" }
+      });
+    }
+    return result;
+  }
   async function health() {
     const result = await request("health");
     if (!result.success)
@@ -9002,6 +9223,7 @@ function createIosDriver(swap, simctl, opts) {
     alert,
     alertOn,
     isFrontmost,
+    axWedge,
     readA11y: async (snapshot) => a11y ? a11y.read(snapshot) : driverErr("E_UNSUPPORTED", "this iOS driver was opened without the injected library channel"),
     a11yEvents: async (since) => a11y ? a11y.events(since) : driverErr("E_UNSUPPORTED", "this iOS driver was opened without the injected library channel"),
     auditNatively: async (options) => nativeAudit ? nativeAudit.audit(options ?? {}) : { issues: [], skipped: { source: "xcuitest", reason: "this iOS driver was opened without the runner" } },
@@ -9014,6 +9236,26 @@ function createIosDriver(swap, simctl, opts) {
     locale: (tag, o) => settings ? settings.locale(tag, o) : noSettings(),
     a11y: (op) => settings ? settings.a11y(op) : noSettings(),
     battery: (op) => settings ? settings.battery(op) : noSettings(),
+    keyboard: async (mode) => kbd ? kbd.keyboard(mode) : driverErr("E_UNSUPPORTED", "this iOS driver was opened without the injected library channel"),
+    async dismissKeyboard() {
+      const resigned = kbd ? await kbd.dismiss() : undefined;
+      if (resigned !== undefined && !resigned.success)
+        return resigned;
+      if (resigned?.data.attached)
+        return { success: true, data: { via: "resign" } };
+      opts.log?.("[ios] keyboard dismissed with Enter: the app was launched without libwarden-inject.dylib, so Return may submit the focused field");
+      const pressed = await sendVoid("key", params({ usage: KEY_USAGE.Enter }));
+      return pressed.success ? { success: true, data: { via: "key" } } : pressed;
+    },
+    async keyboardState() {
+      const taken = await snapshot();
+      if (!taken.success)
+        return taken;
+      return {
+        success: true,
+        data: { mode: kbd?.mode() ?? DEFAULT_KEYBOARD_MODE, visible: keyboardVisible(taken.data) }
+      };
+    },
     camera: async (op) => net ? net.camera(op) : driverErr("E_UNSUPPORTED", "the simulated camera on iOS needs a device lease for the injected dylib: run the spec with `warden e2e`, or `warden ui`; a bare `bun test` has no lease"),
     memoryWarning: (o) => settings ? settings.memoryWarning(o) : noSettings(),
     push: (payload, o) => settings ? settings.push(payload, o) : noSettings(),
@@ -9035,7 +9277,7 @@ function createIosDriver(swap, simctl, opts) {
     app: {
       launch: async (bundleId, plain) => {
         const requested = settings ? withStagedSettings(plain, settings.launchSettings()) : plain;
-        const withEnv = await launchWithInjection(net, a11y, requested);
+        const withEnv = await launchWithInjection(net, a11y, kbd, requested);
         if (!withEnv.success)
           return withEnv;
         const o = withEnv.data;
@@ -9171,6 +9413,7 @@ async function openIosDriver(o) {
       ...o.coldBridgeBudgetMs !== undefined ? { coldBridgeBudgetMs: o.coldBridgeBudgetMs } : {},
       ...network ? { network } : {},
       a11y: () => iosA11yFor(o, now, sleep),
+      keyboard: () => iosKeyboardFor(o, now, sleep),
       nativeAudit: (ctx) => nativeAuditFor(o, exec, log, ctx),
       settings: (ctx) => settingsFor(o, exec, ctx),
       ...o.clockRecorder ? { clockRecorder: o.clockRecorder } : {}
@@ -9210,6 +9453,28 @@ function iosNetworkFactory(o, simctl, now, sleep) {
     ...o.debug ? { debug: true } : {}
   });
 }
+function iosKeyboardFor(o, now, sleep) {
+  const wardenHome2 = o.wardenHome ?? wardenHome();
+  return createIosKeyboard({
+    channel: createInjectChannel({
+      statePath: injectStatePath2(wardenHome2, o.udid),
+      now,
+      sleep,
+      ...o.bundleId ? { bundleId: () => o.bundleId } : {},
+      ...o.injectFs ? { fs: o.injectFs } : {}
+    }),
+    dylib: () => locateInjectDylib({
+      env: { [INJECT_DYLIB_ENV]: process.env[INJECT_DYLIB_ENV], WARDEN_HELPER_DIR: o.env?.helperDir },
+      execPath: o.execPath ?? process.execPath,
+      importDir: o.importDir ?? import.meta.dir,
+      wardenHome: wardenHome2,
+      exists: o.exists ?? existsSync8,
+      realpath: o.realpath ?? realpathSync2,
+      ...o.version ? { version: o.version } : {}
+    }),
+    ...o.debug ? { debug: true } : {}
+  });
+}
 function iosA11yFor(o, now, sleep) {
   const wardenHome2 = o.wardenHome ?? wardenHome();
   return createIosA11y({
@@ -9453,7 +9718,7 @@ var SCREENSHOT_FALLBACK2 = new Set(["E_UNSUPPORTED", "E_IO", "E_INTERNAL"]);
 function params2(values) {
   return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
 }
-var okVoid3 = { success: true, data: undefined };
+var okVoid4 = { success: true, data: undefined };
 function fail3(error) {
   return { success: false, error };
 }
@@ -9486,7 +9751,7 @@ function createIosDeviceDriver(client, devicectl, opts) {
   }
   const sendVoid = async (op, p = {}, timeoutMs) => {
     const result = await request(op, p, timeoutMs === undefined ? {} : { timeoutMs });
-    return result.success ? okVoid3 : result;
+    return result.success ? okVoid4 : result;
   };
   async function snapshot(o) {
     const result = await request("snapshot", params2({ interactiveOnly: o?.interactiveOnly, backend: o?.backend }));
@@ -9621,7 +9886,7 @@ function createIosDeviceDriver(client, devicectl, opts) {
       return installed;
     for (const bundleId of installed.data.bundleIds)
       owned.add(bundleId);
-    return okVoid3;
+    return okVoid4;
   }
   async function uninstall(bundleId) {
     const refused = guard(bundleId, "uninstall");
@@ -9660,6 +9925,11 @@ function createIosDeviceDriver(client, devicectl, opts) {
     gesture: async () => unsupported2("gesture", "the XCUITest runner takes taps, swipes and drags only"),
     biometrics: async () => unsupported2("biometrics", "Face ID / Touch ID cannot be simulated on a real sensor; use a simulator"),
     ...physicalConditionOps(`physical iPhone ${udid}`),
+    dismissKeyboard: async () => {
+      const pressed = await sendVoid("key", params2({ usage: KEY_USAGE.Enter }));
+      return pressed.success ? { success: true, data: { via: "key" } } : pressed;
+    },
+    keyboardState: async () => unsupported2("the keyboard mode", "the injected library runs in simulator apps only"),
     typeText: (text) => sendVoid("typeText", { text }, deviceTypeTextBudgetMs(text)),
     key: (key, modifiers) => sendVoid("key", params2({ usage: KEY_USAGE[key], modifiers: modifiers && [...modifiers] })),
     pressButton,
@@ -10382,6 +10652,10 @@ function createDevice({
     locale: conditions.locale,
     a11y: conditions.a11y,
     battery: conditions.battery,
+    keyboard: conditions.keyboard,
+    async keyboardVisible() {
+      return (await unwrap(() => driver.keyboardState(), "read the keyboard", signal())).visible;
+    },
     camera: conditions.camera,
     memoryWarning: conditions.memoryWarning,
     push: conditions.push,
@@ -10451,13 +10725,9 @@ function createDevice({
       await unwrap(() => driver.clipboard(text), "set clipboard", signal());
     },
     async hideKeyboard() {
-      const snapshot = await readSnapshot();
-      if (!snapshot.flat.some((element) => element.role === "keyboard"))
+      if (!await device.keyboardVisible())
         return;
-      if (driver.platform === "ios")
-        await unwrap(() => driver.key("Enter"), "hide keyboard", signal());
-      else
-        await unwrap(() => driver.pressButton("back"), "hide keyboard", signal());
+      await unwrap(() => driver.dismissKeyboard(), "hide keyboard", signal());
     },
     async screenshot(name) {
       const dir = session.attemptDir ?? join22(session.out, "adhoc");
@@ -10698,13 +10968,15 @@ class Runtime {
   }
   async poll(step, timeoutMs, options = {}) {
     const signal = this.host.signal;
-    const result = await poll(step, {
+    const outer = readDeadlineRemaining();
+    const deadline = this.clock.now() + (outer === undefined ? timeoutMs : Math.min(timeoutMs, outer));
+    const result = await withReadDeadline(() => deadline - this.clock.now(), () => poll(step, {
       timeoutMs,
       ...options.intervalMs === undefined ? {} : { intervalMs: options.intervalMs },
       ...signal === undefined ? {} : { signal },
       now: this.clock.now,
       sleep: this.clock.sleep
-    });
+    }));
     if (result.status === "aborted")
       throw abortError(signal);
     return result;
@@ -10877,6 +11149,8 @@ function traceDevice(device, span) {
     locale: (tag, options) => span("device.locale", () => device.locale(tag, options)),
     a11y: (op) => span("device.a11y", () => device.a11y(op)),
     battery: (op) => span("device.battery", () => device.battery(op)),
+    keyboard: (mode) => span("device.keyboard", () => device.keyboard(mode)),
+    keyboardVisible: () => span("device.keyboardVisible", () => device.keyboardVisible()),
     camera: {
       set: (path, options) => span("device.camera.set", () => camera.set(path, options)),
       clear: (facing) => span("device.camera.clear", () => camera.clear(facing)),

package/types/core/src/affected/affected.schema.d.ts

@@ -167,6 +167,7 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         except: z.ZodOptional<z.ZodArray<z.ZodString>>;
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
+    golden: z.ZodOptional<z.ZodBoolean>;
     biometrics: z.ZodOptional<z.ZodBoolean>;
     reclaim: z.ZodOptional<z.ZodEnum<{
         none: "none";
@@ -262,6 +263,10 @@ export declare const e2eSuiteSchema: z.ZodObject<{
             }>>;
             reduceMotion: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
+        keyboard: z.ZodOptional<z.ZodEnum<{
+            software: "software";
+            hardware: "hardware";
+        }>>;
     }, z.core.$strict>>;
     a11y: z.ZodOptional<z.ZodObject<{
         ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/types/core/src/builds/builds.defaults.d.ts

@@ -12,6 +12,12 @@ export type BuildConfiguration = "Debug" | "Release";
 export declare const IOS_NATIVE_PREPARE: string;
 /** Local build command (run in the project root) when `build.<platform>` is not configured. */
 export declare function defaultBuildCommand(platform: Platform, configuration: BuildConfiguration, framework?: AppFramework): string;
+/**
+ * Android build: prebuild a CNG checkout that has no `android/`, then Gradle alone. Never `expo run:android`: it has no
+ * build-only mode (its `--no-install` skips dependency install, not the app's) and installs the APK on whichever
+ * emulator is booted, warden's or not. warden installs the cached build itself.
+ */
+export declare function androidGradleCommand(configuration: BuildConfiguration, framework?: AppFramework): string;
 /** What an iOS device build is signed with: the team (always) and, when set, the bundle id that replaces the project's. */
 export type IosDeviceBuild = {
     team: string;
@@ -55,6 +61,8 @@ export declare const EAS_TIMEOUT_MS: number;
 export declare const EAS_TRIGGER_GRACE_MS: number;
 /** Local native build timeout. */
 export declare const LOCAL_BUILD_TIMEOUT_MS: number;
+/** How often a local build nobody watches says it is still running (`still building ios (6m 0s): …`). */
+export declare const BUILD_HEARTBEAT_MS = 60000;
 /** Fingerprint command timeout. */
 export declare const FINGERPRINT_TIMEOUT_MS: number;
 /** Build-lock lease ttl; the lease also carries the holder's pid so it lives as long as the process. */