@delacour/warden-e2e 0.14.0 → 0.15.0

package/{chunk-zk3wxa70.mjs → chunk-e3cry5br.mjs}

@@ -264,7 +264,7 @@ async function settleByHash(poll, deps) {
       return { quiet: false, waitedMs: t - start };
   }
 }
-function tuple(element) {
+function elementKey(element) {
   const { x, y, width, height } = element.frame;
   return JSON.stringify([
     element.role,
@@ -280,7 +280,7 @@ function tuple(element) {
 function snapshotHash(snapshot) {
   let text = "";
   for (const element of snapshot.flat)
-    text += `${tuple(element)}
+    text += `${elementKey(element)}
 `;
   return Bun.hash(text).toString(36);
 }
@@ -434,6 +434,11 @@ function fieldContent(entry) {
   const text = fieldValue(entry);
   return text === "" ? { kind: "empty" } : { kind: "text", text };
 }
+function maskedReading(entry, text) {
+  const content = fieldContent(entry);
+  const count = content.kind === "dots" ? content.count : 0;
+  return count === graphemes(text) ? text : "\u2022".repeat(count);
+}
 function clearKeyPresses(entry) {
   const content = fieldContent(entry);
   switch (content.kind) {
@@ -757,7 +762,7 @@ function nonEmpty(value) {
 }
 var MASKED_VALUE = /^[\u2022\u25CF]+$/;
 function isSecure(element, traits) {
-  return element.role === "textfield" && element.value !== undefined && MASKED_VALUE.test(element.value) || element.role === "securefield" || traits.has("password") || traits.has("secure") || element.rawType.toLowerCase().includes("secure");
+  return element.role === "textfield" && element.value !== undefined && MASKED_VALUE.test(element.value) || element.role === "securefield" || traits.has("password") || traits.has("secure") || traits.has("secure-text-field") || element.rawType.toLowerCase().includes("secure");
 }
 function deriveChecked(element, role, spelled, traits, value) {
   if (spelled?.checked !== undefined)
@@ -1016,6 +1021,60 @@ async function typeOver(driver, sleep, prepared, text, via) {
   return typeText(driver, sleep, text);
 }
 
+// ../../packages/e2e/src/driver/keyboard-state.ts
+function keyboardElement(snapshot) {
+  const { height } = snapshot.screen;
+  const onScreen = snapshot.flat.filter((e) => e.role === "keyboard" && e.hidden !== true && e.frame.width > 0 && e.frame.height > 0 && (height <= 0 || e.frame.y < height && e.frame.y + e.frame.height > 0));
+  return onScreen.sort((a, b) => b.frame.width * b.frame.height - a.frame.width * a.frame.height)[0];
+}
+function keyboardVisible(snapshot) {
+  return keyboardElement(snapshot) !== undefined;
+}
+function keyboardFrame(snapshot) {
+  return keyboardElement(snapshot)?.frame;
+}
+
+// ../../packages/e2e/src/screen/keyboard-cover.ts
+var COVER_MARGIN = 40;
+var SWIPE_INSET = 12;
+var SCROLL_SWIPE = { durationMs: 350, momentum: false };
+var SCROLL_ROLES = new Set(["scrollview", "list"]);
+function scrollContainer(entry) {
+  for (let node = entry.parent;node !== undefined; node = node.parent) {
+    if (SCROLL_ROLES.has(node.element.role))
+      return node;
+  }
+  return;
+}
+function coverOf(entry, point, snapshot) {
+  const keyboard = keyboardFrame(snapshot);
+  if (keyboard === undefined || entry.element.role === "keyboard")
+    return;
+  const inside = point.x >= keyboard.x && point.x <= keyboard.x + keyboard.width && point.y >= keyboard.y && point.y <= keyboard.y + keyboard.height;
+  if (!inside)
+    return;
+  const container = scrollContainer(entry);
+  const shift = point.y - (keyboard.y - COVER_MARGIN);
+  if (container === undefined)
+    return { top: keyboard.y, shift };
+  const { frame } = container.element;
+  const bottom = Math.min(frame.y + frame.height, keyboard.y);
+  const free = { x: frame.x, y: frame.y, width: frame.width, height: Math.max(0, bottom - frame.y) };
+  return free.height > 2 * SWIPE_INSET ? { top: keyboard.y, scroller: free, shift } : { top: keyboard.y, shift };
+}
+function scrollPath(scroller, shift) {
+  const x = scroller.x + scroller.width / 2;
+  const room = scroller.height - 2 * SWIPE_INSET;
+  const travel = Math.max(1, Math.min(shift, room));
+  const from = scroller.y + scroller.height - SWIPE_INSET;
+  return { from: { x, y: from }, to: { x, y: from - travel } };
+}
+var COVER_SCROLL_SWIPE = SCROLL_SWIPE;
+async function dismissKeyboard(driver) {
+  const done = await driver.dismissKeyboard();
+  return done.success ? { success: true, data: undefined } : done;
+}
+
 // ../../packages/e2e/src/screen/selector.ts
 var VALUE_KEYS = ["id", "label", "text", "role", "value"];
 var KEY_ORDER = [...VALUE_KEYS, "editable", "nth"];
@@ -1581,7 +1640,8 @@ async function lookUpTestIdViaReact(facet, testId, view, options = {}) {
   if (!result.success)
     return { answered: false };
   const matches = [];
-  for (const component of result.data.components) {
+  const { components } = result.data;
+  for (const component of components) {
     const { testID, rect } = component;
     if (testID === undefined || rect === undefined || !matchesText(testID, testId))
       continue;
@@ -1591,11 +1651,25 @@ async function lookUpTestIdViaReact(facet, testId, view, options = {}) {
       source: "react",
       testId: testID,
       name: component.name,
-      ...component.text === undefined ? {} : { text: component.text }
+      ...textOf2(component, components)
     });
   }
   return { answered: true, matches };
 }
+function textOf2(component, components) {
+  if (component.text !== undefined)
+    return { text: component.text };
+  const inside = new Set([component.id]);
+  const texts = [];
+  for (const other of components) {
+    if (other.parent === null || !inside.has(other.parent))
+      continue;
+    inside.add(other.id);
+    if (other.text !== undefined)
+      texts.push(other.text);
+  }
+  return texts.length === 0 ? {} : { text: texts.join(" ") };
+}
 function reactTapPoint(match, position) {
   if (position === undefined)
     return match.tapPoint;
@@ -1643,6 +1717,8 @@ var DEFAULT_MAX_SWIPES = 10;
 var VERIFY_MS = 1000;
 var CONFIRM_FLOOR_MS = 500;
 var SCROLL_SETTLE = { quietMs: 150, timeoutMs: 1000 };
+var MAX_COVER_SCROLLS = 3;
+var QUICK_CHECK_WINDOW_MS = 2000;
 function assertOptions(verb, options, allowed) {
   const unknown = Object.keys(options).filter((key) => !allowed.includes(key));
   if (unknown.length > 0) {
@@ -1762,11 +1838,12 @@ class Locator {
     return degradedFailure(this.toString(), read, waitedMs, this.reactNote(), screen);
   }
   async conclusive(options = {}) {
-    const first = await this.look(options);
+    const first = await this.look(options.reuse === undefined ? {} : { reuse: options.reuse });
     const settled = await this.settled(first.observed);
     if (settled !== undefined)
       return settled;
-    const timeoutMs = this.rt.actionTimeout();
+    const actionMs = this.rt.actionTimeout();
+    const timeoutMs = options.quick === true ? Math.min(actionMs, QUICK_CHECK_WINDOW_MS) : actionMs;
     let last;
     const result = await this.rt.poll(async () => {
       const observation = await this.rt.tryObserve({ reuse: false });
@@ -1828,7 +1905,7 @@ class Locator {
   }
   count() {
     return this.traced("count", async () => {
-      const { entries, react } = await this.conclusive();
+      const { entries, react } = await this.conclusive({ quick: true });
       return react?.length ?? entries.length;
     });
   }
@@ -1865,7 +1942,7 @@ class Locator {
   }
   isVisible() {
     return this.traced("isVisible", async () => {
-      const { entries, react, observed } = await this.conclusive();
+      const { entries, react, observed } = await this.conclusive({ quick: true });
       if (react !== undefined)
         return reactVisible(this.reactOnly(react, observed), observed);
       return entries.length > 0 && this.exactlyOne(entries, observed).visible;
@@ -2038,6 +2115,26 @@ class Locator {
       return;
     return { entry, observed };
   }
+  async clearOfKeyboard(found, spec, position, timeoutMs) {
+    const coverAt = (at) => coverOf(at.entry, tapPointOf(at.entry, position), at.observed.snapshot);
+    let current = found;
+    let cover = coverAt(current);
+    if (cover === undefined)
+      return found;
+    const { driver } = found.observed;
+    for (let scrolls = 0;cover?.scroller !== undefined && scrolls < MAX_COVER_SCROLLS; scrolls += 1) {
+      const path = scrollPath(cover.scroller, cover.shift);
+      this.rt.drive("scrollIntoView", await driver.swipe(path.from, path.to, COVER_SCROLL_SWIPE));
+      await driver.settle(SCROLL_SETTLE);
+      current = await this.actionable(spec, timeoutMs);
+      cover = coverAt(current);
+    }
+    if (cover === undefined)
+      return current;
+    this.rt.drive("dismissKeyboard", await dismissKeyboard(driver));
+    await driver.settle(SCROLL_SETTLE);
+    return this.actionable(spec, timeoutMs);
+  }
   async tap(options = {}) {
     assertOptions("tap", options, ["position", "timeout", "until", "retries", "windowMs", "pollMs"]);
     const retry = retryPlan(options);
@@ -2047,7 +2144,7 @@ class Locator {
       if (retry === undefined)
         return;
       for (let resent = 0;resent < retry.retries; resent += 1) {
-        const outcome = await this.arrivedWithin(retry, snapshotHash(before));
+        const outcome = await this.arrivedWithin(retry, before);
         if (outcome !== "press-again")
           return;
         before = await this.tapOnce(options);
@@ -2057,19 +2154,31 @@ class Locator {
   async tapOnce(options) {
     const withPosition = options.position !== undefined;
     const spec = { enabled: !withPosition, tapPointOnScreen: !withPosition };
-    const found = (options.until === undefined ? await this.aimFromKept(spec, options.position) : undefined) ?? await this.actionable(spec, options.timeout ?? this.rt.actionTimeout(), true);
+    const timeoutMs = options.timeout ?? this.rt.actionTimeout();
+    const look = (options.until === undefined ? await this.aimFromKept(spec, options.position) : undefined) ?? await this.actionable(spec, timeoutMs, true);
+    const found = "entry" in look ? await this.clearOfKeyboard(look, spec, options.position, timeoutMs) : look;
     const point = "react" in found ? reactTapPoint(found.react, options.position) : tapPointOf(found.entry, options.position);
     const { driver } = found.observed;
+    const aimed = {
+      snapshot: found.observed.snapshot,
+      target: "entry" in found ? found.entry.element : undefined
+    };
     if (!withPosition && "entry" in found && canActOnElements(driver)) {
       if (this.rt.drive("tap", await driver.pressElement(found.entry.element)))
-        return found.observed.snapshot;
+        return aimed;
     }
     this.rt.drive("tap", await driver.tap(point));
-    return found.observed.snapshot;
+    return aimed;
   }
-  async arrivedWithin(plan, pressedOn) {
+  async arrivedWithin(plan, aimed) {
     const { until } = plan;
-    const watch = { pressedOn, started: this.rt.clock.now(), changed: false, unchanged: 0 };
+    const watch = {
+      before: new Set(aimed.snapshot.flat.map(elementKey)),
+      target: aimed.target === undefined ? undefined : elementKey(aimed.target),
+      started: this.rt.clock.now(),
+      changed: false,
+      unchanged: 0
+    };
     const result = await this.rt.poll(async (attempt) => {
       if (typeof until !== "function")
         return this.checkLocatorUntil(until, watch, attempt);
@@ -2092,7 +2201,7 @@ class Locator {
     }
     if (await until.shownIn(observation.observed))
       return { done: true, value: "arrived" };
-    if (snapshotHash(observation.observed.snapshot) === watch.pressedOn)
+    if (!reacted(observation.observed.snapshot, watch))
       watch.unchanged += 1;
     else {
       watch.changed = true;
@@ -2104,7 +2213,9 @@ class Locator {
   async longPress(options = {}) {
     assertOptions("longPress", options, ["durationMs", "timeout"]);
     return this.act("longPress", async () => {
-      const { entry, observed } = await this.actionable({ enabled: true, tapPointOnScreen: true }, options.timeout ?? this.rt.actionTimeout());
+      const spec = { enabled: true, tapPointOnScreen: true };
+      const timeoutMs = options.timeout ?? this.rt.actionTimeout();
+      const { entry, observed } = await this.clearOfKeyboard(await this.actionable(spec, timeoutMs), spec, undefined, timeoutMs);
       const opts = options.durationMs === undefined ? undefined : { durationMs: options.durationMs };
       this.rt.drive("longPress", await observed.driver.longPress(tapPointOf(entry), opts));
     });
@@ -2115,18 +2226,18 @@ class Locator {
     return this.act("fill", async () => {
       const budget = this.rt.budget(options.timeout);
       let target = await this.actionable({ enabled: true, tapPointOnScreen: false }, budget.remaining());
+      const verify = !target.entry.secure;
       let firstHeld;
       for (let attempt = 1;; attempt += 1) {
         const point = focusPoint(target.entry.element.frame);
         this.rt.drive("fill", await focusClearType(target.observed.driver, this.pause, point, target.entry, text, clearMethodFor(attempt), process.env, viaFor(attempt, via)));
-        if (target.entry.secure)
+        if (!verify)
           return;
         const outcome = await this.confirm(target, text, budget);
         if (outcome.ok)
           return;
         if (attempt === 2) {
-          const earlier = firstHeld === undefined ? "" : ` (first attempt held ${JSON.stringify(firstHeld)})`;
-          throw new E2eError2("ACTION_FAILED", `${this}: fill did not take: expected ${JSON.stringify(text)} but the field holds ${JSON.stringify(outcome.held)}${earlier}`, outcome.screen);
+          throw new E2eError2("ACTION_FAILED", `${this}: ${fillMismatch(text, target.entry.secure, outcome.held, firstHeld)}`, outcome.screen);
         }
         firstHeld = outcome.held;
         target = await this.actionable({ enabled: true, tapPointOnScreen: false }, budget.remaining());
@@ -2249,7 +2360,11 @@ class Locator {
   async confirm({ entry, observed }, text, budget) {
     const span = Math.max(budget.remaining(), CONFIRM_FLOOR_MS);
     let lastSeen;
-    const readValue = (found) => text === "" ? fieldValue(found) : rawValue(found);
+    const readValue = (found) => {
+      if (text === "")
+        return fieldValue(found);
+      return found.secure ? maskedReading(found, text) : rawValue(found);
+    };
     const outcome = await confirmFieldValue({
       text,
       now: this.rt.clock.now,
@@ -2307,6 +2422,16 @@ var TAP_WINDOW_MS = 4000;
 var TAP_CHECK_MS = 250;
 var UNCHANGED_CHECKS = 2;
 var UNCHANGED_AFTER_MS = 750;
+function reacted(snapshot, watch) {
+  const now = new Set;
+  for (const element of snapshot.flat) {
+    const key = elementKey(element);
+    if (!watch.before.has(key))
+      return true;
+    now.add(key);
+  }
+  return watch.target !== undefined && !now.has(watch.target);
+}
 function wholeNumber(name, value, atLeast) {
   if (!Number.isInteger(value) || value < atLeast) {
     throw new E2eError2("INVALID_ARGUMENT", `tap ${name} must be an integer of at least ${atLeast}, got ${String(value)}`);
@@ -2349,6 +2474,11 @@ function viaFor(attempt, via) {
 function clearMethodFor(attempt) {
   return attempt === 1 ? "auto" : "counted";
 }
+function fillMismatch(text, secure, held, firstHeld) {
+  const expected = secure ? `${graphemes(text)} characters (secure)` : JSON.stringify(text);
+  const earlier = firstHeld === undefined ? "" : ` (first attempt held ${JSON.stringify(firstHeld)})`;
+  return `fill did not take: expected ${expected} but the field holds ${JSON.stringify(held)}${earlier}`;
+}
 function rawValue(entry) {
   return entry.value ?? (entry.role === "textbox" || entry.role === "searchbox" ? entry.element.text ?? "" : "");
 }
@@ -2493,7 +2623,7 @@ function describeException(details) {
     return String(thrown.value);
   return details.text ?? "JS exception";
 }
-function textOf2(data) {
+function textOf3(data) {
   if (typeof data === "string")
     return data;
   if (data instanceof ArrayBuffer)
@@ -2516,7 +2646,7 @@ function taggedBindingPayload(params) {
   return tagged.success ? { requestId: tagged.data.requestId, payload } : undefined;
 }
 function parseEnvelope(data) {
-  const text = textOf2(data);
+  const text = textOf3(data);
   if (text === undefined)
     return;
   let json;
@@ -4551,6 +4681,14 @@ async function captureNativeLog(target, deps, win) {
   }
 }
 
+// ../../packages/e2e/src/driver/ax-wedge.ts
+function canRecoverAxWedge(driver) {
+  return typeof driver.axWedge === "function";
+}
+function restartedWithin(state, windowMs) {
+  return state.last?.outcome === "restarted" && state.last.agoMs <= windowMs;
+}
+
 // ../../packages/e2e/src/driver/ios/hid-recovery.ts
 import { existsSync as existsSync2 } from "fs";
 
@@ -4639,7 +4777,9 @@ var bridgeStallSchema = z6.looseObject({
   cooldownRemainingMs: z6.number().optional(),
   probes: z6.number(),
   recycles: z6.number().optional(),
-  recyclesExhausted: z6.boolean().optional()
+  recyclesExhausted: z6.boolean().optional(),
+  axWedge: z6.string().optional(),
+  axWedgeRestarts: z6.number().optional()
 });
 var SPAN_FIELDS = [
   ["stallStage", "stage"],
@@ -4650,7 +4790,9 @@ var SPAN_FIELDS = [
   ["stallCooldownMs", "cooldownRemainingMs"],
   ["stallProbes", "probes"],
   ["stallRecycles", "recycles"],
-  ["stallRecyclesExhausted", "recyclesExhausted"]
+  ["stallRecyclesExhausted", "recyclesExhausted"],
+  ["stallAxWedge", "axWedge"],
+  ["stallAxWedgeRestarts", "axWedgeRestarts"]
 ];
 function toBridgeStall(wire) {
   const stall = { stage: wire.stage, cold: wire.cold, probes: wire.probes };
@@ -4666,6 +4808,10 @@ function toBridgeStall(wire) {
     stall.recycles = wire.recycles;
   if (wire.recyclesExhausted !== undefined)
     stall.recyclesExhausted = wire.recyclesExhausted;
+  if (wire.axWedge !== undefined)
+    stall.axWedge = wire.axWedge;
+  if (wire.axWedgeRestarts !== undefined)
+    stall.axWedgeRestarts = wire.axWedgeRestarts;
   return stall;
 }
 function noteBridgeStall(stall) {
@@ -4689,7 +4835,8 @@ function bridgeStallFromSpan(detail) {
     ["stallDeadlineMs", "deadlineMs"],
     ["stallGuestAgeMs", "guestAgeMs"],
     ["stallCooldownMs", "cooldownRemainingMs"],
-    ["stallRecycles", "recycles"]
+    ["stallRecycles", "recycles"],
+    ["stallAxWedgeRestarts", "axWedgeRestarts"]
   ];
   for (const [key, field] of numbers) {
     const value = detail[key];
@@ -4698,9 +4845,20 @@ function bridgeStallFromSpan(detail) {
   }
   if (typeof detail.stallRecyclesExhausted === "boolean")
     stall.recyclesExhausted = detail.stallRecyclesExhausted;
+  if (typeof detail.stallAxWedge === "string")
+    stall.axWedge = detail.stallAxWedge;
   return stall;
 }
 var seconds = (ms) => `${(ms / 1000).toFixed(1)} s`;
+function axWedgeParts(stall) {
+  const parts = [];
+  if (stall.axWedge === "checking")
+    parts.push("both readers silent: checking for a wedged accessibility service");
+  if (stall.axWedgeRestarts !== undefined) {
+    parts.push(`backboardd restarted ${stall.axWedgeRestarts} time${stall.axWedgeRestarts === 1 ? "" : "s"}`);
+  }
+  return parts;
+}
 function formatBridgeStall(stall) {
   const parts = [`stage ${stall.stage}`];
   if (stall.readMs !== undefined) {
@@ -4717,7 +4875,7 @@ function formatBridgeStall(stall) {
     const guests = stall.recycles === 1 ? "guest" : "guests";
     parts.push(`${stall.recycles} stalled ${guests} recycled${stall.recyclesExhausted === true ? ", none left" : ""}`);
   }
-  return parts.join(" \xB7 ");
+  return [...parts, ...axWedgeParts(stall)].join(" \xB7 ");
 }
 
 // ../../packages/e2e/src/driver/ios/simd-protocol.ts
@@ -4879,6 +5037,7 @@ var healthDataSchema = z7.looseObject({
   coreSimulatorVersion: z7.string().nullish(),
   frontmost: z7.object({ unresolvedAgoMs: z7.number(), method: z7.string() }).optional(),
   bridgeRecycles: z7.object({ count: z7.number(), exhausted: z7.boolean() }).optional(),
+  axWedge: z7.lazy(() => axWedgeDataSchema).optional(),
   state: z7.string().optional(),
   uptimeMs: z7.number().optional()
 });
@@ -4945,6 +5104,17 @@ var orientationDataSchema = z7.object({
   ]),
   source: z7.enum(["device", "written", "assumed"]).optional()
 });
+var axWedgeDataSchema = z7.looseObject({
+  restarts: z7.number(),
+  maxRestarts: z7.number(),
+  recovering: z7.boolean(),
+  checked: z7.enum(["restarted", "not-wedged", "failed"]).optional(),
+  last: z7.discriminatedUnion("outcome", [
+    z7.looseObject({ outcome: z7.literal("restarted"), agoMs: z7.number(), ms: z7.number().optional() }),
+    z7.looseObject({ outcome: z7.literal("not-wedged"), agoMs: z7.number() }),
+    z7.looseObject({ outcome: z7.literal("failed"), agoMs: z7.number(), error: z7.string() })
+  ]).optional()
+});
 var opSchemas = {
   health: healthDataSchema,
   snapshot: snapshotDataSchema,
@@ -4956,7 +5126,8 @@ var opSchemas = {
   frontmost: frontmostDataSchema,
   orientation: orientationDataSchema,
   launch: launchDataSchema,
-  terminate: terminateDataSchema
+  terminate: terminateDataSchema,
+  axWedge: axWedgeDataSchema
 };
 function hasOpSchema(op) {
   return Object.hasOwn(opSchemas, op);
@@ -5722,6 +5893,10 @@ var TEXT_SIZE_NAMES = [
   "accessibility-extra-extra-large",
   "accessibility-extra-extra-extra-large"
 ];
+var KEYBOARD_MODES = ["software", "hardware"];
+var DEFAULT_KEYBOARD_MODE = "software";
+var IME_STASH_ENABLED = "warden_ime_enabled";
+var IME_STASH_DEFAULT = "warden_ime_default";
 var CAMERA_FACINGS = ["back", "front"];
 var CONDITION_AREAS = [
   "network",
@@ -5731,7 +5906,8 @@ var CONDITION_AREAS = [
   "locale",
   "a11y",
   "battery",
-  "camera"
+  "camera",
+  "keyboard"
 ];
 
 // ../../packages/core/src/conditions/network.presets.ts
@@ -5876,7 +6052,8 @@ var conditionsConfigSchema = z9.object({
   permissions: z9.partialRecord(z9.enum(PERMISSION_NAMES), z9.enum(["granted", "denied", "unset"])).optional(),
   locale: z9.string().min(1).optional(),
   timezone: z9.string().min(1).optional(),
-  a11y: a11yConfigSchema.optional()
+  a11y: a11yConfigSchema.optional(),
+  keyboard: z9.enum(KEYBOARD_MODES).optional()
 }).strict();
 var cameraFeedInput = z9.union([
   z9.string().min(1),
@@ -5943,6 +6120,8 @@ function normalizeConditions(config) {
     conditions.locale = config.locale;
   if (config.timezone !== undefined)
     conditions.timezone = config.timezone;
+  if (config.keyboard !== undefined)
+    conditions.keyboard = { mode: config.keyboard };
   if (config.a11y !== undefined) {
     const a11y = { ...config.a11y };
     if (config.a11y.textSize !== undefined) {
@@ -6318,6 +6497,8 @@ ${read.error}`);
     throw new E2eError2("SESSION", "not running under warden: WARDEN_UDID is not set");
   return read.data;
 }
+var AX_WEDGE_WAIT_MS = 60000;
+var AX_WEDGE_POLL_MS = 1000;
 var WARM_TRIES = 15;
 var WARM_INTERVAL_MS = 2000;
 function createSession(opts = {}) {
@@ -6362,6 +6543,27 @@ function createSession(opts = {}) {
       await sleep(WARM_INTERVAL_MS);
     }
   }
+  let axWedgeRerunFor = 0;
+  async function recoverAxWedge(attemptMs) {
+    const driver = current;
+    if (closing !== undefined || driver === undefined || !canRecoverAxWedge(driver))
+      return false;
+    const sleep = hid?.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    let state = await driver.axWedge();
+    let waited = 0;
+    while (state.success && state.data.recovering && waited < AX_WEDGE_WAIT_MS) {
+      await sleep(AX_WEDGE_POLL_MS);
+      waited += AX_WEDGE_POLL_MS;
+      state = await driver.axWedge();
+    }
+    if (!state.success || state.data.restarts <= axWedgeRerunFor)
+      return false;
+    if (!restartedWithin(state.data, attemptMs + waited))
+      return false;
+    axWedgeRerunFor = state.data.restarts;
+    note(`sim ${resolved.deviceName ?? resolved.udid}: accessibility service wedged, warden-simd restarted backboardd (the app was quit); running the test again`);
+    return true;
+  }
   async function recoverRunner(deps, name) {
     if (hidRecovered) {
       note(`iPhone ${name}: the runner connection was lost again after a restart; check the phone and retry`);
@@ -6439,6 +6641,7 @@ function createSession(opts = {}) {
     fixtures: opts.fixtures ?? defaultFixtures,
     nativeLog: opts.nativeLog ?? defaultNativeLog,
     recoverHid: hid === undefined || resolved.platform !== "ios" ? undefined : recoverHid,
+    recoverAxWedge: resolved.platform !== "ios" || resolved.deviceKind === "physical" ? undefined : recoverAxWedge,
     resetDevice,
     log: opts.log ?? writeLine,
     get attempt() {
@@ -6577,6 +6780,9 @@ function attemptSession(session, binding) {
     get recoverHid() {
       return session.recoverHid;
     },
+    get recoverAxWedge() {
+      return session.recoverAxWedge;
+    },
     resetDevice: () => session.resetDevice(),
     get fixtures() {
       return session.fixtures;
@@ -7207,15 +7413,15 @@ function runAudit(snapshot, platform, opts = {}) {
 function failing(result, minSeverity = "error") {
   return result.issues.filter((i) => SEVERITY_RANK[i.severity] >= SEVERITY_RANK[minSeverity]);
 }
-function elementKey(i) {
+function elementKey2(i) {
   return i.identifier ?? i.elementId;
 }
 function mergeIssues(base, extra, skipped = []) {
   const issues = [...base.issues];
   const added = [];
   for (const e of extra) {
-    const key = elementKey(e);
-    const idx = issues.findIndex((i) => key !== undefined && elementKey(i) === key && (e.wcag !== undefined ? i.wcag === e.wcag : i.rule === e.rule && i.message === e.message));
+    const key = elementKey2(e);
+    const idx = issues.findIndex((i) => key !== undefined && elementKey2(i) === key && (e.wcag !== undefined ? i.wcag === e.wcag : i.rule === e.rule && i.message === e.message));
     const hit = idx === -1 ? undefined : issues[idx];
     if (hit === undefined) {
       added.push(e);
@@ -7558,6 +7764,12 @@ function createDeviceA11y(deps) {
       const merged = await withA11yRead(driver, taken.data);
       return renderA11yScreen(merged.success ? merged.data : taken.data);
     },
+    async keyboardVisible() {
+      const state = await settled(() => driver.keyboardState(), "keyboardState", signal());
+      if (!state.success)
+        throw toE2eError(state.error, "read the keyboard");
+      return state.data.visible;
+    },
     assertionTimeout: () => env.assertionTimeoutMs,
     step: (label, fn) => deps.step === undefined ? fn() : deps.step(label, fn)
   };
@@ -8353,6 +8565,7 @@ var KNOWN_AREAS = new Set([
   "locale",
   "a11y",
   "battery",
+  "keyboard",
   "camera"
 ]);
 
@@ -8726,6 +8939,8 @@ function createDeviceConditions(deps) {
   let localeDirty = false;
   let a11yDirty = false;
   let batteryDirty = false;
+  let keyboardDirty = false;
+  let currentKeyboard = DEFAULT_KEYBOARD_MODE;
   let cameraDirty = false;
   let currentCamera = {};
   const permissionStates = new Map;
@@ -9102,6 +9317,28 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
     emit({ area: "battery", value });
     return state;
   }
+  const ownsDevice = recorder !== undefined && env.deviceKind !== "physical";
+  const keyboardGoal = baseline.keyboard?.mode ?? DEFAULT_KEYBOARD_MODE;
+  async function applyKeyboard(input) {
+    const mode = input === "toggle" ? currentKeyboard === "software" ? "hardware" : "software" : input;
+    if (!KEYBOARD_MODES.includes(mode)) {
+      throw invalid2(`unknown keyboard mode "${String(input)}" (use software, hardware or toggle)`);
+    }
+    keyboardDirty = true;
+    const run = settingOp("keyboard");
+    const state = await call("keyboard", () => run(mode));
+    currentKeyboard = mode;
+    const value = {
+      mode,
+      ...state.previousIme === undefined ? {} : { previousIme: state.previousIme }
+    };
+    if (mode === DEFAULT_KEYBOARD_MODE)
+      recorder?.settle("keyboard", value, true);
+    else
+      recorder?.record("keyboard", value);
+    emit({ area: "keyboard", value });
+    return state;
+  }
   const home = deps.wardenHome ?? wardenHome(process.env);
   async function applyCamera(next) {
     cameraDirty = true;
@@ -9204,7 +9441,7 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
       throw new E2eError2("ACTION_FAILED", `a network flap or timeline stopped on its own after failing: ${failures[0]}`);
     }
   }
-  const declared = baseline.network !== undefined || baseline.location !== undefined || baseline.clock !== undefined || baseline.permissions !== undefined || baseline.locale !== undefined || baseline.timezone !== undefined || baseline.a11y !== undefined || env.cameraFeeds !== undefined;
+  const declared = baseline.network !== undefined || baseline.location !== undefined || baseline.clock !== undefined || baseline.permissions !== undefined || baseline.locale !== undefined || baseline.timezone !== undefined || baseline.a11y !== undefined || baseline.keyboard !== undefined || ownsDevice || env.cameraFeeds !== undefined;
   async function applyBaselinePermissions() {
     if (baseline.permissions === undefined)
       return;
@@ -9241,6 +9478,10 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
     async () => {
       if (env.cameraFeeds !== undefined)
         await applyCamera(baselineCamera());
+    },
+    async () => {
+      if (baseline.keyboard !== undefined || ownsDevice)
+        await applyKeyboard(keyboardGoal);
     }
   ];
   const teardownSteps = [
@@ -9280,6 +9521,13 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
         batteryDirty = false;
       }
     },
+    {
+      dirty: () => keyboardDirty,
+      run: async () => {
+        await applyKeyboard(keyboardGoal);
+        keyboardDirty = false;
+      }
+    },
     {
       dirty: () => cameraDirty,
       run: async () => {
@@ -9290,7 +9538,7 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
   ];
   const internals = {
     declared,
-    dirty: () => networkDirty || locationDirty || clockDirty || permissionsDirty || localeDirty || a11yDirty || batteryDirty || cameraDirty || runs.size > 0,
+    dirty: () => networkDirty || locationDirty || clockDirty || permissionsDirty || localeDirty || a11yDirty || batteryDirty || keyboardDirty || cameraDirty || runs.size > 0,
     wantsInject: () => baseline.network !== undefined || baseline.clock !== undefined || currentNetwork.kind !== "online" || currentClock.kind !== "real",
     async applyBaseline() {
       for (const step of baselineSteps)
@@ -9303,6 +9551,7 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
       localeDirty = false;
       a11yDirty = false;
       batteryDirty = false;
+      keyboardDirty = false;
     },
     async teardown() {
       const errors = [];
@@ -9331,6 +9580,7 @@ the app runs without the warden network dylib: declare \`conditions.network\` fo
     locale: applyLocale,
     a11y: applyA11y,
     battery: applyBattery,
+    keyboard: applyKeyboard,
     camera: cameraApi,
     memoryWarning: async (options) => {
       const op = settingOp("memoryWarning");
@@ -9650,6 +9900,6 @@ function onlyWasSeen() {
 
 // ../../packages/e2e/src/version.ts
 var WORKSPACE_VERSION = "0.0.0-workspace";
-var WARDEN_E2E_VERSION2 = "0.14.0";
+var WARDEN_E2E_VERSION2 = "0.15.0";
 
-export { E2eError2, registerA11yTarget, a11yTargetOf, canActOnElements, noteSpanDetail, addSpanDetail, canObserve, canDetectAlerts, settleDetailOf, DEFAULT_SETTLE_QUIET_MS, DEFAULT_SETTLE_TIMEOUT_MS, hashFallbackQuietMs, settleByHash, snapshotHash, ok, err, swipeVector, screenRect, isOnScreen, fieldValue, PINCH_MS, ROTATE_MS, PATH_MS, centreOf, pinchRadius, rotateRadius, requireGesture, assertScale, assertDegrees, isInteractiveRole, resolveRole, normalizeText, matchesText, indexSnapshot, testIdQuery, textQuery, roleQuery, selectorExpression, renderSnapshot, renderHeader, lookUpTestIdViaReact, isLocator, Locator, pickOne, textOf, scrollUntilVisible, formatNativeTail, realNativeLogDeps, captureNativeLog, bunExec, execError, driverError, driverErr, bridgeStallSchema, toBridgeStall, noteBridgeStall, bridgeStallFromSpan, formatBridgeStall, logEventSchema, fatalEventSchema, responseSchema, mapWireError, createLineSplitter, encodeRequest, bunSpawn, stdioTransport, socketTransport, createSimdClient, spawnSimd, connectSimd, isRecoverableLoss, parseDuration, CAMERA_FACINGS, CONDITION_AREAS, resolveNetwork, resolveTextSize, androidFontScale, ENV_NAMES, DEFAULT_ASSERTION_TIMEOUT_MS, readEnv, runStep, setDefaultHidRecovery, setDefaultNativeLog, setDefaultDriverFactory, hasDefaultDriverFactory, setDefaultFixtureFactory, hasDefaultFixtureFactory, attemptSession, getSession, peekSession, accessibleName, announce, failing, formatIssues, toE2eError, settled, unwrap, parseUiadA11yEvents, parseInjectEvents, withA11yRead, renderA11yScreen, createDeviceA11y, IOS_DEVICE_CAPABILITIES, sniffCameraMedia, cameraFeedDir, clearCameraFeeds, isLeaseAlive, processAlive, describeOwner, isPhysicalIosId, wardenHome, defaultDbPath, ownerKey, openStore, callerFile, formatCoord, DEFAULT_SPEED_MPS, DEFAULT_INTERVAL_S, realTickerClock, startRouteTicker, startFlap, registerConditions, conditionsOf, conditionSinkFor, createDeviceConditions, parseBudgets, createDevicePerf, perfStartFor, spawnWarden, hash6, attemptDir, screenshotPath, specIdOf, BUN_TIMEOUT_MARGIN_MS2, ownHook, currentScope, createScope, runInScope, hooksFor, resolveUse, registrationDefaults, markOnly, onlyWasSeen, WORKSPACE_VERSION, WARDEN_E2E_VERSION2 };
+export { E2eError2, registerA11yTarget, a11yTargetOf, canActOnElements, noteSpanDetail, addSpanDetail, canObserve, canDetectAlerts, settleDetailOf, DEFAULT_SETTLE_QUIET_MS, DEFAULT_SETTLE_TIMEOUT_MS, hashFallbackQuietMs, settleByHash, snapshotHash, ok, err, swipeVector, screenRect, isOnScreen, fieldValue, PINCH_MS, ROTATE_MS, PATH_MS, centreOf, pinchRadius, rotateRadius, requireGesture, assertScale, assertDegrees, isInteractiveRole, resolveRole, normalizeText, matchesText, indexSnapshot, keyboardVisible, testIdQuery, textQuery, roleQuery, selectorExpression, renderSnapshot, renderHeader, lookUpTestIdViaReact, isLocator, Locator, pickOne, textOf, scrollUntilVisible, formatNativeTail, realNativeLogDeps, captureNativeLog, bunExec, execError, driverError, driverErr, bridgeStallSchema, toBridgeStall, noteBridgeStall, bridgeStallFromSpan, formatBridgeStall, logEventSchema, fatalEventSchema, responseSchema, mapWireError, createLineSplitter, encodeRequest, bunSpawn, stdioTransport, socketTransport, createSimdClient, spawnSimd, connectSimd, isRecoverableLoss, parseDuration, KEYBOARD_MODES, DEFAULT_KEYBOARD_MODE, IME_STASH_ENABLED, IME_STASH_DEFAULT, CAMERA_FACINGS, CONDITION_AREAS, resolveNetwork, resolveTextSize, androidFontScale, ENV_NAMES, DEFAULT_ASSERTION_TIMEOUT_MS, readEnv, runStep, setDefaultHidRecovery, setDefaultNativeLog, setDefaultDriverFactory, hasDefaultDriverFactory, setDefaultFixtureFactory, hasDefaultFixtureFactory, attemptSession, getSession, peekSession, accessibleName, announce, failing, formatIssues, toE2eError, settled, unwrap, parseUiadA11yEvents, parseInjectEvents, withA11yRead, renderA11yScreen, createDeviceA11y, IOS_DEVICE_CAPABILITIES, sniffCameraMedia, cameraFeedDir, clearCameraFeeds, isLeaseAlive, processAlive, describeOwner, isPhysicalIosId, wardenHome, defaultDbPath, ownerKey, openStore, callerFile, formatCoord, DEFAULT_SPEED_MPS, DEFAULT_INTERVAL_S, realTickerClock, startRouteTicker, startFlap, registerConditions, conditionsOf, conditionSinkFor, createDeviceConditions, parseBudgets, createDevicePerf, perfStartFor, spawnWarden, hash6, attemptDir, screenshotPath, specIdOf, BUN_TIMEOUT_MARGIN_MS2, ownHook, currentScope, createScope, runInScope, hooksFor, resolveUse, registrationDefaults, markOnly, onlyWasSeen, WORKSPACE_VERSION, WARDEN_E2E_VERSION2 };