playwright-mimic 0.1.0

package/dist/mimicry/click.js

@@ -0,0 +1,152 @@
+import { generateText, Output } from 'ai';
+import { zClickActionResult } from './schema/action.js';
+import { countTokens } from '../utils/token-counter.js';
+/**
+ * Get click action by matching Gherkin step against captured target elements
+ *
+ * This function uses AI to analyze a Gherkin step and match it against
+ * all available target elements on the page. It returns the top 5 most
+ * likely candidates along with the appropriate click type.
+ *
+ * @param page - Playwright Page object (currently unused but kept for consistency)
+ * @param brain - LanguageModel instance for AI analysis
+ * @param gherkinStep - The Gherkin step to match (e.g., "I click on the Submit button")
+ * @param targetElements - Array of captured target elements from the page
+ * @returns Promise resolving to ClickActionResult with top candidates and click type
+ */
+export const getClickAction = async (_page, brain, gherkinStep, targetElements) => {
+    // Format target elements with their indices for the prompt
+    // Include all relevant identifying information
+    const elementsWithIndices = targetElements.map((element, index) => ({
+        index,
+        tag: element.tag,
+        text: element.text,
+        id: element.id,
+        role: element.role,
+        label: element.label,
+        ariaLabel: element.ariaLabel,
+        typeAttr: element.typeAttr,
+        nameAttr: element.nameAttr,
+        href: element.href,
+        dataset: element.dataset,
+        nthOfType: element.nthOfType,
+    }));
+    // Group elements by tag type
+    const elementsByTag = new Map();
+    for (const el of elementsWithIndices) {
+        const tagKey = el.tag === 'a' ? 'links' : el.tag === 'button' ? 'buttons' : el.tag === 'input' ? 'inputs' : el.tag;
+        if (!elementsByTag.has(tagKey)) {
+            elementsByTag.set(tagKey, []);
+        }
+        elementsByTag.get(tagKey).push(el);
+    }
+    // Format element fields in selector priority order, skipping null/empty values
+    const formatElement = (roleSection) => (el) => {
+        const parts = [];
+        // Priority order: testId → text → role → ariaLabel → label → name → type → href → dataAttributes → tag → id → nthOfType
+        if (el.dataset.testid) {
+            parts.push(`  testId: "${el.dataset.testid}"`);
+        }
+        if (el.text && el.text.trim()) {
+            parts.push(`  text: "${el.text.trim()}"`);
+        }
+        if (el.role && roleSection !== el.role) {
+            parts.push(`  role: ${el.role}`);
+        }
+        if (el.ariaLabel) {
+            parts.push(`  ariaLabel: "${el.ariaLabel}"`);
+        }
+        if (el.label) {
+            parts.push(`  label: "${el.label}"`);
+        }
+        if (el.nameAttr) {
+            parts.push(`  name: "${el.nameAttr}"`);
+        }
+        if (el.typeAttr) {
+            parts.push(`  type: ${el.typeAttr}`);
+        }
+        if (el.href) {
+            parts.push(`  href: "${el.href}"`);
+        }
+        if (Object.keys(el.dataset).length > 0) {
+            const dataKeys = Object.keys(el.dataset).filter(k => k !== 'testid');
+            if (dataKeys.length > 0) {
+                parts.push(`  dataAttributes: ${JSON.stringify(dataKeys)}`);
+            }
+        }
+        parts.push(`  tag: ${el.tag}`);
+        // if (el.id) {
+        //   parts.push(`  id: "${el.id}"`);
+        // }
+        parts.push(`  index: ${el.index}`);
+        if (el.nthOfType > 1) {
+            parts.push(`  nthOfType: ${el.nthOfType}`);
+        }
+        return `  - ${parts.join('\n    ')}`;
+    };
+    // Create formatted description grouped by tag
+    const elementsDescription = Array.from(elementsByTag.entries())
+        .map(([tagKey, elements]) => {
+        const formattedElements = elements.map(formatElement(tagKey)).join('\n');
+        return `${tagKey}:\n${formattedElements}`;
+    })
+        .join('\n\n');
+    const prompt = `You are an expert Playwright test engineer specializing in mapping Gherkin steps to concrete DOM interactions.
+
+Your task is to analyze:
+1. A single Gherkin step that implies a click action.
+2. A list of candidate DOM elements extracted from the page.
+
+You must return the **top 5 most likely elements** that the Gherkin step is referring to.
+
+---
+
+### IMPORTANT RULES
+
+- Rank elements from **most likely (rank 1)** to **least likely (rank 5)**.
+- Prefer **semantic matches** first:
+  - Visible text
+  - Accessible name (label, aria-label, role)
+  - Button / link intent
+- Use "index" **only as a secondary disambiguation signal**, never as the primary reason.
+- Do NOT invent elements or field values.
+- Do NOT include more than 5 results.
+- If fewer than 5 reasonable matches exist, return fewer.
+- Do NOT assume navigation or side effects — this task is only about **what element is clicked**.
+
+
+**Gherkin Step:**
+${gherkinStep}
+
+**Available Target Elements (${targetElements.length} total):**
+${elementsDescription}
+
+
+## Reason and return up to the top 5 most likely elements that the Gherkin step is referring to.
+`;
+    const res = await generateText({
+        model: brain,
+        prompt,
+        maxRetries: 3,
+        output: Output.object({ schema: zClickActionResult, name: 'clickActionResult' }),
+    });
+    await countTokens(res);
+    return res.output;
+};
+export const executeClickAction = async (element, clickActionResult) => {
+    switch (clickActionResult.clickType) {
+        case 'left':
+            return await element?.click();
+        case 'right':
+            return await element?.click({ button: 'right' });
+        case 'double':
+            return await element?.dblclick();
+        case 'middle':
+            return await element?.click({ button: 'middle' });
+        case 'hover':
+            return await element?.hover();
+        default:
+            throw new Error(`Unknown click type: ${clickActionResult.clickType}`);
+    }
+};
+//# sourceMappingURL=click.js.map

