@testmuai/playwright-bindings 0.1.26 → 0.1.27

package/dist/helpers/visionV3.js

@@ -0,0 +1,291 @@
+import { get as configGet } from '../configure.js';
+import { log, repr } from '../log.js';
+import { resolveVar } from '../vars.js';
+import { derive } from './derive.js';
+import { captureScreenshotB64 } from './screenshot.js';
+import { getV3DesktopLocateFullPageTarget } from './healCascade.js';
+import { resolveCoordinateRead } from './coordinateResolverRead.js';
+import { LOCAL_READ_ATTRS, extractValue } from './textualRead.js';
+export const V3_HEAL_VISION_PATH = '/v1/heal/vision';
+export const V3_HEAL_TEXTUAL_QUERY_PATH = '/v1/heal/textual_query';
+const V3_POST_TIMEOUT_MS = 30_000;
+// Computed styles requested on the textual_query DOMSnapshot (PY _CSS_PROPERTIES).
+const V3_SNAPSHOT_CSS_PROPERTIES = [
+    'color', 'background-color', 'border-color',
+    'font-size', 'font-family', 'font-weight', 'font-style',
+    'display', 'visibility', 'opacity',
+];
+// Outer payload fields coerced to str (null -> '') for the server schema.
+const V3_STR_FIELDS = [
+    'code_export_id', 'commit_id', 'test_id', 'username', 'accesskey', 'session_id',
+];
+/** bool: JSON bools + truthy strings; number: float w/ digit-filter fallback;
+ * else str ('' for null). PY _cast_v3_vision_query_result parity. */
+export function castV3VisionQueryResult(raw, returnType) {
+    if (returnType === 'bool') {
+        if (typeof raw === 'boolean')
+            return raw;
+        return ['true', '1', 'yes'].includes(String(raw).trim().toLowerCase());
+    }
+    if (returnType === 'number') {
+        if (typeof raw === 'number')
+            return raw;
+        const s = String(raw).trim();
+        const direct = Number(s);
+        if (s !== '' && Number.isFinite(direct))
+            return direct;
+        const filtered = [...s].filter((c) => (c >= '0' && c <= '9') || c === '.').join('');
+        const parsed = Number(filtered);
+        return filtered && Number.isFinite(parsed) ? parsed : 0.0;
+    }
+    return raw === null || raw === undefined ? '' : String(raw);
+}
+/** Only 'number' is special-cased; ''/null pass through; '-' anywhere flips
+ * the sign of the digit-filter fallback. PY _coerce_textual_value parity. */
+export function coerceTextualValue(value, returnType) {
+    if (returnType !== 'number')
+        return value;
+    if (value === null || value === undefined || value === '')
+        return value;
+    if (typeof value === 'number')
+        return value;
+    const direct = Number(value);
+    if (typeof value !== 'boolean' && Number.isFinite(direct) && String(value).trim() !== '') {
+        return direct;
+    }
+    const s = String(value);
+    const isNegative = s.includes('-');
+    const filtered = [...s].filter((c) => (c >= '0' && c <= '9') || c === '.').join('');
+    if (!filtered)
+        return 0.0;
+    const parsed = Number(filtered);
+    if (!Number.isFinite(parsed))
+        return 0.0;
+    return isNegative ? -parsed : parsed;
+}
+/** Coerce outer payload types in place: str fields via String() (null -> ''),
+ * org_id to int (unparseable -> 0). PY _normalize_v3_payload_types parity. */
+export function normalizeV3PayloadTypes(payload) {
+    for (const key of V3_STR_FIELDS) {
+        if (key in payload) {
+            const v = payload[key];
+            payload[key] = v === null || v === undefined ? '' : String(v);
+        }
+    }
+    if ('org_id' in payload) {
+        const raw = payload['org_id'];
+        const parsed = parseInt(String(raw), 10);
+        payload['org_id'] = raw === null || raw === undefined || raw === '' || Number.isNaN(parsed) ? 0 : parsed;
+    }
+    return payload;
+}
+// Configure creds when present, LT_* env otherwise (grid runs configure only
+// the runtime IDs; creds arrive via env — same fallback as healCascade).
+function v3Creds() {
+    return {
+        username: String(configGet('username') ?? '') || (process.env['LT_USERNAME'] ?? ''),
+        accesskey: String(configGet('accesskey') ?? '') || (process.env['LT_ACCESS_KEY'] ?? ''),
+    };
+}
+function v3AuthHeaders() {
+    const { username, accesskey } = v3Creds();
+    return {
+        'Content-Type': 'application/json',
+        Authorization: `Basic ${Buffer.from(`${username}:${accesskey}`).toString('base64')}`,
+    };
+}
+/** HTTP layer separated for testability (stubbed via global fetch in tests). */
+export async function postV3Vision(url, payload, headers) {
+    const resp = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(V3_POST_TIMEOUT_MS),
+    });
+    if (resp.status >= 400) {
+        const body = await resp.text().catch(() => '');
+        log.helper(`[v3 vision] HTTP ${resp.status} body=${body.slice(0, 1000)}`);
+        throw new Error(`HTTP ${resp.status} from ${url}`);
+    }
+    return (await resp.json());
+}
+function buildCurrentAction(operationType, intent, operationDict) {
+    return {
+        operation_type: operationType,
+        operation_intent: intent,
+        instruction_id: '',
+        operation_id: '',
+        use_query_v2: true,
+        version: 'v3',
+        selector: [],
+        frame_info: [],
+        sub_instruction_obj: { operation_dict: operationDict },
+    };
+}
+function baseV3Payload() {
+    const { username, accesskey } = v3Creds();
+    return {
+        code_export_id: configGet('codeExportId'),
+        commit_id: configGet('commitId'),
+        test_id: configGet('testId'),
+        username,
+        accesskey,
+        org_id: configGet('orgId'),
+        session_id: configGet('sessionId'),
+    };
+}
+/**
+ * V3 vision query — POST screenshot + intent to {automind}/v1/heal/vision and
+ * read `vision_query`, cast to returnType. Throws on transport failure, error
+ * envelope, or a missing field (a junk store is worse than a loud step fail).
+ */
+export async function visionQueryV3(page, description, returnType, codeJs) {
+    const resolvedRaw = await resolveVar(description);
+    const resolved = resolvedRaw === null || resolvedRaw === undefined ? '' : String(resolvedRaw);
+    const baseUrl = String(configGet('automindUrl') ?? '');
+    if (!baseUrl) {
+        log.helper('[vision_query] no heal endpoint configured');
+        return null;
+    }
+    const screenshotB64 = await captureScreenshotB64(page);
+    const payload = normalizeV3PayloadTypes({
+        ...baseV3Payload(),
+        current_action: buildCurrentAction('VISION_QUERY', resolved, {
+            queried_value: resolved,
+            result_type: returnType,
+        }),
+        untagged_image_base64: screenshotB64,
+        use_query_v2: true,
+        version: 'v3',
+    });
+    let result;
+    try {
+        result = await postV3Vision(`${baseUrl}${V3_HEAL_VISION_PATH}`, payload, v3AuthHeaders());
+    }
+    catch (e) {
+        log.helper(`[vision_query] '${description.slice(0, 80)}': ${String(e)}`);
+        throw new Error(`vision_query failed: ${String(e)}`);
+    }
+    if (result['error'])
+        throw new Error(`vision_query failed: ${String(result['error'])}`);
+    const raw = result['vision_query'];
+    if (raw === null || raw === undefined) {
+        throw new Error(`vision_query response missing 'vision_query' field: ${JSON.stringify(result)}`);
+    }
+    const extracted = castV3VisionQueryResult(raw, returnType);
+    log.helper(`[vision_query] result=${repr(extracted).slice(0, 120)}`);
+    if (codeJs === undefined)
+        return extracted;
+    return await derive(page, codeJs, String(extracted));
+}
+/** Raw CDP a11y + DOM snapshots for the server-side textual read. Chromium
+ * only (the grid CDP path); PY's webkit/firefox runtime-asset route N/A here. */
+async function captureV3SnapshotsWithCdp(page) {
+    const cdp = await page.context().newCDPSession(page);
+    try {
+        await cdp.send('Accessibility.enable');
+        const a11ySnapshot = await cdp.send('Accessibility.getFullAXTree');
+        const domSnapshot = await cdp.send('DOMSnapshot.captureSnapshot', {
+            computedStyles: V3_SNAPSHOT_CSS_PROPERTIES,
+            includeDOMRects: true,
+        });
+        return [a11ySnapshot, domSnapshot];
+    }
+    finally {
+        await cdp.detach();
+    }
+}
+/** Pin the xpath= Playwright engine for a read-resolver derived selector
+ * (PY _v3_textual_selector — a stand-in for actionEngine.engineSelector that
+ * avoids the import cycle actionEngine → healCascade → this module). */
+function v3TextualSelector(xpath) {
+    if (xpath.startsWith('xpath=') || xpath.startsWith('css=') || xpath.startsWith('text='))
+        return xpath;
+    if (xpath.startsWith('/') || xpath.startsWith('('))
+        return `xpath=${xpath}`;
+    return xpath;
+}
+/** Scroll the page-space target into the viewport and return clamped viewport
+ * coords. Mirrors the tier scroll math in healCascade's full-page tier —
+ * duplicated (~10 lines, like PY) so the cascade module stays untouched. */
+async function scrollIntoViewViewportCoords(page, coords) {
+    const px = Math.trunc(coords[0]);
+    const py = Math.trunc(coords[1]);
+    const vp = (await page.evaluate(() => [window.innerWidth, window.innerHeight]));
+    const vw = Math.trunc(vp[0]) || 1920;
+    const vh = Math.trunc(vp[1]) || 1080;
+    await page.evaluate(([x, y, w, h]) => window.scrollTo(Math.max(0, x - Math.floor(w / 2)), Math.max(0, y - Math.floor(h / 2))), [px, py, vw, vh]);
+    await new Promise((r) => setTimeout(r, 150));
+    const scroll = (await page.evaluate(() => [window.scrollX, window.scrollY]));
+    const vx = Math.max(0, Math.min(px - Math.trunc(scroll[0]), vw - 1));
+    const vy = Math.max(0, Math.min(py - Math.trunc(scroll[1]), vh - 1));
+    return [vx, vy];
+}
+/**
+ * V3 textual query — locate element locally then read the attribute, with the
+ * server POST as last-resort fallback (PY _textual_query_v3 route table):
+ * 1. no automindUrl → null (no CDP, no network);
+ * 2. attribute empty or not in LOCAL_READ_ATTRS → server straight away;
+ * 3. supported attr → DESKTOP_LOCATE_FULL_PAGE → scroll into view →
+ *    read-resolver (exact hit, no up-walk) → extractValue, no server POST;
+ * 4. any locate/resolve/read failure → server fallback with the RAW
+ *    description (byte-identical to the pre-existing server contract).
+ */
+export async function textualQueryV3(page, description, returnType, selectedAttributeName = '') {
+    const baseUrl = String(configGet('automindUrl') ?? '');
+    if (!baseUrl) {
+        log.helper('[textual_query] no heal endpoint configured');
+        return null;
+    }
+    if (selectedAttributeName && LOCAL_READ_ATTRS.has(selectedAttributeName)) {
+        // Locate-then-read path. resolveVar resolves {{vars}} for the locate
+        // intent only; the RAW description goes to the server fallback. Errors
+        // (including var resolution) degrade to the server, never hard-fail.
+        try {
+            const resolvedRaw = await resolveVar(description);
+            const resolvedDesc = resolvedRaw === null || resolvedRaw === undefined ? '' : String(resolvedRaw);
+            const coords = await getV3DesktopLocateFullPageTarget(page, resolvedDesc);
+            if (coords !== null) {
+                const [vx, vy] = await scrollIntoViewViewportCoords(page, coords);
+                const target = await resolveCoordinateRead(page, vx, vy);
+                if (target !== null) {
+                    const loc = page.locator(v3TextualSelector(target.xpath));
+                    const extracted = await extractValue(loc, selectedAttributeName, null, returnType);
+                    log.helper(`[textual_query] result=${repr(extracted).slice(0, 120)}`);
+                    return extracted;
+                }
+            }
+        }
+        catch (e) {
+            log.helper(`[textual_query] locate-read failed (${String(e)}); server fallback`);
+        }
+    }
+    const [a11ySnapshot, domSnapshot] = await captureV3SnapshotsWithCdp(page);
+    const payload = normalizeV3PayloadTypes({
+        ...baseV3Payload(),
+        current_action: buildCurrentAction('TEXTUAL_QUERY', description, {
+            queried_value: description,
+            selected_attribute_name: selectedAttributeName,
+        }),
+        version: 'v3',
+        a11y_snapshot: a11ySnapshot,
+        dom_snapshot: domSnapshot,
+        is_browser: true,
+        is_mobile: false,
+        device_os: '',
+    });
+    let result;
+    try {
+        result = await postV3Vision(`${baseUrl}${V3_HEAL_TEXTUAL_QUERY_PATH}`, payload, v3AuthHeaders());
+    }
+    catch (e) {
+        log.helper(`[textual_query] '${description.slice(0, 80)}': ${String(e)}`);
+        throw new Error(`textual_query failed: ${String(e)}`);
+    }
+    if (result['error'])
+        throw new Error(`textual_query failed: ${String(result['error'])}`);
+    const extracted = coerceTextualValue(result['value'], returnType);
+    log.helper(`[textual_query] result=${repr(extracted).slice(0, 120)}`);
+    return extracted;
+}
+//# sourceMappingURL=visionV3.js.map

