@taqwright/taqwright 0.0.24

package/dist/keys.d.ts

@@ -0,0 +1,3 @@
+export declare const KEY_TO_UNICODE: Readonly<Record<string, string>>;
+export declare const ANDROID_NAMED_KEYS: Readonly<Record<string, number>>;
+export declare const IOS_NAMED_KEYS: Readonly<Record<string, string>>;

package/dist/keys.js

@@ -0,0 +1,28 @@
+export const KEY_TO_UNICODE = {
+    Enter: '\n',
+    Tab: '\t',
+    Backspace: '\b',
+    Space: ' ',
+};
+export const ANDROID_NAMED_KEYS = {
+    ArrowUp: 19,
+    ArrowDown: 20,
+    ArrowLeft: 21,
+    ArrowRight: 22,
+    Delete: 112,
+    Escape: 111,
+    Home: 122,
+    End: 123,
+    PageUp: 92,
+    PageDown: 93,
+};
+export const IOS_NAMED_KEYS = {
+    Enter: 'enter',
+    Tab: 'tab',
+    Backspace: 'delete',
+    ArrowUp: 'up',
+    ArrowDown: 'down',
+    ArrowLeft: 'left',
+    ArrowRight: 'right',
+    Escape: 'escape',
+};

package/dist/locator/index.d.ts