package/dist/mimicry/click.js.map

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

package/dist/mimicry/forms.d.ts

@@ -0,0 +1,31 @@
+import { Locator, Page } from '@playwright/test';
+import { type LanguageModel } from 'ai';
+import z from 'zod';
+import { TargetInfo } from './selector';
+declare const zFormActionResult: z.ZodObject<{
+    type: z.ZodEnum<{
+        type: "type";
+        fill: "fill";
+        select: "select";
+        uncheck: "uncheck";
+        check: "check";
+        setInputFiles: "setInputFiles";
+        clear: "clear";
+        keypress: "keypress";
+    }>;
+    params: z.ZodObject<{
+        value: z.ZodString;
+        modifiers: z.ZodArray<z.ZodEnum<{
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+            none: "none";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type FormActionResult = z.infer<typeof zFormActionResult>;
+export declare const getFormAction: (_page: Page, brain: LanguageModel, gherkinStep: string, targetElements: TargetInfo[]) => Promise<FormActionResult>;
+export declare const executeFormAction: (page: Page, formActionResult: FormActionResult, targetElement: Locator | null) => Promise<void | string[]>;
+export {};
+//# sourceMappingURL=forms.d.ts.map

package/dist/mimicry/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/mimicry/forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,IAAI,CAAA;AAC7D,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAMrB,CAAA;AAGF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,aAAa,GACxB,OAAO,IAAI,EACX,OAAO,aAAa,EACpB,aAAa,MAAM,EACnB,gBAAgB,UAAU,EAAE,KAC3B,OAAO,CAAC,gBAAgB,CA4H1B,CAAA;AAGD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,IAAI,EACV,kBAAkB,gBAAgB,EAClC,eAAe,OAAO,GAAG,IAAI,KAC5B,OAAO,CAAC,IAAI,GAAG,MAAM,EAAE,CAwBzB,CAAA"}

package/dist/mimicry/forms.js

@@ -0,0 +1,154 @@
+import { generateText, Output } from 'ai';
+import z from 'zod';
+import { countTokens } from '../utils/token-counter';
+const zFormActionResult = z.object({
+    type: z.enum(['keypress', 'type', 'fill', 'select', 'uncheck', 'check', 'setInputFiles', 'clear']),
+    params: z.object({
+        value: z.string().describe("Value to set for the form update."),
+        modifiers: z.array(z.enum(['Alt', 'Control', 'Meta', 'Shift', 'none'])).describe("Optional modifier keys to use for the form update."),
+    }),
+});
+export const getFormAction = async (_page, brain, gherkinStep, targetElements) => {
+    // Format target elements with their indices for the prompt
+    // Include all relevant identifying information
+    const elementsWithIndices = targetElements.map((element, index) => ({
+        index,
+        tag: element.tag,
+        text: element.text,
+        id: element.id,
+        role: element.role,
+        label: element.label,
+        ariaLabel: element.ariaLabel,
+        typeAttr: element.typeAttr,
+        nameAttr: element.nameAttr,
+        href: element.href,
+        dataset: element.dataset,
+        nthOfType: element.nthOfType,
+    }));
+    // Group elements by tag type
+    const elementsByTag = new Map();
+    for (const el of elementsWithIndices) {
+        const tagKey = el.tag === 'a' ? 'links' : el.tag === 'button' ? 'buttons' : el.tag === 'input' ? 'inputs' : el.tag;
+        if (!elementsByTag.has(tagKey)) {
+            elementsByTag.set(tagKey, []);
+        }
+        elementsByTag.get(tagKey).push(el);
+    }
+    // Format element fields in selector priority order, skipping null/empty values
+    const formatElement = (roleSection) => (el) => {
+        const parts = [];
+        // Priority order: testId → text → role → ariaLabel → label → name → type → href → dataAttributes → tag → id → nthOfType
+        if (el.dataset.testid) {
+            parts.push(`  testId: "${el.dataset.testid}"`);
+        }
+        if (el.text && el.text.trim()) {
+            parts.push(`  text: "${el.text.trim()}"`);
+        }
+        if (el.role && roleSection !== el.role) {
+            parts.push(`  role: ${el.role}`);
+        }
+        if (el.ariaLabel) {
+            parts.push(`  ariaLabel: "${el.ariaLabel}"`);
+        }
+        if (el.label) {
+            parts.push(`  label: "${el.label}"`);
+        }
+        if (el.nameAttr) {
+            parts.push(`  name: "${el.nameAttr}"`);
+        }
+        if (el.typeAttr) {
+            parts.push(`  type: ${el.typeAttr}`);
+        }
+        if (el.href) {
+            parts.push(`  href: "${el.href}"`);
+        }
+        if (Object.keys(el.dataset).length > 0) {
+            const dataKeys = Object.keys(el.dataset).filter(k => k !== 'testid');
+            if (dataKeys.length > 0) {
+                parts.push(`  dataAttributes: ${JSON.stringify(dataKeys)}`);
+            }
+        }
+        parts.push(`  tag: ${el.tag}`);
+        // if (el.id) {
+        //   parts.push(`  id: "${el.id}"`);
+        // }
+        parts.push(`  index: ${el.index}`);
+        if (el.nthOfType > 1) {
+            parts.push(`  nthOfType: ${el.nthOfType}`);
+        }
+        return `  - ${parts.join('\n    ')}`;
+    };
+    // Create formatted description grouped by tag
+    const elementsDescription = Array.from(elementsByTag.entries())
+        .map(([tagKey, elements]) => {
+        const formattedElements = elements.map(formatElement(tagKey)).join('\n');
+        return `${tagKey}:\n${formattedElements}`;
+    })
+        .join('\n\n');
+    const res = await generateText({
+        model: brain,
+        prompt: `You are an expert Playwright test engineer specializing in mapping Gherkin steps to concrete DOM interactions.
+
+Your task is to analyze:
+1. A single Gherkin step that implies a click action.
+2. A list of candidate DOM elements extracted from the page.
+
+You must return the **top 5 most likely elements** that the Gherkin step is referring to.
+
+---
+
+### IMPORTANT RULES
+
+- Rank elements from **most likely (rank 1)** to **least likely (rank 5)**.
+- Prefer **semantic matches** first:
+  - Visible text
+  - Accessible name (label, aria-label, role)
+  - Button / link intent
+- Use "index" **only as a secondary disambiguation signal**, never as the primary reason.
+- Do NOT invent elements or field values.
+- Do NOT include more than 5 results.
+- If fewer than 5 reasonable matches exist, return fewer.
+- Do NOT assume navigation or side effects — this task is only about **what element is clicked**.
+
+
+**Gherkin Step:**
+${gherkinStep}
+
+**Available Target Elements (${targetElements.length} total):**
+${elementsDescription}
+
+
+## Reason and return up to the top 5 most likely elements that the Gherkin step is referring to.
+`,
+        output: Output.object({ schema: zFormActionResult, name: 'formActionResult' }),
+        maxRetries: 3,
+    });
+    await countTokens(res);
+    return res.output;
+};
+export const executeFormAction = async (page, formActionResult, targetElement) => {
+    if (targetElement === null) {
+        throw new Error('No target element found');
+    }
+    switch (formActionResult.type) {
+        case 'keypress':
+            return await page.keyboard.press(formActionResult.params.value);
+        case 'type':
+            return await page.keyboard.type(formActionResult.params.value);
+        case 'fill':
+            return await targetElement.fill(formActionResult.params.value);
+        case 'select':
+            return await targetElement.selectOption(formActionResult.params.value);
+        case 'uncheck':
+            return await targetElement.uncheck();
+        case 'check':
+            return await targetElement.check();
+        case 'setInputFiles':
+            return await targetElement.setInputFiles(formActionResult.params.value);
+        case 'clear':
+            return await targetElement.clear();
+        default:
+            throw new Error(`Unknown form action type: ${formActionResult.type}`);
+    }
+};
+//# sourceMappingURL=forms.js.map

package/dist/mimicry/forms.js.map

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

package/dist/mimicry/navigation.d.ts

@@ -0,0 +1,6 @@
+import { type LanguageModel } from 'ai';
+import { Page } from '@playwright/test';
+import { type NavigationAction } from './schema/action.js';
+export declare const getNavigationAction: (_page: Page, brain: LanguageModel, action: string) => Promise<NavigationAction>;
+export declare const executeNavigationAction: (page: Page, navigationAction: NavigationAction) => Promise<void>;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/mimicry/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/mimicry/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,IAAI,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAA;AAG3B,eAAO,MAAM,mBAAmB,GAC9B,OAAO,IAAI,EACX,OAAO,aAAa,EACpB,QAAQ,MAAM,KACb,OAAO,CAAC,gBAAgB,CAqB1B,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,MAAM,IAAI,EACV,kBAAkB,gBAAgB,KACjC,OAAO,CAAC,IAAI,CA0Bd,CAAC"}

package/dist/mimicry/navigation.js

@@ -0,0 +1,52 @@
+import { generateText, Output } from 'ai';
+import { zNavigationAction, } from './schema/action.js';
+import { countTokens } from '../utils/token-counter.js';
+export const getNavigationAction = async (_page, brain, action) => {
+    const res = await generateText({
+        model: brain,
+        maxRetries: 3,
+        prompt: `You are an expert in converting Gherkin test steps into structured browser automation action objects using Playwright.
+
+Your task is to process a single Gherkin step and determine whether it represents a **navigation** action. this can be any of the following:
+- navigate to a page (this requires a url, if no url is provided, go for an option below)
+- closePage: close the current page
+- goBack: go back to the previous page, or navigate back in the browser history
+- goForward: go forward to the next page, or navigate forward in the browser history
+- refresh: refresh the current page, or reload the page
+
+Input Gherkin step: ${action}
+    
+    `,
+        output: Output.object({ schema: zNavigationAction, name: 'navigation' }),
+    });
+    await countTokens(res);
+    return res.output;
+};
+export const executeNavigationAction = async (page, navigationAction) => {
+    switch (navigationAction.type) {
+        case 'openPage':
+        case 'navigate':
+            // console.log('Navigating to', navigationAction.params.url);
+            await page.goto(navigationAction.params.url, { waitUntil: 'networkidle' });
+            break;
+        case 'closePage':
+            // console.log('Closing page');
+            await page.close();
+            break;
+        case 'goBack':
+            // console.log('Going back');  
+            await page.goBack();
+            break;
+        case 'goForward':
+            // console.log('Going forward');
+            await page.goForward();
+            break;
+        case 'refresh':
+            // console.log('Refreshing page');
+            await page.reload();
+            break;
+        default:
+            throw new Error(`Unknown navigation action type: ${navigationAction.type}`);
+    }
+};
+//# sourceMappingURL=navigation.js.map

package/dist/mimicry/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/mimicry/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAG7D,OAAO,EACL,iBAAiB,GAElB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,KAAW,EACX,KAAoB,EACpB,MAAc,EACa,EAAE;IAC7B,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC;QAC7B,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,CAAC;QACb,MAAM,EAAE;;;;;;;;;sBASU,MAAM;;KAEvB;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAEvB,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,IAAU,EACV,gBAAkC,EACnB,EAAE;IACjB,QAAQ,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC9B,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,6DAA6D;YAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAI,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;YAC5E,MAAM;QACR,KAAK,WAAW;YACd,+BAA+B;YAC/B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM;QACR,KAAK,QAAQ;YACX,+BAA+B;YAC/B,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,WAAW;YACd,gCAAgC;YAChC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM;QACR,KAAK,SAAS;YACZ,kCAAkC;YAClC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC,CAAC"}