@applitools/driver 1.4.17-beta.2 → 1.5.2

package/types/driver.d.ts

@@ -1,67 +1,67 @@
-/// <reference types="node" />
-import type * as types from '@applitools/types';
-import { Context, ContextReference } from './context';
-import { Element } from './element';
-import { HelperIOS } from './helper-ios';
-import { HelperAndroid } from './helper-android';
-export declare class Driver<TDriver, TContext, TElement, TSelector> {
-    private _target;
-    private _mainContext;
-    private _currentContext;
-    private _driverInfo;
-    private _logger;
-    private _helper?;
-    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-    constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        driver: Driver<TDriver, TContext, TElement, TSelector> | TDriver;
-        logger?: any;
-    });
-    get target(): TDriver;
-    get currentContext(): Context<TDriver, TContext, TElement, TSelector>;
-    get mainContext(): Context<TDriver, TContext, TElement, TSelector>;
-    get helper(): HelperAndroid<TDriver, TContext, TElement, TSelector> | HelperIOS<TDriver, TContext, TElement, TSelector>;
-    get features(): {
-        shadowSelector?: boolean;
-        allCookies?: boolean;
-    };
-    get deviceName(): string;
-    get platformName(): string;
-    get platformVersion(): string | number;
-    get browserName(): string;
-    get browserVersion(): string | number;
-    get userAgent(): string;
-    get orientation(): 'portrait' | 'landscape';
-    get pixelRatio(): number;
-    get viewportScale(): number;
-    get statusBarHeight(): number;
-    get navigationBarHeight(): number;
-    get isNative(): boolean;
-    get isWeb(): boolean;
-    get isMobile(): boolean;
-    get isIOS(): boolean;
-    get isAndroid(): boolean;
-    get isIE(): boolean;
-    get isEdgeLegacy(): boolean;
-    updateCurrentContext(context: Context<TDriver, TContext, TElement, TSelector>): void;
-    init(): Promise<this>;
-    refreshContexts(): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    switchTo(context: Context<TDriver, TContext, TElement, TSelector>): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    switchToMainContext(): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    switchToParentContext(elevation?: number): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    switchToChildContext(...references: ContextReference<TDriver, TContext, TElement, TSelector>[]): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    normalizeRegion(region: types.Region): Promise<types.Region>;
-    getRegionInViewport(context: Context<TDriver, TContext, TElement, TSelector>, region: types.Region): Promise<types.Region>;
-    element(selector: types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
-    elements(selector: types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
-    execute(script: ((arg: any) => any) | string, arg?: any): Promise<any>;
-    takeScreenshot(): Promise<Buffer>;
-    getViewportSize(): Promise<types.Size>;
-    setViewportSize(size: types.Size): Promise<void>;
-    getDisplaySize(): Promise<types.Size>;
-    getOrientation(): Promise<'portrait' | 'landscape'>;
-    getCookies(): Promise<types.Cookie[]>;
-    getTitle(): Promise<string>;
-    getUrl(): Promise<string>;
-    visit(url: string): Promise<void>;
-}
+/// <reference types="node" />
+import type * as types from '@applitools/types';
+import { Context, ContextReference } from './context';
+import { Element } from './element';
+import { HelperIOS } from './helper-ios';
+import { HelperAndroid } from './helper-android';
+export declare class Driver<TDriver, TContext, TElement, TSelector> {
+    private _target;
+    private _mainContext;
+    private _currentContext;
+    private _driverInfo;
+    private _logger;
+    private _helper?;
+    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    constructor(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        driver: Driver<TDriver, TContext, TElement, TSelector> | TDriver;
+        logger?: any;
+    });
+    get target(): TDriver;
+    get currentContext(): Context<TDriver, TContext, TElement, TSelector>;
+    get mainContext(): Context<TDriver, TContext, TElement, TSelector>;
+    get helper(): HelperAndroid<TDriver, TContext, TElement, TSelector> | HelperIOS<TDriver, TContext, TElement, TSelector>;
+    get features(): {
+        shadowSelector?: boolean;
+        allCookies?: boolean;
+    };
+    get deviceName(): string;
+    get platformName(): string;
+    get platformVersion(): string | number;
+    get browserName(): string;
+    get browserVersion(): string | number;
+    get userAgent(): string;
+    get orientation(): 'portrait' | 'landscape';
+    get pixelRatio(): number;
+    get viewportScale(): number;
+    get statusBarHeight(): number;
+    get navigationBarHeight(): number;
+    get isNative(): boolean;
+    get isWeb(): boolean;
+    get isMobile(): boolean;
+    get isIOS(): boolean;
+    get isAndroid(): boolean;
+    get isIE(): boolean;
+    get isEdgeLegacy(): boolean;
+    updateCurrentContext(context: Context<TDriver, TContext, TElement, TSelector>): void;
+    init(): Promise<this>;
+    refreshContexts(): Promise<Context<TDriver, TContext, TElement, TSelector>>;
+    switchTo(context: Context<TDriver, TContext, TElement, TSelector>): Promise<Context<TDriver, TContext, TElement, TSelector>>;
+    switchToMainContext(): Promise<Context<TDriver, TContext, TElement, TSelector>>;
+    switchToParentContext(elevation?: number): Promise<Context<TDriver, TContext, TElement, TSelector>>;
+    switchToChildContext(...references: ContextReference<TDriver, TContext, TElement, TSelector>[]): Promise<Context<TDriver, TContext, TElement, TSelector>>;
+    normalizeRegion(region: types.Region): Promise<types.Region>;
+    getRegionInViewport(context: Context<TDriver, TContext, TElement, TSelector>, region: types.Region): Promise<types.Region>;
+    element(selector: types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
+    elements(selector: types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
+    execute(script: ((arg: any) => any) | string, arg?: any): Promise<any>;
+    takeScreenshot(): Promise<Buffer>;
+    getViewportSize(): Promise<types.Size>;
+    setViewportSize(size: types.Size): Promise<void>;
+    getDisplaySize(): Promise<types.Size>;
+    getOrientation(): Promise<'portrait' | 'landscape'>;
+    getCookies(): Promise<types.Cookie[]>;
+    getTitle(): Promise<string>;
+    getUrl(): Promise<string>;
+    visit(url: string): Promise<void>;
+}

package/types/element.d.ts

@@ -1,56 +1,56 @@
-import type * as types from '@applitools/types';
-import type { Context } from './context';
-export declare type ElementState = {
-    contentSize?: types.Size;
-    scrollOffset?: types.Location;
-    transforms?: any;
-};
-export declare class Element<TDriver, TContext, TElement, TSelector> {
-    private _target;
-    private _context;
-    private _selector;
-    private _index;
-    private _state;
-    private _originalOverflow;
-    private _touchPadding;
-    private _logger;
-    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-    constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        element?: TElement | Element<TDriver, TContext, TElement, TSelector>;
-        context?: Context<TDriver, TContext, TElement, TSelector>;
-        selector?: types.Selector<TSelector>;
-        index?: number;
-        logger?: any;
-    });
-    get target(): TElement;
-    get selector(): types.Selector<TSelector>;
-    get context(): Context<TDriver, TContext, TElement, TSelector>;
-    get driver(): import("./driver").Driver<TDriver, TContext, TElement, TSelector>;
-    get isRef(): boolean;
-    equals(element: Element<TDriver, TContext, TElement, TSelector> | TElement): Promise<boolean>;
-    init(context: Context<TDriver, TContext, TElement, TSelector>): Promise<this>;
-    getRegion(): Promise<types.Region>;
-    getClientRegion(): Promise<types.Region>;
-    getContentSize(): Promise<types.Size>;
-    isScrollable(): Promise<boolean>;
-    isRoot(): Promise<boolean>;
-    getTouchPadding(): Promise<number>;
-    getText(): Promise<string>;
-    getAttribute(name: string): Promise<string>;
-    setAttribute(name: string, value: string): Promise<void>;
-    scrollTo(offset: types.Location): Promise<types.Location>;
-    translateTo(offset: types.Location): Promise<types.Location>;
-    getScrollOffset(): Promise<types.Location>;
-    getTranslateOffset(): Promise<types.Location>;
-    getInnerOffset(): Promise<types.Location>;
-    click(): Promise<void>;
-    type(value: string): Promise<void>;
-    preserveState(): Promise<ElementState>;
-    restoreState(state?: ElementState): Promise<void>;
-    hideScrollbars(): Promise<void>;
-    restoreScrollbars(): Promise<void>;
-    refresh(freshElement?: TElement): Promise<boolean>;
-    withRefresh<TResult>(operation: (...args: any[]) => TResult): Promise<TResult>;
-    toJSON(): TElement;
-}
+import type * as types from '@applitools/types';
+import type { Context } from './context';
+export declare type ElementState = {
+    contentSize?: types.Size;
+    scrollOffset?: types.Location;
+    transforms?: any;
+};
+export declare class Element<TDriver, TContext, TElement, TSelector> {
+    private _target;
+    private _context;
+    private _selector;
+    private _index;
+    private _state;
+    private _originalOverflow;
+    private _touchPadding;
+    private _logger;
+    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    constructor(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        element?: TElement | Element<TDriver, TContext, TElement, TSelector>;
+        context?: Context<TDriver, TContext, TElement, TSelector>;
+        selector?: types.Selector<TSelector>;
+        index?: number;
+        logger?: any;
+    });
+    get target(): TElement;
+    get selector(): types.Selector<TSelector>;
+    get context(): Context<TDriver, TContext, TElement, TSelector>;
+    get driver(): import("./driver").Driver<TDriver, TContext, TElement, TSelector>;
+    get isRef(): boolean;
+    equals(element: Element<TDriver, TContext, TElement, TSelector> | TElement): Promise<boolean>;
+    init(context: Context<TDriver, TContext, TElement, TSelector>): Promise<this>;
+    getRegion(): Promise<types.Region>;
+    getClientRegion(): Promise<types.Region>;
+    getContentSize(): Promise<types.Size>;
+    isScrollable(): Promise<boolean>;
+    isRoot(): Promise<boolean>;
+    getTouchPadding(): Promise<number>;
+    getText(): Promise<string>;
+    getAttribute(name: string): Promise<string>;
+    setAttribute(name: string, value: string): Promise<void>;
+    scrollTo(offset: types.Location): Promise<types.Location>;
+    translateTo(offset: types.Location): Promise<types.Location>;
+    getScrollOffset(): Promise<types.Location>;
+    getTranslateOffset(): Promise<types.Location>;
+    getInnerOffset(): Promise<types.Location>;
+    click(): Promise<void>;
+    type(value: string): Promise<void>;
+    preserveState(): Promise<ElementState>;
+    restoreState(state?: ElementState): Promise<void>;
+    hideScrollbars(): Promise<void>;
+    restoreScrollbars(): Promise<void>;
+    refresh(freshElement?: TElement): Promise<boolean>;
+    withRefresh<TResult>(operation: (...args: any[]) => TResult): Promise<TResult>;
+    toJSON(): TElement;
+}

