@e2edev/agent-device 0.1.0

package/dist/locate.js

@@ -0,0 +1,100 @@
+/**
+ * LocatorExpression evaluation over one projected snapshot: the location
+ * capability's query language answered against the accessibility tree the
+ * device just reported. One immediate pass, every match in document order;
+ * polling, strictness, and staleness stay with the runner.
+ */
+import { BackendError, matchesText } from '@e2edev/e2e/backend';
+import { isWithin } from './nodes.js';
+import { compileSelector } from './selector.js';
+/** Resolves one expression to the nodes it currently matches. */
+export function resolveExpression(expression, index, options) {
+    switch (expression.kind) {
+        case 'query': {
+            const candidates = expression.scope === undefined ? index : descendantsOf(resolveExpression(expression.scope, index, options), index);
+            return candidates.filter((entry) => matchesQuery(entry, expression.query, options));
+        }
+        case 'filter': {
+            const source = resolveExpression(expression.source, index, options);
+            return source.filter((entry) => {
+                if (expression.hasText !== undefined && !subtreeHasText(entry, index, expression.hasText))
+                    return false;
+                if (expression.has !== undefined) {
+                    const within = descendantsOf([entry], index);
+                    if (resolveExpression(expression.has, within, options).length === 0)
+                        return false;
+                }
+                return true;
+            });
+        }
+        case 'index': {
+            const source = resolveExpression(expression.source, index, options);
+            const position = expression.index === 'first' ? 0 : expression.index === 'last' ? source.length - 1 : expression.index;
+            const picked = source[position];
+            return picked === undefined ? [] : [picked];
+        }
+        case 'selector':
+            return compileSelector(expression.selector)(index);
+        case 'frame':
+            throw new BackendError('FRAME_NOT_FOUND', 'a device surface has no nested documents to scope a query into', {
+                retryable: false,
+            });
+    }
+}
+/** Strict descendants of any node in `ancestors`, in document order. */
+function descendantsOf(ancestors, index) {
+    if (ancestors.length === 0)
+        return [];
+    return index.filter((entry) => ancestors.some((ancestor) => isWithin(entry, ancestor)));
+}
+function subtreeHasText(entry, index, pattern) {
+    const ownTexts = [entry.node.name, entry.node.text, entry.node.value];
+    if (ownTexts.some((text) => text !== undefined && matchesText(text, pattern)))
+        return true;
+    return descendantsOf([entry], index).some((child) => [child.node.name, child.node.text, child.node.value].some((text) => text !== undefined && matchesText(text, pattern)));
+}
+const STATE_KEYS = ['checked', 'disabled', 'selected', 'expanded'];
+/**
+ * One node against one semantic query. Role queries skip hidden nodes unless
+ * the query asks for them, as a browser's role query does; the other kinds
+ * answer with every node and leave visibility to the action or assertion.
+ */
+function matchesQuery(entry, query, options) {
+    const node = entry.node;
+    switch (query.kind) {
+        case 'role': {
+            if (query.value.kind !== 'string') {
+                throw new BackendError('BACKEND_FAILURE', 'role query value must be a string', { retryable: false });
+            }
+            if ((node.role ?? '') !== query.value.value)
+                return false;
+            if (query.name !== undefined && !matchesText(node.name ?? '', query.name))
+                return false;
+            const wanted = query.states ?? {};
+            if (wanted.hidden !== true && node.states?.hidden === true)
+                return false;
+            for (const key of STATE_KEYS) {
+                const expected = wanted[key];
+                if (expected !== undefined && (node.states?.[key] ?? false) !== expected)
+                    return false;
+            }
+            return true;
+        }
+        case 'label':
+            return node.name !== undefined && matchesText(node.name, query.value);
+        case 'placeholder': {
+            const placeholder = node.attributes?.['placeholder'];
+            return placeholder !== undefined && matchesText(placeholder, query.value);
+        }
+        case 'text':
+            return ((node.name !== undefined && matchesText(node.name, query.value)) ||
+                (node.text !== undefined && matchesText(node.text, query.value)));
+        case 'displayValue':
+            return node.value !== undefined && matchesText(node.value, query.value);
+        case 'testId': {
+            const testId = node.attributes?.[options.testIdAttribute];
+            return testId !== undefined && matchesText(testId, query.value);
+        }
+    }
+}
+//# sourceMappingURL=locate.js.map

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,82 @@
+/**
+ * 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 } from '@e2edev/e2e/backend';
+import type { Rect } from './support.ts';
+/** The subset of an agent-device snapshot node this backend 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 {
+    readonly roots: readonly SemanticNode[];
+    /** Every node in document order, parents before children. */
+    readonly index: readonly ProjectedNode[];
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+        readonly scale: number;
+    } | 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 testIdAttribute: string;
+    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[]): {
+    readonly width: number;
+    readonly height: number;
+    readonly scale: number;
+} | undefined;
+/**
+ * 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":"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"}

package/dist/nodes.js

@@ -0,0 +1,295 @@
+/**
+ * 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 }),
+            ...(identifier === undefined ? {} : { attributes: { [options.testIdAttribute]: 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, scale: 1 };
+    }
+    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, scale: 1 } : undefined;
+}
+/**
+ * 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/png.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Minimal PNG codec for masking secure regions in device screenshots: 8-bit
+ * RGB or RGBA, non-interlaced, which is what a simulator or emulator
+ * screenshot is. Anything else is refused loudly, and the caller withholds
+ * the image rather than shipping pixels it could not redact.
+ */
+import type { Rect } from './support.ts';
+export interface DecodedPng {
+    readonly width: number;
+    readonly height: number;
+    /** 3 for RGB, 4 for RGBA. */
+    readonly channels: number;
+    /** Row-major samples, `width * channels` per row, mutable. */
+    readonly pixels: Uint8Array;
+}
+/** Decodes PNG bytes into mutable samples; throws for formats this codec does not read. */
+export declare function decodePng(bytes: Uint8Array): DecodedPng;
+/** Encodes samples as a PNG with unfiltered rows; size is not the goal, fidelity is. */
+export declare function encodePng(image: DecodedPng): Uint8Array;
+/** Decodes, masks, and re-encodes in one step. */
+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":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIzC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAWD,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAqEvD;AA0BD,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAuBvD;AA0BD,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,UAAU,CAK7E"}