@applitools/driver 1.8.0 → 1.8.3

package/dist/capabilities.js

@@ -2,28 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCapabilities = void 0;
 function parseCapabilities(capabilities, customConfig) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
     if (capabilities.capabilities)
         capabilities = capabilities.capabilities;
-    if (((_a = capabilities.platformName) === null || _a === void 0 ? void 0 : _a.startsWith('android')) && !(customConfig === null || customConfig === void 0 ? void 0 : customConfig.keepPlatformNameAsIs)) {
-        capabilities.platformName = capabilities.platformName.charAt(0).toUpperCase() + capabilities.platformName.slice(1);
+    if (!(customConfig === null || customConfig === void 0 ? void 0 : customConfig.keepPlatformNameAsIs)) {
+        // We use `startsWith` for just a theorerical reason. It's not based on any concrete case that we knew of at the time of writing this code.
+        if ((_a = capabilities.platformName) === null || _a === void 0 ? void 0 : _a.startsWith('android')) {
+            capabilities.platformName = capabilities.platformName.charAt(0).toUpperCase() + capabilities.platformName.slice(1);
+        }
+        // We use `startsWith` for just a theorerical reason. It's not based on any concrete case that we knew of at the time of writing this code.
+        if ((_b = capabilities.platformName) === null || _b === void 0 ? void 0 : _b.startsWith('ios')) {
+            capabilities.platformName = 'iOS' + capabilities.platformName.slice(3);
+        }
     }
     const info = {
         browserName: !capabilities.app && !capabilities.bundleId
-            ? ((_b = capabilities.browserName) !== null && _b !== void 0 ? _b : (_c = capabilities.desired) === null || _c === void 0 ? void 0 : _c.browserName) || undefined
+            ? ((_c = capabilities.browserName) !== null && _c !== void 0 ? _c : (_d = capabilities.desired) === null || _d === void 0 ? void 0 : _d.browserName) || undefined
             : undefined,
-        browserVersion: ((_d = capabilities.browserVersion) !== null && _d !== void 0 ? _d : capabilities.version) || undefined,
-        platformName: ((_f = (_e = capabilities.platformName) !== null && _e !== void 0 ? _e : capabilities.platform) !== null && _f !== void 0 ? _f : (_g = capabilities.desired) === null || _g === void 0 ? void 0 : _g.platformName) || undefined,
+        browserVersion: ((_e = capabilities.browserVersion) !== null && _e !== void 0 ? _e : capabilities.version) || undefined,
+        platformName: ((_g = (_f = capabilities.platformName) !== null && _f !== void 0 ? _f : capabilities.platform) !== null && _g !== void 0 ? _g : (_h = capabilities.desired) === null || _h === void 0 ? void 0 : _h.platformName) || undefined,
         platformVersion: capabilities.platformVersion || undefined,
         isW3C: isW3C(capabilities),
         isMobile: isMobile(capabilities),
     };
     if (info.isMobile) {
-        info.deviceName = ((_j = (_h = capabilities.desired) === null || _h === void 0 ? void 0 : _h.deviceName) !== null && _j !== void 0 ? _j : capabilities.deviceName) || undefined;
+        info.deviceName = ((_k = (_j = capabilities.desired) === null || _j === void 0 ? void 0 : _j.deviceName) !== null && _k !== void 0 ? _k : capabilities.deviceName) || undefined;
         info.isNative = info.isMobile && !info.browserName;
         info.isIOS = isIOS(capabilities);
         info.isAndroid = isAndroid(capabilities);
-        info.orientation = (_l = ((_k = capabilities.deviceOrientation) !== null && _k !== void 0 ? _k : capabilities.orientation)) === null || _l === void 0 ? void 0 : _l.toLowerCase();
+        info.orientation = (_m = ((_l = capabilities.deviceOrientation) !== null && _l !== void 0 ? _l : capabilities.orientation)) === null || _m === void 0 ? void 0 : _m.toLowerCase();
     }
     if (info.isNative) {
         info.pixelRatio = capabilities.pixelRatio;

package/dist/context.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -241,6 +245,7 @@ class Context {
             if (this.isRef) {
                 return new element_1.Element({ spec: this._spec, context: this, selector: elementOrSelector, logger: this._logger });
             }
+            this._logger.log('Finding element by selector: ', elementOrSelector);
             const root = await this.root(elementOrSelector);
             if (!root)
                 return null;
@@ -263,6 +268,7 @@ class Context {
             if (this.isRef) {
                 return [new element_1.Element({ spec: this._spec, context: this, selector: elementOrSelector, logger: this._logger })];
             }
+            this._logger.log('Finding elements by selector: ', elementOrSelector);
             const root = await this.root(elementOrSelector);
             if (!root)
                 return [];

package/dist/debug/index.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/driver.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -20,6 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 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");
@@ -31,22 +36,21 @@ const snippets = require('@applitools/snippets');
 // eslint-disable-next-line
 class Driver {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         if (options.driver instanceof Driver)
             return options.driver;
+        this._customConfig = (_a = options.customConfig) !== null && _a !== void 0 ? _a : {};
         this._spec = options.spec;
-        this._customConfig = options.customConfig || {};
-        if (options.logger)
-            this._logger = options.logger;
+        this._logger = (_c = (_b = options.logger) === null || _b === void 0 ? void 0 : _b.extend({ label: 'driver' })) !== null && _c !== void 0 ? _c : (0, logger_1.makeLogger)({ label: 'driver' });
         if (this._spec.isDriver(options.driver)) {
-            this._target = (_c = (_b = (_a = this._spec).transformDriver) === null || _b === void 0 ? void 0 : _b.call(_a, options.driver)) !== null && _c !== void 0 ? _c : options.driver;
+            this._target = (_f = (_e = (_d = this._spec).transformDriver) === null || _e === void 0 ? void 0 : _e.call(_d, options.driver)) !== null && _f !== void 0 ? _f : options.driver;
         }
         else {
             throw new TypeError('Driver constructor called with argument of unknown type!');
         }
         this._mainContext = new context_1.Context({
             spec: this._spec,
-            context: (_f = (_e = (_d = this._spec).extractContext) === null || _e === void 0 ? void 0 : _e.call(_d, this._target)) !== null && _f !== void 0 ? _f : this._target,
+            context: (_j = (_h = (_g = this._spec).extractContext) === null || _h === void 0 ? void 0 : _h.call(_g, this._target)) !== null && _j !== void 0 ? _j : this._target,
             driver: this,
             logger: this._logger,
         });
@@ -141,10 +145,10 @@ class Driver {
     }
     async init() {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
-        var _w, _x, _y, _z, _0, _1, _2, _3;
+        var _w, _x, _y, _z, _0, _1, _2, _3, _4, _5;
         const capabilities = await ((_b = (_a = this._spec).getCapabilities) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
         this._logger.log('Driver capabilities', capabilities);
-        const capabilitiesInfo = capabilities ? capabilities_1.parseCapabilities(capabilities, this._customConfig) : undefined;
+        const capabilitiesInfo = capabilities ? (0, capabilities_1.parseCapabilities)(capabilities, this._customConfig) : undefined;
         const driverInfo = await ((_d = (_c = this._spec).getDriverInfo) === null || _d === void 0 ? void 0 : _d.call(_c, this.target));
         this._driverInfo = Object.assign(Object.assign({}, capabilitiesInfo), driverInfo);
         if (this.isWeb) {
@@ -152,7 +156,7 @@ class Driver {
             (_f = (_x = this._driverInfo).viewportScale) !== null && _f !== void 0 ? _f : (_x.viewportScale = await this.execute(snippets.getViewportScale));
             (_g = (_y = this._driverInfo).userAgent) !== null && _g !== void 0 ? _g : (_y.userAgent = await this.execute(snippets.getUserAgent));
             if (this._driverInfo.userAgent) {
-                const userAgentInfo = user_agent_1.parseUserAgent(this._driverInfo.userAgent);
+                const userAgentInfo = (0, user_agent_1.parseUserAgent)(this._driverInfo.userAgent);
                 this._driverInfo.browserName = (_h = userAgentInfo.browserName) !== null && _h !== void 0 ? _h : this._driverInfo.browserName;
                 this._driverInfo.browserVersion = (_j = userAgentInfo.browserVersion) !== null && _j !== void 0 ? _j : this._driverInfo.browserVersion;
                 if (this._driverInfo.isMobile) {
@@ -168,27 +172,35 @@ class Driver {
             (_q = (_2 = this._driverInfo.features).allCookies) !== null && _q !== void 0 ? _q : (_2.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
         }
         else {
-            const barsHeight = await ((_s = (_r = this._spec).getBarsSize) === null || _s === void 0 ? void 0 : _s.call(_r, this.target).catch(() => undefined));
             const displaySize = await this.getDisplaySize();
+            const orientation = await this.getOrientation();
             // calculate status and navigation bars sizes
-            if (barsHeight) {
-                const orientation = await this.getOrientation();
-                // when status bar is overlapping content on android it returns status bar height equal to viewport height
-                if (this.isAndroid && barsHeight.statusBarHeight / this.pixelRatio < displaySize.height) {
-                    this._driverInfo.statusBarHeight = Math.max((_t = this._driverInfo.statusBarHeight) !== null && _t !== void 0 ? _t : 0, barsHeight.statusBarHeight);
-                }
-                // android witches the width and height only for the navigationBar in landscape mode.
-                this._driverInfo.navigationBarHeight = Math.max((_u = this._driverInfo.navigationBarHeight) !== null && _u !== void 0 ? _u : 0, orientation === 'landscape' ? barsHeight.navigationBarWidth : barsHeight.navigationBarHeight);
-            }
             if (this.isAndroid) {
-                this._driverInfo.statusBarHeight /= this.pixelRatio;
-                this._driverInfo.navigationBarHeight /= this.pixelRatio;
+                // bar sizes could be extracted only on android
+                const barsSize = await ((_s = (_r = this._spec).getBarsSize) === null || _s === void 0 ? void 0 : _s.call(_r, this.target).catch(() => undefined));
+                if (barsSize) {
+                    this._logger.log('Driver bars size', barsSize);
+                    // navigation bar height is replaced with the width in landscape orientation on android (due to the bug in appium)
+                    if (orientation === 'landscape')
+                        barsSize.navigationBarHeight = barsSize.navigationBarWidth;
+                    // when status bar is overlapping content on android it returns status bar height equal to viewport height
+                    if (barsSize.statusBarHeight / this.pixelRatio < displaySize.height) {
+                        this._driverInfo.statusBarHeight = Math.max((_t = this._driverInfo.statusBarHeight) !== null && _t !== void 0 ? _t : 0, barsSize.statusBarHeight);
+                    }
+                    // when navigation bar is invisible on android it returns navigation bar height equal to viewport height
+                    if (barsSize.navigationBarHeight / this.pixelRatio < displaySize.height) {
+                        this._driverInfo.navigationBarHeight = Math.max((_u = this._driverInfo.navigationBarHeight) !== null && _u !== void 0 ? _u : 0, barsSize.navigationBarHeight);
+                    }
+                    // bar heights have to be scaled on android
+                    (_3 = this._driverInfo).statusBarHeight && (_3.statusBarHeight = this._driverInfo.statusBarHeight / this.pixelRatio);
+                    (_4 = this._driverInfo).navigationBarHeight && (_4.navigationBarHeight = this._driverInfo.navigationBarHeight / this.pixelRatio);
+                }
             }
             // calculate viewport size
             if (!this._driverInfo.viewportSize) {
                 this._driverInfo.viewportSize = {
                     width: displaySize.width,
-                    height: displaySize.height - this._driverInfo.statusBarHeight,
+                    height: displaySize.height - this.statusBarHeight,
                 };
             }
             // calculate safe area
@@ -214,7 +226,7 @@ class Driver {
                 : await helper_android_1.HelperAndroid.make({ spec: this._spec, driver: this, logger: this._logger });
         }
         if (this.isMobile) {
-            (_v = (_3 = this._driverInfo).orientation) !== null && _v !== void 0 ? _v : (_3.orientation = await this.getOrientation().catch(() => undefined));
+            (_v = (_5 = this._driverInfo).orientation) !== null && _v !== void 0 ? _v : (_5.orientation = await this.getOrientation().catch(() => undefined));
         }
         this._logger.log('Combined driver info', this._driverInfo);
         return this;
@@ -381,11 +393,11 @@ class Driver {
         }
         return this.currentContext;
     }
-    async normalizeRegion(region, shouldIgnoreSafeRegion) {
+    async normalizeRegion(region) {
         if (this.isWeb || !utils.types.has(this._driverInfo, ['viewportSize', 'statusBarHeight']))
             return region;
         const scaledRegion = this.isAndroid ? utils.geometry.scale(region, 1 / this.pixelRatio) : region;
-        const safeRegion = this.isIOS && !shouldIgnoreSafeRegion
+        const safeRegion = this.isIOS && utils.geometry.isIntersected(scaledRegion, this._driverInfo.safeArea)
             ? utils.geometry.intersect(scaledRegion, this._driverInfo.safeArea)
             : scaledRegion;
         const offsetRegion = utils.geometry.offsetNegative(safeRegion, {
@@ -423,9 +435,11 @@ class Driver {
         let size;
         if (this.isNative) {
             if ((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.viewportSize) {
+                this._logger.log('Extracting viewport size from native driver using cached value');
                 size = this._driverInfo.viewportSize;
             }
             else {
+                this._logger.log('Extracting viewport size from native driver');
                 size = await this.getDisplaySize();
                 if (size.height > size.width) {
                     const orientation = await this.getOrientation();
@@ -433,14 +447,15 @@ class Driver {
                         size = { width: size.height, height: size.width };
                     }
                 }
+                size.height -= this.statusBarHeight;
             }
+            this._logger.log(`Rounding viewport size using`, this._customConfig.useCeilForViewportSize ? 'ceil' : 'round');
             if (this._customConfig.useCeilForViewportSize) {
                 size = utils.geometry.ceil(size);
             }
             else {
                 size = utils.geometry.round(size);
             }
-            this._logger.log(`Extracting viewport size from native driver using '${this._customConfig.useCeilForViewportSize ? 'ceil' : 'round'}' method`);
         }
         else if (this._spec.getViewportSize) {
             this._logger.log('Extracting viewport size from web driver using spec method');
@@ -492,20 +507,22 @@ class Driver {
         if (this.isWeb && !this.isMobile)
             return;
         const size = await this._spec.getWindowSize(this.target);
-        return this.isAndroid ? utils.geometry.scale(size, 1 / this.pixelRatio) : size;
+        const normalizedSize = this.isAndroid ? utils.geometry.scale(size, 1 / this.pixelRatio) : size;
+        this._logger.log('Extracted and normalized display size:', normalizedSize);
+        return normalizedSize;
     }
     async getOrientation() {
         if (this.isWeb && !this.isMobile)
             return;
-        const orientation = this._spec.getOrientation(this.target);
+        const orientation = await this._spec.getOrientation(this.target);
         this._logger.log('Extracted device orientation:', orientation);
         return orientation;
     }
     async setOrientation(orientation) {
         if (this.isWeb && !this.isMobile)
             return;
+        this._logger.log('Set device orientation:', orientation);
         await this._spec.setOrientation(this.target, orientation);
-        this._logger.log('set device orientation:', orientation);
     }
     async getCookies() {
         var _a, _b, _c;
@@ -529,7 +546,7 @@ class Driver {
     async getUrl() {
         if (this.isNative)
             return null;
-        const url = this._spec.getUrl(this.target);
+        const url = await this._spec.getUrl(this.target);
         this._logger.log('Extracted url:', url);
         return url;
     }

package/dist/element.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -106,7 +110,7 @@ class Element {
             return this;
         }
     }
-    async getRegion(shouldIgnoreSafeRegion) {
+    async getRegion() {
         const region = await this.withRefresh(async () => {
             if (this.driver.isWeb) {
                 this._logger.log('Extracting region of web element with selector', this.selector);
@@ -116,7 +120,7 @@ class Element {
                 this._logger.log('Extracting region of native element with selector', this.selector);
                 const region = await this._spec.getElementRegion(this.driver.target, this.target);
                 this._logger.log('Extracted native region', region);
-                return this.driver.normalizeRegion(region, shouldIgnoreSafeRegion);
+                return this.driver.normalizeRegion(region);
             }
         });
         this._logger.log('Extracted region', region);

package/dist/fake/index.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/fake/spec-driver.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/index.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/spec-utils.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/user-agent.js

@@ -1,7 +1,11 @@
 "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]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/driver",
-  "version": "1.8.0",
+  "version": "1.8.3",
   "description": "Applitools universal framework wrapper",
   "keywords": [
     "applitools",
@@ -73,26 +73,27 @@
     }
   },
   "dependencies": {
+    "@applitools/logger": "1.1.4",
     "@applitools/snippets": "2.2.3",
-    "@applitools/types": "1.4.0",
-    "@applitools/utils": "1.2.14"
+    "@applitools/types": "1.4.2",
+    "@applitools/utils": "1.3.0"
   },
   "devDependencies": {
-    "@applitools/bongo": "^2.0.3",
-    "@types/mocha": "^9.0.0",
-    "@types/node": "^16.3.3",
-    "@typescript-eslint/eslint-plugin": "^4.28.3",
-    "@typescript-eslint/parser": "^4.28.3",
-    "eslint": "^7.9.0",
-    "eslint-config-prettier": "^8.3.0",
+    "@applitools/bongo": "^2.1.0",
+    "@types/mocha": "^9.1.1",
+    "@types/node": "^17.0.31",
+    "@typescript-eslint/eslint-plugin": "^5.22.0",
+    "@typescript-eslint/parser": "^5.22.0",
+    "eslint": "^8.14.0",
+    "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-mocha-no-only": "^1.1.1",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^3.1.4",
+    "eslint-plugin-prettier": "^4.0.0",
     "husky": "^4.3.7",
-    "mocha": "^9.0.3",
-    "prettier": "^2.3.2",
-    "ts-node": "^10.1.0",
-    "typescript": "^4.3.5"
+    "mocha": "^10.0.0",
+    "prettier": "^2.6.2",
+    "ts-node": "^10.7.0",
+    "typescript": "^4.6.4"
   },
   "engines": {
     "node": ">= 8.9.0"

package/types/context.d.ts

@@ -1,5 +1,6 @@
 import type * as types from '@applitools/types';
-import type { Driver } from './driver';
+import { type Logger } from '@applitools/logger';
+import { type Driver } from './driver';
 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 ContextPlain<TDriver, TContext, TElement, TSelector> = ContextReference<TDriver, TContext, TElement, TSelector> | {
@@ -32,7 +33,7 @@ export declare class Context<TDriver, TContext, TElement, TSelector> {
         reference?: ContextReference<TDriver, TContext, TElement, TSelector>;
         element?: Element<TDriver, TContext, TElement, TSelector>;
         scrollingElement?: Element<TDriver, TContext, TElement, TSelector>;
-        logger?: any;
+        logger?: Logger;
     });
     get target(): TContext;
     get driver(): Driver<TDriver, TContext, TElement, TSelector>;

package/types/driver.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="node" />
 import type * as types from '@applitools/types';
+import { type Logger } from '@applitools/logger';
 import { Context, ContextReference } from './context';
 import { Element } from './element';
 import { HelperIOS } from './helper-ios';
@@ -16,7 +17,7 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
     constructor(options: {
         spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
         driver: Driver<TDriver, TContext, TElement, TSelector> | TDriver;
-        logger?: any;
+        logger?: Logger;
         customConfig?: types.CustomDriverConfig;
     });
     get target(): TDriver;
@@ -52,7 +53,7 @@ export declare class Driver<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, shouldIgnoreSafeRegion?: boolean): Promise<types.Region>;
+    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>[]>;
@@ -62,7 +63,7 @@ export declare class Driver<TDriver, TContext, TElement, TSelector> {
     setViewportSize(size: types.Size): Promise<void>;
     getDisplaySize(): Promise<types.Size>;
     getOrientation(): Promise<'portrait' | 'landscape'>;
-    setOrientation(orientation: types.ScreenOrientation): Promise<void>;
+    setOrientation(orientation: 'portrait' | 'landscape'): Promise<void>;
     getCookies(): Promise<types.Cookie[]>;
     getTitle(): Promise<string>;
     getUrl(): Promise<string>;

package/types/element.d.ts

@@ -1,5 +1,6 @@
 import type * as types from '@applitools/types';
-import type { Context } from './context';
+import { type Logger } from '@applitools/logger';
+import { type Context } from './context';
 export declare type ElementState = {
     contentSize?: types.Size;
     scrollOffset?: types.Location;
@@ -21,7 +22,7 @@ export declare class Element<TDriver, TContext, TElement, TSelector> {
         context?: Context<TDriver, TContext, TElement, TSelector>;
         selector?: types.Selector<TSelector>;
         index?: number;
-        logger?: any;
+        logger?: Logger;
         root?: TElement;
     });
     get target(): TElement;
@@ -31,7 +32,7 @@ export declare class Element<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(shouldIgnoreSafeRegion?: boolean): Promise<types.Region>;
+    getRegion(): Promise<types.Region>;
     getClientRegion(): Promise<types.Region>;
     getContentSize(): Promise<types.Size>;
     isScrollable(): Promise<boolean>;

package/types/helper-android.d.ts

@@ -1,11 +1,12 @@
 import type * as types from '@applitools/types';
+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>;
         driver: Driver<TDriver, TContext, TElement, TSelector>;
-        logger: any;
+        logger: Logger;
     }): Promise<HelperAndroid<TDriver, TContext, TElement, TSelector> | null>;
     private readonly _spec;
     private readonly _element;

package/types/helper-ios.d.ts

@@ -1,11 +1,12 @@
 import type * as types from '@applitools/types';
+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>;
         driver: Driver<TDriver, TContext, TElement, TSelector>;
-        logger: any;
+        logger: Logger;
     }): Promise<HelperIOS<TDriver, TContext, TElement, TSelector> | null>;
     private readonly _driver;
     private readonly _element;
@@ -15,7 +16,7 @@ export declare class HelperIOS<TDriver, TContext, TElement, TSelector> {
         driver: Driver<TDriver, TContext, TElement, TSelector>;
         element: Element<TDriver, TContext, TElement, TSelector>;
         spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
-        logger?: any;
+        logger?: Logger;
     });
     getContentSize(_element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Size>;
 }