package/types/fake/index.d.ts

@@ -1,3 +1,3 @@
-export { MockDriver } from './mock-driver';
-export { Driver, Element, Selector } from './spec-driver';
-export * as spec from './spec-driver';
+export { MockDriver } from './mock-driver';
+export { Driver, Element, Selector } from './spec-driver';
+export * as spec from './spec-driver';

package/types/fake/mock-driver.d.ts

@@ -1,35 +1,35 @@
-export declare class MockDriver {
-    constructor(options?: {});
-    mockScript(scriptMatcher: any, resultGenerator: any): void;
-    mockElement(selector: any, state: any): any;
-    mockElements(nodes: any, { parentId, parentContextId, parentRootId }?: {
-        parentId?: any;
-        parentContextId?: any;
-        parentRootId?: any;
-    }): void;
-    mockSelector(selector: any, element: any): void;
-    wrapMethod(name: any, wrapper: any): void;
-    unwrapMethod(name: any): void;
-    get info(): {
-        isMobile: boolean;
-        isNative: boolean;
-        deviceName: any;
-        platformName: any;
-        platformVersion: any;
-        browserName: any;
-        browserVersion: any;
-    };
-    executeScript(script: any, args?: any[]): Promise<any>;
-    findElement(selector: any, rootElement?: any): Promise<any>;
-    findElements(selector: any, rootElement: any): Promise<any>;
-    switchToFrame(reference: any): Promise<this>;
-    switchToParentFrame(): Promise<this>;
-    getWindowRect(): Promise<any>;
-    setWindowRect(rect: any): Promise<void>;
-    getUrl(): Promise<any>;
-    getTitle(): Promise<any>;
-    visit(url: any): Promise<void>;
-    takeScreenshot(): Promise<void>;
-    toString(): string;
-    toJSON(): string;
-}
+export declare class MockDriver {
+    constructor(options?: {});
+    mockScript(scriptMatcher: any, resultGenerator: any): void;
+    mockElement(selector: any, state: any): any;
+    mockElements(nodes: any, { parentId, parentContextId, parentRootId }?: {
+        parentId?: any;
+        parentContextId?: any;
+        parentRootId?: any;
+    }): void;
+    mockSelector(selector: any, element: any): void;
+    wrapMethod(name: any, wrapper: any): void;
+    unwrapMethod(name: any): void;
+    get info(): {
+        isMobile: boolean;
+        isNative: boolean;
+        deviceName: any;
+        platformName: any;
+        platformVersion: any;
+        browserName: any;
+        browserVersion: any;
+    };
+    executeScript(script: any, args?: any[]): Promise<any>;
+    findElement(selector: any, rootElement?: any): Promise<any>;
+    findElements(selector: any, rootElement: any): Promise<any>;
+    switchToFrame(reference: any): Promise<this>;
+    switchToParentFrame(): Promise<this>;
+    getWindowRect(): Promise<any>;
+    setWindowRect(rect: any): Promise<void>;
+    getUrl(): Promise<any>;
+    getTitle(): Promise<any>;
+    visit(url: any): Promise<void>;
+    takeScreenshot(): Promise<void>;
+    toString(): string;
+    toJSON(): string;
+}

