playwright-locator-healer 0.1.3

package/dist/healing/heal/caller-context.js

@@ -0,0 +1,46 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const FRAME_RE = /\s+at\s+(?:.*?\s+\()?([^()\s]+):(\d+):(\d+)\)?$/;
+function isLibraryFrame(file) {
+    return (file.includes('node_modules') ||
+        file.includes('/healing/') ||
+        file.includes('/dist/') ||
+        file.startsWith('node:') ||
+        file === '<anonymous>');
+}
+/**
+ * Walk the stack of `new Error()` and find the first frame that lives outside
+ * `healing/` and `node_modules/` — that's the test/POM source line that
+ * triggered the heal. Returns a trimmed snippet (the failing line plus the
+ * comment immediately above it, if any) for use as the LLM `description`.
+ */
+export function inferDescriptionFromCallsite(stack) {
+    const s = stack ?? new Error().stack ?? '';
+    for (const line of s.split('\n')) {
+        const m = line.match(FRAME_RE);
+        if (!m)
+            continue;
+        const [, file, lineNoStr] = m;
+        if (isLibraryFrame(file))
+            continue;
+        const fileClean = file.startsWith('file://') ? file.replace(/^file:\/\//, '') : file;
+        const abs = path.isAbsolute(fileClean) ? fileClean : path.resolve(process.cwd(), fileClean);
+        let content;
+        try {
+            content = fs.readFileSync(abs, 'utf-8').split('\n');
+        }
+        catch {
+            return '';
+        }
+        const lineNo = Number(lineNoStr);
+        const idx = lineNo - 1;
+        if (idx < 0 || idx >= content.length)
+            return '';
+        const cur = (content[idx] ?? '').trim();
+        const prev = (content[idx - 1] ?? '').trim();
+        const isComment = prev.startsWith('//') || prev.startsWith('*');
+        return isComment ? `${prev}\n${cur}` : cur;
+    }
+    return '';
+}
+//# sourceMappingURL=caller-context.js.map

package/dist/healing/heal/caller-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-context.js","sourceRoot":"","sources":["../../../healing/heal/caller-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AAEnE,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QACxB,IAAI,KAAK,aAAa,CACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,cAAc,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrF,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAC5F,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/healing/heal/orchestrator-helpers.d.ts

@@ -0,0 +1,84 @@
+/**
+ * healing/heal/orchestrator-helpers.ts
+ *
+ * Small pure helpers split out of orchestrator.ts so the top-level state
+ * machine stays focused. All exports here are internal — the public
+ * surface (`healAction`, `synthEntry`, `HealActionInput`, `toPlaywrightCode`)
+ * remains on `./orchestrator.ts`.
+ */
+import type { Page } from '@playwright/test';
+import type { HealEntryV2 } from '../types.js';
+/**
+ * Best-effort `page.locator(sel).count()` — invalid selectors throw on
+ * `.count()`, so we treat any throw as "0 matches" and let the heal flow
+ * fall through to the LLM rounds.
+ *
+ * @param page - Playwright page.
+ * @param selector - Raw selector string.
+ * @returns Match count, or 0 on any error.
+ */
+export declare function safeCount(page: Page, selector: string): Promise<number>;
+/**
+ * Evaluate a JS expression that must return a single visible `Element` on
+ * the page. Used for round-4 `js` tier suggestions which bypass the
+ * normal locator validator.
+ *
+ * @param page - Playwright page.
+ * @param jsExpr - JS expression body (no leading `return`).
+ * @returns `true` iff the expression returned a visible element.
+ */
+export declare function validateJs(page: Page, jsExpr: string): Promise<boolean>;
+/**
+ * Map a `selectorType` string to its baseline tier (used when the LLM
+ * suggestion didn't include an explicit `tier`). Plain semantic types
+ * come first, testid second, then chained scope, then CSS / xpath / js.
+ *
+ * @param t - Selector kind: `role`, `label`, `text`, `testid`,
+ *   `filter-chain`, `css`, `xpath`, or `js`.
+ * @returns Tier number (1 best – 7 worst). Unknown types default to 4.
+ */
+export declare function tierOfType(t: string): number;
+/**
+ * DOM-side function executed via `pickedHandle.evaluate(...)`. Pulls the
+ * full ancestor-chain HTML (up to 3 levels) and a structured snapshot of
+ * the picked element's properties.
+ *
+ * NOTE: this function is serialized + run in the page context — it must
+ * not reference any module-level imports or closure state.
+ *
+ * @param el - The picked Element (provided by Playwright at runtime).
+ * @returns `{ ancestorsHtml, structured }` matching the shape
+ *   `requestHealedLocator` consumes.
+ */
+export declare function extractStructured(el: Element): {
+    ancestorsHtml: string;
+    structured: {
+        tag: string;
+        id: string;
+        classes: string[];
+        text: string;
+        ariaLabel: string;
+        ariaRole: string;
+        accessibleName: string;
+        dataTestId: string;
+        dataAttrs: Record<string, string>;
+        name: string;
+        type: string;
+        placeholder: string;
+        href: string;
+        associatedLabel: string;
+        parentRole: string;
+        siblingsSameTag: number;
+        outerHTML: string;
+    };
+};
+/**
+ * Foreground LLM-upgrade stub. When a cache hit returns a fragile-tier
+ * selector (≥5: class-chain CSS, xpath, JS), the orchestrator can try
+ * one more LLM round to upgrade to a stable tier. Currently a no-op
+ * placeholder; wiring is a future task.
+ *
+ * @returns `null` — always falls back to the cached entry.
+ */
+export declare function tryForegroundUpgrade(): Promise<HealEntryV2 | null>;
+//# sourceMappingURL=orchestrator-helpers.d.ts.map

package/dist/healing/heal/orchestrator-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-helpers.d.ts","sourceRoot":"","sources":["../../../healing/heal/orchestrator-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAwCA;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAExE"}

package/dist/healing/heal/orchestrator-helpers.js

@@ -0,0 +1,117 @@
+/**
+ * Best-effort `page.locator(sel).count()` — invalid selectors throw on
+ * `.count()`, so we treat any throw as "0 matches" and let the heal flow
+ * fall through to the LLM rounds.
+ *
+ * @param page - Playwright page.
+ * @param selector - Raw selector string.
+ * @returns Match count, or 0 on any error.
+ */
+export async function safeCount(page, selector) {
+    // intentionally swallowed: invalid selectors throw on count() → treat as zero matches
+    try {
+        return await page.locator(selector).count();
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Evaluate a JS expression that must return a single visible `Element` on
+ * the page. Used for round-4 `js` tier suggestions which bypass the
+ * normal locator validator.
+ *
+ * @param page - Playwright page.
+ * @param jsExpr - JS expression body (no leading `return`).
+ * @returns `true` iff the expression returned a visible element.
+ */
+export async function validateJs(page, jsExpr) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const handle = await page.evaluateHandle(new Function(`return (${jsExpr})`));
+        const el = handle.asElement();
+        if (!el)
+            return false;
+        return await el.isVisible();
+    }
+    catch {
+        // intentionally swallowed: js-eval errors mean the suggestion is invalid → caller treats as failed validate
+        return false;
+    }
+}
+/**
+ * Map a `selectorType` string to its baseline tier (used when the LLM
+ * suggestion didn't include an explicit `tier`). Plain semantic types
+ * come first, testid second, then chained scope, then CSS / xpath / js.
+ *
+ * @param t - Selector kind: `role`, `label`, `text`, `testid`,
+ *   `filter-chain`, `css`, `xpath`, or `js`.
+ * @returns Tier number (1 best – 7 worst). Unknown types default to 4.
+ */
+export function tierOfType(t) {
+    return ({ role: 1, label: 1, text: 1, testid: 2, 'filter-chain': 3, css: 4, xpath: 6, js: 7 }[t] ?? 4);
+}
+/**
+ * DOM-side function executed via `pickedHandle.evaluate(...)`. Pulls the
+ * full ancestor-chain HTML (up to 3 levels) and a structured snapshot of
+ * the picked element's properties.
+ *
+ * NOTE: this function is serialized + run in the page context — it must
+ * not reference any module-level imports or closure state.
+ *
+ * @param el - The picked Element (provided by Playwright at runtime).
+ * @returns `{ ancestorsHtml, structured }` matching the shape
+ *   `requestHealedLocator` consumes.
+ */
+export function extractStructured(el) {
+    const e = el;
+    let anc = '';
+    let n = e;
+    let d = 0;
+    while (n && d < 3) {
+        anc = n.outerHTML.slice(0, 300) + '\n' + anc;
+        n = n.parentElement;
+        d++;
+    }
+    const tag = e.tagName.toLowerCase();
+    const id = e.id ?? '';
+    const classes = Array.from(e.classList);
+    const text = (e.textContent ?? '').trim().replace(/\s+/g, ' ').slice(0, 120);
+    return {
+        ancestorsHtml: anc,
+        structured: {
+            tag,
+            id,
+            classes,
+            text,
+            ariaLabel: e.getAttribute('aria-label') ?? '',
+            ariaRole: e.getAttribute('role') ?? '',
+            accessibleName: e.getAttribute('aria-label') || text,
+            dataTestId: e.getAttribute('data-testid') ??
+                e.getAttribute('data-test') ??
+                e.getAttribute('data-cy') ??
+                '',
+            dataAttrs: {},
+            name: e.getAttribute('name') ?? '',
+            type: e.getAttribute('type') ?? '',
+            placeholder: e.getAttribute('placeholder') ?? '',
+            href: e.getAttribute('href') ?? '',
+            associatedLabel: '',
+            parentRole: '',
+            siblingsSameTag: 0,
+            outerHTML: e.outerHTML.slice(0, 800),
+        },
+    };
+}
+/**
+ * Foreground LLM-upgrade stub. When a cache hit returns a fragile-tier
+ * selector (≥5: class-chain CSS, xpath, JS), the orchestrator can try
+ * one more LLM round to upgrade to a stable tier. Currently a no-op
+ * placeholder; wiring is a future task.
+ *
+ * @returns `null` — always falls back to the cached entry.
+ */
+export async function tryForegroundUpgrade() {
+    return null;
+}
+//# sourceMappingURL=orchestrator-helpers.js.map

package/dist/healing/heal/orchestrator-helpers.js.map

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

package/dist/healing/heal/orchestrator.d.ts

@@ -0,0 +1,47 @@
+import type { Page } from '@playwright/test';
+import type { HealEntryV2 } from '../types.js';
+/**
+ * Caller input for `healAction`. The orchestrator owns cache lookup,
+ * overlay injection, LLM rounds, and confirmation — the caller only
+ * supplies the page + the locator that needs healing.
+ */
+export interface HealActionInput {
+    /** Live Playwright `Page` against which to validate candidate locators. */
+    page: Page;
+    /** The selector string the developer originally wrote (the one that broke). */
+    originalSelector: string;
+    /** Playwright action verb (`click`, `fill`, `expect.toBeVisible`, …). */
+    action: string;
+    /** Optional natural-language hint about what the element is for. */
+    description?: string;
+    /** Caller test file path — used as the cache scope key. */
+    testFile: string;
+    /** Override `.healed-locators` cache directory. Defaults to `cwd/.healed-locators`. */
+    cacheDir?: string;
+    /** Caller stack captured at proxy entry (P2-2) — keeps user frame visible. */
+    callerStack?: string;
+}
+/**
+ * Top-level heal entry point. Five-stage flow:
+ *   0. live re-check — maybe the page changed and the original works now
+ *   1. cache lookup — return a previously-healed selector if it still resolves
+ *   2. overlay + pick — developer clicks the right element
+ *   3. preflight — try cheap deterministic locators (testid, role+name, …)
+ *   4. progressive LLM rounds — 4 rounds with increasing tier permissions
+ *
+ * Returns the persisted `HealEntryV2` so the caller (auto-fixture or
+ * manual code) can build a Playwright `Locator` from the result and retry.
+ *
+ * @param input - See `HealActionInput`.
+ * @returns The healed entry (selector + selectorType + tier + trace).
+ * @throws HealCancelledError, HealExhaustedError, HealLLMError on the
+ *   respective failure modes; HealingError(circuit-open) when the LLM
+ *   circuit breaker is open.
+ */
+export declare function healAction(input: HealActionInput): Promise<HealEntryV2>;
+export { toPlaywrightCode } from './playwright-code.js';
+export declare function synthEntry(original: string, type: HealEntryV2['selectorType'], healed: string, intent: string, action: string, trace: {
+    callSite: string;
+    pomFrame: string;
+}, tier?: number, fingerprint?: HealEntryV2['fingerprint']): HealEntryV2;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/healing/heal/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../healing/heal/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,kBAAkB,CAAC;AAqB5D,OAAO,KAAK,EAAE,WAAW,EAAqD,MAAM,aAAa,CAAC;AAGlG;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAkE7E;AA8ZD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA6HxD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,CAAC,cAAc,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,SAAI,EACR,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,GACvC,WAAW,CAQb"}