package/dist/helpers/visionV3.js.map

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

package/dist/helpers/wait.d.ts

@@ -1,3 +1,16 @@
 import type { Page } from 'playwright';
-export declare function checkUntilCondition(page: Page, condition: string): Promise<boolean>;
+import type { Condition } from './condition.js';
+/**
+ * Until-loop condition check — TWO forms, selected by argument type (the V3
+ * contract's deliberate divergence: a Condition crosses the boundary as a
+ * LIVE OBJECT, never a stringified repr the binding evals):
+ *
+ * - `Condition` instance → LOCAL evaluation against the variable store. No
+ *   screenshot, no vision endpoint. Unevaluable throws
+ *   ConditionEvaluationError — an authoring/generation error, never a
+ *   "condition not met" result (Top-15 #5: a silent false lets the retry
+ *   loop exhaust its budget while masking the real problem).
+ * - `string` → the V4 vision path, byte-identical to the previous behavior.
+ */
+export declare function checkUntilCondition(page: Page, condition: string | Condition): Promise<boolean>;
 //# sourceMappingURL=wait.d.ts.map

package/dist/helpers/wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/helpers/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBzF"}
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/helpers/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/dist/helpers/wait.js

@@ -2,7 +2,32 @@ import { config } from '../config.js';
 import { fetchWithAuth } from '../http.js';
 import { log, preview } from '../log.js';
 import { takeScreenshot } from './screenshot.js';