@@ -0,0 +1,206 @@
+import type { Client as WebDriverClient } from 'webdriver';
+import { type BoundingBox, type LocatorDescriptor, type LocatorStrategy, Platform, type ScrollDirection } from '../types/index.js';
+declare const DEFAULT_TIMEOUT = 30000;
+export interface ActionOptions {
+    timeout?: number;
+}
+export interface WaitForOptions extends ActionOptions {
+    state?: 'visible' | 'hidden' | 'attached' | 'enabled' | 'disabled';
+}
+export interface LongPressOptions extends ActionOptions {
+    duration?: number;
+}
+export interface DragOptions extends ActionOptions {
+    duration?: number;
+    moveDuration?: number;
+    speed?: number;
+    from?: {
+        x?: number;
+        y?: number;
+    };
+    to?: {
+        x?: number;
+        y?: number;
+    };
+}
+export interface ElementSwipeOptions {
+    duration?: number;
+    distance?: number;
+    from?: {
+        x?: number;
+        y?: number;
+    };
+    to?: {
+        x?: number;
+        y?: number;
+    };
+}
+export interface ScrollIntoViewOptions {
+    direction?: ScrollDirection;
+    maxAttempts?: number;
+    visibleTimeout?: number;
+    duration?: number;
+    distance?: number;
+    from?: {
+        x?: number;
+        y?: number;
+    };
+    to?: {
+        x?: number;
+        y?: number;
+    };
+    forceGesture?: boolean;
+    bottomMargin?: number;
+}
+export interface LocatorContext {
+    driver: WebDriverClient;
+    platform: Platform;
+    defaultTimeout: number;
+}
+export interface SelectOptionInput {
+    label?: string;
+    index?: number;
+    date?: string;
+    time?: string;
+}
+export interface PressSequentiallyOptions extends ActionOptions {
+    delay?: number;
+}
+export interface LocatorFilterOptions {
+    has?: Locator;
+    hasNot?: Locator;
+    hasText?: string | RegExp;
+    hasNotText?: string | RegExp;
+    visible?: boolean;
+}
+interface IndexSelector {
+    kind: 'first' | 'last' | 'nth';
+    n?: number;
+}
+type ChainOp = {
+    kind: 'filter';
+    filter: LocatorFilterOptions;
+} | {
+    kind: 'and';
+    other: Locator;
+} | {
+    kind: 'or';
+    other: Locator;
+};
+interface LocatorChainState {
+    parent?: Locator;
+    chainOps: ChainOp[];
+    indexSelector?: IndexSelector;
+}
+export declare class Locator {
+    private readonly ctx;
+    private readonly strategy;
+    private readonly state;
+    private readonly pinnedIds?;
+    constructor(ctx: LocatorContext, strategy: LocatorStrategy, state?: LocatorChainState, pinnedIds?: readonly string[]);
+    static fromStrategy(ctx: LocatorContext, strategy: LocatorStrategy): Locator;
+    private static pinnedToIds;
+    private derive;
+    private rebaseRoot;
+    click(opts?: ActionOptions): Promise<void>;
+    tap(opts?: ActionOptions): Promise<void>;
+    clickWithCoordFallback(opts?: ActionOptions): Promise<void>;
+    doubleClick(opts?: ActionOptions): Promise<void>;
+    doubleTap(opts?: ActionOptions): Promise<void>;
+    longPress(opts?: LongPressOptions): Promise<void>;
+    clear(opts?: ActionOptions): Promise<void>;
+    fill(value: string, opts?: ActionOptions): Promise<void>;
+    private typeInto;
+    private findEditableNode;
+    private findEditableDescendant;
+    private isEditableElement;
+    sendKeyStrokes(value: string, opts?: ActionOptions): Promise<void>;
+    focus(opts?: ActionOptions): Promise<void>;
+    blur(_opts?: ActionOptions): Promise<void>;
+    isChecked(opts?: ActionOptions): Promise<boolean>;
+    check(opts?: ActionOptions): Promise<void>;
+    uncheck(opts?: ActionOptions): Promise<void>;
+    private readChecked;
+    private waitForChecked;
+    press(key: string, opts?: ActionOptions): Promise<void>;
+    pressSequentially(text: string, opts?: PressSequentiallyOptions): Promise<void>;
+    selectOption(value: string | SelectOptionInput, opts?: ActionOptions): Promise<void>;
+    private detectPickerType;
+    private selectPickerWheel;
+    private selectIosDatePicker;
+    private selectAndroidSpinner;
+    private selectAndroidDatePicker;
+    private selectAndroidTimePicker;
+    private selectMenuOption;
+    screenshot(opts?: ActionOptions): Promise<Buffer>;
+    scrollIntoView(opts?: ScrollIntoViewOptions): Promise<void>;
+    private nudgeAboveBottom;
+    private scrollUntilVisible;
+    swipeLeft(opts?: ElementSwipeOptions): Promise<void>;
+    swipeRight(opts?: ElementSwipeOptions): Promise<void>;
+    swipeUp(opts?: ElementSwipeOptions): Promise<void>;
+    swipeDown(opts?: ElementSwipeOptions): Promise<void>;
+    pinchIn(opts?: ActionOptions): Promise<void>;
+    pinchOut(opts?: ActionOptions): Promise<void>;
+    private iosTwoFingerPinch;
+    dragTo(target: Locator, opts?: DragOptions): Promise<void>;
+    dragToPoint(point: {
+        x: number;
+        y: number;
+    }, opts?: DragOptions): Promise<void>;
+    isVisible(opts?: ActionOptions): Promise<boolean>;
+    isEnabled(opts?: ActionOptions): Promise<boolean>;
+    getText(opts?: ActionOptions): Promise<string>;
+    getValue(opts?: ActionOptions): Promise<string>;
+    boundingBox(opts?: ActionOptions): Promise<BoundingBox>;
+    getAttribute(name: string, opts?: ActionOptions): Promise<string | null>;
+    isFocused(opts?: ActionOptions): Promise<boolean>;
+    isEditable(opts?: ActionOptions): Promise<boolean>;
+    isInViewport(opts?: ActionOptions): Promise<boolean>;
+    isEmpty(opts?: ActionOptions): Promise<boolean>;
+    assertVisible(opts?: ActionOptions): Promise<void>;
+    assertHidden(opts?: ActionOptions): Promise<void>;
+    assertEnabled(opts?: ActionOptions): Promise<void>;
+    assertDisabled(opts?: ActionOptions): Promise<void>;
+    assertChecked(opts?: ActionOptions): Promise<void>;
+    assertUnchecked(opts?: ActionOptions): Promise<void>;
+    assertAttached(opts?: ActionOptions): Promise<void>;
+    assertEditable(opts?: ActionOptions): Promise<void>;
+    assertReadonly(opts?: ActionOptions): Promise<void>;
+    assertFocused(opts?: ActionOptions): Promise<void>;
+    assertEmpty(opts?: ActionOptions): Promise<void>;
+    assertInViewport(opts?: ActionOptions): Promise<void>;
+    assertCount(expected: number, opts?: ActionOptions): Promise<void>;
+    assertAttribute(name: string, expected: string | RegExp, opts?: ActionOptions): Promise<void>;
+    private pollBooleanQuery;
+    assertText(expected: string | RegExp, opts?: ActionOptions): Promise<void>;
+    assertContainsText(expected: string, opts?: ActionOptions): Promise<void>;
+    assertValue(expected: string | RegExp, opts?: ActionOptions): Promise<void>;
+    private assertGetter;
+    waitFor(opts?: WaitForOptions): Promise<void>;
+    filter(opts: LocatorFilterOptions): Locator;
+    first(): Locator;
+    last(): Locator;
+    nth(n: number): Locator;
+    locator(child: Locator | LocatorStrategy): Locator;
+    and(other: Locator): Locator;
+    or(other: Locator): Locator;
+    count(): Promise<number>;
+    all(): Promise<Locator[]>;
+    allInnerTexts(): Promise<string[]>;
+    allTextContents(): Promise<string[]>;
+    private readElementText;
+    private matchesState;
+    private resolveAll;
+    private resolveOnce;
+    private elementMatchesText;
+    private filterIdsByText;
+    private applyFilterOp;
+    private existsUnder;
+    private resolveVisible;
+    private resolveActionable;
+    private swipeElement;
+    private executeDrag;
+}
+export { DEFAULT_TIMEOUT as DEFAULT_LOCATOR_TIMEOUT };
+export declare function buildLocatorFromDescriptor(ctx: LocatorContext, desc: LocatorDescriptor): Locator;