playwright-mimic 0.1.0 → 0.1.1

package/dist/mimic/navigation.js

@@ -0,0 +1,117 @@
+import { generateText, Output } from 'ai';
+import { zNavigationAction, } from './schema/action.js';
+import { countTokens } from '../utils/token-counter.js';
+import { addAnnotation } from './annotations.js';
+export const getNavigationAction = async (_page, brain, action, testContext) => {
+    // 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,
+        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
+
+${contextDescription}
+**Input Gherkin step:** ${action}
+
+**Instructions:**
+1. Determine the navigation type and extract the URL if applicable
+2. Provide a clear, human-readable description of what navigation is happening
+   - For navigate/openPage: "Navigate to [page name or URL]" (e.g., "Navigate to login page", "Navigate to https://example.com")
+   - Do not hallucinate the domain, if none are mentioned, just pass the uri (e.g., "/login")
+   - For goBack: "Go back to previous page in browser history" (the system will add the specific URL information)
+   - For goForward: "Go forward to next page in browser history" (the system will add the specific URL information)
+   - For refresh: "Refresh the current page" (the system will add the specific URL information)
+   - For closePage: "Close the current browser page/tab" (the system will add the specific URL information)
+    
+    `,
+        output: Output.object({ schema: zNavigationAction, name: 'navigation' }),
+    });
+    await countTokens(res);
+    return res.output;
+};
+/**
+ * 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 const executeNavigationAction = async (page, navigationAction, testInfo, gherkinStep) => {
+    // Use LLM-generated description or build a default one
+    const actionDescription = navigationAction.description || 'navigation action';
+    switch (navigationAction.type) {
+        case 'openPage':
+        case 'navigate':
+            addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} and waiting for page to load completely`);
+            await page.goto(navigationAction.params.url, { waitUntil: 'networkidle' });
+            break;
+        case 'closePage':
+            // Only close page if explicitly requested - be very careful with this action
+            // Check if page is still open before closing
+            if (page.isClosed()) {
+                addAnnotation(testInfo, gherkinStep, `→ Page is already closed, cannot close again`);
+                return navigationAction;
+            }
+            // Capture current URL for better traceability
+            const currentUrlBeforeClose = page.url();
+            addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (closing page at ${currentUrlBeforeClose})`);
+            await page.close();
+            break;
+        case 'goBack':
+            // Capture current URL before going back for better traceability
+            const currentUrlBeforeBack = page.url();
+            await page.goBack();
+            try {
+                const urlAfterBack = page.url();
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeBack} to ${urlAfterBack})`);
+            }
+            catch {
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeBack})`);
+            }
+            break;
+        case 'goForward':
+            // Capture current URL before going forward for better traceability
+            const currentUrlBeforeForward = page.url();
+            await page.goForward();
+            try {
+                const urlAfterForward = page.url();
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeForward} to ${urlAfterForward})`);
+            }
+            catch {
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeForward})`);
+            }
+            break;
+        case 'refresh':
+            // Capture current URL for better traceability
+            const currentUrlBeforeRefresh = page.url();
+            addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} to reload all content (refreshing ${currentUrlBeforeRefresh})`);
+            await page.reload();
+            break;
+        default:
+            throw new Error(`Unknown navigation action type: ${navigationAction.type}`);
+    }
+    // Return the action for snapshot storage
+    return navigationAction;
+};
+//# sourceMappingURL=navigation.js.map

package/dist/mimic/navigation.js.map

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

package/dist/mimic/replay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snapshot Replay Module
+ *
+ * Replays test steps from a snapshot without using LLM calls.
+ * This provides fast, deterministic test execution for previously successful tests.
+ */
+import { Page, TestInfo } from '@playwright/test';
+import type { Snapshot } from './types.js';
+/**
+ * Replay a complete test from a snapshot
+ *
+ * Executes all steps in the snapshot without making LLM calls.
+ * This is much faster than normal execution since it skips AI analysis.
+ *
+ * @param page - Playwright Page object
+ * @param snapshot - Snapshot containing steps to replay
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when all steps are replayed
+ */
+export declare function replayFromSnapshot(page: Page, snapshot: Snapshot, testInfo?: TestInfo): Promise<void>;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/mimic/replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAQ,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAUzD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/mimic/replay.js