+import { ConditionEvaluationError } from '../errors.js';
+/**
+ * Until-loop condition check — TWO forms, selected by argument type (the V3
+ * contract's deliberate divergence: a Condition crosses the boundary as a
+ * LIVE OBJECT, never a stringified repr the binding evals):
+ *
+ * - `Condition` instance → LOCAL evaluation against the variable store. No
+ *   screenshot, no vision endpoint. Unevaluable throws
+ *   ConditionEvaluationError — an authoring/generation error, never a
+ *   "condition not met" result (Top-15 #5: a silent false lets the retry
+ *   loop exhaust its budget while masking the real problem).
+ * - `string` → the V4 vision path, byte-identical to the previous behavior.
+ */
 export async function checkUntilCondition(page, condition) {
+    if (typeof condition !== 'string') {
+        try {
+            const [ok] = await condition.evaluate();
+            log.helper(`[check_until_condition] local eval -> ${ok}`);
+            return ok;
+        }
+        catch (e) {
+            if (e?.name === 'ConditionEvaluationError')
+                throw e;
+            throw new ConditionEvaluationError(JSON.stringify(condition.toDict()), e);
+        }
+    }
     if (!config.current.smart) {
         log.helper(`[check_until_condition] smart is OFF — returning False (condition skipped)`);
         return false;

package/dist/helpers/wait.js.map

@@ -1 +1 @@
-{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/helpers/wait.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAU,EAAE,SAAiB;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,4EAA4E,CAAC,CAAC;QACzF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,qCAAqC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,0BAA0B,EAAE;QACtF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;KACjE,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA+C,CAAC;IAC/E,GAAG,CAAC,MAAM,CAAC,oDAAoD,IAAI,CAAC,OAAO,gBAAgB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9G,2FAA2F;IAC3F,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/helpers/wait.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGxD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAU,EACV,SAA6B;IAE7B,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxC,GAAG,CAAC,MAAM,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAK,CAAW,EAAE,IAAI,KAAK,0BAA0B;gBAAE,MAAM,CAAC,CAAC;YAC/D,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,4EAA4E,CAAC,CAAC;QACzF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,qCAAqC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,0BAA0B,EAAE;QACtF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;KACjE,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA+C,CAAC;IAC/E,GAAG,CAAC,MAAM,CAAC,oDAAoD,IAAI,CAAC,OAAO,gBAAgB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9G,2FAA2F;IAC3F,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -2,8 +2,17 @@ import { configure } from './configure.js';
 import { test } from './test.js';
 import { step } from './step.js';
 import { run } from './session.js';
-import { resolveVar, setVar } from './vars.js';
-import { TestmuConfigError, AssertionFailureError } from './errors.js';
+import { resolveVar, setVar, getVariableValue } from './vars.js';
+import { TestmuConfigError, AssertionFailureError, AutohealExhausted, ConditionEvaluationError } from './errors.js';
+import { routeFailure } from './routeFailure.js';
+import { getCookies } from './helpers/cookies.js';
+import { primeDialog } from './helpers/dialog.js';
+import { locator, VisionLocator } from './visionLocator.js';
+import { resolveRankedLocator } from './rankedLocator.js';
+import { multiClick, longPress } from './helpers/gesture.js';
+import { scrollUntilElement } from './helpers/scrollUntil.js';
+import { newTab, closeTab, ensureActivePage } from './helpers/tabs.js';
+import { dragDrop, elementDrag } from './helpers/drag.js';
 import { executeJs } from './helpers/executeJs.js';
 import { executeApi } from './helpers/executeApi.js';
 import { executeDb } from './helpers/executeDb.js';
@@ -17,6 +26,8 @@ import { smartuiSnapshot } from './helpers/smartui.js';
 import { switchTab } from './helpers/tabs.js';
 import { clickDrag } from './helpers/drag.js';
 import { checkUntilCondition } from './helpers/wait.js';
+import { asText } from './helpers/text.js';
+import { Condition, ResolvedCondition, PossibleCondition, ConcatenationOperator } from './helpers/condition.js';
 import { executeKaneCli } from './helpers/kaneCli.js';
 import { downloadsPath } from './downloadsPath.js';
 import { devtoolsNetworkQuery, devtoolsConsoleQuery, devtoolsCookiesQuery, devtoolsStorageQuery, clipboardWrite, clipboardPaste, clipboardClear, devtoolsClipboardQuery, devtoolsPerformanceQuery } from './helpers/devtools.js';
@@ -47,6 +58,7 @@ declare const testmu: {
     clickDrag: typeof clickDrag;
     checkUntilCondition: typeof checkUntilCondition;
     executeKaneCli: typeof executeKaneCli;
+    asText: typeof asText;
     downloadsPath: typeof downloadsPath;
     devtoolsNetworkQuery: typeof devtoolsNetworkQuery;
     devtoolsConsoleQuery: typeof devtoolsConsoleQuery;
@@ -58,9 +70,23 @@ declare const testmu: {
     devtoolsClipboardQuery: typeof devtoolsClipboardQuery;
     devtoolsPerformanceQuery: typeof devtoolsPerformanceQuery;
     apiCallsQuery: typeof apiCallsQuery;
+    routeFailure: typeof routeFailure;
+    getCookies: typeof getCookies;
+    primeDialog: typeof primeDialog;
+    locator: typeof locator;
+    resolveRankedLocator: typeof resolveRankedLocator;
+    multiClick: typeof multiClick;
+    longPress: typeof longPress;
+    scrollUntilElement: typeof scrollUntilElement;
+    newTab: typeof newTab;
+    closeTab: typeof closeTab;
+    ensureActivePage: typeof ensureActivePage;
+    dragDrop: typeof dragDrop;
+    elementDrag: typeof elementDrag;
 };
 export default testmu;
-export { resolveVar, setVar, TestmuConfigError, AssertionFailureError };
+export { resolveVar, setVar, TestmuConfigError, AssertionFailureError, AutohealExhausted, ConditionEvaluationError, Condition, ResolvedCondition, PossibleCondition, ConcatenationOperator, getVariableValue, VisionLocator, };
+export type { SelectorSpec, VisionLocatorOptions } from './visionLocator.js';
 export type { ConfigureOptions, GlobalVariable } from './configure.js';
 export type { RunTarget, Config } from './config.js';
 export type { Reporter } from './reporters/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,wBAAwB,EACtF,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAC1E,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EACL,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EACvE,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,oBAAoB,EAAE,oBAAoB,EAC1C,oBAAoB,EAAE,oBAAoB,EAC1C,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EACtE,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAkC,MAAM,uBAAuB,CAAC;AAEtF,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EACL,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,qBAAqB,EAC5D,iBAAiB,EAAE,wBAAwB,EAE3C,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EACtE,gBAAgB,EAAE,aAAa,GAChC,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,8 +2,17 @@ import { configure } from './configure.js';
 import { test } from './test.js';
 import { step } from './step.js';
 import { run } from './session.js';
-import { resolveVar, setVar } from './vars.js';
-import { TestmuConfigError, AssertionFailureError } from './errors.js';
+import { resolveVar, setVar, getVariableValue } from './vars.js';
+import { TestmuConfigError, AssertionFailureError, AutohealExhausted, ConditionEvaluationError, } from './errors.js';
+import { routeFailure } from './routeFailure.js';
+import { getCookies } from './helpers/cookies.js';
+import { primeDialog } from './helpers/dialog.js';
+import { locator, VisionLocator } from './visionLocator.js';
+import { resolveRankedLocator } from './rankedLocator.js';
+import { multiClick, longPress } from './helpers/gesture.js';
+import { scrollUntilElement } from './helpers/scrollUntil.js';
+import { newTab, closeTab, ensureActivePage } from './helpers/tabs.js';
+import { dragDrop, elementDrag } from './helpers/drag.js';
 import { executeJs } from './helpers/executeJs.js';
 import { executeApi } from './helpers/executeApi.js';
 import { executeDb } from './helpers/executeDb.js';
@@ -17,6 +26,8 @@ import { smartuiSnapshot } from './helpers/smartui.js';
 import { switchTab } from './helpers/tabs.js';
 import { clickDrag } from './helpers/drag.js';
 import { checkUntilCondition } from './helpers/wait.js';
+import { asText } from './helpers/text.js';
+import { Condition, ResolvedCondition, PossibleCondition, ConcatenationOperator, } from './helpers/condition.js';
 import { executeKaneCli } from './helpers/kaneCli.js';
 import { downloadsPath } from './downloadsPath.js';
 import { devtoolsNetworkQuery, devtoolsConsoleQuery, devtoolsCookiesQuery, devtoolsStorageQuery, clipboardWrite, clipboardPaste, clipboardClear, devtoolsClipboardQuery, devtoolsPerformanceQuery, } from './helpers/devtools.js';
@@ -31,16 +42,24 @@ const testmu = {
     evaluateNetworkAssertion, networkQuery,
     evaluateMath, smartuiSnapshot,
     switchTab, clickDrag,
-    checkUntilCondition, executeKaneCli,
+    checkUntilCondition, executeKaneCli, asText,
     downloadsPath,
     devtoolsNetworkQuery, devtoolsConsoleQuery,
     devtoolsCookiesQuery, devtoolsStorageQuery,
     clipboardWrite, clipboardPaste, clipboardClear, devtoolsClipboardQuery,
     devtoolsPerformanceQuery,
     apiCallsQuery,
+    // V3 instance view — additive; inert unless configure({kaneVersion:'v3'}).
+    routeFailure, getCookies, primeDialog,
+    locator, resolveRankedLocator,
+    multiClick, longPress, scrollUntilElement,
+    newTab, closeTab, ensureActivePage,
+    dragDrop, elementDrag,
 };
 export default testmu;
-export { resolveVar, setVar, TestmuConfigError, AssertionFailureError };
+export { resolveVar, setVar, TestmuConfigError, AssertionFailureError, AutohealExhausted, ConditionEvaluationError, 
+// V3 condition family + resolver — the generator emits these bare.
+Condition, ResolvedCondition, PossibleCondition, ConcatenationOperator, getVariableValue, VisionLocator, };
 export { getApiCallLog, clearApiCallLog } from './helpers/apiCalls.js';
 export { ExecuteJsError } from './helpers/executeJs.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,GAC1E,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,oBAAoB,EAAE,oBAAoB,EAC1C,oBAAoB,EAAE,oBAAoB,EAC1C,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EACtE,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAkC,MAAM,uBAAuB,CAAC;AAEtF,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG;IAC1B,SAAS,EAAE,UAAU,EAAE,SAAS;IAChC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB;IACzE,eAAe;IACf,MAAM,EAAE,gBAAgB;IACxB,eAAe,EAAE,cAAc;IAC/B,wBAAwB,EAAE,YAAY;IACtC,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,SAAS;IACpB,mBAAmB,EAAE,cAAc;IACnC,aAAa;IACb,oBAAoB,EAAE,oBAAoB;IAC1C,oBAAoB,EAAE,oBAAoB;IAC1C,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB;IACtE,wBAAwB;IACxB,aAAa;CACd,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;AAOxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/log.d.ts

@@ -18,7 +18,10 @@ export declare const log: {
     /** Error. */
     error(msg: string): void;
 };
-/** Preview a string capped at maxLen chars (matches Python's `description[:80]`). */
+/** Preview a string capped at maxLen chars (matches Python's `description[:80]`).
+ * JSON.stringify returns undefined (NOT a string) for undefined/functions/
+ * symbols — String() fallback so logging a valueless result never throws
+ * (dev-proven: executeJs of an empty/return-less script → setVar(undefined)). */
 export declare function preview(s: unknown, maxLen?: number): string;
 /**
  * Python `repr()`-like quoting for log values. Strings come out single-quoted

package/dist/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,eAAO,MAAM,GAAG;IACd,gFAAgF;cACtE,MAAM,GAAG,IAAI;IAGvB,uEAAuE;cAC7D,MAAM,GAAG,IAAI;IAGvB,wEAAwE;gBAC5D,MAAM,GAAG,IAAI;IAGzB,eAAe;cACL,MAAM,GAAG,IAAI;IAGvB,aAAa;eACF,MAAM,GAAG,IAAI;CAGzB,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGvC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,eAAO,MAAM,GAAG;IACd,gFAAgF;cACtE,MAAM,GAAG,IAAI;IAGvB,uEAAuE;cAC7D,MAAM,GAAG,IAAI;IAGvB,wEAAwE;gBAC5D,MAAM,GAAG,IAAI;IAGzB,eAAe;cACL,MAAM,GAAG,IAAI;IAGvB,aAAa;eACF,MAAM,GAAG,IAAI;CAGzB,CAAC;AAEF;;;iFAGiF;AACjF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKvC"}

package/dist/log.js

@@ -34,9 +34,12 @@ export const log = {
         console.error(`${ts()} ERROR ${msg}`);
     },
 };
-/** Preview a string capped at maxLen chars (matches Python's `description[:80]`). */
+/** Preview a string capped at maxLen chars (matches Python's `description[:80]`).
+ * JSON.stringify returns undefined (NOT a string) for undefined/functions/
+ * symbols — String() fallback so logging a valueless result never throws
+ * (dev-proven: executeJs of an empty/return-less script → setVar(undefined)). */
 export function preview(s, maxLen = 80) {
-    const str = typeof s === 'string' ? s : JSON.stringify(s);
+    const str = typeof s === 'string' ? s : String(JSON.stringify(s) ?? s);
     return str.length <= maxLen ? str : str.slice(0, maxLen) + '...';
 }
 /**
@@ -47,6 +50,8 @@ export function preview(s, maxLen = 80) {
 export function repr(v) {
     if (typeof v === 'string')
         return `'${v.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
-    return JSON.stringify(v);
+    // JSON.stringify yields undefined (not a string) for undefined/functions/
+    // symbols — String() fallback so `.slice()` at call sites never throws.
+    return String(JSON.stringify(v) ?? v);
 }
 //# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS,EAAE;IACT,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,CACL,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG;QAClE,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,gFAAgF;IAChF,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,uEAAuE;IACvE,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,wEAAwE;IACxE,MAAM,CAAC,GAAW;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,eAAe;IACf,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,aAAa;IACb,KAAK,CAAC,GAAW;QACf,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,CAAU,EAAE,MAAM,GAAG,EAAE;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,CAAU;IAC7B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;IACvF,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS,EAAE;IACT,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,CACL,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG;QAClE,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,gFAAgF;IAChF,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,uEAAuE;IACvE,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,wEAAwE;IACxE,MAAM,CAAC,GAAW;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,eAAe;IACf,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,aAAa;IACb,KAAK,CAAC,GAAW;QACf,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC;AAEF;;;iFAGiF;AACjF,MAAM,UAAU,OAAO,CAAC,CAAU,EAAE,MAAM,GAAG,EAAE;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,CAAU;IAC7B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;IACvF,0EAA0E;IAC1E,wEAAwE;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/rankedLocator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ranked-selector resolution + wrong-element heal — PY _ranked_locator.py port.
+ *
+ * Codegen with multiple ranked candidates emits:
+ *   await testmu.resolveRankedLocator(page, [page.locator('#a'), page.locator('#b')],
+ *                                     'email field')
+ *
+ * Sequential rank order (Selenium semantics), NOT .or().first (DOM order).
+ * V3 (description given): a match is wrapped so a Playwright error on the
+ * wrong matched element falls through to description-based vision heal; on
+ * exhaustion returns a VisionLocator. V4 (no description): bare locator, or a
+ * TimeoutError-named Error on exhaustion.
+ *
+ * The wrapper is a Proxy, NOT a subclass — playwright's .d.ts declares
+ * Locator as an interface, there is nothing to `extends` (contract §6).
+ */
+import type { Locator, Page } from 'playwright';
+import { VisionLocator } from './visionLocator.js';
+/** Wrap a ranked MATCH so a genuine Playwright action error heals via the
+ * description (VisionLocator). Non-action members pass through bound. */
+export declare function _makeHealingLocator(page: Page, loc: Locator, description: string): Locator;
+/**
+ * Return the first locator whose count() > 0, in rank order.
+ * See module docstring for V3 vs V4 exhaustion semantics.
+ */
+export declare function resolveRankedLocator(page: Page, locators: Locator[], description?: string): Promise<Locator | VisionLocator>;
+//# sourceMappingURL=rankedLocator.d.ts.map

package/dist/rankedLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankedLocator.d.ts","sourceRoot":"","sources":["../src/rankedLocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAW,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgC5D;yEACyE;AACzE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAiC1F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,SAAK,GACf,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,CAUlC"}