@e2edev/mobile 0.8.0-canary-20260921180210

package/dist/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../src/locate.ts"],"names":[],"mappings":"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"}

package/dist/nodes.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Projection of an agent-device accessibility snapshot onto the contract's
+ * `SemanticNode` tree. agent-device hands back a flat list with tree
+ * coordinates (`index`, `parentIndex`, `depth`) and platform element types;
+ * this module rebuilds the tree, maps the types onto the closed role
+ * vocabulary `screen.getByRole` and trace relocation speak, and mints the
+ * ids the surface owns.
+ */
+import type { SemanticNode, ViewportSize } from 'e2e/engine';
+import type { Rect } from './support.ts';
+/** The subset of an agent-device snapshot node this engine reads. */
+export interface RawNode {
+    readonly ref?: string;
+    readonly index?: number;
+    readonly parentIndex?: number;
+    readonly depth?: number;
+    readonly type?: string;
+    readonly role?: string;
+    readonly label?: string;
+    readonly value?: string;
+    readonly identifier?: string;
+    readonly rect?: Rect;
+    readonly enabled?: boolean;
+    readonly selected?: boolean;
+    readonly focused?: boolean;
+    readonly visibleToUser?: boolean;
+    readonly hittable?: boolean;
+    readonly appName?: string;
+    readonly windowTitle?: string;
+}
+/** One projected node with what the surface needs to act on it and to answer selector terms. */
+export interface ProjectedNode {
+    readonly id: string;
+    /** agent-device ref without its `@` prefix; empty for a node the runner cannot act on. */
+    readonly ref: string;
+    /** Platform element type, lower-cased (`text-field`, `cell`, `navigation-bar`). */
+    readonly kind: string;
+    readonly raw: RawNode;
+    readonly node: SemanticNode;
+    readonly parent: ProjectedNode | undefined;
+}
+export interface ProjectedSnapshot {
+    /** The device's top-level elements (windows, the application node); the surface wraps them in one root. */
+    readonly roots: readonly SemanticNode[];
+    /** Every node in document order, parents before children. */
+    readonly index: readonly ProjectedNode[];
+    readonly viewport: ViewportSize | undefined;
+}
+/** One element-type spelling for `NavigationBar`, `navigation-bar`, and `android.widget.NavigationBar` alike. */
+export declare function normalizeKind(type: string): string;
+/**
+ * Projects one snapshot. `mintId` is called once per node in document order,
+ * so the surface's id space stays unique across observations.
+ */
+export declare function projectSnapshot(raw: readonly RawNode[], options: {
+    readonly mintId: () => string;
+}): ProjectedSnapshot;
+/**
+ * The screen's logical size, read off the application or window node when
+ * the platform emits one, else the extent of every rect; undefined for a
+ * snapshot with no geometry at all.
+ */
+export declare function viewportOf(raw: readonly RawNode[]): ViewportSize | undefined;
+/**
+ * The id of the root node every observation is reported under. It is the
+ * same across observations, as the contract requires: `perform(root, swipe)`
+ * is the viewport swipe, addressed from an earlier observation.
+ */
+export declare const ROOT_ID = "root";
+/**
+ * The one root the contract wants over a device's several top-level
+ * elements. Its box is the viewport; it carries no name of its own, the
+ * foreground app being reported as the snapshot's location.
+ */
+export declare function screenRoot(roots: readonly SemanticNode[], viewport: ViewportSize): SemanticNode;
+/**
+ * The visible screen's title: the navigation bar's (iOS) or toolbar's
+ * (Android) own label, else the first text inside it, else its identifier
+ * (UIKit names the bar after its title). Undefined when the screen has no
+ * title bar, which is the honest answer for a launch screen, a full-screen
+ * sheet, or Android's Settings home.
+ */
+export declare function screenTitle(snapshot: ProjectedSnapshot): string | undefined;
+/** True when `entry` is a strict descendant of `ancestor`. */
+export declare function isWithin(entry: ProjectedNode, ancestor: ProjectedNode): boolean;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;CAC7C;AA2GD,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAkDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAuEtH;AAOD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,YAAY,GAAG,SAAS,CAa5E;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,SAAS,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,CAO/F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAW3E;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAK/E"}