@@ -0,0 +1,133 @@
+/**
+ * Snapshot Replay Module
+ *
+ * Replays test steps from a snapshot without using LLM calls.
+ * This provides fast, deterministic test execution for previously successful tests.
+ */
+import { test } from '@playwright/test';
+import { executeNavigationAction } from './navigation.js';
+import { executeClickAction } from './click.js';
+import { executeFormAction } from './forms.js';
+import { buildSelectorForTarget } from './selector.js';
+/**
+ * Replay a complete test from a snapshot
+ *
+ * Executes all steps in the snapshot without making LLM calls.
+ * This is much faster than normal execution since it skips AI analysis.
+ *
+ * @param page - Playwright Page object
+ * @param snapshot - Snapshot containing steps to replay
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when all steps are replayed
+ */
+export async function replayFromSnapshot(page, snapshot, testInfo) {
+    // Replay each step in order
+    for (const step of snapshot.steps) {
+        await test.step(step.stepText, async () => {
+            switch (step.actionKind) {
+                case 'navigation':
+                    await replayNavigationStep(page, step, testInfo);
+                    break;
+                case 'click':
+                    await replayClickStep(page, step, testInfo);
+                    break;
+                case 'form update':
+                    await replayFormStep(page, step, testInfo);
+                    break;
+                default:
+                    throw new Error(`Unknown action kind in snapshot: ${step.actionKind}`);
+            }
+        });
+    }
+}
+/**
+ * Replay a navigation step from snapshot
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing navigation action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when navigation is complete
+ */
+async function replayNavigationStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    await executeNavigationAction(page, actionDetails, testInfo, step.stepText);
+}
+/**
+ * Replay a click step from snapshot
+ *
+ * Reconstructs the locator from stored target element information.
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing click action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when click is complete
+ */
+async function replayClickStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    // Reconstruct the target element from snapshot
+    if (!step.targetElement) {
+        throw new Error(`Snapshot step ${step.stepIndex} (click) is missing targetElement`);
+    }
+    // If we have a stored selector, try to use it directly
+    let element;
+    if (step.targetElement.selector) {
+        try {
+            element = page.locator(step.targetElement.selector);
+            // Verify the element exists
+            await element.waitFor({ timeout: 5000 });
+        }
+        catch (error) {
+            // Selector might be stale, fall back to rebuilding from TargetInfo
+            console.warn(`Stored selector failed for step ${step.stepIndex}, rebuilding from TargetInfo`);
+            element = await buildSelectorForTarget(page, step.targetElement);
+        }
+    }
+    else {
+        // Rebuild selector from TargetInfo
+        element = await buildSelectorForTarget(page, step.targetElement);
+    }
+    // Find the selected candidate from the click action result
+    // The first candidate should be the one we used originally
+    const selectedCandidate = actionDetails.candidates[0];
+    if (!selectedCandidate) {
+        throw new Error(`Snapshot step ${step.stepIndex} (click) has no candidates in actionDetails`);
+    }
+    await executeClickAction(element, actionDetails, selectedCandidate, testInfo, step.stepText);
+}
+/**
+ * Replay a form step from snapshot
+ *
+ * Reconstructs the form element locator from stored target element information.
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing form action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when form action is complete
+ */
+async function replayFormStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    // Reconstruct the target element from snapshot
+    if (!step.targetElement) {
+        throw new Error(`Snapshot step ${step.stepIndex} (form) is missing targetElement`);
+    }
+    // If we have a stored selector, try to use it directly
+    let element;
+    if (step.targetElement.selector) {
+        try {
+            element = page.locator(step.targetElement.selector);
+            // Verify the element exists
+            await element.waitFor({ timeout: 5000 });
+        }
+        catch (error) {
+            // Selector might be stale, fall back to rebuilding from TargetInfo
+            console.warn(`Stored selector failed for step ${step.stepIndex}, rebuilding from TargetInfo`);
+            element = await buildSelectorForTarget(page, step.targetElement);
+        }
+    }
+    else {
+        // Rebuild selector from TargetInfo
+        element = await buildSelectorForTarget(page, step.targetElement);
+    }
+    await executeFormAction(page, actionDetails, element, testInfo, step.stepText);
+}
+//# sourceMappingURL=replay.js.map

package/dist/mimic/replay.js.map

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

package/dist/mimic/schema/action.d.ts

