playwright-mimic 0.1.0 → 0.1.1

package/dist/mimic/click.js

@@ -0,0 +1,233 @@
+import { generateText, Output } from 'ai';
+import { zClickActionResult } from './schema/action.js';
+import { countTokens } from '../utils/token-counter.js';
+import { addAnnotation } from './annotations.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
+ * @param testContext - Optional test context with previous steps and current state
+ * @returns Promise resolving to ClickActionResult with top candidates and click type
+ */
+export const getClickAction = async (_page, brain, gherkinStep, targetElements, testContext) => {
+    // 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');
+    // Build context description for the prompt
+    const contextDescription = testContext ? `
+**Test Context:**
+- Current URL: ${testContext.currentState.url}
+- Current Page Title: ${testContext.currentState.pageTitle}
+- Step ${testContext.currentStepIndex + 1} of ${testContext.totalSteps}
+${testContext.previousSteps.length > 0 ? `
+**Previous Steps Executed:**
+${testContext.previousSteps.map((prevStep, idx) => `${idx + 1}. Step ${prevStep.stepIndex + 1}: "${prevStep.stepText}" (${prevStep.actionKind}${prevStep.url ? ` → ${prevStep.url}` : ''})`).join('\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**.
+- For each candidate, provide a **clear, human-readable description** that identifies the element (e.g., "Submit button", "Login link with text 'Sign in'", "Email input field labeled 'Email address'"). This description will be used in test annotations.
+- Consider the test context - what steps came before may help identify the correct element.
+
+${contextDescription}
+**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;
+};
+/**
+ * Execute a click action on a page element with plain English annotation
+ *
+ * This function performs the actual click interaction and logs what action
+ * is being performed in human-readable terms for better test traceability.
+ * Uses the LLM-generated description from the selected candidate.
+ *
+ * @param element - Playwright Locator for the target element to interact with
+ * @param clickActionResult - Click action result containing click type and target information
+ * @param selectedCandidate - The selected candidate element with LLM-generated description
+ * @param testInfo - Playwright TestInfo for adding annotations
+ * @param gherkinStep - The original Gherkin step for annotation type
+ * @returns Promise that resolves to an object containing the action result and selector (for snapshot storage)
+ */
+export const executeClickAction = async (element, clickActionResult, selectedCandidate, testInfo, gherkinStep) => {
+    // Use the LLM-generated description from the candidate
+    // This description was created by the AI when matching the element
+    const elementDescription = selectedCandidate.description || 'element';
+    // Check if element is valid before attempting click
+    if (!element) {
+        throw new Error(`Cannot click: element not found or page may be closed`);
+    }
+    // Build annotation description based on click type
+    let annotationDescription = '';
+    switch (clickActionResult.clickType) {
+        case 'left':
+            annotationDescription = `→ Clicking on ${elementDescription} with left mouse button`;
+            break;
+        case 'right':
+            annotationDescription = `→ Right-clicking on ${elementDescription} to open context menu`;
+            break;
+        case 'double':
+            annotationDescription = `→ Double-clicking on ${elementDescription} to activate`;
+            break;
+        case 'middle':
+            annotationDescription = `→ Clicking on ${elementDescription} with middle mouse button`;
+            break;
+        case 'hover':
+            annotationDescription = `→ Hovering over ${elementDescription} to reveal additional options`;
+            break;
+        default:
+            throw new Error(`Unknown click type: ${clickActionResult.clickType}`);
+    }
+    // Add annotation using centralized utility
+    addAnnotation(testInfo, gherkinStep, annotationDescription);
+    // Get selector string for snapshot storage
+    // Try to get a CSS selector representation if possible
+    let selector = null;
+    try {
+        // Attempt to get a selector string from the locator
+        // This is best-effort and may not always work
+        const locatorString = element.toString();
+        if (locatorString && locatorString !== '[object Object]') {
+            selector = locatorString;
+        }
+    }
+    catch (error) {
+        // If we can't get selector, that's okay - we'll rebuild from TargetInfo
+    }
+    // Perform the click action
+    switch (clickActionResult.clickType) {
+        case 'left':
+            await element.click();
+            break;
+        case 'right':
+            await element.click({ button: 'right' });
+            break;
+        case 'double':
+            await element.dblclick();
+            break;
+        case 'middle':
+            await element.click({ button: 'middle' });
+            break;
+        case 'hover':
+            await element.hover();
+            break;
+        default:
+            throw new Error(`Unknown click type: ${clickActionResult.clickType}`);
+    }
+    // Return action result and selector for snapshot storage
+    return { actionResult: clickActionResult, selector };
+};
+//# sourceMappingURL=click.js.map

package/dist/mimic/click.js.map

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

package/dist/mimic/forms.d.ts

@@ -0,0 +1,47 @@
+import { Locator, Page, TestInfo } from '@playwright/test';
+import { type LanguageModel } from 'ai';
+import z from 'zod';
+import { TargetInfo } from './selector';
+import type { TestContext } from '../mimic.js';
+declare const zFormActionResult: z.ZodObject<{
+    type: z.ZodEnum<{
+        type: "type";
+        select: "select";
+        fill: "fill";
+        check: "check";
+        uncheck: "uncheck";
+        setInputFiles: "setInputFiles";
+        clear: "clear";
+        keypress: "keypress";
+    }>;
+    params: z.ZodObject<{
+        value: z.ZodString;
+        modifiers: z.ZodArray<z.ZodEnum<{
+            none: "none";
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+        }>>;
+    }, z.core.$strip>;
+    elementDescription: z.ZodString;
+}, z.core.$strip>;
+export type FormActionResult = z.infer<typeof zFormActionResult>;
+export declare const getFormAction: (_page: Page, brain: LanguageModel, gherkinStep: string, targetElements: TargetInfo[], testContext?: TestContext) => Promise<FormActionResult>;
+/**
+ * Execute a form action on a page element with plain English annotation
+ *
+ * This function performs form interactions (typing, selecting, checking, etc.)
+ * and adds test annotations for better traceability and validation.
+ * Uses the LLM-generated element description from the form action result.
+ *
+ * @param page - Playwright Page object for keyboard actions
+ * @param formActionResult - Form action result containing action type, parameters, and element description
+ * @param targetElement - Playwright Locator for the target form element
+ * @param testInfo - Playwright TestInfo for adding annotations (optional)
+ * @param gherkinStep - The original Gherkin step for annotation type (optional)
+ * @returns Promise that resolves when the form action is complete
+ */
+export declare const executeFormAction: (page: Page, formActionResult: FormActionResult, targetElement: Locator | null, testInfo?: TestInfo, gherkinStep?: string) => Promise<void | string[]>;
+export {};
+//# sourceMappingURL=forms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/mimic/forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,IAAI,CAAA;AAC7D,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;iBAWrB,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,EAC5B,cAAc,WAAW,KACxB,OAAO,CAAC,gBAAgB,CAmJ1B,CAAA;AAGD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,IAAI,EACV,kBAAkB,gBAAgB,EAClC,eAAe,OAAO,GAAG,IAAI,EAC7B,WAAW,QAAQ,EACnB,cAAc,MAAM,KACnB,OAAO,CAAC,IAAI,GAAG,MAAM,EAAE,CA+FzB,CAAA"}

package/dist/mimic/forms.js

@@ -0,0 +1,264 @@
+import { generateText, Output } from 'ai';
+import z from 'zod';
+import { countTokens } from '../utils/token-counter';
+import { addAnnotation } from './annotations.js';
+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."),
+    }),
+    /**
+     * Human-readable description of the target form element for test annotations
+     * Should clearly identify which form field is being interacted with (e.g., "Email input field", "Submit button", "Country dropdown")
+     */
+    elementDescription: z.string().describe("Human-readable description of the target form element for test annotations"),
+});
+export const getFormAction = async (_page, brain, gherkinStep, targetElements, testContext) => {
+    // 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');
+    // Build context description for the prompt
+    const contextDescription = testContext ? `
+**Test Context:**
+- Current URL: ${testContext.currentState.url}
+- Current Page Title: ${testContext.currentState.pageTitle}
+- Step ${testContext.currentStepIndex + 1} of ${testContext.totalSteps}
+${testContext.previousSteps.length > 0 ? `
+**Previous Steps Executed:**
+${testContext.previousSteps.map((prevStep, idx) => `${idx + 1}. Step ${prevStep.stepIndex + 1}: "${prevStep.stepText}" (${prevStep.actionKind}${prevStep.url ? ` → ${prevStep.url}` : ''})`).join('\n')}
+` : ''}
+` : '';
+    const res = await generateText({
+        model: brain,
+        prompt: `You are an expert Playwright test engineer specializing in mapping Gherkin steps to form interactions.
+
+Your task is to analyze:
+1. A single Gherkin step that implies a form update action (typing, filling, selecting, checking, etc.).
+2. A list of candidate form elements extracted from the page.
+
+You must determine:
+- The type of form action (fill, type, select, check, uncheck, clear, etc.)
+- The value to use (text to type, option to select, etc.)
+
+${contextDescription}
+**Gherkin Step:**
+${gherkinStep}
+
+**Available Form Elements (${targetElements.length} total):**
+${elementsDescription}
+
+**Action Types:**
+- fill: Replace all content in a field with text (USE THIS for typing text like email addresses, names, etc.)
+- type: Type text character by character (slower, simulates real typing - use when needed for special cases)
+- select: Select an option from dropdown/select element
+- check: Check a checkbox (USE THIS when step says "check" or "select" a checkbox)
+- uncheck: Uncheck a checkbox (USE THIS when step says "uncheck" or "deselect" a checkbox)
+- clear: Clear field content
+- keypress: Press a SINGLE KEY ONLY (e.g., "Enter", "Tab", "Escape", "ArrowDown") - DO NOT use for typing text strings or checkboxes
+- setInputFiles: Upload a file
+
+**IMPORTANT:**
+- For typing text (email addresses, names, messages, etc.), ALWAYS use "fill" or "type", NEVER "keypress"
+- For checkboxes, ALWAYS use "check" or "uncheck", NEVER "keypress"
+- "keypress" is ONLY for single keyboard keys like "Enter", "Tab", "Escape", "ArrowUp", "ArrowDown", etc.
+- If the step says "type X into Y" or "fill Y with X", use "fill" (preferred) or "type", NOT "keypress"
+- If the step says "check" or "select" a checkbox, use "check", NOT "keypress"
+
+**Instructions:**
+1. Identify what form action is being requested
+2. Extract the value from the step (text to type, option to select, etc.)
+3. Identify which form element is being targeted (name field, email field, submit button, etc.)
+4. Return the appropriate action type, value, and a clear description of the target element
+   - The elementDescription should clearly identify the form field (e.g., "Email input field", "Name field labeled 'Full Name'", "Submit button", "Country dropdown")
+
+Think step-by-step about what the user wants to do with the form.`,
+        output: Output.object({ schema: zFormActionResult, name: 'formActionResult' }),
+        maxRetries: 3,
+    });
+    await countTokens(res);
+    return res.output;
+};
+/**
+ * Execute a form action on a page element with plain English annotation
+ *
+ * This function performs form interactions (typing, selecting, checking, etc.)
+ * and adds test annotations for better traceability and validation.
+ * Uses the LLM-generated element description from the form action result.
+ *
+ * @param page - Playwright Page object for keyboard actions
+ * @param formActionResult - Form action result containing action type, parameters, and element description
+ * @param targetElement - Playwright Locator for the target form element
+ * @param testInfo - Playwright TestInfo for adding annotations (optional)
+ * @param gherkinStep - The original Gherkin step for annotation type (optional)
+ * @returns Promise that resolves when the form action is complete
+ */
+export const executeFormAction = async (page, formActionResult, targetElement, testInfo, gherkinStep) => {
+    if (targetElement === null) {
+        throw new Error('No target element found');
+    }
+    // Use LLM-generated description from the form action result
+    const elementDescription = formActionResult.elementDescription || 'form field';
+    let annotationDescription = '';
+    // Get selector string for snapshot storage
+    // Try to get a CSS selector representation if possible
+    let selector = null;
+    try {
+        // Attempt to get a selector string from the locator
+        // This is best-effort and may not always work
+        const locatorString = targetElement.toString();
+        if (locatorString && locatorString !== '[object Object]') {
+            selector = locatorString;
+        }
+    }
+    catch (error) {
+        // If we can't get selector, that's okay - we'll rebuild from TargetInfo
+    }
+    // Perform the form action with appropriate plain English annotation
+    switch (formActionResult.type) {
+        case 'keypress':
+            // Validate that keypress is only used for single keys, not text strings
+            const keyValue = formActionResult.params.value;
+            const validSingleKeys = ['Enter', 'Tab', 'Escape', 'Backspace', 'Delete', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Home', 'End', 'PageUp', 'PageDown', 'F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8', 'F9', 'F10', 'F11', 'F12'];
+            // Handle empty or invalid keypress values
+            if (!keyValue || keyValue.trim() === '') {
+                // If empty value and step mentions "check", convert to check action
+                const stepLower = (gherkinStep || '').toLowerCase();
+                if (stepLower.includes('check') || stepLower.includes('select')) {
+                    console.warn(`⚠️  keypress action received empty value for checkbox operation - converting to check action`);
+                    annotationDescription = `→ Checking ${elementDescription} to select the option`;
+                    addAnnotation(testInfo, gherkinStep, annotationDescription);
+                    await targetElement.check();
+                }
+                else {
+                    throw new Error(`keypress action requires a valid key value, but received empty string. Use 'check' for checkboxes, 'fill' for text input, etc.`);
+                }
+            }
+            else if (keyValue.length > 1 && !validSingleKeys.includes(keyValue)) {
+                // If it's not a valid single key and looks like text, use fill instead
+                console.warn(`⚠️  keypress action received text "${keyValue}" - converting to fill action`);
+                annotationDescription = `→ Filling ${elementDescription} with value "${keyValue}"`;
+                addAnnotation(testInfo, gherkinStep, annotationDescription);
+                await targetElement.fill(keyValue);
+            }
+            else {
+                annotationDescription = `→ Pressing key "${keyValue}" on the keyboard`;
+                addAnnotation(testInfo, gherkinStep, annotationDescription);
+                await page.keyboard.press(keyValue);
+            }
+            break;
+        case 'type':
+            annotationDescription = `→ Typing "${formActionResult.params.value}" using keyboard input`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await page.keyboard.type(formActionResult.params.value);
+            break;
+        case 'fill':
+            annotationDescription = `→ Filling ${elementDescription} with value "${formActionResult.params.value}"`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.fill(formActionResult.params.value);
+            break;
+        case 'select':
+            annotationDescription = `→ Selecting option "${formActionResult.params.value}" from ${elementDescription}`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.selectOption(formActionResult.params.value);
+            break;
+        case 'uncheck':
+            annotationDescription = `→ Unchecking ${elementDescription} to deselect the option`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.uncheck();
+            break;
+        case 'check':
+            annotationDescription = `→ Checking ${elementDescription} to select the option`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.check();
+            break;
+        case 'setInputFiles':
+            annotationDescription = `→ Uploading file "${formActionResult.params.value}" to ${elementDescription}`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.setInputFiles(formActionResult.params.value);
+            break;
+        case 'clear':
+            annotationDescription = `→ Clearing the contents of ${elementDescription}`;
+            addAnnotation(testInfo, gherkinStep, annotationDescription);
+            await targetElement.clear();
+            break;
+        default:
+            throw new Error(`Unknown form action type: ${formActionResult.type}`);
+    }
+    // Return action result and selector for snapshot storage
+    return { actionResult: formActionResult, selector };
+};
+//# sourceMappingURL=forms.js.map

package/dist/mimic/forms.js.map

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

package/dist/mimic/navigation.d.ts

@@ -0,0 +1,19 @@
+import { type LanguageModel } from 'ai';
+import { Page, TestInfo } from '@playwright/test';
+import { type NavigationAction } from './schema/action.js';
+import type { TestContext } from '../mimic.js';
+export declare const getNavigationAction: (_page: Page, brain: LanguageModel, action: string, testContext?: TestContext) => Promise<NavigationAction>;
+/**
+ * Execute a navigation action on the page with plain English annotation
+ *
+ * This function performs browser navigation actions (navigate, go back, refresh, etc.)
+ * and adds test annotations for better traceability and validation.
+ *
+ * @param page - Playwright Page object to perform navigation on
+ * @param navigationAction - Navigation action containing type, parameters, and description
+ * @param testInfo - Playwright TestInfo for adding annotations (optional)
+ * @param gherkinStep - The original Gherkin step for annotation type (optional)
+ * @returns Promise that resolves to the navigation action (for snapshot storage)
+ */
+export declare const executeNavigationAction: (page: Page, navigationAction: NavigationAction, testInfo?: TestInfo, gherkinStep?: string) => Promise<NavigationAction>;
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/mimic/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,IAAI,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,mBAAmB,GAC9B,OAAO,IAAI,EACX,OAAO,aAAa,EACpB,QAAQ,MAAM,EACd,cAAc,WAAW,KACxB,OAAO,CAAC,gBAAgB,CA8C1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,IAAI,EACV,kBAAkB,gBAAgB,EAClC,WAAW,QAAQ,EACnB,cAAc,MAAM,KACnB,OAAO,CAAC,gBAAgB,CAwD1B,CAAC"}