package/types/fake/spec-driver.d.ts

@@ -1,30 +1,30 @@
-/// <reference types="node" />
-import type { Size, DriverInfo } from '@applitools/types';
-export declare type Driver = any;
-export declare type Element = any;
-export declare type Selector = string | {
-    using: string;
-    value: string;
-};
-export declare function isDriver(driver: any): driver is Driver;
-export declare function isElement(element: any): element is Element;
-export declare function isSelector(selector: any): selector is Selector;
-export declare function transformSelector(selector: Selector | {
-    selector: Selector;
-}): Selector;
-export declare function isStaleElementError(): boolean;
-export declare function isEqualElements(_driver: Driver, element1: Element, element2: Element): Promise<boolean>;
-export declare function executeScript(driver: Driver, script: ((arg: any) => any) | string, arg: any): Promise<any>;
-export declare function findElement(driver: Driver, selector: Selector, parent?: Element): Promise<Element>;
-export declare function findElements(driver: Driver, selector: Selector, parent?: Element): Promise<Element[]>;
-export declare function mainContext(driver: Driver): Promise<Driver>;
-export declare function parentContext(driver: Driver): Promise<Driver>;
-export declare function childContext(driver: Driver, element: Element): Promise<Driver>;
-export declare function takeScreenshot(driver: Driver): Promise<Buffer | string>;
-export declare function getDriverInfo(driver: Driver): Promise<DriverInfo>;
-export declare function getWindowSize(driver: Driver): Promise<Size>;
-export declare function setWindowSize(driver: Driver, size: Size): Promise<void>;
-export declare function getOrientation(_driver: Driver): Promise<'portrait' | 'landscape'>;
-export declare function getUrl(driver: Driver): Promise<string>;
-export declare function getTitle(driver: Driver): Promise<string>;
-export declare function visit(driver: Driver, url: string): Promise<void>;
+/// <reference types="node" />
+import type { Size, DriverInfo } from '@applitools/types';
+export declare type Driver = any;
+export declare type Element = any;
+export declare type Selector = string | {
+    using: string;
+    value: string;
+};
+export declare function isDriver(driver: any): driver is Driver;
+export declare function isElement(element: any): element is Element;
+export declare function isSelector(selector: any): selector is Selector;
+export declare function transformSelector(selector: Selector | {
+    selector: Selector;
+}): Selector;
+export declare function isStaleElementError(): boolean;
+export declare function isEqualElements(_driver: Driver, element1: Element, element2: Element): Promise<boolean>;
+export declare function executeScript(driver: Driver, script: ((arg: any) => any) | string, arg: any): Promise<any>;
+export declare function findElement(driver: Driver, selector: Selector, parent?: Element): Promise<Element>;
+export declare function findElements(driver: Driver, selector: Selector, parent?: Element): Promise<Element[]>;
+export declare function mainContext(driver: Driver): Promise<Driver>;
+export declare function parentContext(driver: Driver): Promise<Driver>;
+export declare function childContext(driver: Driver, element: Element): Promise<Driver>;
+export declare function takeScreenshot(driver: Driver): Promise<Buffer | string>;
+export declare function getDriverInfo(driver: Driver): Promise<DriverInfo>;
+export declare function getWindowSize(driver: Driver): Promise<Size>;
+export declare function setWindowSize(driver: Driver, size: Size): Promise<void>;
+export declare function getOrientation(_driver: Driver): Promise<'portrait' | 'landscape'>;
+export declare function getUrl(driver: Driver): Promise<string>;
+export declare function getTitle(driver: Driver): Promise<string>;
+export declare function visit(driver: Driver, url: string): Promise<void>;

