@bctrl/sdk 1.0.1 → 1.0.3

package/dist/drivers/playwright/generated/locator.d.ts

@@ -1,795 +0,0 @@
-/**
- * AUTO-GENERATED FILE - DO NOT EDIT
- *
- * Generated from: packages/automation-spec/src/drivers/playwright/methods/
- * Run `pnpm generate:playwright` to regenerate.
- */
-import type { SimpleRpcSender } from '../../../internal/transport.js';
-import type { PlaywrightAriaRole, PlaywrightBlurOptions, PlaywrightBoundingBox, PlaywrightBoundingBoxOptions, PlaywrightCheckOptions, PlaywrightClearOptions, PlaywrightClickOptions, PlaywrightDblclickOptions, PlaywrightDispatchEventOptions, PlaywrightDragToOptions, PlaywrightEvaluateOptions, PlaywrightFilePayload, PlaywrightFillOptions, PlaywrightFocusOptions, PlaywrightGetByAltTextOptions, PlaywrightGetByLabelOptions, PlaywrightGetByPlaceholderOptions, PlaywrightGetByRoleOptions, PlaywrightGetByTextOptions, PlaywrightGetByTitleOptions, PlaywrightHoverOptions, PlaywrightLocatorFilterOptions, PlaywrightLocatorOptions, PlaywrightPressOptions, PlaywrightPressSequentiallyOptions, PlaywrightScreenshotOptions, PlaywrightScrollIntoViewIfNeededOptions, PlaywrightSelectOptionOptions, PlaywrightSelectOptionValue, PlaywrightSetCheckedOptions, PlaywrightSetInputFilesOptions, PlaywrightTapOptions, PlaywrightUncheckOptions, PlaywrightWaitForOptions } from '../types.js';
-import { RemotePlaywrightElementHandle } from './element-handle.js';
-import { RemotePlaywrightFrameLocator } from './frame-locator.js';
-import type { RemotePlaywrightPage } from './page.js';
-/** Factory function for creating element handles */
-export type ElementHandleFactory = (handleId: string) => RemotePlaywrightElementHandle;
-/** Factory function for creating locators */
-export type LocatorFactory = (selector: string, parent?: RemotePlaywrightLocator) => RemotePlaywrightLocator;
-/** Factory function for creating frame locators */
-export type FrameLocatorFactory = (selector: string) => RemotePlaywrightFrameLocator;
-/**
- * Internal state for RemotePlaywrightLocator configuration.
- */
-interface RemotePlaywrightLocatorState {
-    /** Timeout in milliseconds for actions */
-    timeout: number;
-}
-/**
- * RemotePlaywrightLocator - Remote Playwright Locator API over RPC.
- *
- * @see https://playwright.dev/docs/api/class-locator
- */
-export declare class RemotePlaywrightLocator {
-    private _state;
-    readonly selector: string;
-    private sendRpc;
-    private createElementHandle;
-    private createLocator;
-    private createFrameLocator;
-    private readonly _page;
-    constructor(selector: string, sendRpc: SimpleRpcSender, createElementHandle: ElementHandleFactory, createLocator: LocatorFactory, createFrameLocator: FrameLocatorFactory, _page: RemotePlaywrightPage, state?: Partial<RemotePlaywrightLocatorState>);
-    /**
-     * 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: number): RemotePlaywrightLocator;
-    /**
-     * Takes a screenshot of the element.
-     * @see https://playwright.dev/docs/api/class-locator#locator-screenshot
-     */
-    screenshot(options?: PlaywrightScreenshotOptions): Promise<Buffer>;
-    /**
-     * Clones the locator.
-     * @returns A new locator with the same configuration.
-     */
-    clone(): RemotePlaywrightLocator;
-    /**
-     * 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
-     */
-    click(options?: PlaywrightClickOptions): Promise<void>;
-    /**
-     * 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
-     */
-    dblclick(options?: PlaywrightDblclickOptions): Promise<void>;
-    /**
-     * 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
-     */
-    fill(value: string, options?: PlaywrightFillOptions): Promise<void>;
-    /**
-     * 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
-     */
-    clear(options?: PlaywrightClearOptions): Promise<void>;
-    /**
-     * 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
-     */
-    press(key: string, options?: PlaywrightPressOptions): Promise<void>;
-    /**
-     * 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
-     */
-    pressSequentially(text: string, options?: PlaywrightPressSequentiallyOptions): Promise<void>;
-    /**
-     * 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
-     */
-    type(text: string, options?: {
-        delay?: number;
-        noWaitAfter?: boolean;
-        timeout?: number;
-    }): Promise<void>;
-    /**
-     * 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
-     */
-    hover(options?: PlaywrightHoverOptions): Promise<void>;
-    /**
-     * 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
-     */
-    tap(options?: PlaywrightTapOptions): Promise<void>;
-    /**
-     * Focuses the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-focus
-     */
-    focus(options?: PlaywrightFocusOptions): Promise<void>;
-    /**
-     * Removes focus from the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-blur
-     */
-    blur(options?: PlaywrightBlurOptions): Promise<void>;
-    /**
-     * Checks a checkbox or radio button.
-     *
-     * @remarks
-     * If already checked, this method does nothing.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-check
-     */
-    check(options?: PlaywrightCheckOptions): Promise<void>;
-    /**
-     * Unchecks a checkbox.
-     *
-     * @remarks
-     * If already unchecked, this method does nothing.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-uncheck
-     */
-    uncheck(options?: PlaywrightUncheckOptions): Promise<void>;
-    /**
-     * 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
-     */
-    setChecked(checked: boolean, options?: PlaywrightSetCheckedOptions): Promise<void>;
-    /**
-     * 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
-     */
-    selectOption(values: string | string[] | PlaywrightSelectOptionValue | PlaywrightSelectOptionValue[], options?: PlaywrightSelectOptionOptions): Promise<string[]>;
-    /**
-     * 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
-     */
-    selectText(options?: {
-        force?: boolean;
-        timeout?: number;
-    }): Promise<void>;
-    /**
-     * 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
-     */
-    setInputFiles(files: string | string[] | PlaywrightFilePayload | PlaywrightFilePayload[], options?: PlaywrightSetInputFilesOptions): Promise<void>;
-    /**
-     * 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
-     */
-    dragTo(target: RemotePlaywrightLocator, options?: PlaywrightDragToOptions): Promise<void>;
-    /**
-     * 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
-     */
-    scrollIntoViewIfNeeded(options?: PlaywrightScrollIntoViewIfNeededOptions): Promise<void>;
-    /**
-     * 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
-     */
-    dispatchEvent(type: string, eventInit?: Record<string, unknown>, options?: PlaywrightDispatchEventOptions): Promise<void>;
-    /**
-     * 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
-     */
-    highlight(): Promise<void>;
-    /**
-     * 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
-     */
-    count(): Promise<number>;
-    /**
-     * 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
-     */
-    isVisible(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 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
-     */
-    isHidden(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * Returns whether the element is enabled.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeEnabled().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-enabled
-     */
-    isEnabled(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * Returns whether the element is disabled.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeDisabled().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-disabled
-     */
-    isDisabled(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 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
-     */
-    isChecked(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * Returns whether the element is editable.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toBeEditable().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-is-editable
-     */
-    isEditable(options?: {
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * Returns the innerHTML of the element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-inner-html
-     */
-    innerHTML(options?: {
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 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
-     */
-    innerText(options?: {
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * Returns the textContent of the element.
-     *
-     * @remarks
-     * For assertions, prefer expect(locator).toHaveText().
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-text-content
-     */
-    textContent(options?: {
-        timeout?: number;
-    }): Promise<string | null>;
-    /**
-     * 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
-     */
-    allInnerTexts(): Promise<string[]>;
-    /**
-     * 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
-     */
-    allTextContents(): Promise<string[]>;
-    /**
-     * Returns the attribute value of the element.
-     * @param name - Attribute name
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-get-attribute
-     */
-    getAttribute(name: string, options?: {
-        timeout?: number;
-    }): Promise<string | null>;
-    /**
-     * Returns the input value for <input>, <textarea>, or <select> elements.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-input-value
-     */
-    inputValue(options?: {
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 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
-     */
-    boundingBox(options?: PlaywrightBoundingBoxOptions): Promise<PlaywrightBoundingBox | null>;
-    /**
-     * 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
-     */
-    waitFor(options?: PlaywrightWaitForOptions): Promise<void>;
-    /**
-     * 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
-     */
-    evaluate<R, Arg = unknown>(pageFunction: string | ((element: Element, arg: Arg) => R | Promise<R>), arg?: Arg, options?: PlaywrightEvaluateOptions): Promise<R>;
-    /**
-     * 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
-     */
-    evaluateAll<R, Arg = unknown>(pageFunction: string | ((elements: Element[], arg: Arg) => R | Promise<R>), arg?: Arg): Promise<R>;
-    /**
-     * 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
-     */
-    evaluateHandle<R, Arg = unknown>(pageFunction: string | ((element: Element, arg: Arg) => R | Promise<R>), arg?: Arg): Promise<unknown>;
-    /**
-     * 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
-     */
-    elementHandle(options?: {
-        timeout?: number;
-    }): Promise<RemotePlaywrightElementHandle>;
-    /**
-     * 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
-     */
-    elementHandles(): Promise<RemotePlaywrightElementHandle[]>;
-    /**
-     * Returns locator to the first matching element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-first
-     */
-    first(): RemotePlaywrightLocator;
-    /**
-     * Returns locator to the last matching element.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-last
-     */
-    last(): RemotePlaywrightLocator;
-    /**
-     * 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: number): RemotePlaywrightLocator;
-    /**
-     * 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: string | RemotePlaywrightLocator, options?: PlaywrightLocatorOptions): RemotePlaywrightLocator;
-    /**
-     * 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?: PlaywrightLocatorFilterOptions): RemotePlaywrightLocator;
-    /**
-     * 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: RemotePlaywrightLocator): RemotePlaywrightLocator;
-    /**
-     * 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: RemotePlaywrightLocator): RemotePlaywrightLocator;
-    /**
-     * 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
-     */
-    all(): Promise<RemotePlaywrightLocator[]>;
-    /**
-     * 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: PlaywrightAriaRole, options?: PlaywrightGetByRoleOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp, options?: PlaywrightGetByTextOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp, options?: PlaywrightGetByLabelOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp, options?: PlaywrightGetByPlaceholderOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp, options?: PlaywrightGetByAltTextOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp, options?: PlaywrightGetByTitleOptions): RemotePlaywrightLocator;
-    /**
-     * 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: string | RegExp): RemotePlaywrightLocator;
-    /**
-     * 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(): RemotePlaywrightFrameLocator;
-    /**
-     * 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: string): RemotePlaywrightFrameLocator;
-    /**
-     * Returns the Page that this locator belongs to.
-     *
-     * @see https://playwright.dev/docs/api/class-locator#locator-page
-     */
-    page(): RemotePlaywrightPage;
-}
-export {};