@delacour/warden-e2e 0.7.0 → 0.8.0

package/types/core/src/a11y/a11y.config.d.ts

@@ -0,0 +1,47 @@
+import { type Result } from "../../../types/src/result";
+import { z } from "zod";
+/** Every rule id an audit can report (`native` = XCUITest / ATF findings). Keep in step with `A11yRuleId` in `@delacour/warden-e2e`. */
+export declare const A11Y_RULE_IDS: readonly ["missing-name", "image-no-name", "target-size", "target-size-platform", "duplicate-name", "role-in-name", "label-in-name", "hidden-focusable", "text-clipped", "native"];
+/**
+ * `a11y` (top level, or per `e2e.<suite>`): how `device.a11yAudit()` / `toPassA11yAudit()` judge a screen.
+ * `ignore` drops a rule (everywhere, or only on the element with that `identifier`); `minSeverity` is the lowest
+ * severity that fails (default `error`); `rules` limits the audit to those rules.
+ */
+export declare const a11yAuditConfigSchema: z.ZodObject<{
+    ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rule: z.ZodEnum<{
+            "missing-name": "missing-name";
+            "image-no-name": "image-no-name";
+            "target-size": "target-size";
+            "target-size-platform": "target-size-platform";
+            "duplicate-name": "duplicate-name";
+            "role-in-name": "role-in-name";
+            "label-in-name": "label-in-name";
+            "hidden-focusable": "hidden-focusable";
+            "text-clipped": "text-clipped";
+            native: "native";
+        }>;
+        identifier: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    minSeverity: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "missing-name": "missing-name";
+        "image-no-name": "image-no-name";
+        "target-size": "target-size";
+        "target-size-platform": "target-size-platform";
+        "duplicate-name": "duplicate-name";
+        "role-in-name": "role-in-name";
+        "label-in-name": "label-in-name";
+        "hidden-focusable": "hidden-focusable";
+        "text-clipped": "text-clipped";
+        native: "native";
+    }>>>;
+}, z.core.$strict>;
+export type A11yAuditConfig = z.infer<typeof a11yAuditConfigSchema>;
+/** The suite's keys over the top-level ones (a suite's `ignore` / `rules` replace, not extend); undefined when neither is set. */
+export declare function mergeA11yAuditConfig(top: A11yAuditConfig | undefined, suite: A11yAuditConfig | undefined): A11yAuditConfig | undefined;
+/** `WARDEN_A11Y_AUDIT`: the JSON `warden e2e` writes. */
+export declare function parseA11yAuditEnv(raw: string): Result<A11yAuditConfig>;

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

@@ -151,8 +151,8 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         variant: z.ZodOptional<z.ZodString>;
         kind: z.ZodOptional<z.ZodEnum<{
             release: "release";
-            dev: "dev";
             simulator: "simulator";
+            dev: "dev";
         }>>;
     }, z.core.$strict>]>>;
     ports: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -166,6 +166,11 @@ export declare const e2eSuiteSchema: z.ZodObject<{
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     biometrics: z.ZodOptional<z.ZodBoolean>;
+    reclaim: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        uninstall: "uninstall";
+        erase: "erase";
+    }>>;
     warmRunners: z.ZodOptional<z.ZodUndefined>;
     warmDrivers: z.ZodOptional<z.ZodBoolean>;
     headless: z.ZodOptional<z.ZodBoolean>;
@@ -256,6 +261,49 @@ export declare const e2eSuiteSchema: z.ZodObject<{
             reduceMotion: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    a11y: z.ZodOptional<z.ZodObject<{
+        ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rule: z.ZodEnum<{
+                "missing-name": "missing-name";
+                "image-no-name": "image-no-name";
+                "target-size": "target-size";
+                "target-size-platform": "target-size-platform";
+                "duplicate-name": "duplicate-name";
+                "role-in-name": "role-in-name";
+                "label-in-name": "label-in-name";
+                "hidden-focusable": "hidden-focusable";
+                "text-clipped": "text-clipped";
+                native: "native";
+            }>;
+            identifier: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        minSeverity: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "missing-name": "missing-name";
+            "image-no-name": "image-no-name";
+            "target-size": "target-size";
+            "target-size-platform": "target-size-platform";
+            "duplicate-name": "duplicate-name";
+            "role-in-name": "role-in-name";
+            "label-in-name": "label-in-name";
+            "hidden-focusable": "hidden-focusable";
+            "text-clipped": "text-clipped";
+            native: "native";
+        }>>>;
+    }, z.core.$strict>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        back: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            loop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>]>>;
+        front: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            loop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>>;
     required: z.ZodDefault<z.ZodBoolean>;
     specs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         entries: z.ZodDefault<z.ZodArray<z.ZodString>>;