package/types/helper-android.d.ts

@@ -1,23 +1,23 @@
-import type * as types from '@applitools/types';
-import type { Driver } from './driver';
-import type { Element } from './element';
-export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
-    static make<TDriver, TContext, TElement, TSelector>(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        driver: Driver<TDriver, TContext, TElement, TSelector>;
-        logger: any;
-    }): Promise<HelperAndroid<TDriver, TContext, TElement, TSelector> | null>;
-    private readonly _spec;
-    private readonly _element;
-    private readonly _legacy;
-    private _logger;
-    constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        element: Element<TDriver, TContext, TElement, TSelector>;
-        legacy: boolean;
-        logger?: any;
-    });
-    _getElementId(element: Element<TDriver, TContext, TElement, TSelector>): Promise<string>;
-    getContentSize(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Size>;
-    getRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
-}
+import type * as types from '@applitools/types';
+import type { Driver } from './driver';
+import type { Element } from './element';
+export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
+    static make<TDriver, TContext, TElement, TSelector>(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        driver: Driver<TDriver, TContext, TElement, TSelector>;
+        logger: any;
+    }): Promise<HelperAndroid<TDriver, TContext, TElement, TSelector> | null>;
+    private readonly _spec;
+    private readonly _element;
+    private readonly _legacy;
+    private _logger;
+    constructor(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        element: Element<TDriver, TContext, TElement, TSelector>;
+        legacy: boolean;
+        logger?: any;
+    });
+    _getElementId(element: Element<TDriver, TContext, TElement, TSelector>): Promise<string>;
+    getContentSize(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Size>;
+    getRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
+}

