@eidra-umain/greenlight 0.1.0

package/dist/pilot/assertions.js

@@ -0,0 +1,219 @@
+/**
+ * Assertion execution — validates page state against expected conditions.
+ */
+import { globals } from "../globals.js";
+import { resolveActionTarget } from "./locator.js";
+/**
+ * Poll an assertion until it passes or the timeout expires.
+ * This handles cases where the page is still updating (e.g. dropdown
+ * appearing after typing, navigation completing, etc.).
+ */
+export async function pollAssertion(check, timeoutMs = 5000) {
+    const deadline = performance.now() + timeoutMs;
+    let lastError = new Error("Assertion timed out");
+    while (performance.now() < deadline) {
+        try {
+            await check();
+            return;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+        }
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    throw lastError;
+}
+/**
+ * Execute an assertion against the current page state.
+ * Positive assertions (checking something exists/appears) are polled with
+ * a timeout to handle async page updates (dropdowns, navigation, etc.).
+ * Negative assertions (checking something is absent) run once immediately.
+ */
+export async function executeAssertion(page, action, a11yTree) {
+    const assertion = action.assertion;
+    if (!assertion) {
+        throw new Error("executeAssertion called without an assertion");
+    }
+    // Handle compare assertions separately — they need the value store
+    if (assertion.type === "compare" && action.compare) {
+        await executeCompareAssertion(page, action, a11yTree);
+        return;
+    }
+    const check = buildAssertionCheck(page, assertion);
+    // Positive assertions benefit from polling (content may still be loading).
+    // Negative assertions and URL checks should fail immediately.
+    const shouldPoll = assertion.type === "contains_text" ||
+        assertion.type === "element_visible" ||
+        assertion.type === "element_exists" ||
+        assertion.type === "link_exists" ||
+        assertion.type === "field_exists";
+    if (shouldPoll) {
+        await pollAssertion(check);
+    }
+    else {
+        await check();
+    }
+}
+/** Extract a numeric value from a text string. */
+export function extractNumber(text) {
+    // Remove thousand separators and normalize decimal separators
+    const cleaned = text.replace(/\s/g, "").replace(/,/g, ".");
+    const match = /(-?\d+\.?\d*)/.exec(cleaned);
+    return match ? parseFloat(match[1]) : null;
+}
+/**
+ * Execute a compare assertion: read a current value from the page,
+ * compare it against a remembered value using the specified operator.
+ */
+export async function executeCompareAssertion(page, action, a11yTree) {
+    if (!action.compare) {
+        throw new Error("executeCompareAssertion called without compare metadata");
+    }
+    const { variable, operator } = action.compare;
+    // Get the remembered value from the global value store
+    if (!globals.valueStore.has(variable)) {
+        throw new Error(`No remembered value found for "${variable}"`);
+    }
+    const rememberedText = globals.valueStore.get(variable);
+    if (rememberedText === undefined) {
+        throw new Error(`No remembered value found for "${variable}"`);
+    }
+    // Get the current value from the page
+    let currentText;
+    if (action.ref || action.text) {
+        const locator = await resolveActionTarget(page, action, a11yTree);
+        currentText = (await locator.textContent() ?? "").trim();
+    }
+    else {
+        // No element target — use keyword search on the page (same approach
+        // as the remember fallback). Extract keywords from the variable name
+        // and find a matching text segment containing a number.
+        const keywords = variable
+            .replace(/_/g, " ")
+            .split(" ")
+            .filter((w) => w.length > 2);
+        const innerText = await page.locator("body").innerText();
+        const segments = innerText
+            .split(/[\n\t]+/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        let best = "";
+        for (const seg of segments) {
+            if (!/\d/.test(seg))
+                continue;
+            const lower = seg.toLowerCase();
+            if (keywords.some((kw) => lower.includes(kw.toLowerCase()))) {
+                if (!best || seg.length < best.length) {
+                    best = seg;
+                }
+            }
+        }
+        if (!best) {
+            throw new Error(`compare assertion: could not find a value on the page matching "${variable}"`);
+        }
+        currentText = best;
+        if (globals.debug) {
+            console.log(`      [compare] Found current value by keyword search: "${currentText}"`);
+        }
+    }
+    const rememberedNum = extractNumber(rememberedText);
+    const currentNum = extractNumber(currentText);
+    if (rememberedNum === null) {
+        throw new Error(`Cannot extract number from remembered value "${rememberedText}"`);
+    }
+    if (currentNum === null) {
+        throw new Error(`Cannot extract number from current value "${currentText}"`);
+    }
+    if (globals.debug) {
+        console.log(`      [compare] "${variable}" = ${String(rememberedNum)}, current = ${String(currentNum)}, operator = ${operator}`);
+    }
+    let passed;
+    switch (operator) {
+        case "less_than":
+            passed = currentNum < rememberedNum;
+            break;
+        case "greater_than":
+            passed = currentNum > rememberedNum;
+            break;
+        case "equal":
+            passed = currentNum === rememberedNum;
+            break;
+        case "not_equal":
+            passed = currentNum !== rememberedNum;
+            break;
+        case "less_or_equal":
+            passed = currentNum <= rememberedNum;
+            break;
+        case "greater_or_equal":
+            passed = currentNum >= rememberedNum;
+            break;
+        default: throw new Error(`Unknown comparison operator: ${String(operator)}`);
+    }
+    if (!passed) {
+        throw new Error(`Comparison failed: current value ${String(currentNum)} is not ${operator.replace(/_/g, " ")} remembered "${variable}" (${String(rememberedNum)})`);
+    }
+}
+export function buildAssertionCheck(page, assertion) {
+    return async () => {
+        switch (assertion.type) {
+            case "contains_text": {
+                const body = await page.locator("body").textContent();
+                if (!body?.toLowerCase().includes(assertion.expected.toLowerCase())) {
+                    throw new Error(`Page does not contain text: "${assertion.expected}"`);
+                }
+                break;
+            }
+            case "not_contains_text": {
+                const bodyText = await page.locator("body").textContent();
+                if (bodyText?.toLowerCase().includes(assertion.expected.toLowerCase())) {
+                    throw new Error(`Page contains text it should not: "${assertion.expected}"`);
+                }
+                break;
+            }
+            case "url_contains": {
+                const url = page.url();
+                if (!url.includes(assertion.expected)) {
+                    throw new Error(`URL "${url}" does not contain "${assertion.expected}"`);
+                }
+                break;
+            }
+            case "element_visible":
+            case "element_exists": {
+                const visible = await page.getByText(assertion.expected).isVisible();
+                if (!visible) {
+                    throw new Error(`Element with text "${assertion.expected}" is not visible`);
+                }
+                break;
+            }
+            case "element_not_visible": {
+                const visible = await page.getByText(assertion.expected).isVisible();
+                if (visible) {
+                    throw new Error(`Element with text "${assertion.expected}" is still visible`);
+                }
+                break;
+            }
+            case "link_exists": {
+                const link = page.locator(`a[href="${assertion.expected}"], a[href$="${assertion.expected}"]`);
+                const count = await link.count();
+                if (count === 0) {
+                    throw new Error(`No link found with href matching "${assertion.expected}"`);
+                }
+                break;
+            }
+            case "field_exists": {
+                // Check for a form field by label, placeholder, or aria-label
+                const byLabel = page.getByLabel(assertion.expected);
+                const byPlaceholder = page.getByPlaceholder(assertion.expected);
+                const labelCount = await byLabel.count();
+                const placeholderCount = await byPlaceholder.count();
+                if (labelCount === 0 && placeholderCount === 0) {
+                    throw new Error(`No form field found matching "${assertion.expected}"`);
+                }
+                break;
+            }
+            default:
+                throw new Error(`Unknown assertion type: ${assertion.type}`);
+        }
+    };
+}
+//# sourceMappingURL=assertions.js.map

package/dist/pilot/assertions.js.map

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

package/dist/pilot/checkbox.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Checkbox interaction — handles check/uncheck across different UI frameworks.
+ */
+import type { Page, Locator } from "playwright";
+/**
+ * Check or uncheck a checkbox using multiple strategies.
+ * Modern frameworks (React, Vue, etc.) use synthetic event systems that
+ * don't respond to native DOM property changes. We try multiple approaches
+ * in order until the checkbox state actually changes.
+ */
+export declare function checkCheckbox(page: Page, locator: Locator, checked: boolean): Promise<void>;
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/pilot/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../src/pilot/checkbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAG/C;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CA6Ff"}

package/dist/pilot/checkbox.js

@@ -0,0 +1,104 @@
+/**
+ * Checkbox interaction — handles check/uncheck across different UI frameworks.
+ */
+import { globals } from "../globals.js";
+/**
+ * Check or uncheck a checkbox using multiple strategies.
+ * Modern frameworks (React, Vue, etc.) use synthetic event systems that
+ * don't respond to native DOM property changes. We try multiple approaches
+ * in order until the checkbox state actually changes.
+ */
+export async function checkCheckbox(page, locator, checked) {
+    const method = checked ? "check" : "uncheck";
+    // Strategy 1: Playwright's native check/uncheck (works for standard checkboxes)
+    try {
+        if (checked) {
+            await locator.check({ timeout: 3000 });
+        }
+        else {
+            await locator.uncheck({ timeout: 3000 });
+        }
+        return;
+    }
+    catch {
+        if (globals.debug) {
+            console.log(`      [${method}] Playwright ${method}() timed out, trying label click`);
+        }
+    }
+    // Strategy 2: Find and click the associated <label> element.
+    // This is the most reliable approach for custom-styled checkboxes
+    // because it mimics what a real user does.
+    try {
+        const labelClicked = await locator.evaluate((el) => {
+            // If this IS the input, find its label
+            const input = el.tagName === "INPUT"
+                ? el
+                : el.querySelector("input[type='checkbox']");
+            if (!input)
+                return false;
+            // Try label[for="id"]
+            if (input.id) {
+                const label = document.querySelector(`label[for="${input.id}"]`);
+                if (label) {
+                    label.click();
+                    return true;
+                }
+            }
+            // Try wrapping <label>
+            const label = input.closest("label");
+            if (label) {
+                label.click();
+                return true;
+            }
+            return false;
+        });
+        if (labelClicked) {
+            if (globals.debug) {
+                console.log(`      [${method}] Label click succeeded`);
+            }
+            return;
+        }
+    }
+    catch {
+        // Continue to next strategy
+    }
+    // Strategy 3: Force click the element itself
+    try {
+        await locator.click({ force: true, timeout: 2000 });
+        if (globals.debug) {
+            console.log(`      [${method}] Force click succeeded`);
+        }
+        return;
+    }
+    catch {
+        if (globals.debug) {
+            console.log(`      [${method}] Force click failed, using JS property set + React workaround`);
+        }
+    }
+    // Strategy 4: Set the property and fire React-compatible events.
+    // React uses an internal event system that tracks the input's value
+    // via a property descriptor override. We need to use the native
+    // setter and then dispatch events to trigger React's onChange.
+    await locator.evaluate((el, targetChecked) => {
+        const input = el.tagName === "INPUT"
+            ? el
+            : el.querySelector("input[type='checkbox']");
+        if (!input) {
+            el.click();
+            return;
+        }
+        // Use the native property setter to bypass React's override
+        const descriptor = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "checked");
+        if (descriptor?.set) {
+            descriptor.set.call(input, targetChecked);
+        }
+        else {
+            input.checked = targetChecked;
+        }
+        // Fire events that React's synthetic event system listens for
+        input.dispatchEvent(new Event("click", { bubbles: true }));
+        input.dispatchEvent(new Event("input", { bubbles: true }));
+        input.dispatchEvent(new Event("change", { bubbles: true }));
+    }, checked);
+}
+//# sourceMappingURL=checkbox.js.map

package/dist/pilot/checkbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.js","sourceRoot":"","sources":["../../src/pilot/checkbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,IAAU,EACV,OAAgB,EAChB,OAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAE5C,gFAAgF;IAChF,IAAI,CAAC;QACJ,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACP,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,CAAC;QACD,OAAM;IACP,CAAC;IAAC,MAAM,CAAC;QACR,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,gBAAgB,MAAM,kCAAkC,CAAC,CAAA;QACtF,CAAC;IACF,CAAC;IAED,6DAA6D;IAC7D,kEAAkE;IAClE,2CAA2C;IAC3C,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAe,EAAE,EAAE;YAC/D,uCAAuC;YACvC,MAAM,KAAK,GAA4B,EAAE,CAAC,OAAO,KAAK,OAAO;gBAC5D,CAAC,CAAC,EAAsB;gBACxB,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAA;YAC7C,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAA;YAExB,sBAAsB;YACtB,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;gBAChE,IAAI,KAAK,EAAE,CAAC;oBACV,KAAqB,CAAC,KAAK,EAAE,CAAA;oBAC9B,OAAO,IAAI,CAAA;gBACZ,CAAC;YACF,CAAC;YACD,uBAAuB;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACpC,IAAI,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,OAAO,IAAI,CAAA;YACZ,CAAC;YACD,OAAO,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,IAAI,YAAY,EAAE,CAAC;YAClB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,yBAAyB,CAAC,CAAA;YACvD,CAAC;YACD,OAAM;QACP,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,4BAA4B;IAC7B,CAAC;IAED,6CAA6C;IAC7C,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,yBAAyB,CAAC,CAAA;QACvD,CAAC;QACD,OAAM;IACP,CAAC;IAAC,MAAM,CAAC;QACR,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,gEAAgE,CAAC,CAAA;QAC9F,CAAC;IACF,CAAC;IAED,iEAAiE;IACjE,oEAAoE;IACpE,gEAAgE;IAChE,+DAA+D;IAC/D,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAe,EAAE,aAAsB,EAAE,EAAE;QAClE,MAAM,KAAK,GAA4B,EAAE,CAAC,OAAO,KAAK,OAAO;YAC5D,CAAC,CAAC,EAAsB;YACxB,CAAC,CAAC,EAAE,CAAC,aAAa,CAAmB,wBAAwB,CAAC,CAAA;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,EAAE,CAAC,KAAK,EAAE,CAAA;YACV,OAAM;QACP,CAAC;QACD,4DAA4D;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CACjD,gBAAgB,CAAC,SAAS,EAAE,SAAS,CACrC,CAAA;QACD,IAAI,UAAU,EAAE,GAAG,EAAE,CAAC;YACrB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QAC1C,CAAC;aAAM,CAAC;YACP,KAAK,CAAC,OAAO,GAAG,aAAa,CAAA;QAC9B,CAAC;QACD,8DAA8D;QAC9D,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC1D,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC1D,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5D,CAAC,EAAE,OAAO,CAAC,CAAA;AACZ,CAAC"}

package/dist/pilot/executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Action executor — translates LLM Action objects into Playwright browser calls.
+ */
+import type { Page } from "playwright";
+import type { Action, A11yNode, ExecutionResult } from "../reporter/types.js";
+/**
+ * Run an action that might trigger navigation.
+ * Listens for a 'framenavigated' event during the action — if one fires,
+ * waits for the new page to reach domcontentloaded. If no navigation
+ * happens, returns immediately with no delay.
+ */
+export declare function runWithNavigationHandling(page: Page, action: () => Promise<void>): Promise<void>;
+/**
+ * Execute a single Action against the browser page.
+ */
+export declare function executeAction(page: Page, action: Action, a11yTree: A11yNode[], _valueStore?: Map<string, string>): Promise<ExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/pilot/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/pilot/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EACX,MAAM,EACN,QAAQ,EACR,eAAe,EAEf,MAAM,sBAAsB,CAAA;AAY7B;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC9C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAiCD;;GAEG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAAE,EACpB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,eAAe,CAAC,CAid1B"}