@@ -0,0 +1,315 @@
+import { z } from "zod";
+/**
+ * Shared: identifiers and primitive helpers
+ */
+export declare const zPoint: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>;
+export declare const zMouseButton: z.ZodEnum<{
+    left: "left";
+    middle: "middle";
+    right: "right";
+}>;
+export declare const zModifierKeys: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    Alt: "Alt";
+    Control: "Control";
+    Meta: "Meta";
+    Shift: "Shift";
+}>>>;
+export declare const zFrameDescription: z.ZodObject<{
+    pageGuid: z.ZodString;
+    pageAlias: z.ZodString;
+    framePath: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * ACTION INTENT (PASS 1): coarse category only
+ * Keep this small so an LLM can commit early with high accuracy.
+ */
+export declare const zActionKind: z.ZodEnum<{
+    navigation: "navigation";
+    click: "click";
+    assertion: "assertion";
+    other: "other";
+    "form update": "form update";
+}>;
+export declare const zGeneralActionPlan: z.ZodObject<{
+    kind: z.ZodEnum<{
+        navigation: "navigation";
+        click: "click";
+        assertion: "assertion";
+        other: "other";
+        "form update": "form update";
+    }>;
+    description: z.ZodString;
+}, z.core.$strip>;
+/**
+ * ACTION SUBTYPE (PASS 2): constrained sub-choices within the category? maybe add as object with values or special
+ */
+export declare const zMouseType: z.ZodEnum<{
+    click: "click";
+    doubleClick: "doubleClick";
+    hover: "hover";
+}>;
+export declare const zFormUpdateTypes: z.ZodEnum<{
+    type: "type";
+    select: "select";
+    fill: "fill";
+    check: "check";
+    press: "press";
+    uncheck: "uncheck";
+    setInputFiles: "setInputFiles";
+    clear: "clear";
+}>;
+export declare const zNavigationType: z.ZodEnum<{
+    openPage: "openPage";
+    navigate: "navigate";
+    closePage: "closePage";
+    goBack: "goBack";
+    goForward: "goForward";
+    refresh: "refresh";
+    openInNewTab: "openInNewTab";
+}>;
+export declare const zAssertionType: z.ZodEnum<{
+    "text visible": "text visible";
+    "value visible": "value visible";
+    "checked visible": "checked visible";
+    "aria snapshot visible": "aria snapshot visible";
+    "screenshot of element": "screenshot of element";
+}>;
+export declare const zMouseAction: z.ZodObject<{
+    type: z.ZodEnum<{
+        click: "click";
+        doubleClick: "doubleClick";
+        hover: "hover";
+    }>;
+    params: z.ZodObject<{
+        button: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>>>;
+        position: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>>;
+        modifiers: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+        }>>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const zFormUpdateAction: z.ZodObject<{
+    type: z.ZodEnum<{
+        type: "type";
+        select: "select";
+        fill: "fill";
+        check: "check";
+        press: "press";
+        uncheck: "uncheck";
+        setInputFiles: "setInputFiles";
+        clear: "clear";
+    }>;
+    params: z.ZodObject<{
+        value: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+        }>>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const zNavigationAction: z.ZodObject<{
+    type: z.ZodEnum<{
+        openPage: "openPage";
+        navigate: "navigate";
+        closePage: "closePage";
+        goBack: "goBack";
+        goForward: "goForward";
+        refresh: "refresh";
+        openInNewTab: "openInNewTab";
+    }>;
+    params: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    description: z.ZodString;
+}, z.core.$strip>;
+export type NavigationAction = z.infer<typeof zNavigationAction>;
+/**
+ * Click action result schema
+ * Contains top candidate elements matched against a Gherkin step
+ */
+export declare const zClickActionResult: z.ZodObject<{
+    candidates: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        tag: z.ZodString;
+        text: z.ZodString;
+        id: z.ZodNullable<z.ZodString>;
+        role: z.ZodNullable<z.ZodString>;
+        label: z.ZodNullable<z.ZodString>;
+        ariaLabel: z.ZodNullable<z.ZodString>;
+        confidence: z.ZodNullable<z.ZodNumber>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    clickType: z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+        hover: "hover";
+        double: "double";
+    }>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type ClickActionResult = z.infer<typeof zClickActionResult>;
+export declare const zAssertionAction: z.ZodObject<{
+    type: z.ZodEnum<{
+        "text visible": "text visible";
+        "value visible": "value visible";
+        "checked visible": "checked visible";
+        "aria snapshot visible": "aria snapshot visible";
+        "screenshot of element": "screenshot of element";
+    }>;
+    params: z.ZodObject<{
+        expected: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const zOtherAction: z.ZodObject<{
+    type: z.ZodLiteral<"custom">;
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * ACTION SUBTYPE (PASS 2): Union of all subtype schemas with kind
+ * This allows progressive refinement: first get kind, then get specific subtype.
+ */
+export declare const zActionPass2: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"mouse">;
+    type: z.ZodEnum<{
+        click: "click";
+        doubleClick: "doubleClick";
+        hover: "hover";
+    }>;
+    params: z.ZodObject<{
+        button: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>>>;
+        position: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>>;
+        modifiers: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+        }>>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"form update">;
+    type: z.ZodEnum<{
+        type: "type";
+        select: "select";
+        fill: "fill";
+        check: "check";
+        press: "press";
+        uncheck: "uncheck";
+        setInputFiles: "setInputFiles";
+        clear: "clear";
+    }>;
+    params: z.ZodObject<{
+        value: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            Alt: "Alt";
+            Control: "Control";
+            Meta: "Meta";
+            Shift: "Shift";
+        }>>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"navigation">;
+    type: z.ZodEnum<{
+        openPage: "openPage";
+        navigate: "navigate";
+        closePage: "closePage";
+        goBack: "goBack";
+        goForward: "goForward";
+        refresh: "refresh";
+        openInNewTab: "openInNewTab";
+    }>;
+    params: z.ZodObject<{
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    description: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"assertion">;
+    type: z.ZodEnum<{
+        "text visible": "text visible";
+        "value visible": "value visible";
+        "checked visible": "checked visible";
+        "aria snapshot visible": "aria snapshot visible";
+        "screenshot of element": "screenshot of element";
+    }>;
+    params: z.ZodObject<{
+        expected: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"other">;
+    type: z.ZodLiteral<"custom">;
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>], "kind">;
+/**
+ * ACTION DETAILS (PASS 3): parameters, selector link, and signals
+ * Each subtype has a focused schema to minimize ambiguity.
+ */
+export declare const zMouseParams: z.ZodObject<{
+    button: z.ZodDefault<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+    clickCount: z.ZodDefault<z.ZodNumber>;
+    position: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>>;
+    modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        Alt: "Alt";
+        Control: "Control";
+        Meta: "Meta";
+        Shift: "Shift";
+    }>>>;
+}, z.core.$strip>;
+export declare const zKeyboardPressParams: z.ZodObject<{
+    key: z.ZodString;
+    modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        Alt: "Alt";
+        Control: "Control";
+        Meta: "Meta";
+        Shift: "Shift";
+    }>>>;
+}, z.core.$strip>;
+export declare const zKeyboardTypeParams: z.ZodObject<{
+    text: z.ZodString;
+    delayMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const zKeyboardFillParams: z.ZodObject<{
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const zOpenPageParams: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+export declare const zNavigateParams: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+export declare const zClosePageParams: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Type exports for convenience
+ */
+export type Point = z.infer<typeof zPoint>;
+//# sourceMappingURL=action.d.ts.map

package/dist/mimic/schema/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/mimic/schema/action.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,MAAM;;;iBAGjB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;EAAuE,CAAC;AACjG,eAAO,MAAM,aAAa;;;;;IAGZ,CAAC;AAEf,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;EAEkB,CAAC;AAE3C,eAAO,MAAM,kBAAkB;;;;;;;;;iBAK7B,CAAC;AAEH;;GAEG;AAEH,eAAO,MAAM,UAAU;;;;EAEc,CAAC;AACtC,eAAO,MAAM,gBAAgB;;;;;;;;;EAE0B,CAAC;AACxD,eAAO,MAAM,eAAe;;;;;;;;EAEc,CAAC;AAC3C,eAAO,MAAM,cAAc;;;;;;EAEM,CAAC;AAElC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;iBAOvB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;iBAM5B,CAAC;AAGH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBA8D7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAGnE,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAK3B,CAAC;AAGH,eAAO,MAAM,YAAY;;;iBAGvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAM2C,CAAC;AAErE;;;GAGG;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;iBAKvB,CAAC;AAGH,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AACH,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAGH,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AACH,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AACH,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAoGH;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC"}