package/types/helper-ios.d.ts

@@ -1,21 +1,21 @@
-import type * as types from '@applitools/types';
-import type { Driver } from './driver';
-import type { Element } from './element';
-export declare class HelperIOS<TDriver, TContext, TElement, TSelector> {
-    static make<TDriver, TContext, TElement, TSelector>(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        driver: Driver<TDriver, TContext, TElement, TSelector>;
-        logger: any;
-    }): Promise<HelperIOS<TDriver, TContext, TElement, TSelector> | null>;
-    private readonly _driver;
-    private readonly _element;
-    private readonly _spec;
-    private _logger;
-    constructor(options: {
-        driver: Driver<TDriver, TContext, TElement, TSelector>;
-        element: Element<TDriver, TContext, TElement, TSelector>;
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        logger?: any;
-    });
-    getContentSize(_element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Size>;
-}
+import type * as types from '@applitools/types';
+import type { Driver } from './driver';
+import type { Element } from './element';
+export declare class HelperIOS<TDriver, TContext, TElement, TSelector> {
+    static make<TDriver, TContext, TElement, TSelector>(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        driver: Driver<TDriver, TContext, TElement, TSelector>;
+        logger: any;
+    }): Promise<HelperIOS<TDriver, TContext, TElement, TSelector> | null>;
+    private readonly _driver;
+    private readonly _element;
+    private readonly _spec;
+    private _logger;
+    constructor(options: {
+        driver: Driver<TDriver, TContext, TElement, TSelector>;
+        element: Element<TDriver, TContext, TElement, TSelector>;
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        logger?: any;
+    });
+    getContentSize(_element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Size>;
+}

package/types/index.d.ts

@@ -1,3 +1,3 @@
-export * from './driver';
-export * from './context';
-export * from './element';
+export * from './driver';
+export * from './context';
+export * from './element';

package/types/spec-utils.d.ts

@@ -1,13 +1,13 @@
-import type * as types from '@applitools/types';
-export declare function isCommonSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is types.CommonSelector<TSelector>;
-export declare function isSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is types.Selector<TSelector>;
-export declare function transformSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector' | 'transformSelector'>, selector: types.Selector<TSelector>, environment?: {
-    isWeb?: boolean;
-    isNative?: boolean;
-    isIOS?: boolean;
-    isAndroid?: boolean;
-}): TSelector;
-export declare function splitSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: types.Selector<TSelector>): {
-    contextSelectors: types.Selector<TSelector>[];
-    elementSelector: types.Selector<TSelector>;
-};
+import type * as types from '@applitools/types';
+export declare function isCommonSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is types.CommonSelector<TSelector>;
+export declare function isSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is types.Selector<TSelector>;
+export declare function transformSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector' | 'transformSelector'>, selector: types.Selector<TSelector>, environment?: {
+    isWeb?: boolean;
+    isNative?: boolean;
+    isIOS?: boolean;
+    isAndroid?: boolean;
+}): TSelector;
+export declare function splitSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: types.Selector<TSelector>): {
+    contextSelectors: types.Selector<TSelector>[];
+    elementSelector: types.Selector<TSelector>;
+};

