@bctrl/sdk 1.0.1 → 1.0.3

package/dist/drivers/playwright/generated/locator.js

@@ -1,974 +0,0 @@
-/**
- * AUTO-GENERATED FILE - DO NOT EDIT
- *
- * Generated from: packages/automation-spec/src/drivers/playwright/methods/
- * Run `pnpm generate:playwright` to regenerate.
- */
-import { serializeFunctionSource } from '../../../internal/transport.js';
-/**
- * RemotePlaywrightLocator - Remote Playwright Locator API over RPC.
- *
- * @see https://playwright.dev/docs/api/class-locator
- */
-export class RemotePlaywrightLocator {
-    _state = {
-        timeout: 30000,
-    };
-    selector;
-    sendRpc;
-    createElementHandle;
-    createLocator;
-    createFrameLocator;
-    _page;
-    constructor(selector, sendRpc, createElementHandle, createLocator, createFrameLocator, _page, state) {
-        this.selector = selector;
-        this.sendRpc = sendRpc;
-        this.createElementHandle = createElementHandle;
-        this.createLocator = createLocator;
-        this.createFrameLocator = createFrameLocator;
-        this._page = _page;
-        if (state) {
-            this._state = { ...this._state, ...state };
-        }
-    }
-    /**
-     * Sets the timeout for this locator's actions.
-     * Returns a new Locator with the updated timeout.
-     * @param timeout Timeout in milliseconds
-     * @returns New Locator instance with updated timeout
-     */
-    setTimeout(timeout) {
-        const clone = this.clone();
-        clone._state.timeout = timeout;
-        return clone;
-    }
-    /**
-     * Takes a screenshot of the element.
-     * @see https://playwright.dev/docs/api/class-locator#locator-screenshot
-     */
-    async screenshot(options) {
-        const result = await this.sendRpc('screenshot', [options]);
-        return Buffer.from(result, 'base64');
-    }
-    /**
-     * Clones the locator.
-     * @returns A new locator with the same configuration.
-     */
-    clone() {
-        return new RemotePlaywrightLocator(this.selector, this.sendRpc, this.createElementHandle, this.createLocator, this.createFrameLocator, this._page, { ...this._state });
-    }
-    /**
-     * Clicks on the element.
-     *
-     * @remarks
-     * Waits for actionability checks, scrolls element into view,
-     * and uses Page.mouse to click in the center of the element.
-     *
-     * @example
-     * await locator.click();
-     *
-     * @example
-     * await locator.click({ button: 'right' });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-click
-     */
-    async click(options) {
-        await this.sendRpc('click', [options]);
-    }
-    /**
-     * Double-clicks on the element.
-     *
-     * @remarks
-     * Performs two clicks with a short delay, simulating a native double-click.
-     * Waits for actionability checks before performing the action.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-dblclick
-     */
-    async dblclick(options) {
-        await this.sendRpc('dblclick', [options]);
-    }
-    /**
-     * Fills an input or textarea element with the specified value.
-     * @param value - Value to fill in
-     *
-     * @remarks
-     * This method waits for actionability checks, focuses the element,
-     * fills it, and triggers an input event. It clears the existing value before filling.
-     * Works with <input>, <textarea>, and [contenteditable] elements.
-     *
-     * @example
-     * await page.getByLabel('Password').fill('secret');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-fill
-     */
-    async fill(value, options) {
-        await this.sendRpc('fill', [value, options]);
-    }
-    /**
-     * Clears the input field.
-     *
-     * @remarks
-     * Waits for actionability checks, focuses the element,
-     * clears it, and triggers an input event.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-clear
-     */
-    async clear(options) {
-        await this.sendRpc('clear', [options]);
-    }
-    /**
-     * Presses a single key or key combination.
-     * @param key - Key to press (e.g., "Enter", "Control+A")
-     *
-     * @remarks
-     * Focuses the element, then uses keyboard.down() and keyboard.up().
-     * Supports modifier keys like Control, Shift, Alt, Meta.
-     *
-     * @example
-     * await locator.press('Enter');
-     *
-     * @example
-     * await locator.press('Control+c');
-     *
-     * @example
-     * await locator.press('Shift+ArrowDown');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-press
-     */
-    async press(key, options) {
-        await this.sendRpc('press', [key, options]);
-    }
-    /**
-     * Types text character by character with keydown, keypress, and keyup events.
-     * @param text - Characters to type
-     *
-     * @remarks
-     * Use this for special keyboard handling. In most cases, fill() is preferred.
-     * The delay option can simulate realistic typing speed.
-     *
-     * @example
-     * await locator.pressSequentially('Hello');
-     *
-     * @example
-     * await locator.pressSequentially('World', { delay: 100 });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-press-sequentially
-     */
-    async pressSequentially(text, options) {
-        await this.sendRpc('pressSequentially', [text, options]);
-    }
-    /**
-     * Types text into the element (DEPRECATED - use fill() or pressSequentially()).
-     *
-     * @remarks
-     * This method is deprecated. Use fill() for most cases,
-     * or pressSequentially() when special keyboard handling is required.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-type
-     */
-    async type(text, options) {
-        await this.sendRpc('type', [text, options]);
-    }
-    /**
-     * Hovers over the element.
-     *
-     * @remarks
-     * Waits for actionability checks, scrolls element into view,
-     * and moves mouse to the center of the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-hover
-     */
-    async hover(options) {
-        await this.sendRpc('hover', [options]);
-    }
-    /**
-     * Performs a tap gesture on the element.
-     *
-     * @remarks
-     * Requires hasTouch option to be enabled in browser context.
-     * Waits for actionability checks before performing the tap.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-tap
-     */
-    async tap(options) {
-        await this.sendRpc('tap', [options]);
-    }
-    /**
-     * Focuses the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-focus
-     */
-    async focus(options) {
-        await this.sendRpc('focus', [options]);
-    }
-    /**
-     * Removes focus from the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-blur
-     */
-    async blur(options) {
-        await this.sendRpc('blur', [options]);
-    }
-    /**
-     * Checks a checkbox or radio button.
-     *
-     * @remarks
-     * If already checked, this method does nothing.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-check
-     */
-    async check(options) {
-        await this.sendRpc('check', [options]);
-    }
-    /**
-     * Unchecks a checkbox.
-     *
-     * @remarks
-     * If already unchecked, this method does nothing.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-uncheck
-     */
-    async uncheck(options) {
-        await this.sendRpc('uncheck', [options]);
-    }
-    /**
-     * Sets the checked state of a checkbox or radio button.
-     * @param checked - Whether to check or uncheck
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-set-checked
-     */
-    async setChecked(checked, options) {
-        await this.sendRpc('setChecked', [checked, options]);
-    }
-    /**
-     * Selects option(s) in a <select> element.
-     * @param values - Options to select by value, label, or index
-     *
-     * @remarks
-     * Waits for actionability checks, waits until all options are present,
-     * and triggers change and input events. Returns array of selected option values.
-     *
-     * @example
-     * await locator.selectOption('blue');
-     *
-     * @example
-     * await locator.selectOption({ label: 'Blue' });
-     *
-     * @example
-     * await locator.selectOption(['red', 'green', 'blue']);
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-select-option
-     */
-    async selectOption(values, options) {
-        return this.sendRpc('selectOption', [values, options]);
-    }
-    /**
-     * Selects all text content of the element.
-     *
-     * @remarks
-     * This method waits for actionability checks, then focuses the element and selects all text content.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-select-text
-     */
-    async selectText(options) {
-        await this.sendRpc('selectText', [options]);
-    }
-    /**
-     * Sets files for a file input element.
-     * @param files - File paths or file objects to upload
-     *
-     * @remarks
-     * Pass empty array to clear selected files.
-     * Supports paths, objects with name/mimeType/buffer, or directories.
-     *
-     * @example
-     * await locator.setInputFiles('file.pdf');
-     *
-     * @example
-     * await locator.setInputFiles(['file1.txt', 'file2.txt']);
-     *
-     * @example
-     * await locator.setInputFiles({ name: 'file.txt', mimeType: 'text/plain', buffer: Buffer.from('content') });
-     *
-     * @example
-     * await locator.setInputFiles([]); // Clear files
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-set-input-files
-     */
-    async setInputFiles(files, options) {
-        await this.sendRpc('setInputFiles', [files, options]);
-    }
-    /**
-     * Drags this element to the target element.
-     * @param target - Target locator to drag to
-     *
-     * @remarks
-     * Performs mousedown on source, moves to target, and releases with mouseup.
-     * Supports sourcePosition and targetPosition options for precise control.
-     *
-     * @example
-     * await source.dragTo(target);
-     *
-     * @example
-     * await source.dragTo(target, { sourcePosition: { x: 0, y: 0 } });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-drag-to
-     */
-    async dragTo(target, options) {
-        await this.sendRpc('dragTo', [target, options]);
-    }
-    /**
-     * Scrolls the element into view if not already visible.
-     *
-     * @remarks
-     * Uses IntersectionObserver to determine if element is already visible.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-scroll-into-view-if-needed
-     */
-    async scrollIntoViewIfNeeded(options) {
-        await this.sendRpc('scrollIntoViewIfNeeded', [options]);
-    }
-    /**
-     * Programmatically dispatches a DOM event on the element.
-     * @param type - DOM event type (e.g., "click", "dragstart")
-     * @param eventInit - Event initialization properties
-     *
-     * @remarks
-     * The event is created as composed, cancelable, and bubbles by default.
-     * Works regardless of element visibility state.
-     *
-     * @example
-     * await locator.dispatchEvent('click');
-     *
-     * @example
-     * await locator.dispatchEvent('dragstart', { dataTransfer });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-dispatch-event
-     */
-    async dispatchEvent(type, eventInit, options) {
-        await this.sendRpc('dispatchEvent', [type, eventInit, options]);
-    }
-    /**
-     * Highlights the element on screen (for debugging).
-     *
-     * @remarks
-     * Useful for debugging during test development. Not recommended for production tests.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-highlight
-     */
-    async highlight() {
-        await this.sendRpc('highlight', []);
-    }
-    /**
-     * Returns the number of elements matching this locator.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveCount() to avoid flakiness.
-     *
-     * @example
-     * const count = await page.getByRole('listitem').count();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-count
-     */
-    async count() {
-        return this.sendRpc('count', []);
-    }
-    /**
-     * Returns whether the element is visible.
-     *
-     * @remarks
-     * Does not wait for element to appear. For assertions, prefer expect(locator).toBeVisible().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-visible
-     */
-    async isVisible(options) {
-        return this.sendRpc('isVisible', [options]);
-    }
-    /**
-     * Returns whether the element is hidden.
-     *
-     * @remarks
-     * Opposite of isVisible(). For assertions, prefer expect(locator).toBeHidden().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-hidden
-     */
-    async isHidden(options) {
-        return this.sendRpc('isHidden', [options]);
-    }
-    /**
-     * Returns whether the element is enabled.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeEnabled().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-enabled
-     */
-    async isEnabled(options) {
-        return this.sendRpc('isEnabled', [options]);
-    }
-    /**
-     * Returns whether the element is disabled.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeDisabled().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-disabled
-     */
-    async isDisabled(options) {
-        return this.sendRpc('isDisabled', [options]);
-    }
-    /**
-     * Returns whether a checkbox or radio is checked.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeChecked().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-checked
-     */
-    async isChecked(options) {
-        return this.sendRpc('isChecked', [options]);
-    }
-    /**
-     * Returns whether the element is editable.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeEditable().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-editable
-     */
-    async isEditable(options) {
-        return this.sendRpc('isEditable', [options]);
-    }
-    /**
-     * Returns the innerHTML of the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-inner-html
-     */
-    async innerHTML(options) {
-        return this.sendRpc('innerHTML', [options]);
-    }
-    /**
-     * Returns the innerText of the element.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveText() with useInnerText option.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-inner-text
-     */
-    async innerText(options) {
-        return this.sendRpc('innerText', [options]);
-    }
-    /**
-     * Returns the textContent of the element.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveText().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-text-content
-     */
-    async textContent(options) {
-        return this.sendRpc('textContent', [options]);
-    }
-    /**
-     * Returns an array of innerText values for all matching elements.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveText() with useInnerText option.
-     *
-     * @example
-     * const texts = await page.getByRole('link').allInnerTexts();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-all-inner-texts
-     */
-    async allInnerTexts() {
-        return this.sendRpc('allInnerTexts', []);
-    }
-    /**
-     * Returns an array of textContent values for all matching elements.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveText().
-     *
-     * @example
-     * const texts = await page.getByRole('link').allTextContents();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-all-text-contents
-     */
-    async allTextContents() {
-        return this.sendRpc('allTextContents', []);
-    }
-    /**
-     * Returns the attribute value of the element.
-     * @param name - Attribute name
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-attribute
-     */
-    async getAttribute(name, options) {
-        return this.sendRpc('getAttribute', [name, options]);
-    }
-    /**
-     * Returns the input value for <input>, <textarea>, or <select> elements.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-input-value
-     */
-    async inputValue(options) {
-        return this.sendRpc('inputValue', [options]);
-    }
-    /**
-     * Returns the bounding box of the element, or null if not visible.
-     *
-     * @remarks
-     * Returns { x, y, width, height } in pixels relative to the main frame viewport.
-     * Scrolling affects the coordinates. Returns null if element is not visible.
-     *
-     * @example
-     * const box = await locator.boundingBox();
-     * await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-bounding-box
-     */
-    async boundingBox(options) {
-        return this.sendRpc('boundingBox', [options]);
-    }
-    /**
-     * Waits for element to satisfy the given state.
-     *
-     * @remarks
-     * State options: 'attached', 'detached', 'visible', 'hidden'.
-     * Returns immediately if condition is already met. Default state is 'visible'.
-     *
-     * @example
-     * await locator.waitFor();
-     *
-     * @example
-     * await locator.waitFor({ state: 'attached' });
-     *
-     * @example
-     * await locator.waitFor({ state: 'hidden', timeout: 5000 });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-wait-for
-     */
-    async waitFor(options) {
-        await this.sendRpc('waitFor', [options]);
-    }
-    /**
-     * Evaluates a function in the browser context with the element as first argument.
-     * @param pageFunction - Function to evaluate in browser context
-     * @param arg - Argument to pass to function
-     *
-     * @remarks
-     * Returns the value of the evaluated function. The function receives the DOM element as first argument.
-     *
-     * @example
-     * const tagName = await locator.evaluate(el => el.tagName);
-     *
-     * @example
-     * const text = await locator.evaluate((el, suffix) => el.textContent + suffix, '!');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-evaluate
-     */
-    async evaluate(pageFunction, arg, options) {
-        const _pageFunction = serializeFunctionSource(pageFunction);
-        return this.sendRpc('evaluate', [_pageFunction, arg, options]);
-    }
-    /**
-     * Evaluates a function with all matching elements as first argument.
-     * @param pageFunction - Function to evaluate in browser context
-     * @param arg - Argument to pass to function
-     *
-     * @remarks
-     * Does not wait for elements - returns empty array if none match.
-     *
-     * @example
-     * const count = await locator.evaluateAll(els => els.length);
-     *
-     * @example
-     * const texts = await locator.evaluateAll(els => els.map(e => e.textContent));
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-evaluate-all
-     */
-    async evaluateAll(pageFunction, arg) {
-        const _pageFunction = serializeFunctionSource(pageFunction);
-        return this.sendRpc('evaluateAll', [_pageFunction, arg]);
-    }
-    /**
-     * Returns a JSHandle with the result of the evaluation.
-     * @param pageFunction - Function to evaluate in browser context
-     * @param arg - Argument to pass to function
-     *
-     * @remarks
-     * Use when you need to retain a reference to a JavaScript object in the page. Note: JSHandle is not fully supported in the remote SDK.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-evaluate-handle
-     */
-    async evaluateHandle(pageFunction, arg) {
-        const _pageFunction = serializeFunctionSource(pageFunction);
-        return this.sendRpc('evaluateHandle', [_pageFunction, arg]);
-    }
-    /**
-     * Resolves to the ElementHandle of the element.
-     *
-     * @remarks
-     * Returns the handle to the element that matches this locator.
-     * Throws if no elements or multiple elements match.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-element-handle
-     */
-    async elementHandle(options) {
-        const result = await this.sendRpc('elementHandle', [options]);
-        return this.createElementHandle(result.id);
-    }
-    /**
-     * Resolves to all ElementHandles matching this locator.
-     *
-     * @remarks
-     * Returns an empty array if no elements match.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-element-handles
-     */
-    async elementHandles() {
-        const results = await this.sendRpc('elementHandles', []);
-        return results.map((r) => this.createElementHandle(r.id));
-    }
-    /**
-     * Returns locator to the first matching element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-first
-     */
-    first() {
-        return this.createLocator(`${this.selector} >> nth=0`);
-    }
-    /**
-     * Returns locator to the last matching element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-last
-     */
-    last() {
-        return this.createLocator(`${this.selector} >> nth=-1`);
-    }
-    /**
-     * Returns locator to the nth matching element.
-     * @param index - Zero-based index
-     *
-     * @remarks
-     * Index is zero-based. Negative indices count from the end (-1 is last).
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-nth
-     */
-    nth(index) {
-        return this.createLocator(`${this.selector} >> nth=${index}`);
-    }
-    /**
-     * Creates a locator matching descendants of this element.
-     * @param selectorOrLocator - Selector or locator to match descendants
-     *
-     * @remarks
-     * Accepts CSS, XPath, or text selectors. Can also accept another locator.
-     *
-     * @example
-     * const button = row.locator('button.submit');
-     *
-     * @example
-     * const link = section.locator('a', { hasText: 'Learn more' });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-locator
-     */
-    locator(selectorOrLocator, options) {
-        const childSelector = typeof selectorOrLocator === 'string'
-            ? selectorOrLocator
-            : selectorOrLocator.selector;
-        let newSelector = `${this.selector} >> ${childSelector}`;
-        if (options?.hasText) {
-            const text = options.hasText instanceof RegExp ? `/${options.hasText.source}/${options.hasText.flags}` : options.hasText;
-            newSelector += ` >> internal:has-text="${text}"`;
-        }
-        if (options?.hasNotText) {
-            const text = options.hasNotText instanceof RegExp ? `/${options.hasNotText.source}/${options.hasNotText.flags}` : options.hasNotText;
-            newSelector += ` >> internal:has-not-text="${text}"`;
-        }
-        if (options?.has) {
-            newSelector += ` >> internal:has="${options.has.selector}"`;
-        }
-        if (options?.hasNot) {
-            newSelector += ` >> internal:has-not="${options.hasNot.selector}"`;
-        }
-        return this.createLocator(newSelector);
-    }
-    /**
-     * Narrows the locator with additional filters.
-     *
-     * @remarks
-     * Supports has, hasNot, hasText, hasNotText, and visible options.
-     * Multiple filters can be chained.
-     *
-     * @example
-     * const row = page.locator('tr').filter({ hasText: 'John' });
-     *
-     * @example
-     * const active = items.filter({ has: page.locator('.active') });
-     *
-     * @example
-     * const noButton = rows.filter({ hasNot: page.getByRole('button') });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-filter
-     */
-    filter(options) {
-        let newSelector = this.selector;
-        if (options?.hasText) {
-            const text = options.hasText instanceof RegExp ? `/${options.hasText.source}/${options.hasText.flags}` : options.hasText;
-            newSelector += ` >> internal:has-text="${text}"`;
-        }
-        if (options?.hasNotText) {
-            const text = options.hasNotText instanceof RegExp ? `/${options.hasNotText.source}/${options.hasNotText.flags}` : options.hasNotText;
-            newSelector += ` >> internal:has-not-text="${text}"`;
-        }
-        if (options?.has) {
-            const hasSelector = typeof options.has === 'string' ? options.has : options.has.selector;
-            newSelector += ` >> internal:has="${hasSelector}"`;
-        }
-        if (options?.hasNot) {
-            const hasNotSelector = typeof options.hasNot === 'string' ? options.hasNot : options.hasNot.selector;
-            newSelector += ` >> internal:has-not="${hasNotSelector}"`;
-        }
-        return this.createLocator(newSelector);
-    }
-    /**
-     * Creates a locator that matches both this locator AND the argument.
-     * @param locator - Additional locator to match
-     *
-     * @remarks
-     * Both conditions must be satisfied for an element to match.
-     *
-     * @example
-     * const button = page.getByRole('button').and(page.getByTitle('Subscribe'));
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-and
-     */
-    and(locator) {
-        return this.createLocator(`${this.selector} >> internal:and="${locator.selector}"`);
-    }
-    /**
-     * Creates a locator that matches this locator OR the argument.
-     * @param locator - Alternative locator to match
-     *
-     * @remarks
-     * Either condition being satisfied will match. Be careful with strict mode -
-     * if both match, use .first() to select one.
-     *
-     * @example
-     * const btnOrLink = page.getByRole('button').or(page.getByRole('link'));
-     *
-     * @example
-     * await btnOrLink.first().click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-or
-     */
-    or(locator) {
-        return this.createLocator(`${this.selector} >> internal:or="${locator.selector}"`);
-    }
-    /**
-     * Returns array of locators pointing to all matching elements.
-     *
-     * @remarks
-     * Does not wait for elements. Use with caution on dynamic lists.
-     * Wait for the list to stabilize before calling.
-     *
-     * @example
-     * for (const li of await page.getByRole('listitem').all()) {
-     *   await li.click();
-     * }
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-all
-     */
-    async all() {
-        const count = await this.count();
-        const locators = [];
-        for (let i = 0; i < count; i++) {
-            locators.push(this.nth(i));
-        }
-        return locators;
-    }
-    /**
-     * Locates elements by their ARIA role.
-     * @param role - ARIA role to match
-     *
-     * @remarks
-     * Matches by implicit ARIA role (e.g., <button>) or explicit role attribute.
-     * Options include name, checked, disabled, expanded, etc.
-     *
-     * @example
-     * await locator.getByRole('button', { name: 'Submit' }).click();
-     *
-     * @example
-     * await locator.getByRole('checkbox', { checked: true });
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-role
-     */
-    getByRole(role, options) {
-        let roleSelector = `role=${role}`;
-        if (options?.name) {
-            const name = options.name instanceof RegExp ? `/${options.name.source}/${options.name.flags}` : JSON.stringify(options.name);
-            roleSelector += `[name=${name}]`;
-        }
-        if (options?.checked !== undefined)
-            roleSelector += `[checked=${options.checked}]`;
-        if (options?.disabled !== undefined)
-            roleSelector += `[disabled=${options.disabled}]`;
-        if (options?.expanded !== undefined)
-            roleSelector += `[expanded=${options.expanded}]`;
-        if (options?.includeHidden !== undefined)
-            roleSelector += `[include-hidden=${options.includeHidden}]`;
-        if (options?.level !== undefined)
-            roleSelector += `[level=${options.level}]`;
-        if (options?.pressed !== undefined)
-            roleSelector += `[pressed=${options.pressed}]`;
-        if (options?.selected !== undefined)
-            roleSelector += `[selected=${options.selected}]`;
-        if (options?.exact !== undefined)
-            roleSelector += `[exact=${options.exact}]`;
-        return this.createLocator(`${this.selector} >> ${roleSelector}`);
-    }
-    /**
-     * Locates elements containing the specified text.
-     * @param text - Text or pattern to match
-     *
-     * @remarks
-     * Matches case-insensitively by default. Use exact: true for exact match.
-     *
-     * @example
-     * await locator.getByText('Welcome').click();
-     *
-     * @example
-     * await locator.getByText(/hello/i).click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-text
-     */
-    getByText(text, options) {
-        const textStr = text instanceof RegExp ? `/${text.source}/${text.flags}` : JSON.stringify(text);
-        let textSelector = `internal:text=${textStr}`;
-        if (options?.exact)
-            textSelector += `s`;
-        return this.createLocator(`${this.selector} >> ${textSelector}`);
-    }
-    /**
-     * Locates form elements by their associated label text.
-     * @param text - Label text or pattern
-     *
-     * @remarks
-     * Matches <label> text, aria-label, or aria-labelledby.
-     *
-     * @example
-     * await locator.getByLabel('Email').fill('test@example.com');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-label
-     */
-    getByLabel(text, options) {
-        const textStr = text instanceof RegExp ? `/${text.source}/${text.flags}` : JSON.stringify(text);
-        let labelSelector = `internal:label=${textStr}`;
-        if (options?.exact)
-            labelSelector += `s`;
-        return this.createLocator(`${this.selector} >> ${labelSelector}`);
-    }
-    /**
-     * Locates input elements by their placeholder text.
-     * @param text - Placeholder text or pattern
-     *
-     * @example
-     * await locator.getByPlaceholder('Search...').fill('query');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-placeholder
-     */
-    getByPlaceholder(text, options) {
-        const textStr = text instanceof RegExp ? `/${text.source}/${text.flags}` : JSON.stringify(text);
-        let placeholderSelector = `internal:attr=[placeholder=${textStr}]`;
-        if (options?.exact)
-            placeholderSelector += `s`;
-        return this.createLocator(`${this.selector} >> ${placeholderSelector}`);
-    }
-    /**
-     * Locates elements by their alt attribute (typically images).
-     * @param text - Alt text or pattern
-     *
-     * @example
-     * await locator.getByAltText('Company Logo').click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-alt-text
-     */
-    getByAltText(text, options) {
-        const textStr = text instanceof RegExp ? `/${text.source}/${text.flags}` : JSON.stringify(text);
-        let altSelector = `internal:attr=[alt=${textStr}]`;
-        if (options?.exact)
-            altSelector += `s`;
-        return this.createLocator(`${this.selector} >> ${altSelector}`);
-    }
-    /**
-     * Locates elements by their title attribute.
-     * @param text - Title attribute text or pattern
-     *
-     * @example
-     * await locator.getByTitle('More information').click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-title
-     */
-    getByTitle(text, options) {
-        const textStr = text instanceof RegExp ? `/${text.source}/${text.flags}` : JSON.stringify(text);
-        let titleSelector = `internal:attr=[title=${textStr}]`;
-        if (options?.exact)
-            titleSelector += `s`;
-        return this.createLocator(`${this.selector} >> ${titleSelector}`);
-    }
-    /**
-     * Locates elements by their test ID attribute.
-     * @param testId - Test ID value or pattern
-     *
-     * @remarks
-     * Default attribute is data-testid. Can be configured via selectors.setTestIdAttribute().
-     *
-     * @example
-     * await locator.getByTestId('submit-button').click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-by-test-id
-     */
-    getByTestId(testId) {
-        const testIdStr = testId instanceof RegExp ? `/${testId.source}/${testId.flags}` : JSON.stringify(testId);
-        return this.createLocator(`${this.selector} >> internal:testid=${testIdStr}`);
-    }
-    /**
-     * Returns a FrameLocator pointing to the iframe this locator points to.
-     *
-     * @remarks
-     * Useful when you have a Locator to an iframe and want to interact with its content.
-     *
-     * @example
-     * const frameLocator = locator.contentFrame();
-     * await frameLocator.getByRole('button').click();
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-content-frame
-     */
-    contentFrame() {
-        return this.createFrameLocator(this.selector);
-    }
-    /**
-     * Returns a FrameLocator for an iframe within this element.
-     * @param selector - CSS selector for iframe
-     *
-     * @remarks
-     * Use to interact with content inside iframes.
-     *
-     * @example
-     * const frame = locator.frameLocator('iframe.content');
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-frame-locator
-     */
-    frameLocator(selector) {
-        return this.createFrameLocator(`${this.selector} >> ${selector}`);
-    }
-    /**
-     * Returns the Page that this locator belongs to.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-page
-     */
-    page() {
-        return this._page;
-    }
-}