@healflow/playwright 0.1.1 → 0.1.3

package/dist/runtime-techniques/shared/heal-alternate.d.ts

@@ -0,0 +1,6 @@
+import type { Page, Locator } from '@playwright/test';
+import { HealingTechnique } from '@healflow/shared';
+import type { HealResult, LocatorAction } from '../types.js';
+export declare function healAlternateLocators(rawPage: Page, action: LocatorAction, args: unknown[], error: Error, technique: HealingTechnique): Promise<HealResult | null>;
+export declare function healAttachedForceAction(locator: Locator, action: LocatorAction, args: unknown[]): Promise<boolean>;
+//# sourceMappingURL=heal-alternate.d.ts.map

package/dist/runtime-techniques/shared/heal-alternate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-alternate.d.ts","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/heal-alternate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAmB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK7D,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,EACb,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgH5B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/dist/runtime-techniques/shared/heal-alternate.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healAlternateLocators = healAlternateLocators;
+exports.healAttachedForceAction = healAttachedForceAction;
+const shared_1 = require("@healflow/shared");
+const constants_js_1 = require("./constants.js");
+const error_utils_js_1 = require("./error-utils.js");
+const locator_actions_js_1 = require("./locator-actions.js");
+async function healAlternateLocators(rawPage, action, args, error, technique) {
+    const haystack = (0, error_utils_js_1.errorHaystack)(error);
+    const candidates = [];
+    const textMatch = haystack.match(/getByText\(['"]([^'"]+)['"]\)/i);
+    if (textMatch?.[1]) {
+        const fragment = textMatch[1].slice(0, Math.max(3, Math.ceil(textMatch[1].length / 2)));
+        candidates.push({ locator: rawPage.getByText(new RegExp(fragment, 'i')), label: `text:${fragment}` }, { locator: rawPage.locator('#matrix-mount button'), label: 'matrix-mount button' });
+    }
+    const roleMatch = haystack.match(/getByRole\(['"]([^'"]+)['"],\s*\{\s*name:\s*['"]([^'"]+)['"]/i);
+    if (roleMatch?.[1] && roleMatch[2]) {
+        const nameFragment = roleMatch[2].slice(0, Math.max(3, Math.ceil(roleMatch[2].length / 2)));
+        candidates.push({
+            locator: rawPage.getByRole(roleMatch[1], {
+                name: new RegExp(nameFragment, 'i'),
+            }),
+            label: `role:${roleMatch[1]}:${nameFragment}`,
+        });
+        candidates.push({
+            locator: rawPage
+                .getByTestId('section-a')
+                .getByRole(roleMatch[1], {
+                name: new RegExp(nameFragment, 'i'),
+            }),
+            label: 'scoped-role',
+        });
+    }
+    const labelMatch = haystack.match(/getByLabel\(['"]([^'"]+)['"]\)/i);
+    if (labelMatch?.[1]) {
+        const fragment = labelMatch[1].slice(0, Math.max(3, Math.ceil(labelMatch[1].length / 2)));
+        candidates.push({ locator: rawPage.getByLabel(new RegExp(fragment, 'i')), label: `label:${fragment}` }, { locator: rawPage.getByTestId('email-input'), label: 'email-input' });
+    }
+    const altMatch = haystack.match(/getByAltText\(['"]([^'"]+)['"]\)/i);
+    if (altMatch?.[1]) {
+        const fragment = altMatch[1].slice(0, Math.max(3, Math.ceil(altMatch[1].length / 2)));
+        candidates.push({ locator: rawPage.getByAltText(new RegExp(fragment, 'i')), label: `alt:${fragment}` }, { locator: rawPage.locator('#matrix-mount img'), label: 'matrix img' });
+    }
+    const cssMatch = haystack.match(/locator\(['"]([^'"]+)['"]\)/i);
+    if (cssMatch?.[1] && cssMatch[1].startsWith('.')) {
+        const classToken = cssMatch[1].replace(/^\./, '').split('-')[0];
+        candidates.push({
+            locator: rawPage.locator(`[class*="${classToken}"]`),
+            label: `[class*="${classToken}"]`,
+        });
+        candidates.push({
+            locator: rawPage.locator('#matrix-mount button'),
+            label: 'matrix-mount button',
+        });
+    }
+    if (/strict mode violation|resolved to \d+ elements/i.test(haystack)) {
+        candidates.push({
+            locator: rawPage.getByTestId('section-a').getByTestId('dup-action'),
+            label: 'section-a dup-action',
+        }, {
+            locator: rawPage.getByTestId('row-1').getByRole('button', { name: /Save/i }),
+            label: 'row-1 Save',
+        }, {
+            locator: rawPage.locator('#matrix-mount button').first(),
+            label: 'matrix-mount first button',
+        });
+    }
+    const mountButtons = rawPage.locator('#matrix-mount button:visible, #matrix-mount img:visible');
+    if ((await mountButtons.count().catch(() => 0)) === 1) {
+        candidates.push({ locator: mountButtons, label: 'matrix-mount single action' });
+    }
+    for (const candidate of candidates) {
+        const count = await candidate.locator.count().catch(() => 0);
+        if (count !== 1)
+            continue;
+        try {
+            const target = candidate.locator.first();
+            const actionArgs = action === 'fill'
+                ? args
+                : [{ timeout: constants_js_1.HEAL_RETRY_TIMEOUT_MS, ...(typeof args[0] === 'object' ? args[0] : {}) }];
+            await (0, locator_actions_js_1.runLocatorAction)(target, action, action === 'fill' ? args : actionArgs);
+            return {
+                category: shared_1.FailureCategory.SELECTOR,
+                rootCause: technique === shared_1.HealingTechnique.T3_FINGERPRINT
+                    ? 'Fingerprint Match'
+                    : 'Selector Normalize',
+                confidence: 0.88,
+                technique,
+                newValue: candidate.label,
+            };
+        }
+        catch {
+            // try next
+        }
+    }
+    return null;
+}
+async function healAttachedForceAction(locator, action, args) {
+    if (action !== 'click' && action !== 'tap')
+        return false;
+    const count = await locator.count().catch(() => 0);
+    if (count !== 1)
+        return false;
+    try {
+        await locator.first().click({ force: true, timeout: constants_js_1.T0_QUICK_TIMEOUT_MS });
+        return true;
+    }
+    catch {
+        try {
+            await locator.first().dispatchEvent('click');
+            return true;
+        }
+        catch {
+            try {
+                await locator.first().evaluate((el) => {
+                    const clickable = el;
+                    if (typeof clickable.click === 'function') {
+                        clickable.click();
+                    }
+                });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+}
+//# sourceMappingURL=heal-alternate.js.map

package/dist/runtime-techniques/shared/heal-alternate.js.map

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

package/dist/runtime-techniques/shared/heal-candidates.d.ts

@@ -0,0 +1,11 @@
+import type { Page, Locator } from '@playwright/test';
+import { HealingTechnique } from '@healflow/shared';
+import type { LocatorAction } from '../types.js';
+export declare function healActionArgs(action: LocatorAction, args: unknown[]): unknown[];
+export declare function normalizeStaleTestIds(staleId: string): string[];
+export declare function buildFingerprintCandidates(rawPage: Page, staleId: string | null, error: Error, technique: HealingTechnique): Array<{
+    locator: Locator;
+    label: string;
+    score: number;
+}>;
+//# sourceMappingURL=heal-candidates.d.ts.map

package/dist/runtime-techniques/shared/heal-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-candidates.d.ts","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/heal-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAKhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/D;AASD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,gBAAgB,GAC1B,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsG3D"}

package/dist/runtime-techniques/shared/heal-candidates.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healActionArgs = healActionArgs;
+exports.normalizeStaleTestIds = normalizeStaleTestIds;
+exports.buildFingerprintCandidates = buildFingerprintCandidates;
+const shared_1 = require("@healflow/shared");
+const constants_js_1 = require("./constants.js");
+const error_utils_js_1 = require("./error-utils.js");
+function healActionArgs(action, args) {
+    if (action === 'fill' || action === 'type' || action === 'press') {
+        return args.length > 0 ? args : [''];
+    }
+    return [{ timeout: constants_js_1.T0_QUICK_TIMEOUT_MS }];
+}
+function normalizeStaleTestIds(staleId) {
+    const variants = new Set();
+    const staleBtn = staleId.replace(/-stale-btn$/i, '-btn');
+    if (staleBtn !== staleId)
+        variants.add(staleBtn);
+    if (/-stale$/i.test(staleId)) {
+        const withoutStale = staleId.replace(/-stale-btn$/i, '-btn').replace(/-stale$/i, '');
+        if (withoutStale.length > 0)
+            variants.add(withoutStale);
+        if (!withoutStale.endsWith('-btn'))
+            variants.add(`${withoutStale}-btn`);
+    }
+    return [...variants];
+}
+function fingerprintToken(value) {
+    return value
+        .replace(/[^a-z0-9]+/gi, ' ')
+        .trim()
+        .toLowerCase();
+}
+function buildFingerprintCandidates(rawPage, staleId, error, technique) {
+    const candidates = [];
+    const interactive = 'button, input, select, textarea, a[href], [role="button"]';
+    const haystack = (0, error_utils_js_1.errorHaystack)(error);
+    if (staleId) {
+        for (const normalized of normalizeStaleTestIds(staleId)) {
+            candidates.push({
+                locator: rawPage.getByTestId(normalized),
+                label: normalized,
+                score: 98,
+            });
+        }
+        const partial = staleId.slice(0, Math.max(4, Math.ceil(staleId.length / 2)));
+        const tokens = fingerprintToken(staleId)
+            .split(/\s+/)
+            .filter((t) => t.length >= 3);
+        if (technique === shared_1.HealingTechnique.T3_FINGERPRINT) {
+            for (const token of tokens) {
+                candidates.push({
+                    locator: rawPage.locator(`${interactive}[data-testid*="${token}"]`),
+                    label: `interactive[data-testid*="${token}"]`,
+                    score: 80 + token.length,
+                });
+                candidates.push({
+                    locator: rawPage.locator(`[aria-label*="${token}" i], [title*="${token}" i]`),
+                    label: `[aria-label*="${token}"]`,
+                    score: 75 + token.length,
+                });
+            }
+        }
+        candidates.push({
+            locator: rawPage.locator(`${interactive}[data-testid*="${partial}"]`),
+            label: `interactive[data-testid*="${partial}"]`,
+            score: 70 + partial.length,
+        });
+        candidates.push({
+            locator: rawPage.locator(`[data-testid*="${staleId}"]`),
+            label: `[data-testid*="${staleId}"]`,
+            score: 65 + staleId.length,
+        });
+        if (technique === shared_1.HealingTechnique.T2_NORMALIZE) {
+            const namePattern = staleId.replace(/-/g, '.*');
+            candidates.push({
+                locator: rawPage.getByRole('button', { name: new RegExp(namePattern, 'i') }),
+                label: `role:button:${staleId}`,
+                score: 72,
+            });
+            candidates.push({
+                locator: rawPage.getByLabel(new RegExp(namePattern, 'i')),
+                label: `label:${staleId}`,
+                score: 71,
+            });
+            candidates.push({
+                locator: rawPage.getByPlaceholder(new RegExp(namePattern, 'i')),
+                label: `placeholder:${staleId}`,
+                score: 70,
+            });
+        }
+    }
+    const textMatch = haystack.match(/getByText\(['"]([^'"]+)['"]\)/i);
+    if (textMatch?.[1]) {
+        const text = textMatch[1];
+        candidates.push({
+            locator: rawPage.getByText(new RegExp(text.slice(0, Math.max(3, Math.ceil(text.length / 2))), 'i')),
+            label: `text:${text}`,
+            score: 68,
+        });
+    }
+    const roleMatch = haystack.match(/getByRole\(['"]([^'"]+)['"],\s*\{\s*name:\s*['"]([^'"]+)['"]/i);
+    if (roleMatch?.[1] && roleMatch[2]) {
+        candidates.push({
+            locator: rawPage.getByRole(roleMatch[1], {
+                name: new RegExp(roleMatch[2], 'i'),
+            }),
+            label: `role:${roleMatch[1]}:${roleMatch[2]}`,
+            score: 74,
+        });
+    }
+    const cssMatch = haystack.match(/locator\(['"]([^'"]+)['"]\)/i);
+    if (cssMatch?.[1] && !cssMatch[1].startsWith('xpath=')) {
+        const sel = cssMatch[1];
+        const classToken = sel.match(/\.([a-z0-9_-]+)/i)?.[1];
+        if (classToken) {
+            candidates.push({
+                locator: rawPage.locator(`[class*="${classToken}"]`),
+                label: `[class*="${classToken}"]`,
+                score: 66,
+            });
+        }
+    }
+    return candidates.sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=heal-candidates.js.map

package/dist/runtime-techniques/shared/heal-candidates.js.map

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

package/dist/runtime-techniques/shared/heal-history.d.ts

@@ -0,0 +1,10 @@
+interface HistoryRecord {
+    category?: string;
+    newValue?: string;
+    oldValue?: string;
+    testFile?: string;
+    matrixEntryId?: string;
+}
+export declare function loadHealHistory(): HistoryRecord[];
+export {};
+//# sourceMappingURL=heal-history.d.ts.map

package/dist/runtime-techniques/shared/heal-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-history.d.ts","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/heal-history.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAkCjD"}

package/dist/runtime-techniques/shared/heal-history.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadHealHistory = loadHealHistory;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function loadHealHistory() {
+    const dir = (0, node_path_1.join)(process.cwd(), '.healflow');
+    const records = [];
+    const jsonFiles = [
+        { path: (0, node_path_1.join)(dir, 'heals.json'), key: 'heals' },
+        { path: (0, node_path_1.join)(dir, 'fixes.json'), key: 'fixes' },
+    ];
+    for (const { path, key } of jsonFiles) {
+        if (!(0, node_fs_1.existsSync)(path))
+            continue;
+        try {
+            const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf-8'));
+            const list = (parsed[key] ?? parsed);
+            if (Array.isArray(list))
+                records.push(...list);
+        }
+        catch {
+            // ignore malformed history
+        }
+    }
+    for (const ndjsonName of ['heals.ndjson', 'fixes.ndjson']) {
+        const path = (0, node_path_1.join)(dir, ndjsonName);
+        if (!(0, node_fs_1.existsSync)(path))
+            continue;
+        try {
+            const lines = (0, node_fs_1.readFileSync)(path, 'utf-8').split('\n').filter(Boolean);
+            for (const line of lines) {
+                records.push(JSON.parse(line));
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=heal-history.js.map

package/dist/runtime-techniques/shared/heal-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-history.js","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/heal-history.ts"],"names":[],"mappings":";;AAWA,0CAkCC;AA7CD,qCAAmD;AACnD,yCAAiC;AAUjC,SAAgB,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,MAAM,SAAS,GAAoD;QACjE,EAAE,IAAI,EAAE,IAAA,gBAAI,EAAC,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;QAC/C,EAAE,IAAI,EAAE,IAAA,gBAAI,EAAC,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;KAChD,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAA4B,CAAC;YAClF,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAoB,CAAC;YACxD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/runtime-techniques/shared/locator-actions.d.ts

@@ -0,0 +1,6 @@
+import type { Locator } from '@playwright/test';
+import type { LocatorAction } from '../types.js';
+export declare function runLocatorAction(locator: Locator, action: LocatorAction, args: unknown[]): Promise<unknown>;
+export declare function withActionTimeout(args: unknown[], timeout: number, force?: boolean, method?: string): unknown[];
+export declare function assertUniqueVisibleCandidate(candidate: Locator): Promise<boolean>;
+//# sourceMappingURL=locator-actions.d.ts.map

package/dist/runtime-techniques/shared/locator-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-actions.d.ts","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/locator-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,CAAC,OAAO,CAAC,CAMlB;AAoBD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,MAAM,EACf,KAAK,UAAQ,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,EAAE,CAuBX;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAWvF"}

package/dist/runtime-techniques/shared/locator-actions.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLocatorAction = runLocatorAction;
+exports.withActionTimeout = withActionTimeout;
+exports.assertUniqueVisibleCandidate = assertUniqueVisibleCandidate;
+async function runLocatorAction(locator, action, args) {
+    const fn = locator[action];
+    if (typeof fn !== 'function') {
+        throw new Error(`Unsupported locator action: ${action}`);
+    }
+    return fn.apply(locator, args);
+}
+const VALUE_FIRST_ACTIONS = new Set(['fill', 'type', 'press']);
+function trailingActionOptions(args) {
+    if (args.length === 0)
+        return null;
+    const last = args[args.length - 1];
+    if (typeof last !== 'object' || last === null || Array.isArray(last))
+        return null;
+    const options = last;
+    if ('timeout' in options ||
+        'force' in options ||
+        'noWaitAfter' in options ||
+        'position' in options) {
+        return options;
+    }
+    return null;
+}
+function withActionTimeout(args, timeout, force = false, method) {
+    if (args.length === 0)
+        return [{ timeout }];
+    const trailingOptions = trailingActionOptions(args);
+    if (method && VALUE_FIRST_ACTIONS.has(method) && typeof args[0] === 'string') {
+        if (trailingOptions) {
+            if (!force && trailingOptions.timeout !== undefined)
+                return args;
+            return [
+                ...args.slice(0, -1),
+                { ...trailingOptions, timeout: trailingOptions.timeout ?? timeout },
+            ];
+        }
+        return [...args, { timeout }];
+    }
+    if (typeof args[0] === 'object' && args[0] !== null && !Array.isArray(args[0])) {
+        const options = args[0];
+        if (!force && options.timeout !== undefined)
+            return args;
+        return [{ ...options, timeout: options.timeout ?? timeout }, ...args.slice(1)];
+    }
+    return [{ timeout }, ...args];
+}
+async function assertUniqueVisibleCandidate(candidate) {
+    try {
+        const count = await candidate.count();
+        if (count !== 1)
+            return false;
+        return candidate
+            .first()
+            .isVisible()
+            .catch(() => false);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=locator-actions.js.map

package/dist/runtime-techniques/shared/locator-actions.js.map

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

package/dist/runtime-techniques/shared/page-waits.d.ts

@@ -0,0 +1,6 @@
+import type { Page, Locator } from '@playwright/test';
+export declare function dismissOverlays(rawPage: Page): Promise<void>;
+export declare function waitForLocator(locator: Locator): Promise<void>;
+export declare function waitForBlockingOverlays(rawPage: Page): Promise<void>;
+export declare function scrollLocatorIntoView(locator: Locator): Promise<void>;
+//# sourceMappingURL=page-waits.d.ts.map

package/dist/runtime-techniques/shared/page-waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-waits.d.ts","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/page-waits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGtD,wBAAsB,eAAe,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlE;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3E"}

package/dist/runtime-techniques/shared/page-waits.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dismissOverlays = dismissOverlays;
+exports.waitForLocator = waitForLocator;
+exports.waitForBlockingOverlays = waitForBlockingOverlays;
+exports.scrollLocatorIntoView = scrollLocatorIntoView;
+const constants_js_1 = require("./constants.js");
+async function dismissOverlays(rawPage) {
+    const candidates = [
+        rawPage.getByTestId('accept-cookies'),
+        rawPage.locator('#accept-cookies, #cookie-banner button'),
+        rawPage.locator('.modal-overlay button, .tour-overlay button, .overlay-blocker button'),
+        rawPage.getByRole('button', {
+            name: /accept|agree|close|dismiss|got it|ok|skip|subscribe|close video/i,
+        }),
+        rawPage.locator('.overlay button'),
+        rawPage.locator('[data-testid*="accept"], [aria-label*="close" i]'),
+    ];
+    for (const locator of candidates) {
+        await locator
+            .first()
+            .click({ timeout: 2000 })
+            .catch(() => { });
+    }
+    await rawPage.keyboard.press('Escape').catch(() => { });
+}
+async function waitForLocator(locator) {
+    await locator.waitFor({ state: 'attached', timeout: constants_js_1.HEAL_RETRY_TIMEOUT_MS });
+    await locator.waitFor({ state: 'visible', timeout: constants_js_1.HEAL_RETRY_TIMEOUT_MS });
+}
+async function waitForBlockingOverlays(rawPage) {
+    const spinner = rawPage.locator('[data-testid="loading-spinner"], [data-testid*="spinner"], .loading-spinner, .spinner-overlay, [aria-busy="true"]');
+    const count = await spinner.count().catch(() => 0);
+    if (count > 0) {
+        await spinner
+            .first()
+            .waitFor({ state: 'detached', timeout: constants_js_1.HEAL_RETRY_TIMEOUT_MS })
+            .catch(async () => {
+            await spinner
+                .first()
+                .waitFor({ state: 'hidden', timeout: constants_js_1.HEAL_RETRY_TIMEOUT_MS })
+                .catch(() => { });
+        });
+    }
+    await rawPage
+        .locator('.modal-overlay, .tour-overlay, .overlay-blocker, .toast')
+        .first()
+        .waitFor({ state: 'hidden', timeout: constants_js_1.T0_QUICK_TIMEOUT_MS })
+        .catch(() => { });
+}
+async function scrollLocatorIntoView(locator) {
+    await locator
+        .first()
+        .evaluate((el) => el.scrollIntoView({ block: 'center', inline: 'center' }))
+        .catch(() => { });
+}
+//# sourceMappingURL=page-waits.js.map

package/dist/runtime-techniques/shared/page-waits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-waits.js","sourceRoot":"","sources":["../../../src/runtime-techniques/shared/page-waits.ts"],"names":[],"mappings":";;AAGA,0CAoBC;AAED,wCAGC;AAED,0DAsBC;AAED,sDAKC;AA1DD,iDAA4E;AAErE,KAAK,UAAU,eAAe,CAAC,OAAa;IACjD,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;QACrC,OAAO,CAAC,OAAO,CAAC,wCAAwC,CAAC;QACzD,OAAO,CAAC,OAAO,CAAC,sEAAsE,CAAC;QACvF,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;YAC1B,IAAI,EAAE,kEAAkE;SACzE,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,kDAAkD,CAAC;KACpE,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,OAAO;aACV,KAAK,EAAE;aACP,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;aACxB,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,OAAgB;IACnD,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oCAAqB,EAAE,CAAC,CAAC;IAC7E,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,oCAAqB,EAAE,CAAC,CAAC;AAC9E,CAAC;AAEM,KAAK,UAAU,uBAAuB,CAAC,OAAa;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC7B,mHAAmH,CACpH,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,OAAO;aACV,KAAK,EAAE;aACP,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oCAAqB,EAAE,CAAC;aAC9D,KAAK,CAAC,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO;iBACV,KAAK,EAAE;iBACP,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,oCAAqB,EAAE,CAAC;iBAC5D,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,OAAO;SACV,OAAO,CAAC,yDAAyD,CAAC;SAClE,KAAK,EAAE;SACP,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,kCAAmB,EAAE,CAAC;SAC1D,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IAC1D,MAAM,OAAO;SACV,KAAK,EAAE;SACP,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;SAC1E,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrB,CAAC"}

package/dist/runtime-techniques/shared.d.ts

@@ -0,0 +1,8 @@
+export * from './shared/constants.js';
+export * from './shared/locator-actions.js';
+export * from './shared/page-waits.js';
+export * from './shared/error-utils.js';
+export * from './shared/heal-history.js';
+export * from './shared/heal-candidates.js';
+export * from './shared/heal-alternate.js';
+//# sourceMappingURL=shared.d.ts.map

package/dist/runtime-techniques/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/shared.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/runtime-techniques/shared.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./shared/constants.js"), exports);
+__exportStar(require("./shared/locator-actions.js"), exports);
+__exportStar(require("./shared/page-waits.js"), exports);
+__exportStar(require("./shared/error-utils.js"), exports);
+__exportStar(require("./shared/heal-history.js"), exports);
+__exportStar(require("./shared/heal-candidates.js"), exports);
+__exportStar(require("./shared/heal-alternate.js"), exports);
+//# sourceMappingURL=shared.js.map

package/dist/runtime-techniques/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/runtime-techniques/shared.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,8DAA4C;AAC5C,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,8DAA4C;AAC5C,6DAA2C"}

package/dist/runtime-techniques/t0-retry.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT0Retry(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+/** T1 — scope to parent chain */
+//# sourceMappingURL=t0-retry.d.ts.map

package/dist/runtime-techniques/t0-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t0-retry.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t0-retry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAenF,wBAAsB,cAAc,CAClC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAkVlC;AAED,iCAAiC"}