@browserflow-ai/core 0.0.6

package/dist/locator-object.d.ts

@@ -0,0 +1,556 @@
+/**
+ * LocatorObject types and resolution utilities
+ *
+ * @see bf-6ig for implementation task
+ */
+import { z } from 'zod';
+import type { Page, Locator } from 'playwright-core';
+/**
+ * Supported locator strategy types
+ */
+export type LocatorStrategyType = 'testid' | 'role' | 'label' | 'placeholder' | 'text' | 'css';
+/**
+ * Locator strategy definition
+ */
+export interface LocatorStrategy {
+    type: LocatorStrategyType;
+    value?: string;
+    attribute?: string;
+    role?: string;
+    name?: string;
+    exact?: boolean;
+    text?: string;
+    selector?: string;
+}
+/**
+ * DOM fingerprint for element verification
+ */
+export interface DOMFingerprint {
+    tag: string;
+    classes: string[];
+    attributes?: Record<string, string>;
+}
+/**
+ * Bounding box for element position
+ */
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Proof data for element verification
+ */
+export interface LocatorProof {
+    a11y_role?: string;
+    a11y_name?: string;
+    dom_fingerprint?: DOMFingerprint;
+    bounding_box?: BoundingBox;
+}
+/**
+ * Scoping constraints for locator
+ */
+export interface LocatorScoping {
+    within?: LocatorStrategy[];
+    nth?: number;
+}
+/**
+ * Complete LocatorObject - core primitive for deterministic element selection
+ */
+export interface LocatorObject {
+    locator_id: string;
+    preferred: LocatorStrategy;
+    fallbacks: LocatorStrategy[];
+    scoping?: LocatorScoping;
+    proof: LocatorProof;
+}
+/**
+ * Options for resolving locators
+ */
+export interface ResolveOptions {
+    useFallbacks: boolean;
+    timeout?: number;
+}
+export declare const locatorStrategyTypeSchema: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+export declare const locatorStrategySchema: z.ZodObject<{
+    type: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+    value: z.ZodOptional<z.ZodString>;
+    attribute: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    exact: z.ZodOptional<z.ZodBoolean>;
+    text: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+    value?: string | undefined;
+    exact?: boolean | undefined;
+    role?: string | undefined;
+    name?: string | undefined;
+    text?: string | undefined;
+    selector?: string | undefined;
+    attribute?: string | undefined;
+}, {
+    type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+    value?: string | undefined;
+    exact?: boolean | undefined;
+    role?: string | undefined;
+    name?: string | undefined;
+    text?: string | undefined;
+    selector?: string | undefined;
+    attribute?: string | undefined;
+}>;
+export declare const domFingerprintSchema: z.ZodObject<{
+    tag: z.ZodString;
+    classes: z.ZodArray<z.ZodString, "many">;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    tag: string;
+    classes: string[];
+    attributes?: Record<string, string> | undefined;
+}, {
+    tag: string;
+    classes: string[];
+    attributes?: Record<string, string> | undefined;
+}>;
+export declare const boundingBoxSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+export declare const locatorProofSchema: z.ZodObject<{
+    a11y_role: z.ZodOptional<z.ZodString>;
+    a11y_name: z.ZodOptional<z.ZodString>;
+    dom_fingerprint: z.ZodOptional<z.ZodObject<{
+        tag: z.ZodString;
+        classes: z.ZodArray<z.ZodString, "many">;
+        attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        tag: string;
+        classes: string[];
+        attributes?: Record<string, string> | undefined;
+    }, {
+        tag: string;
+        classes: string[];
+        attributes?: Record<string, string> | undefined;
+    }>>;
+    bounding_box: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    a11y_role?: string | undefined;
+    a11y_name?: string | undefined;
+    dom_fingerprint?: {
+        tag: string;
+        classes: string[];
+        attributes?: Record<string, string> | undefined;
+    } | undefined;
+    bounding_box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+}, {
+    a11y_role?: string | undefined;
+    a11y_name?: string | undefined;
+    dom_fingerprint?: {
+        tag: string;
+        classes: string[];
+        attributes?: Record<string, string> | undefined;
+    } | undefined;
+    bounding_box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+}>;
+export declare const locatorScopingSchema: z.ZodObject<{
+    within: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+        value: z.ZodOptional<z.ZodString>;
+        attribute: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        exact: z.ZodOptional<z.ZodBoolean>;
+        text: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }>, "many">>;
+    nth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    within?: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }[] | undefined;
+    nth?: number | undefined;
+}, {
+    within?: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }[] | undefined;
+    nth?: number | undefined;
+}>;
+export declare const locatorObjectSchema: z.ZodObject<{
+    locator_id: z.ZodString;
+    preferred: z.ZodObject<{
+        type: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+        value: z.ZodOptional<z.ZodString>;
+        attribute: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        exact: z.ZodOptional<z.ZodBoolean>;
+        text: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }>;
+    fallbacks: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+        value: z.ZodOptional<z.ZodString>;
+        attribute: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        exact: z.ZodOptional<z.ZodBoolean>;
+        text: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }, {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }>, "many">;
+    scoping: z.ZodOptional<z.ZodObject<{
+        within: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["testid", "role", "label", "placeholder", "text", "css"]>;
+            value: z.ZodOptional<z.ZodString>;
+            attribute: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            exact: z.ZodOptional<z.ZodBoolean>;
+            text: z.ZodOptional<z.ZodString>;
+            selector: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }, {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }>, "many">>;
+        nth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        within?: {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }[] | undefined;
+        nth?: number | undefined;
+    }, {
+        within?: {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }[] | undefined;
+        nth?: number | undefined;
+    }>>;
+    proof: z.ZodObject<{
+        a11y_role: z.ZodOptional<z.ZodString>;
+        a11y_name: z.ZodOptional<z.ZodString>;
+        dom_fingerprint: z.ZodOptional<z.ZodObject<{
+            tag: z.ZodString;
+            classes: z.ZodArray<z.ZodString, "many">;
+            attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        }, {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        }>>;
+        bounding_box: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        a11y_role?: string | undefined;
+        a11y_name?: string | undefined;
+        dom_fingerprint?: {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        } | undefined;
+        bounding_box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }, {
+        a11y_role?: string | undefined;
+        a11y_name?: string | undefined;
+        dom_fingerprint?: {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        } | undefined;
+        bounding_box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    locator_id: string;
+    preferred: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    };
+    fallbacks: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }[];
+    proof: {
+        a11y_role?: string | undefined;
+        a11y_name?: string | undefined;
+        dom_fingerprint?: {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        } | undefined;
+        bounding_box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+    };
+    scoping?: {
+        within?: {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }[] | undefined;
+        nth?: number | undefined;
+    } | undefined;
+}, {
+    locator_id: string;
+    preferred: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    };
+    fallbacks: {
+        type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+        value?: string | undefined;
+        exact?: boolean | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        text?: string | undefined;
+        selector?: string | undefined;
+        attribute?: string | undefined;
+    }[];
+    proof: {
+        a11y_role?: string | undefined;
+        a11y_name?: string | undefined;
+        dom_fingerprint?: {
+            tag: string;
+            classes: string[];
+            attributes?: Record<string, string> | undefined;
+        } | undefined;
+        bounding_box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+    };
+    scoping?: {
+        within?: {
+            type: "testid" | "role" | "label" | "placeholder" | "text" | "css";
+            value?: string | undefined;
+            exact?: boolean | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            text?: string | undefined;
+            selector?: string | undefined;
+            attribute?: string | undefined;
+        }[] | undefined;
+        nth?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * Converts a LocatorStrategy to a Playwright Locator
+ */
+export declare function strategyToLocator(strategy: LocatorStrategy, page: Page): Locator;
+/**
+ * Resolves a LocatorObject to a Playwright Locator
+ */
+export declare function resolveLocator(locatorObj: LocatorObject, page: Page, options: ResolveOptions): Locator;
+export type LocatorMethod = 'getByRole' | 'getByText' | 'getByLabel' | 'getByPlaceholder' | 'getByTestId' | 'getByAltText' | 'getByTitle' | 'locator';
+export interface LocatorArgs {
+    role?: string;
+    name?: string | RegExp;
+    text?: string | RegExp;
+    testId?: string;
+    exact?: boolean;
+    selector?: string;
+    [key: string]: unknown;
+}
+/**
+ * Legacy LocatorObject interface (for backwards compatibility)
+ */
+export interface LegacyLocatorObject {
+    ref?: string;
+    selector?: string;
+    method?: LocatorMethod;
+    args?: LocatorArgs;
+    description?: string;
+}
+/**
+ * Legacy function - resolves a LegacyLocatorObject to a string representation
+ */
+export declare function resolveLegacyLocator(locator: LegacyLocatorObject): string;
+//# sourceMappingURL=locator-object.d.ts.map

package/dist/locator-object.d.ts.map

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

package/dist/locator-object.js

@@ -0,0 +1,114 @@
+/**
+ * LocatorObject types and resolution utilities
+ *
+ * @see bf-6ig for implementation task
+ */
+import { z } from 'zod';
+// Zod schemas
+export const locatorStrategyTypeSchema = z.enum(['testid', 'role', 'label', 'placeholder', 'text', 'css']);
+export const locatorStrategySchema = z.object({
+    type: locatorStrategyTypeSchema,
+    // For testid
+    value: z.string().optional(),
+    attribute: z.string().optional(),
+    // For role
+    role: z.string().optional(),
+    name: z.string().optional(),
+    exact: z.boolean().optional(),
+    // For label/placeholder/text
+    text: z.string().optional(),
+    // For css
+    selector: z.string().optional(),
+});
+export const domFingerprintSchema = z.object({
+    tag: z.string(),
+    classes: z.array(z.string()),
+    attributes: z.record(z.string()).optional(),
+});
+export const boundingBoxSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+    width: z.number(),
+    height: z.number(),
+});
+export const locatorProofSchema = z.object({
+    a11y_role: z.string().optional(),
+    a11y_name: z.string().optional(),
+    dom_fingerprint: domFingerprintSchema.optional(),
+    bounding_box: boundingBoxSchema.optional(),
+});
+export const locatorScopingSchema = z.object({
+    within: z.array(locatorStrategySchema).optional(),
+    nth: z.number().int().optional(),
+});
+export const locatorObjectSchema = z.object({
+    locator_id: z.string().min(1),
+    preferred: locatorStrategySchema,
+    fallbacks: z.array(locatorStrategySchema),
+    scoping: locatorScopingSchema.optional(),
+    proof: locatorProofSchema,
+});
+/**
+ * Converts a LocatorStrategy to a Playwright Locator
+ */
+export function strategyToLocator(strategy, page) {
+    switch (strategy.type) {
+        case 'testid':
+            if (strategy.attribute && strategy.attribute !== 'data-testid') {
+                // Custom testid attribute
+                return page.locator(`[${strategy.attribute}="${strategy.value}"]`);
+            }
+            return page.getByTestId(strategy.value);
+        case 'role':
+            const roleOptions = {};
+            if (strategy.name) {
+                roleOptions.name = strategy.name;
+                roleOptions.exact = strategy.exact ?? true;
+            }
+            return page.getByRole(strategy.role, roleOptions);
+        case 'label':
+            return page.getByLabel(strategy.text);
+        case 'placeholder':
+            return page.getByPlaceholder(strategy.text);
+        case 'text':
+            return page.getByText(strategy.text);
+        case 'css':
+            return page.locator(strategy.selector);
+        default:
+            throw new Error(`Unknown locator strategy type: ${strategy.type}`);
+    }
+}
+/**
+ * Resolves a LocatorObject to a Playwright Locator
+ */
+export function resolveLocator(locatorObj, page, options) {
+    // Start with preferred strategy
+    let locator = strategyToLocator(locatorObj.preferred, page);
+    // Apply scoping constraints
+    if (locatorObj.scoping?.within) {
+        for (const scope of locatorObj.scoping.within) {
+            const scopeLocator = strategyToLocator(scope, page);
+            locator = scopeLocator.locator(locator);
+        }
+    }
+    if (locatorObj.scoping?.nth !== undefined) {
+        locator = locator.nth(locatorObj.scoping.nth);
+    }
+    // TODO: If useFallbacks is true and locator doesn't find element,
+    // iterate through fallbacks. This requires async operation.
+    return locator;
+}
+/**
+ * Legacy function - resolves a LegacyLocatorObject to a string representation
+ */
+export function resolveLegacyLocator(locator) {
+    if (locator.selector) {
+        return `locator(${JSON.stringify(locator.selector)})`;
+    }
+    if (locator.method && locator.args) {
+        const argsStr = JSON.stringify(locator.args);
+        return `${locator.method}(${argsStr})`;
+    }
+    return 'locator("body")';
+}
+//# sourceMappingURL=locator-object.js.map

package/dist/locator-object.js.map

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