@applitools/driver 1.10.3 → 1.10.5

package/dist/capabilities.js

@@ -14,6 +14,7 @@ function parseCapabilities(capabilities) {
         platformVersion: capabilities.platformVersion || undefined,
         isW3C: isW3C(capabilities),
         isMobile: isMobile(capabilities),
+        isChrome: isChrome(capabilities),
     };
     if (info.isMobile) {
         info.deviceName = ((_h = (_g = capabilities.desired) === null || _g === void 0 ? void 0 : _g.deviceName) !== null && _h !== void 0 ? _h : capabilities.deviceName) || undefined;
@@ -45,7 +46,7 @@ function isAppium(capabilities) {
     return (Boolean(capabilities.automationName || capabilities.deviceName || capabilities.appiumVersion) ||
         Object.keys(capabilities).some(cap => cap.startsWith('appium:')));
 }
-function _isChrome(capabilities) {
+function isChrome(capabilities) {
     return Boolean(capabilities.chrome || capabilities['goog:chromeOptions']);
 }
 function _isFirefox(capabilities) {

package/dist/context.js

@@ -24,9 +24,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
+const element_1 = require("./element");
 const utils = __importStar(require("@applitools/utils"));
 const specUtils = __importStar(require("./spec-utils"));
-const element_1 = require("./element");
 const snippets = require('@applitools/snippets');
 class Context {
     constructor(options) {
@@ -358,9 +358,15 @@ class Context {
                 this._scrollingElement = await this.element(this._scrollingElement);
             }
             else if (this.driver.isWeb) {
-                const isIOS = this.driver.isIOS;
-                const selector = isIOS ? 'html' : await this.execute(snippets.getDocumentScrollingElement);
-                this._logger.log(`default SRE is ${selector}${isIOS ? ' (because Safari on iOS)' : ''}`);
+                let selector;
+                if (this.driver.isIOS && !this.driver.isEmulation) {
+                    selector = 'html';
+                    this._logger.log(`Using hardcoded default scrolling element for Safari on iOS - "${selector}"`);
+                }
+                else {
+                    selector = await this.execute(snippets.getDocumentScrollingElement);
+                    this._logger.log(`Using dynamic default scrolling element - "${selector}"`);
+                }
                 this._scrollingElement = await this.element({ type: 'css', selector });
             }
             else {

package/dist/driver.js

@@ -24,14 +24,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeDriver = exports.Driver = void 0;
-const logger_1 = require("@applitools/logger");
-const utils = __importStar(require("@applitools/utils"));
-const specUtils = __importStar(require("./spec-utils"));
 const context_1 = require("./context");
+const logger_1 = require("@applitools/logger");
 const helper_ios_1 = require("./helper-ios");
 const helper_android_1 = require("./helper-android");
 const user_agent_1 = require("./user-agent");
 const capabilities_1 = require("./capabilities");
+const utils = __importStar(require("@applitools/utils"));
+const specUtils = __importStar(require("./spec-utils"));
 const snippets = require('@applitools/snippets');
 // eslint-disable-next-line
 class Driver {
@@ -126,6 +126,10 @@ class Driver {
     get isWeb() {
         return this.isWebView || !this.isNative;
     }
+    get isEmulation() {
+        var _a, _b;
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isEmulation) !== null && _b !== void 0 ? _b : false;
+    }
     get isMobile() {
         var _a, _b;
         return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isMobile) !== null && _b !== void 0 ? _b : false;
@@ -160,7 +164,7 @@ class Driver {
         if (this.isMobile) {
             this._driverInfo.orientation =
                 (_g = (await this.getOrientation().catch(() => undefined))) !== null && _g !== void 0 ? _g : this._driverInfo.orientation;
-            const world = this.isMobile && (await this.getCurrentWorld());
+            const world = await this.getCurrentWorld();
             this._driverInfo.isWebView = !!(world === null || world === void 0 ? void 0 : world.isWebView);
         }
         if (this.isWeb) {
@@ -182,9 +186,10 @@ class Driver {
             }
             if (!this._driverInfo.isMobile && (this.isAndroid || this.isIOS)) {
                 this._driverInfo.isMobile = true;
+                this._driverInfo.isEmulation = this._driverInfo.isChrome;
             }
             (_s = (_11 = this._driverInfo).features) !== null && _s !== void 0 ? _s : (_11.features = {});
-            (_t = (_12 = this._driverInfo.features).allCookies) !== null && _t !== void 0 ? _t : (_12.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
+            (_t = (_12 = this._driverInfo.features).allCookies) !== null && _t !== void 0 ? _t : (_12.allCookies = this._driverInfo.isChrome || (/chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile));
         }
         else {
             // this value always excludes the height of the navigation bar, and sometimes it also excludes the height of the status bar

package/dist/index.js

@@ -27,7 +27,10 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.specUtils = void 0;
+__exportStar(require("./spec-driver"), exports);
 __exportStar(require("./driver"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./element"), exports);
+__exportStar(require("./selector"), exports);
+__exportStar(require("./types"), exports);
 exports.specUtils = __importStar(require("./spec-utils"));

package/dist/selector.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/spec-driver.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/driver",
-  "version": "1.10.3",
+  "version": "1.10.5",
   "description": "Applitools universal framework wrapper",
   "keywords": [
     "applitools",
@@ -87,15 +87,14 @@
     }
   },
   "dependencies": {
-    "@applitools/logger": "1.1.24",
+    "@applitools/logger": "1.1.26",
     "@applitools/snippets": "2.4.5",
-    "@applitools/types": "1.5.17",
     "@applitools/utils": "1.3.12",
     "semver": "7.3.7"
   },
   "devDependencies": {
     "@applitools/bongo": "^2.2.0",
-    "@applitools/scripts": "^1.1.0",
+    "@applitools/scripts": "^1.2.0",
     "@types/mocha": "^9.1.1",
     "@types/node": "^17.0.31",
     "@typescript-eslint/eslint-plugin": "^5.22.0",

package/types/capabilities.d.ts

@@ -1,4 +1,4 @@
-import type * as types from '@applitools/types';
+import { type DriverInfo } from './spec-driver';
 declare type Capabilities = Record<string, any>;
-export declare function parseCapabilities(capabilities: Capabilities): types.DriverInfo;
+export declare function parseCapabilities(capabilities: Capabilities): DriverInfo;
 export {};

package/types/context.d.ts

@@ -1,18 +1,20 @@
-import type * as types from '@applitools/types';
-import { type Logger } from '@applitools/logger';
+import type { Location, Size, Region, Cookie } from './types';
+import { type SpecDriver, type WaitOptions } from './spec-driver';
 import { type Driver } from './driver';
+import { type Selector } from './selector';
+import { type Logger } from '@applitools/logger';
 import { Element } from './element';
-export declare type ContextReference<TDriver, TContext, TElement, TSelector> = Context<TDriver, TContext, TElement, TSelector> | Element<TDriver, TContext, TElement, TSelector> | TElement | types.Selector<TSelector> | string | number;
+export declare type ContextReference<TDriver, TContext, TElement, TSelector> = Context<TDriver, TContext, TElement, TSelector> | Element<TDriver, TContext, TElement, TSelector> | TElement | Selector<TSelector> | string | number;
 export declare type ContextPlain<TDriver, TContext, TElement, TSelector> = ContextReference<TDriver, TContext, TElement, TSelector> | {
     reference: ContextReference<TDriver, TContext, TElement, TSelector>;
     scrollingElement?: Element<TDriver, TContext, TElement, TSelector>;
     parent?: ContextPlain<TDriver, TContext, TElement, TSelector>;
 };
 export declare type ContextState = {
-    region?: types.Region;
-    clientRegion?: types.Region;
-    scrollingRegion?: types.Region;
-    innerOffset?: types.Location;
+    region?: Region;
+    clientRegion?: Region;
+    scrollingRegion?: Region;
+    innerOffset?: Location;
 };
 export declare class Context<TDriver, TContext, TElement, TSelector> {
     private _target;
@@ -24,9 +26,9 @@ export declare class Context<TDriver, TContext, TElement, TSelector> {
     private _state;
     private _logger;
     private _isReference;
-    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    protected readonly _spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
     constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         context?: TContext | Context<TDriver, TContext, TElement, TSelector>;
         driver?: Driver<TDriver, TContext, TElement, TSelector>;
         parent?: Context<TDriver, TContext, TElement, TSelector>;
@@ -48,29 +50,29 @@ export declare class Context<TDriver, TContext, TElement, TSelector> {
     focus(): Promise<this>;
     equals(context: Context<TDriver, TContext, TElement, TSelector> | Element<TDriver, TContext, TElement, TSelector>): Promise<boolean>;
     context(reference: ContextPlain<TDriver, TContext, TElement, TSelector>): Promise<Context<TDriver, TContext, TElement, TSelector>>;
-    root(selector: types.Selector<TSelector>): Promise<{
+    root(selector: Selector<TSelector>): Promise<{
         context: Context<TDriver, TContext, TElement, TSelector>;
         shadow?: Element<TDriver, TContext, TElement, TSelector>;
-        selector: types.Selector<TSelector>;
+        selector: Selector<TSelector>;
     }>;
-    element(elementOrSelector: TElement | types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
-    elements(selectorOrElement: types.Selector<TSelector> | TElement): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
-    waitFor(selector: types.Selector<TSelector>, options?: types.WaitOptions): Promise<Element<TDriver, TContext, TElement, TSelector>>;
+    element(elementOrSelector: TElement | Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
+    elements(selectorOrElement: Selector<TSelector> | TElement): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
+    waitFor(selector: Selector<TSelector>, options?: WaitOptions): Promise<Element<TDriver, TContext, TElement, TSelector>>;
     execute(script: ((args: any) => any) | string, arg?: any): Promise<any>;
     getContextElement(): Promise<Element<TDriver, TContext, TElement, TSelector>>;
     getScrollingElement(): Promise<Element<TDriver, TContext, TElement, TSelector>>;
-    setScrollingElement(scrollingElement: Element<TDriver, TContext, TElement, TSelector> | TElement | types.Selector<TSelector>): Promise<void>;
+    setScrollingElement(scrollingElement: Element<TDriver, TContext, TElement, TSelector> | TElement | Selector<TSelector>): Promise<void>;
     blurElement(element?: Element<TDriver, TContext, TElement, TSelector>): Promise<TElement>;
     focusElement(element: Element<TDriver, TContext, TElement, TSelector>): Promise<any>;
-    getRegion(): Promise<types.Region>;
-    getClientRegion(): Promise<types.Region>;
-    getScrollingRegion(): Promise<types.Region>;
-    getContentSize(): Promise<types.Size>;
-    getInnerOffset(): Promise<types.Location>;
-    getLocationInMainContext(): Promise<types.Location>;
-    getLocationInViewport(): Promise<types.Location>;
-    getRegionInViewport(region: types.Region): Promise<types.Region>;
-    getCookies(): Promise<types.Cookie[]>;
+    getRegion(): Promise<Region>;
+    getClientRegion(): Promise<Region>;
+    getScrollingRegion(): Promise<Region>;
+    getContentSize(): Promise<Size>;
+    getInnerOffset(): Promise<Location>;
+    getLocationInMainContext(): Promise<Location>;
+    getLocationInViewport(): Promise<Location>;
+    getRegionInViewport(region: Region): Promise<Region>;
+    getCookies(): Promise<Cookie[]>;
     private preserveInnerOffset;
     private preserveContextRegions;
     private preserveScrollingRegion;

package/types/debug/check-spec-driver.d.ts

@@ -1,4 +1,4 @@
-import type { SpecDriver } from '@applitools/types';
+import { type SpecDriver } from '../spec-driver';
 export declare function checkSpecDriver<TDriver, TContext, TElement, TSelector>(options: {
     spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
     driver: TDriver;

package/types/driver.d.ts

@@ -1,15 +1,20 @@
 /// <reference types="node" />
-import type * as types from '@applitools/types';
+import type { Size, Region, ScreenOrientation, Cookie } from './types';
+import { type Selector } from './selector';
+import { type SpecDriver } from './spec-driver';
+import { type Element } from './element';
+import { Context, type ContextReference } from './context';
 import { type Logger } from '@applitools/logger';
-import { Context, ContextReference } from './context';
-import { Element } from './element';
 import { HelperIOS } from './helper-ios';
 import { HelperAndroid } from './helper-android';
 declare type DriverOptions<TDriver, TContext, TElement, TSelector> = {
-    spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
     driver: Driver<TDriver, TContext, TElement, TSelector> | TDriver;
     logger?: Logger;
-    customConfig?: types.CustomDriverConfig;
+    customConfig?: {
+        useCeilForViewportSize?: boolean;
+        disableHelper?: boolean;
+    };
 };
 export declare class Driver<TDriver, TContext, TElement, TSelector> {
     private _target;
@@ -20,7 +25,7 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
     private _customConfig;
     private _helper?;
     private _previousWorld;
-    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    protected readonly _spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
     constructor(options: DriverOptions<TDriver, TContext, TElement, TSelector>);
     get target(): TDriver;
     get currentContext(): Context<TDriver, TContext, TElement, TSelector>;
@@ -36,7 +41,7 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
     get browserName(): string;
     get browserVersion(): string | number;
     get userAgent(): string;
-    get orientation(): 'portrait' | 'landscape' | 'portrait-secondary' | 'landscape-secondary';
+    get orientation(): ScreenOrientation;
     get pixelRatio(): number;
     get viewportScale(): number;
     get statusBarSize(): number;
@@ -44,6 +49,7 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
     get isNative(): boolean;
     get isWebView(): boolean;
     get isWeb(): boolean;
+    get isEmulation(): boolean;
     get isMobile(): boolean;
     get isIOS(): boolean;
     get isAndroid(): boolean;
@@ -57,25 +63,31 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
         goHome?: boolean;
     }): Promise<void>;
     getWorlds(attempt?: number): Promise<string[]>;
-    getCurrentWorld(): Promise<types.WorldInfo>;
+    getCurrentWorld(): Promise<{
+        id: string;
+        home: string;
+        next?: string;
+        isNative: boolean;
+        isWebView: boolean;
+    }>;
     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>[]>;
+    normalizeRegion(region: Region): Promise<Region>;
+    getRegionInViewport(context: Context<TDriver, TContext, TElement, TSelector>, region: Region): Promise<Region>;
+    element(selector: Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
+    elements(selector: Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
     execute(script: ((arg: any) => any) | string, arg?: any): Promise<any>;
     takeScreenshot(): Promise<Buffer>;
-    getViewportRegion(): Promise<types.Region>;
-    getViewportSize(): Promise<types.Size>;
-    setViewportSize(size: types.Size): Promise<void>;
-    getDisplaySize(): Promise<types.Size>;
+    getViewportRegion(): Promise<Region>;
+    getViewportSize(): Promise<Size>;
+    setViewportSize(size: Size): Promise<void>;
+    getDisplaySize(): Promise<Size>;
     getOrientation(): Promise<'portrait' | 'landscape' | 'portrait-secondary' | 'landscape-secondary'>;
     setOrientation(orientation: 'portrait' | 'landscape'): Promise<void>;
-    getCookies(): Promise<types.Cookie[]>;
+    getCookies(): Promise<Cookie[]>;
     getTitle(): Promise<string>;
     getUrl(): Promise<string>;
     visit(url: string): Promise<void>;

package/types/element.d.ts

@@ -1,9 +1,11 @@
-import type * as types from '@applitools/types';
-import { type Logger } from '@applitools/logger';
+import type { Location, Size, Region } from './types';
+import { type SpecDriver } from './spec-driver';
 import { type Context } from './context';
+import { type Selector } from './selector';
+import { type Logger } from '@applitools/logger';
 export declare type ElementState<TElement> = {
-    contentSize?: types.Size;
-    scrollOffset?: types.Location;
+    contentSize?: Size;
+    scrollOffset?: Location;
     transforms?: any;
     attributes?: Record<string, string | Error>;
     touchPadding?: number;
@@ -18,18 +20,18 @@ export declare class Element<TDriver, TContext, TElement, TSelector> {
     private _state;
     private _originalOverflow;
     private _logger;
-    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    protected readonly _spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
     constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         element?: TElement | Element<TDriver, TContext, TElement, TSelector>;
         context?: Context<TDriver, TContext, TElement, TSelector>;
-        selector?: types.Selector<TSelector>;
+        selector?: Selector<TSelector>;
         index?: number;
         logger?: Logger;
     });
     get target(): TElement;
-    get selector(): types.Selector<TSelector>;
-    get commonSelector(): types.Selector<never>;
+    get selector(): Selector<TSelector>;
+    get commonSelector(): Selector<never>;
     get index(): number;
     get context(): Context<TDriver, TContext, TElement, TSelector>;
     get driver(): import("./driver").Driver<TDriver, TContext, TElement, TSelector>;
@@ -37,15 +39,15 @@ export declare class Element<TDriver, TContext, TElement, TSelector> {
     equals(element: Element<TDriver, TContext, TElement, TSelector> | TElement): Promise<boolean>;
     contains(innerElement: 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>;
+    getRegion(): Promise<Region>;
+    getClientRegion(): Promise<Region>;
     getContentSize(options?: {
         lazyLoad?: {
             scrollLength?: number;
             waitingTime?: number;
             maxAmountToScroll?: number;
         };
-    }): Promise<types.Size>;
+    }): Promise<Size>;
     isPager(): Promise<boolean>;
     isScrollable(): Promise<boolean>;
     isRoot(): Promise<boolean>;
@@ -54,13 +56,13 @@ export declare class Element<TDriver, TContext, TElement, TSelector> {
     getText(): Promise<string>;
     getAttribute(name: string): Promise<string>;
     setAttribute(name: string, value: string): Promise<void>;
-    scrollTo(offset: types.Location, options?: {
+    scrollTo(offset: Location, options?: {
         force: boolean;
-    }): Promise<types.Location>;
-    translateTo(offset: types.Location): Promise<types.Location>;
-    getScrollOffset(): Promise<types.Location>;
-    getTranslateOffset(): Promise<types.Location>;
-    getInnerOffset(): Promise<types.Location>;
+    }): Promise<Location>;
+    translateTo(offset: Location): Promise<Location>;
+    getScrollOffset(): Promise<Location>;
+    getTranslateOffset(): Promise<Location>;
+    getInnerOffset(): Promise<Location>;
     click(): Promise<void>;
     type(value: string): Promise<void>;
     preserveState(): Promise<ElementState<TElement>>;

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

@@ -1,5 +1,6 @@
 /// <reference types="node" />
-import type { Size, DriverInfo } from '@applitools/types';
+import { type Size } from '../types';
+import { type DriverInfo } from '../spec-driver';
 export declare type Driver = any;
 export declare type Element = any;
 export declare type Selector = string | {

package/types/helper-android.d.ts

@@ -1,10 +1,11 @@
-import type * as types from '@applitools/types';
+import type { Location, Region } from './types';
+import { type SpecDriver } from './spec-driver';
+import { type Driver } from './driver';
+import { type Element } from './element';
 import { type Logger } from '@applitools/logger';
-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>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         driver: Driver<TDriver, TContext, TElement, TSelector>;
         logger: Logger;
     }): Promise<HelperAndroid<TDriver, TContext, TElement, TSelector> | null>;
@@ -16,7 +17,7 @@ export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
     private _logger;
     readonly name: 'android' | 'android-legacy';
     constructor(options: {
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         input: Element<TDriver, TContext, TElement, TSelector>;
         action?: Element<TDriver, TContext, TElement, TSelector>;
         legacy: boolean;
@@ -31,9 +32,9 @@ export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
             waitingTime?: number;
             maxAmountToScroll?: number;
         };
-    }): Promise<types.Region>;
+    }): Promise<Region>;
     getTouchPadding(): Promise<number>;
-    getRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
+    getRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<Region>;
     scrollToTop(element: Element<TDriver, TContext, TElement, TSelector>): Promise<void>;
-    scrollBy(element: Element<TDriver, TContext, TElement, TSelector>, offset: types.Location): Promise<void>;
+    scrollBy(element: Element<TDriver, TContext, TElement, TSelector>, offset: Location): Promise<void>;
 }

package/types/helper-ios.d.ts

@@ -1,10 +1,11 @@
-import type * as types from '@applitools/types';
+import type { Region } from './types';
+import { type SpecDriver } from './spec-driver';
+import { type Driver } from './driver';
+import { type Element } from './element';
 import { type Logger } from '@applitools/logger';
-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>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         driver: Driver<TDriver, TContext, TElement, TSelector>;
         logger: Logger;
     }): Promise<HelperIOS<TDriver, TContext, TElement, TSelector> | null>;
@@ -16,8 +17,8 @@ export declare class HelperIOS<TDriver, TContext, TElement, TSelector> {
     constructor(options: {
         driver: Driver<TDriver, TContext, TElement, TSelector>;
         element: Element<TDriver, TContext, TElement, TSelector>;
-        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        spec: SpecDriver<TDriver, TContext, TElement, TSelector>;
         logger?: Logger;
     });
-    getContentRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
+    getContentRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<Region>;
 }

package/types/index.d.ts

@@ -1,4 +1,7 @@
+export * from './spec-driver';
 export * from './driver';
 export * from './context';
 export * from './element';
+export * from './selector';
+export * from './types';
 export * as specUtils from './spec-utils';

package/types/selector.d.ts

@@ -0,0 +1,7 @@
+export declare type Selector<TSelector = never> = TSelector | string | {
+    selector: TSelector | string;
+    type?: string;
+    shadow?: Selector<TSelector>;
+    frame?: Selector<TSelector>;
+};
+export declare type CommonSelector = Selector;

package/types/spec-driver.d.ts

@@ -0,0 +1,97 @@
+/// <reference types="node" />
+import type { Location, Size, Region, ScreenOrientation, Cookie } from './types';
+import { type Selector } from './selector';
+export declare type DriverInfo = {
+    sessionId?: string;
+    browserName?: string;
+    browserVersion?: string;
+    platformName?: string;
+    platformVersion?: string;
+    deviceName?: string;
+    userAgent?: string;
+    viewportLocation?: Location;
+    viewportSize?: Size;
+    displaySize?: Size;
+    orientation?: ScreenOrientation;
+    pixelRatio?: number;
+    viewportScale?: number;
+    safeArea?: Region;
+    statusBarSize?: number;
+    navigationBarSize?: number;
+    isW3C?: boolean;
+    isChrome?: boolean;
+    isEmulation?: boolean;
+    isMobile?: boolean;
+    isNative?: boolean;
+    isAndroid?: boolean;
+    isIOS?: boolean;
+    isWebView?: boolean;
+    features?: {
+        shadowSelector?: boolean;
+        allCookies?: boolean;
+    };
+};
+export declare type WaitOptions = {
+    state?: 'exist' | 'visible';
+    interval?: number;
+    timeout?: number;
+};
+export interface SpecDriver<TDriver, TContext, TElement, TSelector> {
+    isDriver(driver: any): driver is TDriver;
+    isContext?(context: any): context is TContext;
+    isElement(element: any): element is TElement;
+    isSelector(selector: any): selector is TSelector;
+    transformDriver?(driver: any): TDriver;
+    transformElement?(element: any): TElement;
+    transformSelector?(selector: Selector<TSelector>): TSelector;
+    untransformSelector?(selector: TSelector | Selector<TSelector>): Selector;
+    extractContext?(element: TDriver | TContext): TContext;
+    extractSelector?(element: TElement): TSelector;
+    isStaleElementError(error: any, selector?: TSelector): boolean;
+    isEqualElements?(context: TContext, element1: TElement, element2: TElement): Promise<boolean>;
+    mainContext(context: TContext): Promise<TContext>;
+    parentContext?(context: TContext): Promise<TContext>;
+    childContext(context: TContext, element: TElement): Promise<TContext>;
+    executeScript(context: TContext, script: ((arg?: any) => any) | string, arg?: any): Promise<any>;
+    findElement(context: TContext, selector: TSelector, parent?: TElement): Promise<TElement | null>;
+    findElements(context: TContext, selector: TSelector, parent?: TElement): Promise<TElement[]>;
+    waitForSelector?(context: TContext, selector: TSelector, parent?: TElement, options?: WaitOptions): Promise<TElement | null>;
+    setWindowSize?(driver: TDriver, size: Size): Promise<void>;
+    getWindowSize?(driver: TDriver): Promise<Size>;
+    setViewportSize?(driver: TDriver, size: Size): Promise<void>;
+    getViewportSize?(driver: TDriver): Promise<Size>;
+    getCookies?(driver: TDriver | TContext, context?: boolean): Promise<Cookie[]>;
+    getDriverInfo?(driver: TDriver): Promise<DriverInfo>;
+    getCapabilities?(driver: TDriver): Promise<Record<string, any>>;
+    getTitle(driver: TDriver): Promise<string>;
+    getUrl(driver: TDriver): Promise<string>;
+    takeScreenshot(driver: TDriver): Promise<Buffer | string>;
+    click?(context: TContext, element: TElement | TSelector): Promise<void>;
+    type?(context: TContext, element: TElement, value: string): Promise<void>;
+    visit?(driver: TDriver, url: string): Promise<void>;
+    getOrientation?(driver: TDriver): Promise<ScreenOrientation>;
+    setOrientation?(driver: TDriver, orientation: ScreenOrientation): Promise<void>;
+    getSystemBars?(driver: TDriver): Promise<{
+        statusBar: {
+            visible: boolean;
+            x: number;
+            y: number;
+            height: number;
+            width: number;
+        };
+        navigationBar: {
+            visible: boolean;
+            x: number;
+            y: number;
+            height: number;
+            width: number;
+        };
+    }>;
+    getElementRegion?(driver: TDriver, element: TElement): Promise<Region>;
+    getElementAttribute?(driver: TDriver, element: TElement, attr: string): Promise<string>;
+    getElementText?(driver: TDriver, element: TElement): Promise<string>;
+    performAction?(driver: TDriver, steps: any[]): Promise<void>;
+    getCurrentWorld?(driver: TDriver): Promise<string>;
+    getWorlds?(driver: TDriver): Promise<string[]>;
+    switchWorld?(driver: TDriver, id: string): Promise<void>;
+}

package/types/spec-utils.d.ts

@@ -1,4 +1,5 @@
-import type * as types from '@applitools/types';
+import { type SpecDriver } from './spec-driver';
+import { type Selector } from './selector';
 declare type CommonSelector<TSelector = never> = {
     selector: TSelector | string;
     type?: string;
@@ -6,17 +7,17 @@ declare type CommonSelector<TSelector = never> = {
     frame?: CommonSelector<TSelector> | TSelector | string;
 };
 export declare function isSimpleCommonSelector(selector: any): selector is CommonSelector;
-export declare function isCommonSelector<TSelector>(spec: Pick<types.SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is 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?: {
+export declare function isCommonSelector<TSelector>(spec: Pick<SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is CommonSelector<TSelector>;
+export declare function isSelector<TSelector>(spec: Pick<SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: any): selector is Selector<TSelector>;
+export declare function transformSelector<TSelector>(spec: Pick<SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector' | 'transformSelector'>, selector: 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>;
+export declare function splitSelector<TSelector>(spec: Pick<SpecDriver<unknown, unknown, unknown, TSelector>, 'isSelector'>, selector: Selector<TSelector>): {
+    contextSelectors: Selector<TSelector>[];
+    elementSelector: Selector<TSelector>;
 };
-export declare function withFastCache<TSpecDriver extends types.SpecDriver<unknown, unknown, unknown, unknown>>(spec: TSpecDriver): TSpecDriver;
+export declare function withFastCache<TSpecDriver extends SpecDriver<unknown, unknown, unknown, unknown>>(spec: TSpecDriver): TSpecDriver;
 export {};

package/types/types.d.ts

@@ -0,0 +1,20 @@
+export declare type Location = {
+    x: number;
+    y: number;
+};
+export declare type Size = {
+    width: number;
+    height: number;
+};
+export declare type Region = Location & Size;
+export declare type ScreenOrientation = 'portrait' | 'landscape' | 'portrait-secondary' | 'landscape-secondary';
+export declare type Cookie = {
+    name: string;
+    value: string;
+    domain?: string;
+    path?: string;
+    expiry?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+};