package/types/core/src/android-keyguard.d.ts

@@ -21,6 +21,8 @@ export type KeyguardDeps = {
     adb: string;
     now?: () => number;
 };
+/** Whether `dumpsys window` positively reports the keyguard up; an unreadable dump is not a lock screen. */
+export declare function keyguardIsShowing(deps: KeyguardDeps, serial: string): Promise<boolean>;
 /**
  * Get past the lock screen (idempotent: nothing is typed when it is already gone) and keep the device awake.
  * Up to three unlock attempts; before the last one SystemUI is restarted, which recovers a restored snapshot

package/types/core/src/batch/preset.schema.d.ts

@@ -4,6 +4,12 @@ export declare const slimConfigSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodO
     except: z.ZodOptional<z.ZodArray<z.ZodString>>;
     keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>]>;
+/** `reclaim`: what happens to a device's state when its lease ends (`ReclaimMode`). */
+export declare const reclaimSchema: z.ZodEnum<{
+    none: "none";
+    uninstall: "uninstall";
+    erase: "erase";
+}>;
 export declare const duration: z.ZodString;
 export declare const portSpec: z.ZodString;
 /** `batches.<name>` in `warden.config.ts`: a saved `warden batch` invocation. */
@@ -31,8 +37,8 @@ export declare const batchPresetSchema: z.ZodObject<{
         variant: z.ZodOptional<z.ZodString>;
         kind: z.ZodOptional<z.ZodEnum<{
             release: "release";
-            dev: "dev";
             simulator: "simulator";
+            dev: "dev";
         }>>;
     }, z.core.$strict>]>>;
     headless: z.ZodOptional<z.ZodBoolean>;
@@ -41,6 +47,11 @@ export declare const batchPresetSchema: z.ZodObject<{
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     biometrics: z.ZodOptional<z.ZodBoolean>;
+    reclaim: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        uninstall: "uninstall";
+        erase: "erase";
+    }>>;
     retry: z.ZodOptional<z.ZodNumber>;
     passes: z.ZodOptional<z.ZodNumber>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

package/types/core/src/builds/app-option.schema.d.ts

@@ -29,8 +29,8 @@ export declare const appOptionSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodOb
     variant: z.ZodOptional<z.ZodString>;
     kind: z.ZodOptional<z.ZodEnum<{
         release: "release";
-        dev: "dev";
         simulator: "simulator";
+        dev: "dev";
     }>>;
 }, z.core.$strict>]>;
 export type AppOption = z.infer<typeof appOptionSchema>;

package/types/core/src/builds/config.schema.d.ts

@@ -238,8 +238,8 @@ export declare const wardenConfigSchema: z.ZodObject<{
             variant: z.ZodOptional<z.ZodString>;
             kind: z.ZodOptional<z.ZodEnum<{
                 release: "release";
-                dev: "dev";
                 simulator: "simulator";
+                dev: "dev";
             }>>;
         }, z.core.$strict>]>>;
         headless: z.ZodOptional<z.ZodBoolean>;
@@ -248,6 +248,11 @@ export declare const wardenConfigSchema: z.ZodObject<{
             keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>]>>;
         biometrics: z.ZodOptional<z.ZodBoolean>;
+        reclaim: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            uninstall: "uninstall";
+            erase: "erase";
+        }>>;
         retry: z.ZodOptional<z.ZodNumber>;
         passes: z.ZodOptional<z.ZodNumber>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -338,8 +343,8 @@ export declare const wardenConfigSchema: z.ZodObject<{
             variant: z.ZodOptional<z.ZodString>;
             kind: z.ZodOptional<z.ZodEnum<{
                 release: "release";
-                dev: "dev";
                 simulator: "simulator";
+                dev: "dev";
             }>>;
         }, z.core.$strict>]>>;
         ports: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -353,6 +358,11 @@ export declare const wardenConfigSchema: z.ZodObject<{
             keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>]>>;
         biometrics: z.ZodOptional<z.ZodBoolean>;