package/dist/nodes.js

@@ -0,0 +1,315 @@
+/**
+ * Projection of an agent-device accessibility snapshot onto the contract's
+ * `SemanticNode` tree. agent-device hands back a flat list with tree
+ * coordinates (`index`, `parentIndex`, `depth`) and platform element types;
+ * this module rebuilds the tree, maps the types onto the closed role
+ * vocabulary `screen.getByRole` and trace relocation speak, and mints the
+ * ids the surface owns.
+ */
+/**
+ * Platform element types onto the role vocabulary. Anything not listed keeps
+ * its lower-cased type as the role, so no information is lost; the map only
+ * makes the common controls answer the same `getByRole` a browser does.
+ */
+const ROLE_MAP = {
+    button: 'button',
+    link: 'link',
+    'text-field': 'textbox',
+    textfield: 'textbox',
+    'search-field': 'textbox',
+    'text-view': 'textbox',
+    'edit-text': 'textbox',
+    'secure-text-field': 'textbox',
+    securetextfield: 'textbox',
+    switch: 'switch',
+    toggle: 'switch',
+    checkbox: 'checkbox',
+    'check-box': 'checkbox',
+    slider: 'slider',
+    image: 'image',
+    'image-view': 'image',
+    'static-text': 'text',
+    text: 'text',
+    cell: 'listitem',
+    'list-item': 'listitem',
+    'table-cell': 'listitem',
+    'collection-cell': 'listitem',
+    tab: 'tab',
+    'tab-bar-item': 'tab',
+    'tab-bar-button': 'tab',
+    'menu-item': 'menuitem',
+    'menu-button': 'menuitem',
+    alert: 'alert',
+    dialog: 'dialog',
+    sheet: 'dialog',
+    'action-sheet': 'dialog',
+    heading: 'heading',
+    header: 'heading',
+    'navigation-bar': 'navigation',
+    'activity-indicator': 'status',
+    'progress-indicator': 'status',
+};
+const SECURE_KINDS = new Set(['secure-text-field', 'securetextfield', 'password-field']);
+const CHECKABLE_ROLES = new Set(['switch', 'checkbox']);
+const CHECKED_VALUES = new Set(['1', 'on', 'true', 'checked', 'selected']);
+const UNCHECKED_VALUES = new Set(['0', 'off', 'false', 'unchecked']);
+const SCREEN_KINDS = new Set(['application', 'app', 'window']);
+/**
+ * Android view classes onto the role vocabulary, keyed by the simple class
+ * name in kebab case. A `TextView` is static text here where an iOS
+ * `TextView` is an editor, which is why the two platforms keep separate maps.
+ */
+const ANDROID_ROLE_MAP = {
+    'text-view': 'text',
+    'edit-text': 'textbox',
+    'auto-complete-text-view': 'textbox',
+    'text-input-edit-text': 'textbox',
+    'search-view': 'textbox',
+    button: 'button',
+    'image-button': 'button',
+    'material-button': 'button',
+    'image-view': 'image',
+    switch: 'switch',
+    'switch-compat': 'switch',
+    'switch-material': 'switch',
+    'toggle-button': 'switch',
+    'check-box': 'checkbox',
+    'material-check-box': 'checkbox',
+    'radio-button': 'radio',
+    'seek-bar': 'slider',
+    slider: 'slider',
+    spinner: 'combobox',
+    'web-view': 'document',
+    'recycler-view': 'list',
+    'list-view': 'list',
+    'grid-view': 'list',
+    'scroll-view': 'group',
+    'view-group': 'group',
+    view: 'group',
+    'compose-view': 'group',
+    'view-factory-holder': 'group',
+    'card-view': 'group',
+};
+/** Identifier suffixes of the view that carries an Android screen's title. */
+const ANDROID_TITLE_IDS = [':id/collapsing_toolbar', ':id/action_bar', ':id/toolbar'];
+/**
+ * Platform element type of one raw node as a kebab-case token: XCTest sends
+ * `NavigationBar` and `StaticText`, Android sends `android.widget.TextView`;
+ * both read as one vocabulary here, the Android package prefix dropped.
+ * `role` is the fallback some platforms send instead.
+ */
+function kindOf(raw) {
+    return normalizeKind(raw.type ?? raw.role ?? '');
+}
+/** True when a raw type is a qualified Android class name. */
+function isAndroidClass(type) {
+    return type !== undefined && type.includes('.');
+}
+/** One element-type spelling for `NavigationBar`, `navigation-bar`, and `android.widget.NavigationBar` alike. */
+export function normalizeKind(type) {
+    const simple = type.slice(type.lastIndexOf('.') + 1);
+    return simple
+        .replaceAll(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replaceAll(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/** Contract role for one platform element type. */
+function roleOf(kind, android = false) {
+    if (kind === '')
+        return undefined;
+    if (android)
+        return ANDROID_ROLE_MAP[kind] ?? (kind.endsWith('layout') ? 'group' : kind);
+    return ROLE_MAP[kind] ?? kind;
+}
+function checkedOf(role, value) {
+    if (role === undefined || !CHECKABLE_ROLES.has(role) || value === undefined)
+        return undefined;
+    const lowered = value.trim().toLowerCase();
+    if (CHECKED_VALUES.has(lowered))
+        return true;
+    if (UNCHECKED_VALUES.has(lowered))
+        return false;
+    return undefined;
+}
+function stripRef(ref) {
+    if (ref === undefined)
+        return '';
+    return ref.startsWith('@') ? ref.slice(1) : ref;
+}
+/**
+ * Parent position of every raw node. `parentIndex` is authoritative when it
+ * names a node in the list; otherwise `depth` reconstructs nesting from the
+ * document order agent-device emits; a node with neither is a root.
+ */
+function parentPositions(raw) {
+    const byIndex = new Map();
+    raw.forEach((node, position) => {
+        if (typeof node.index === 'number')
+            byIndex.set(node.index, position);
+    });
+    const lastAtDepth = [];
+    return raw.map((node, position) => {
+        let parent;
+        if (typeof node.parentIndex === 'number' && node.parentIndex >= 0) {
+            const resolved = byIndex.get(node.parentIndex);
+            if (resolved !== undefined && resolved < position)
+                parent = resolved;
+        }
+        if (parent === undefined && typeof node.depth === 'number' && node.depth > 0) {
+            parent = lastAtDepth[node.depth - 1];
+        }
+        if (typeof node.depth === 'number') {
+            lastAtDepth[node.depth] = position;
+            lastAtDepth.length = node.depth + 1;
+        }
+        return parent;
+    });
+}
+/**
+ * Projects one snapshot. `mintId` is called once per node in document order,
+ * so the surface's id space stays unique across observations.
+ */
+export function projectSnapshot(raw, options) {
+    const parents = parentPositions(raw);
+    const children = new Map();
+    const roots = [];
+    parents.forEach((parent, position) => {
+        if (parent === undefined) {
+            roots.push(position);
+            return;
+        }
+        const siblings = children.get(parent);
+        if (siblings === undefined)
+            children.set(parent, [position]);
+        else
+            siblings.push(position);
+    });
+    const index = [];
+    const build = (position, parent) => {
+        const source = raw[position];
+        const id = options.mintId();
+        const kind = kindOf(source);
+        const role = roleOf(kind, isAndroidClass(source.type));
+        const secure = SECURE_KINDS.has(kind);
+        const checked = checkedOf(role, source.value);
+        const states = {
+            ...(source.enabled === false ? { disabled: true } : {}),
+            ...(source.selected === true ? { selected: true } : {}),
+            ...(source.focused === true ? { focused: true } : {}),
+            ...(source.visibleToUser === false ? { hidden: true } : {}),
+            ...(secure ? { secure: true } : {}),
+            ...(checked === undefined ? {} : { checked }),
+        };
+        const identifier = source.identifier === undefined || source.identifier === '' ? undefined : source.identifier;
+        const projected = { node: undefined };
+        const entry = {
+            id,
+            ref: stripRef(source.ref),
+            kind,
+            raw: source,
+            parent,
+            get node() {
+                return projected.node;
+            },
+        };
+        index.push(entry);
+        const childNodes = (children.get(position) ?? []).map((child) => build(child, entry));
+        const node = {
+            ref: { id, revision: '' },
+            ...(role === undefined ? {} : { role }),
+            // A device label is both the node's accessible name and its visible
+            // text, so `toHaveText` and `getByText` read the same string; the model
+            // rendering elides `text` whenever it equals `name`, so this costs nothing.
+            ...(source.label === undefined || source.label === '' ? {} : { name: source.label, text: source.label }),
+            // A secure field's value is never observed; the tree carries that it is
+            // secure, not what it holds. Android echoes a text view's label as its
+            // value, which would render every line twice, so an echo is dropped.
+            ...(secure || source.value === undefined || source.value === '' || source.value === source.label
+                ? {}
+                : { value: source.value }),
+            ...(secure ? { inputPurpose: 'password' } : {}),
+            ...(Object.keys(states).length === 0 ? {} : { states }),
+            // The accessibility identifier (iOS) or resource id (Android) is the node's test id.
+            ...(identifier === undefined ? {} : { testId: identifier }),
+            ...(source.rect === undefined ? {} : { rect: { ...source.rect } }),
+            // Structural hint for tuned replay policies: an identifier survives relabeling; a label does not anchor.
+            ...(identifier === undefined ? {} : { selector: `id=${quoteTerm(identifier)}` }),
+            ...(childNodes.length === 0 ? {} : { children: childNodes }),
+        };
+        projected.node = node;
+        return node;
+    };
+    const rootNodes = roots.map((position) => build(position, undefined));
+    return { roots: rootNodes, index, viewport: viewportOf(raw) };
+}
+/** Quotes one selector term value the way agent-device's parser reads it back. */
+function quoteTerm(value) {
+    return /[\s"]/.test(value) ? JSON.stringify(value) : value;
+}
+/**
+ * The screen's logical size, read off the application or window node when
+ * the platform emits one, else the extent of every rect; undefined for a
+ * snapshot with no geometry at all.
+ */
+export function viewportOf(raw) {
+    const screen = raw.find((node) => SCREEN_KINDS.has(kindOf(node)) && node.rect !== undefined);
+    if (screen?.rect !== undefined && screen.rect.width > 0 && screen.rect.height > 0) {
+        return { width: screen.rect.width, height: screen.rect.height };
+    }
+    let width = 0;
+    let height = 0;
+    for (const node of raw) {
+        if (node.rect === undefined)
+            continue;
+        width = Math.max(width, node.rect.x + node.rect.width);
+        height = Math.max(height, node.rect.y + node.rect.height);
+    }
+    return width > 0 && height > 0 ? { width, height } : undefined;
+}
+/**
+ * The id of the root node every observation is reported under. It is the
+ * same across observations, as the contract requires: `perform(root, swipe)`
+ * is the viewport swipe, addressed from an earlier observation.
+ */
+export const ROOT_ID = 'root';
+/**
+ * The one root the contract wants over a device's several top-level
+ * elements. Its box is the viewport; it carries no name of its own, the
+ * foreground app being reported as the snapshot's location.
+ */
+export function screenRoot(roots, viewport) {
+    return {
+        ref: { id: ROOT_ID, revision: '' },
+        role: 'screen',
+        rect: { x: 0, y: 0, width: viewport.width, height: viewport.height },
+        ...(roots.length === 0 ? {} : { children: roots }),
+    };
+}
+/**
+ * The visible screen's title: the navigation bar's (iOS) or toolbar's
+ * (Android) own label, else the first text inside it, else its identifier
+ * (UIKit names the bar after its title). Undefined when the screen has no
+ * title bar, which is the honest answer for a launch screen, a full-screen
+ * sheet, or Android's Settings home.
+ */
+export function screenTitle(snapshot) {
+    const bar = snapshot.index.find((entry) => entry.kind === 'navigation-bar') ??
+        snapshot.index.find((entry) => ANDROID_TITLE_IDS.some((suffix) => entry.raw.identifier?.endsWith(suffix) === true));
+    if (bar === undefined)
+        return undefined;
+    if (bar.raw.label !== undefined && bar.raw.label.trim() !== '')
+        return bar.raw.label;
+    const text = snapshot.index.find((entry) => entry.node.role === 'text' && entry.raw.label !== undefined && entry.raw.label.trim() !== '' && isWithin(entry, bar));
+    if (text !== undefined)
+        return text.raw.label;
+    return bar.raw.identifier === undefined || bar.raw.identifier.trim() === '' ? undefined : bar.raw.identifier;
+}
+/** True when `entry` is a strict descendant of `ancestor`. */
+export function isWithin(entry, ancestor) {
+    for (let current = entry.parent; current !== undefined; current = current.parent) {
+        if (current === ancestor)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=nodes.js.map

package/dist/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"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"}

package/dist/options.d.ts

@@ -0,0 +1,93 @@
+/**
+ * What the device engine is given: its options, and the agent-device client
+ * it drives them through. Shared by the surface (one session per worker) and
+ * the pool (the target's devices, one per worker slot).
+ */
+import type { createAgentDeviceClient } from 'agent-device';
+import type { DeviceDaemon } from './bindings.ts';
+import type { DeviceProvider } from './provider.ts';
+export type AgentDeviceClient = ReturnType<typeof createAgentDeviceClient>;
+/**
+ * Mints the agent-device client for one session, against a leased daemon
+ * when a provider supplied one, else the local daemon; the seam unit tests
+ * script.
+ */
+export type ClientFactory = (session: string, daemon?: DeviceDaemon) => AgentDeviceClient;
+export type MobilePlatform = 'ios' | 'android';
+/**
+ * Options of the device engine. Every optional value also accepts `undefined`,
+ * so values read straight from `process.env` need no conditional spread.
+ */
+export interface MobileOptions {
+    /** Platform the target's device runs. */
+    readonly platform: MobilePlatform;
+    /**
+     * App opened fresh at the start of every attempt: a bundle id, a package
+     * name, or a display name agent-device resolves (`Settings`). Without it the
+     * surface observes whatever is in the foreground, and `app.restart()` and
+     * `app.clearState()` are not available.
+     */
+    readonly app?: string | undefined;
+    /**
+     * Build to install on the device once per worker, before the first attempt:
+     * an iOS `.app` bundle or an Android `.apk`, resolved against the project
+     * root (the config's directory). Without `app`, the installed bundle id or
+     * package becomes the app opened fresh at the start of every attempt.
+     */
+    readonly appPath?: string | undefined;
+    /**
+     * Stable identity keying trace cache and session entries; defaults to `app`,
+     * else `appPath`. Declare one when the pinned app differs per run (a build
+     * path with a version in it) so entries survive the rename.
+     */
+    readonly identity?: string | undefined;
+    /** Report label joining the cache identity; a simulator or emulator defaults to `test`. */
+    readonly environment?: 'test' | 'staging' | 'production' | undefined;
+    /**
+     * Simulator or emulator to use, by name or UDID. A list is a pool: the
+     * engine declares one worker per entry and worker slot `n` drives the
+     * `n`th, so `workers` at or above the pool size runs the target's files
+     * across every device at once. Omitted, the pool is every booted device of
+     * the platform at `prepare`, as many as the run has slots; with none booted,
+     * agent-device boots one. A `DeviceProvider` leases hosted devices instead:
+     * one per worker slot at `prepare`, each driven through the daemon the
+     * lease names, all released when the run ends.
+     */
+    readonly device?: string | readonly string[] | DeviceProvider | undefined;
+    /**
+     * agent-device session name, before the worker slot: slot `n` drives its
+     * device under `<session>-<n>`, `e2e-<target name>-<n>` by default. One run
+     * per session at a time: concurrent runs on the same session interleave
+     * taps.
+     */
+    readonly session?: string | undefined;
+    /**
+     * What an observation captures. `full` (default) includes static text, so
+     * judgments can read values; `interactive` keeps only actionable nodes and
+     * is cheaper on screens with long lists.
+     */
+    readonly snapshot?: 'full' | 'interactive' | undefined;
+    /**
+     * How long the UI must hold still after a tap, fill, or back before the
+     * action counts as landed, in milliseconds; `false` skips the wait. The
+     * wait keeps the observation that follows an action off a transition
+     * frame; the runner's own polling (`expect`, actions waiting for their
+     * node) covers the rest, so a short window suffices. Default 150. Every
+     * frame of a running animation changes the tree, so a 150 ms window still
+     * catches a transition in flight; raise it for slow devices or apps that
+     * settle in stages, or lower it to 0 to keep only the first re-observation.
+     */
+    readonly settle?: number | false | undefined;
+    /**
+     * How long a control that appeared or moved with the last action is given
+     * to finish arriving before a test acts on it, in milliseconds. Default
+     * 500, the length of a modal or screen transition. Accessibility frames
+     * report a control's final position from the first frame of a transition,
+     * so this budget is the only thing that keeps a test from tapping a point
+     * the control has not reached; controls already on screen at the same
+     * place before the action are acted on at once. Raise it for slower
+     * transitions.
+     */
+    readonly transition?: number | undefined;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,iBAAiB,CAAC;AAE1F,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACrE;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,cAAc,GAAG,SAAS,CAAC;IAC1E;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACvD;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC7C;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C"}

package/dist/options.js

@@ -0,0 +1,7 @@
+/**
+ * What the device engine is given: its options, and the agent-device client
+ * it drives them through. Shared by the surface (one session per worker) and
+ * the pool (the target's devices, one per worker slot).
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/png.d.ts

@@ -0,0 +1,4 @@
+import type { Rect } from './support.ts';
+/** Paints each requested rectangle opaque black, rounding outward and clipping to the image. */
+export declare function maskPng(bytes: Uint8Array, rects: readonly Rect[]): Uint8Array;
+//# sourceMappingURL=png.d.ts.map

package/dist/png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../src/png.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,gGAAgG;AAChG,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,UAAU,CAmB7E"}

package/dist/png.js

@@ -0,0 +1,25 @@
+/** Screenshot masking policy; PNG parsing and encoding belong to pngjs. */
+import { PNG } from 'pngjs';
+/** Paints each requested rectangle opaque black, rounding outward and clipping to the image. */
+export function maskPng(bytes, rects) {
+    if (rects.length === 0)
+        return bytes;
+    const image = PNG.sync.read(Buffer.from(bytes));
+    for (const rect of rects) {
+        const x0 = Math.max(0, Math.floor(rect.x));
+        const y0 = Math.max(0, Math.floor(rect.y));
+        const x1 = Math.min(image.width, Math.ceil(rect.x + rect.width));
+        const y1 = Math.min(image.height, Math.ceil(rect.y + rect.height));
+        for (let y = y0; y < y1; y += 1) {
+            for (let x = x0; x < x1; x += 1) {
+                const at = (y * image.width + x) * 4;
+                image.data[at] = 0;
+                image.data[at + 1] = 0;
+                image.data[at + 2] = 0;
+                image.data[at + 3] = 255;
+            }
+        }
+    }
+    return PNG.sync.write(image);
+}
+//# sourceMappingURL=png.js.map

package/dist/png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../src/png.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,gGAAgG;AAChG,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,KAAsB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}