package/types/user-agent.d.ts

@@ -1,12 +1,12 @@
-declare type PlatformInfo = {
-    platformName: string;
-    platformVersion?: string;
-};
-declare type BrowserInfo = {
-    browserName: string;
-    browserVersion?: string;
-};
-export declare function parseUserAgent(userAgent: string): PlatformInfo & BrowserInfo;
-export declare function parsePlatform(userAgent: string): PlatformInfo;
-export declare function parseBrowser(userAgent: string): BrowserInfo;
-export {};
+declare type PlatformInfo = {
+    platformName: string;
+    platformVersion?: string;
+};
+declare type BrowserInfo = {
+    browserName: string;
+    browserVersion?: string;
+};
+export declare function parseUserAgent(userAgent: string): PlatformInfo & BrowserInfo;
+export declare function parsePlatform(userAgent: string): PlatformInfo;
+export declare function parseBrowser(userAgent: string): BrowserInfo;
+export {};

package/dist/utils.js

@@ -1,82 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeSpecUtils = void 0;
-const utils = __importStar(require("@applitools/utils"));
-const snippets = require('@applitools/snippets');
-function makeSpecUtils(spec) {
-    return { isSelector, transformSelector, splitSelector, findRootElement };
-    function isSelector(selector) {
-        return (spec.isSelector(selector) ||
-            utils.types.isString(selector) ||
-            (utils.types.isPlainObject(selector) &&
-                utils.types.has(selector, 'selector') &&
-                (utils.types.isString(selector.selector) || spec.isSelector(selector.selector))));
-    }
-    function transformSelector(selector) {
-        var _a, _b;
-        return (_b = (_a = spec.transformSelector) === null || _a === void 0 ? void 0 : _a.call(spec, selector)) !== null && _b !== void 0 ? _b : selector;
-    }
-    function splitSelector(selector) {
-        let current = selector;
-        let active = {};
-        const path = [active];
-        while (utils.types.has(current, 'selector') &&
-            (utils.types.has(current, 'frame') || utils.types.has(current, 'shadow'))) {
-            active.selector = current.selector;
-            if (current.type)
-                active.type = current.type;
-            if (current.frame) {
-                active = {};
-                path.push(active);
-                current = current.frame;
-            }
-            else if (current.shadow) {
-                active = active.shadow = {};
-                current = current.shadow;
-            }
-        }
-        if (spec.isSelector(current) || utils.types.isString(current)) {
-            active.selector = current;
-        }
-        else {
-            active.selector = current.selector;
-            if (current.type)
-                active.type = current.type;
-        }
-        return path;
-    }
-    async function findRootElement(context, selector) {
-        let root = null;
-        let currentSelector = selector;
-        while (utils.types.has(currentSelector, ['selector', 'shadow']) && isSelector(currentSelector.shadow)) {
-            const element = await spec.findElement(context, transformSelector(currentSelector), root);
-            if (!element)
-                break;
-            root = await spec.executeScript(context, snippets.getShadowRoot, [element]);
-            if (!root)
-                break;
-            currentSelector = currentSelector.shadow;
-        }
-        return { root, selector: currentSelector };
-    }
-}
-exports.makeSpecUtils = makeSpecUtils;

package/types/utils.d.ts

@@ -1,11 +0,0 @@
-import type * as types from '@applitools/types';
-export declare type SpecUtils<_TDriver, TContext, TElement, TSelector> = {
-    isSelector(selector: any): selector is types.Selector<TSelector>;
-    transformSelector(selector: types.Selector<TSelector>): TSelector;
-    splitSelector(selector: types.Selector<TSelector>): types.Selector<TSelector>[];
-    findRootElement(context: TContext, selector: types.Selector<TSelector>): Promise<{
-        root: TElement;
-        selector: types.Selector<TSelector>;
-    }>;
-};
-export declare function makeSpecUtils<TDriver, TContext, TElement, TSelector>(spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>): SpecUtils<TDriver, TContext, TElement, TSelector>;