+        reclaim: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            uninstall: "uninstall";
+            erase: "erase";
+        }>>;
         warmRunners: z.ZodOptional<z.ZodUndefined>;
         warmDrivers: z.ZodOptional<z.ZodBoolean>;
         headless: z.ZodOptional<z.ZodBoolean>;
@@ -443,6 +453,49 @@ export declare const wardenConfigSchema: z.ZodObject<{
                 reduceMotion: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        a11y: z.ZodOptional<z.ZodObject<{
+            ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                rule: z.ZodEnum<{
+                    "missing-name": "missing-name";
+                    "image-no-name": "image-no-name";
+                    "target-size": "target-size";
+                    "target-size-platform": "target-size-platform";
+                    "duplicate-name": "duplicate-name";
+                    "role-in-name": "role-in-name";
+                    "label-in-name": "label-in-name";
+                    "hidden-focusable": "hidden-focusable";
+                    "text-clipped": "text-clipped";
+                    native: "native";
+                }>;
+                identifier: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            minSeverity: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>>;
+            rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "missing-name": "missing-name";
+                "image-no-name": "image-no-name";
+                "target-size": "target-size";
+                "target-size-platform": "target-size-platform";
+                "duplicate-name": "duplicate-name";
+                "role-in-name": "role-in-name";
+                "label-in-name": "label-in-name";
+                "hidden-focusable": "hidden-focusable";
+                "text-clipped": "text-clipped";
+                native: "native";
+            }>>>;
+        }, z.core.$strict>>;
+        camera: z.ZodOptional<z.ZodObject<{
+            back: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                path: z.ZodString;
+                loop: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>]>>;
+            front: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                path: z.ZodString;
+                loop: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>]>>;
+        }, z.core.$strict>>;
         required: z.ZodDefault<z.ZodBoolean>;
         specs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             entries: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -461,6 +514,11 @@ export declare const wardenConfigSchema: z.ZodObject<{
         keep: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     biometrics: z.ZodOptional<z.ZodBoolean>;
+    reclaim: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        uninstall: "uninstall";
+        erase: "erase";
+    }>>;
     perf: z.ZodOptional<z.ZodObject<{
         budgets: z.ZodOptional<z.ZodObject<{
             startupColdMs: z.ZodOptional<z.ZodNumber>;
@@ -548,6 +606,39 @@ export declare const wardenConfigSchema: z.ZodObject<{
             reduceMotion: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    a11y: z.ZodOptional<z.ZodObject<{
+        ignore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rule: z.ZodEnum<{
+                "missing-name": "missing-name";
+                "image-no-name": "image-no-name";
+                "target-size": "target-size";
+                "target-size-platform": "target-size-platform";
+                "duplicate-name": "duplicate-name";
+                "role-in-name": "role-in-name";
+                "label-in-name": "label-in-name";
+                "hidden-focusable": "hidden-focusable";
+                "text-clipped": "text-clipped";
+                native: "native";
+            }>;
+            identifier: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        minSeverity: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "missing-name": "missing-name";
+            "image-no-name": "image-no-name";
+            "target-size": "target-size";
+            "target-size-platform": "target-size-platform";
+            "duplicate-name": "duplicate-name";
+            "role-in-name": "role-in-name";
+            "label-in-name": "label-in-name";
+            "hidden-focusable": "hidden-focusable";
+            "text-clipped": "text-clipped";
+            native: "native";
+        }>>>;
+    }, z.core.$strict>>;
     android: z.ZodOptional<z.ZodObject<{
         snapshot: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;

package/types/core/src/builds/define-config.d.ts

@@ -326,6 +326,13 @@ export interface WardenBatchPreset {
      * `biometrics`. Default false.
      */
     biometrics?: boolean | undefined;
+    /**
+     * What happens to the state of the devices of this run when they are released: `"erase"` (iOS: shutdown +
+     * `simctl erase`; Android: uninstalls the third-party apps), `"uninstall"` (removes the user-installed apps) or
+     * `"none"`. Only warden-created simulators and emulators are reclaimed, never foreign, golden or physical
+     * devices. Overrides the top-level `reclaim`; `WARDEN_RECLAIM` is the fallback below it. Default `"none"`.
+     */
+    reclaim?: "erase" | "uninstall" | "none" | undefined;
     /** Per-job log dir. */
     logs?: string | undefined;
     /**
@@ -420,6 +427,20 @@ export interface WardenPerfConfig {
     /** Budgets; a metric the report has no number for (its capture did not run) cannot breach. */
     budgets?: WardenPerfBudgets | undefined;
 }
+/** `a11y` (top level, or `e2e.<suite>.a11y`): how accessibility audits judge a screen. */
+export interface WardenA11yConfig {
+    /** Findings to drop: a rule everywhere, or only on the element with that `identifier` (testID). */
+    ignore?: Array<{
+        rule: WardenA11yRule;
+        identifier?: string | undefined;
+    }> | undefined;
+    /** Lowest severity that fails an audit. @default "error" */
+    minSeverity?: "error" | "warning" | undefined;
+    /** Run only these rules (default: all). */
+    rules?: WardenA11yRule[] | undefined;
+}
+/** A rule id an audit reports; `native` = XCUITest / ATF findings. */
+export type WardenA11yRule = "missing-name" | "image-no-name" | "target-size" | "target-size-platform" | "duplicate-name" | "role-in-name" | "label-in-name" | "hidden-focusable" | "text-clipped" | "native";
 /** `conditions.network` as a custom shape: the fields of a `custom` network condition. */
 export interface WardenCustomNetwork {
     /** Added round-trip time, ms. */
@@ -507,6 +528,16 @@ export interface WardenE2eDeviceLeg {
      */
     default?: boolean | undefined;
 }
+/** One camera asset: a path (relative to the config file), or `{ path, loop }`. */
+export type WardenCameraFeed = string | {
+    path: string;
+    loop?: boolean | undefined;
+};
+/** `e2e.<suite>.camera`: the asset each facing plays. At least one of `back` / `front`. */
+export type WardenCameraConfig = {
+    back?: WardenCameraFeed | undefined;
+    front?: WardenCameraFeed | undefined;
+};
 /**
  * `e2e.<suite>`: the specs `warden affected` selects and `warden e2e` runs. Every path and glob is
  * relative to the config file.
@@ -521,6 +552,14 @@ export interface WardenE2eSuite {
     perf?: WardenPerfConfig | undefined;
     /** Device conditions every spec of this suite starts from; each area replaces the top-level one. */
     conditions?: WardenConditionsConfig | undefined;
+    /** Accessibility audit settings for this suite; each key replaces the top-level `a11y` one. */
+    a11y?: WardenA11yConfig | undefined;
+    /**
+     * The simulated camera every spec of this suite starts from, applied before the first `app.open()`: a path, or
+     * `{ path, loop }` (video loop, default true), per facing. Paths are relative to the config file. Android devices of
+     * the suite are claimed with `--camera` (profile `<profile>+cam`, cold boot). png, jpg, heic, mp4 and mov are accepted.
+     */
+    camera?: WardenCameraConfig | undefined;
     /** Directory of specs: `*.e2e.ts(x)` specs whose other `.ts` files are helpers (searched recursively; dot dirs, `node_modules` and `__baselines__` skipped). */
     specsDir: string;
     /** How the specs run: the app under test, its launch arguments and the timeouts. */
@@ -685,6 +724,13 @@ export interface WardenE2eSuite {
      * `biometrics`. Default false.
      */
     biometrics?: boolean | undefined;
+    /**
+     * What happens to the state of the devices of this run when they are released: `"erase"` (iOS: shutdown +
+     * `simctl erase`; Android: uninstalls the third-party apps), `"uninstall"` (removes the user-installed apps) or
+     * `"none"`. Only warden-created simulators and emulators are reclaimed, never foreign, golden or physical
+     * devices. Overrides the top-level `reclaim`; `WARDEN_RECLAIM` is the fallback below it. Default `"none"`.
+     */
+    reclaim?: "erase" | "uninstall" | "none" | undefined;
     /** Removed: renamed `warmDrivers`. */
     warmRunners?: undefined;
     /**
@@ -748,10 +794,19 @@ export interface WardenConfig {
      * override it. Default false.
      */
     biometrics?: boolean | undefined;
+    /**
+     * What happens to the state of the devices of this run when they are released: `"erase"` (iOS: shutdown +
+     * `simctl erase`; Android: uninstalls the third-party apps), `"uninstall"` (removes the user-installed apps) or
+     * `"none"`. Only warden-created simulators and emulators are reclaimed, never foreign, golden or physical
+     * devices. Overrides the top-level `reclaim`; `WARDEN_RECLAIM` is the fallback below it. Default `"none"`.
+     */
+    reclaim?: "erase" | "uninstall" | "none" | undefined;
     /** Perf budgets every `e2e` suite starts from (a suite's own `perf.budgets` replace them per key). */
     perf?: WardenPerfConfig | undefined;
     /** Device conditions every `e2e` suite starts from (a suite's own `conditions` replace them per area). */
     conditions?: WardenConditionsConfig | undefined;
+    /** Accessibility audit settings every `e2e` suite starts from (a suite's own `a11y` keys replace them). */
+    a11y?: WardenA11yConfig | undefined;
     /** Android emulator settings. */
     android?: WardenAndroidSettings | undefined;
     /** Physical iPhone settings. */

package/types/core/src/camera-mode.d.ts

@@ -0,0 +1,17 @@
+import { type CameraFacing } from "./conditions/conditions.types";
+/**
+ * Which cameras of an Android `+cam` emulator play a video: facing → the video file's name in the camera dir
+ * (`back.mp4`). A facing left out plays `<facing>.png`. The source kind is fixed when the emulator launches, so
+ * this file records what the RUNNING emulator was launched with; the next launch reads it.
+ */
+export type CameraMode = Partial<Record<CameraFacing, string>>;
+export declare function cameraModePath(dir: string): string;
+/** The recorded mode; a missing or unreadable file is all-image. */
+export declare function readCameraMode(dir: string): CameraMode;
+/** Record `mode` atomically; an all-image mode removes the file. */
+export declare function writeCameraMode(dir: string, mode: CameraMode): void;
+export declare function clearCameraMode(dir: string): void;
+export declare function usesVideo(mode: CameraMode): boolean;
+export declare function sameCameraMode(a: CameraMode, b: CameraMode): boolean;
+/** The emulator's `-camera-back` / `-camera-front` values for `mode`. */
+export declare function cameraSources(dir: string, mode: CameraMode): Record<CameraFacing, string>;

package/types/core/src/camera-placeholder.d.ts

@@ -0,0 +1,9 @@
+/** A 64x48 neutral grey PNG: what a camera emulator's cameras show until a feed is set. */
+export declare const PLACEHOLDER_PNG: Buffer<ArrayBuffer>;
+/**
+ * Put a device's feeds back to the placeholders: both PNGs rewritten atomically (temp + rename, the emulator may be
+ * reading), the staged videos and `mode.json` removed. The emulator itself keeps whatever source it launched with.
+ */
+export declare function resetCameraFeeds(dir: string): void;
+/** Seed `back.png` and `front.png` in `dir` with the grey placeholder, leaving any existing file alone. */
+export declare function seedCameraPlaceholders(dir: string): void;

package/types/core/src/camera-profile.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Camera profiles. An Android profile with `camera: true` is a different device identity from the same profile
+ * without it: the emulator's camera source is fixed at launch (`-camera-back imagefile:…`), so a camera emulator
+ * is never reused as a plain one. The identity is the profile plus `+cam`, after `+bio` when both apply
+ * (`<avd>+bio+cam`); callers that split `+bio` strip `+cam` first.
+ */
+export declare const CAMERA_PROFILE_SUFFIX = "+cam";
+export declare function cameraProfile(profile: string, camera: boolean): string;
+export declare function splitCameraProfile(profile: string): {
+    profile: string;
+    camera: boolean;
+};

package/types/core/src/claim-errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The machine codes a failed device claim carries, with the exit code the CLI returns for each and a short fix.
+ * A claim error travels as a string (`Result<…, string>`) through every claim caller, so the code rides at its
+ * front (`NO_DEVICE: …`, `NO_CAPACITY[ram-budget]: …`) and `parseClaimError` reads it back where it is reported.
+ */
+/** Why the host has no room for the boots a claim needs. */
+export type CapacityReason = "ram-budget" | "cpu-budget" | "memory-pressure" | "host-load";
+export type ClaimErrorCode = "QUEUE_TIMEOUT" | "NO_CAPACITY" | "NO_DEVICE" | "REQUESTER_LIMIT" | "RUNTIME_MISSING" | "HEALTH_FAILED" | "LEASE_LOST";
+/** What a claim error says: its code, and for `NO_CAPACITY` which resource ran out. */
+export type ClaimErrorKind = {
+    code: "NO_CAPACITY";
+    capacityReason: CapacityReason;
+} | {
+    code: Exclude<ClaimErrorCode, "NO_CAPACITY">;
+};
+export type ClaimErrorEntry = {
+    exit: number;
+    hint: string;
+};
+/**
+ * Exit codes 5-11 are claim failures; 1 stays the generic failure, 2 someone else's device / an ambiguous pick,
+ * 3 a missing tool, 4 a stale ref, 124 a timed-out job and 130 an interrupt.
+ */
+export declare const CLAIM_ERRORS: Record<ClaimErrorCode, ClaimErrorEntry>;
+/** `NO_DEVICE: <message>` / `NO_CAPACITY[ram-budget]: <message>`. */
+export declare function claimError(kind: ClaimErrorKind, message: string): string;
+/** A claim error read back from its message: the code, its exit code and hint, and the message without the tag. */
+export type ParsedClaimError = ClaimErrorKind & ClaimErrorEntry & {
+    message: string;
+};
+/** The coded claim error at the front of `error`, or undefined for an uncoded failure. */
+export declare function parseClaimError(error: string): ParsedClaimError | undefined;
+/** Is this provider error a missing runtime / AVD (`RUNTIME_MISSING`)? */
+export declare const isRuntimeMissing: (error: string) => boolean;

package/types/core/src/conditions/a11y-keys.d.ts

@@ -0,0 +1,45 @@
+import type { A11yCondition } from "./conditions.types";
+/**
+ * Accessibility settings that live in `defaults` / `settings` rather than `simctl ui` or `font_scale`. Shared by the
+ * e2e driver (apply) and condition undo (reset), so the two can never name different keys.
+ */
+export declare const IOS_A11Y_DOMAIN = "com.apple.Accessibility";
+/** Condition field to the `com.apple.Accessibility` key it sets on a simulator (applied live, no relaunch). */
+export declare const IOS_A11Y_DEFAULTS: {
+    readonly reduceMotion: "ReduceMotionEnabled";
+    readonly boldText: "EnhancedTextLegibilityEnabled";
+    readonly reduceTransparency: "EnhancedBackgroundContrastEnabled";
+    readonly buttonShapes: "ButtonShapesEnabled";
+    readonly differentiateWithoutColor: "DifferentiateWithoutColor";
+    readonly onOffLabels: "IncreaseButtonLegibilityEnabled";
+    readonly screenReader: "VoiceOverTouchEnabled";
+};
+export type IosDefaultsField = keyof typeof IOS_A11Y_DEFAULTS;
+export declare const IOS_DEFAULTS_FIELDS: IosDefaultsField[];
+/**
+ * One `simctl spawn <udid> defaults write` per entry. Not batched through `sh -c`: `simctl spawn` runs the
+ * simulator's own `defaults` only when it resolves the bare name itself (verified on iOS 26: `/usr/bin/defaults` and a
+ * shell both fail with "Could not write domain" / a dyld abort).
+ */
+export declare function iosDefaultsWriteArgvs(udid: string, entries: readonly (readonly [IosDefaultsField, boolean])[]): string[][];
+/** `defaults delete` per field; a key that is not there exits 1, which the caller must tolerate (`iosDefaultsMissing`). */
+export declare function iosDefaultsDeleteArgvs(udid: string, fields: readonly IosDefaultsField[]): string[][];
+/**
+ * `defaults delete` of a key that is not there exits 1: "does not exist" (older Xcode), "Could not find key" (Xcode
+ * 27), or "Domain not found" when the whole domain is empty. Already as wanted.
+ */
+export declare const iosDefaultsMissing: (stderr: string) => boolean;
+/** The defaults-backed fields a recorded condition holds, i.e. the keys warden wrote (and may delete). */
+export declare function iosDefaultsFields(record: A11yCondition): IosDefaultsField[];
+/** `settings put` argvs (no `adb shell` prefix) that undo the Android-only fields a recorded condition holds. */
+export declare function androidA11yResets(record: A11yCondition): string[][];
+/** Android setting names TalkBack mode writes. */
+export declare const ANDROID_SERVICES_KEY = "enabled_accessibility_services";
+export declare const ANDROID_A11Y_ENABLED_KEY = "accessibility_enabled";
+/** The `settings` argv (no `adb shell` prefix) that sets a secure key to `value`, or deletes it when it was unset. */
+export declare function androidSecureRestoreArgv(key: string, value: string | null): string[];
+/**
+ * TalkBack mode on Android: put back the accessibility services and master switch that were there before. Nothing
+ * when the record has no `screenReaderPrevious` (warden did not turn a screen reader on, so it has nothing to restore).
+ */
+export declare function androidScreenReaderResets(record: A11yCondition): string[][];

package/types/core/src/conditions/camera-media.d.ts

@@ -0,0 +1,30 @@
+import { type Result } from "../../../types/src/result";
+import type { CameraFacing, CameraFeed } from "./conditions.types";
+export type CameraMediaKind = CameraFeed["kind"];
+export type CameraMediaExt = "png" | "jpg" | "heic" | "mp4" | "mov";
+export type CameraMediaError = {
+    code: "E_CAMERA_NOT_FOUND" | "E_CAMERA_MEDIA";
+    message: string;
+};
+/** The kind of a camera asset from its leading bytes (the extension is ignored): png / jpg / heic image, mp4 / mov video. */
+export declare function sniffCameraMedia(path: string): Result<{
+    kind: CameraMediaKind;
+    ext: CameraMediaExt;
+}, CameraMediaError>;
+/** Where a device's staged camera feeds live; the simulator / emulator reads them straight off the host filesystem. */
+export declare function cameraFeedDir(wardenHome: string, udid: string): string;
+export type StageCameraFeedInput = {
+    wardenHome: string;
+    udid: string;
+    facing: CameraFacing;
+    source: string;
+    /** video only: play again from the start at the end (default true where the caller has no opinion) */
+    loop: boolean;
+};
+/**
+ * Copy a camera asset to `<camera dir>/<facing>-<content hash>.<ext>`. The name changes with the content, so a
+ * consumer that compares paths (the iOS dylib, the Android swap) sees every new asset as new.
+ */
+export declare function stageCameraFeed(input: StageCameraFeedInput): Result<CameraFeed, CameraMediaError>;
+/** Remove every staged feed of a device (release / reset). Missing dir is fine. */
+export declare function clearCameraFeeds(wardenHome: string, udid: string): void;

package/types/core/src/conditions/conditions.config.d.ts

@@ -93,6 +93,30 @@ export declare const conditionsConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type ConditionsConfig = z.input<typeof conditionsConfigSchema>;
+/**
+ * A suite's `camera` key: the asset each facing plays from the first `app.open()` on. A path, or `{ path, loop }`
+ * (`loop` applies to a video, default true). Paths are relative to the config file.
+ */
+export declare const cameraConfigSchema: z.ZodObject<{
+    back: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        loop: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    front: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        loop: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+export type CameraConfig = z.input<typeof cameraConfigSchema>;
+/** A suite's camera with absolute paths and a loop flag per facing: what `WARDEN_CAMERA_FEEDS` carries. */
+export type CameraSuiteFeeds = Partial<Record<"back" | "front", {
+    path: string;
+    loop: boolean;
+}>>;
+/** `camera` as absolute paths (against `baseDir`, the config file's directory) with `loop` defaulted to true. */
+export declare function resolveCameraConfig(config: CameraConfig, baseDir: string): CameraSuiteFeeds;
+/** `WARDEN_CAMERA_FEEDS`: the JSON of a suite's resolved camera, checked again on the spec side. */
+export declare function parseCameraFeedsEnv(raw: string): Result<CameraSuiteFeeds>;
 /** What a spec's `device.network.set` takes: a condition, or its word. */
 export type NetworkInput = NetworkCondition | "online" | "offline" | NetworkPreset;
 /** A word, a custom shape (config) or a ready condition, as a `NetworkCondition`. */