@applitools/driver 1.2.5 → 1.3.1

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 ## Unreleased
 
 
+## 1.3.1 - 2021/11/14
+
+- add in-house capability parsing and system bars size handling mechanisms
+- adjust scrolling algorithm on native devices
+- support cookies
+- updated to @applitools/types@1.0.20 (from 1.0.19)
+
+## 1.3.0 - 2021/11/10
+
+- updated to @applitools/types@1.0.19 (from 1.0.18)
+
+## 1.3.0 - 2021/11/10
+
+- updated to @applitools/types@1.0.19 (from 1.0.18)
+
+## 1.2.7 - 2021/10/30
+
+- updated to @applitools/types@1.0.18 (from 1.0.14)
+- updated to @applitools/utils@1.2.4 (from 1.2.3)
+
+## 1.2.6 - 2021/10/7
+
+- fix issue with fractional viewport size on mobile devices
+
 ## 1.2.5 - 2021/10/5
 
 - fix issue with wrong user agent overrides valid driver info

package/dist/capabilities.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCapabilities = void 0;
+function parseCapabilities(capabilities) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const info = {
+        browserName: ((_a = capabilities.browserName) !== null && _a !== void 0 ? _a : (_b = capabilities.desired) === null || _b === void 0 ? void 0 : _b.browserName) || undefined,
+        browserVersion: ((_c = capabilities.browserVersion) !== null && _c !== void 0 ? _c : capabilities.version) || undefined,
+        platformName: ((_e = (_d = capabilities.platformName) !== null && _d !== void 0 ? _d : capabilities.platform) !== null && _e !== void 0 ? _e : (_f = capabilities.desired) === null || _f === void 0 ? void 0 : _f.platformName) || undefined,
+        platformVersion: capabilities.platformVersion || undefined,
+        isW3C: isW3C(capabilities),
+        isMobile: isMobile(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;
+        info.isNative = info.isMobile && !info.browserName;
+        info.isIOS = isIOS(capabilities);
+        info.isAndroid = isAndroid(capabilities);
+    }
+    if (info.isNative) {
+        info.pixelRatio = capabilities.pixelRatio;
+        info.statusBarHeight = capabilities.statBarHeight;
+        info.navigationBarHeight = 0;
+    }
+    return info;
+}
+exports.parseCapabilities = parseCapabilities;
+function isW3C(capabilities) {
+    const isW3C = Boolean((capabilities.platformName || capabilities.browserVersion) &&
+        (capabilities.platformVersion || capabilities.hasOwnProperty('setWindowRect')));
+    return isW3C || isAppium(capabilities);
+}
+function isAppium(capabilities) {
+    return (Boolean(capabilities.automationName || capabilities.deviceName || capabilities.appiumVersion) ||
+        Object.keys(capabilities).some(cap => cap.startsWith('appium:')));
+}
+function _isChrome(capabilities) {
+    return Boolean(capabilities.chrome || capabilities['goog:chromeOptions']);
+}
+function _isFirefox(capabilities) {
+    return capabilities.browserName === 'firefox' || Object.keys(capabilities).some(cap => cap.startsWith('moz:'));
+}
+function isMobile(capabilities) {
+    var _a, _b;
+    return (capabilities.browserName === '' ||
+        ['ipad', 'iphone', 'android'].includes((_b = (_a = capabilities.browserName) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '') ||
+        isAppium(capabilities));
+}
+function isIOS(capabilities) {
+    return /iOS/i.test(capabilities.platformName) || /(iPad|iPhone)/i.test(capabilities.deviceName);
+}
+function isAndroid(capabilities) {
+    return /Android/i.test(capabilities.platformName) || /Android/i.test(capabilities.browserName);
+}

package/dist/context.js

@@ -437,6 +437,13 @@ class Context {
         }
         return region;
     }
+    async getCookies() {
+        var _a, _b;
+        if (this.driver.isNative)
+            return [];
+        await this.focus();
+        return (_b = (_a = this._spec) === null || _a === void 0 ? void 0 : _a.getCookies(this.target, true)) !== null && _b !== void 0 ? _b : [];
+    }
     async preserveInnerOffset() {
         this._state.innerOffset = await this.getInnerOffset();
     }

package/dist/driver.js

@@ -24,6 +24,7 @@ const utils = __importStar(require("@applitools/utils"));
 const context_1 = require("./context");
 const utils_1 = require("./utils");
 const user_agent_1 = require("./user-agent");
+const capabilities_1 = require("./capabilities");
 const snippets = require('@applitools/snippets');
 // eslint-disable-next-line
 class Driver {
@@ -125,23 +126,43 @@ class Driver {
         this._currentContext = context;
     }
     async init() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
-        this._driverInfo = await ((_b = (_a = this._spec).getDriverInfo) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        var _s, _t, _u, _v, _w, _x;
+        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) : 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) {
-            const userAgent = (_d = (_c = this._driverInfo) === null || _c === void 0 ? void 0 : _c.userAgent) !== null && _d !== void 0 ? _d : (await this.execute(snippets.getUserAgent));
-            const pixelRatio = (_f = (_e = this._driverInfo) === null || _e === void 0 ? void 0 : _e.pixelRatio) !== null && _f !== void 0 ? _f : (await this.execute(snippets.getPixelRatio));
-            const userAgentInfo = userAgent ? user_agent_1.parseUserAgent(userAgent) : {};
-            this._driverInfo = Object.assign(Object.assign({}, this._driverInfo), { isMobile: (_h = (_g = this._driverInfo) === null || _g === void 0 ? void 0 : _g.isMobile) !== null && _h !== void 0 ? _h : ['iOS', 'Android'].includes(userAgentInfo.platformName), platformName: ((_j = this._driverInfo) === null || _j === void 0 ? void 0 : _j.isMobile)
-                    ? (_l = (_k = this._driverInfo) === null || _k === void 0 ? void 0 : _k.platformName) !== null && _l !== void 0 ? _l : userAgentInfo.platformName
-                    : (_m = userAgentInfo.platformName) !== null && _m !== void 0 ? _m : (_o = this._driverInfo) === null || _o === void 0 ? void 0 : _o.platformName, platformVersion: ((_p = this._driverInfo) === null || _p === void 0 ? void 0 : _p.isMobile)
-                    ? (_r = (_q = this._driverInfo) === null || _q === void 0 ? void 0 : _q.platformVersion) !== null && _r !== void 0 ? _r : userAgentInfo.platformVersion
-                    : (_s = userAgentInfo.platformVersion) !== null && _s !== void 0 ? _s : (_t = this._driverInfo) === null || _t === void 0 ? void 0 : _t.platformVersion, browserName: (_u = userAgentInfo.browserName) !== null && _u !== void 0 ? _u : (_v = this._driverInfo) === null || _v === void 0 ? void 0 : _v.browserName, browserVersion: (_w = userAgentInfo.browserVersion) !== null && _w !== void 0 ? _w : (_x = this._driverInfo) === null || _x === void 0 ? void 0 : _x.browserVersion, userAgent,
-                pixelRatio });
+            (_e = (_s = this._driverInfo).pixelRatio) !== null && _e !== void 0 ? _e : (_s.pixelRatio = await this.execute(snippets.getPixelRatio));
+            (_f = (_t = this._driverInfo).userAgent) !== null && _f !== void 0 ? _f : (_t.userAgent = await this.execute(snippets.getUserAgent));
+            if (this._driverInfo.userAgent) {
+                const userAgentInfo = user_agent_1.parseUserAgent(this._driverInfo.userAgent);
+                this._driverInfo.browserName = (_g = userAgentInfo.browserName) !== null && _g !== void 0 ? _g : this._driverInfo.browserName;
+                this._driverInfo.browserVersion = (_h = userAgentInfo.browserVersion) !== null && _h !== void 0 ? _h : this._driverInfo.browserVersion;
+                if (!this._driverInfo.isMobile) {
+                    (_j = (_u = this._driverInfo).platformName) !== null && _j !== void 0 ? _j : (_u.platformName = userAgentInfo.platformName);
+                    (_k = (_v = this._driverInfo).platformVersion) !== null && _k !== void 0 ? _k : (_v.platformVersion = userAgentInfo.platformVersion);
+                }
+                else {
+                    this._driverInfo.platformName = (_l = userAgentInfo.platformName) !== null && _l !== void 0 ? _l : this._driverInfo.platformName;
+                    this._driverInfo.platformVersion = (_m = userAgentInfo.platformVersion) !== null && _m !== void 0 ? _m : this._driverInfo.platformVersion;
+                }
+            }
+            (_o = (_w = this._driverInfo).features) !== null && _o !== void 0 ? _o : (_w.features = {});
+            (_p = (_x = this._driverInfo.features).allCookies) !== null && _p !== void 0 ? _p : (_x.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
         }
         else {
-            if (this.isAndroid) {
-                this._driverInfo.statusBarHeight = this._driverInfo.statusBarHeight / this.pixelRatio;
-                this._driverInfo.navigationBarHeight = this._driverInfo.navigationBarHeight / this.pixelRatio;
+            if (this.isNative) {
+                const barsHeight = await ((_r = (_q = this._spec).getBarsHeight) === null || _r === void 0 ? void 0 : _r.call(_q, this.target).catch(() => undefined));
+                if (barsHeight) {
+                    this._driverInfo.statusBarHeight = Math.max(barsHeight.statusBarHeight, driverInfo.statusBarHeight);
+                    this._driverInfo.navigationBarHeight = Math.max(barsHeight.navigationBarHeight, driverInfo.navigationBarHeight);
+                }
+                if (this.isAndroid) {
+                    this._driverInfo.statusBarHeight /= this.pixelRatio;
+                    this._driverInfo.navigationBarHeight /= this.pixelRatio;
+                }
             }
             if (!this._driverInfo.viewportSize) {
                 const displaySize = await this.getDisplaySize();
@@ -151,7 +172,7 @@ class Driver {
                 };
             }
         }
-        this._logger.log('Driver initialized', this._driverInfo);
+        this._logger.log('Combined driver info', this._driverInfo);
         return this;
     }
     async refreshContexts() {
@@ -354,6 +375,7 @@ class Driver {
                     }
                 }
             }
+            size = utils.geometry.round(size);
         }
         else if (this._spec.getViewportSize) {
             this._logger.log('Extracting viewport size from web driver using spec method');
@@ -411,6 +433,12 @@ class Driver {
         this._logger.log('Extracted device orientation:', orientation);
         return orientation;
     }
+    async getCookies() {
+        var _a, _b;
+        if (this.isNative || !this.features.allCookies)
+            return [];
+        return (_b = (_a = this._spec) === null || _a === void 0 ? void 0 : _a.getCookies(this.target)) !== null && _b !== void 0 ? _b : [];
+    }
     async getTitle() {
         if (this.isNative)
             return null;

package/dist/element.js

@@ -309,12 +309,20 @@ class Element {
                 let remainingOffset;
                 if (offset.x === 0 && offset.y === 0) {
                     requiredOffset = offset;
-                    remainingOffset = { x: -maxOffset.x, y: -maxOffset.y };
+                    // if it has to be scrolled to the very beginning, then scroll maximum amount of pixels and a bit extra to be sure
+                    remainingOffset = { x: -(maxOffset.x + 0), y: -(maxOffset.y + 0) };
                 }
                 else {
                     requiredOffset = { x: Math.min(offset.x, maxOffset.x), y: Math.min(offset.y, maxOffset.y) };
                     remainingOffset = utils.geometry.offsetNegative(requiredOffset, currentScrollOffset);
+                    // if it has to be scrolled to the very end, then do a bit of extra scrolling to be sure
+                    // if (requiredOffset.x === maxOffset.x) remainingOffset.x += 100
+                    // if (requiredOffset.y === maxOffset.y) remainingOffset.y += 100
                 }
+                // if (requiredOffset.x === 0) remainingOffset.x -= 100
+                // if (requiredOffset.y === 0) remainingOffset.y -= 100
+                // if (requiredOffset.x === maxOffset.x) remainingOffset.x += 100
+                // if (requiredOffset.y === maxOffset.y) remainingOffset.y += 100
                 if (this.driver.isAndroid) {
                     remainingOffset = utils.geometry.scale(remainingOffset, this.driver.pixelRatio);
                 }
@@ -330,7 +338,7 @@ class Element {
                     actions.push({ action: 'press', x: xStart, y: yCenter }, { action: 'wait', ms: 1500 }, { action: 'moveTo', x: xEnd, y: yCenter }, { action: 'release' });
                     xRemaining -= xRight - xLeft;
                 }
-                const yPadding = Math.floor(scrollableRegion.height * 0.1);
+                const yPadding = Math.floor(scrollableRegion.height * 0.08);
                 const xCenter = Math.floor(scrollableRegion.x + scrollableRegion.width / 2); // 0
                 const yTop = scrollableRegion.y + yPadding;
                 const yDirection = remainingOffset.y > 0 ? 'down' : 'up';

package/dist/fake/index.js

@@ -0,0 +1,25 @@
+"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.spec = exports.MockDriver = void 0;
+var mock_driver_1 = require("./mock-driver");
+Object.defineProperty(exports, "MockDriver", { enumerable: true, get: function () { return mock_driver_1.MockDriver; } });
+exports.spec = __importStar(require("./spec-driver"));

package/dist/fake/mock-driver.js

@@ -1,3 +1,7 @@
+"use strict";
+// @ts-nocheck
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockDriver = void 0;
 const { inspect } = require('util');
 const utils = require('@applitools/utils');
 const snippets = require('@applitools/snippets');
@@ -18,7 +22,8 @@ const DEFAULT_PROPS = {
     overflow: null,
 };
 class MockDriver {
-    constructor({ viewport = { width: 1000, height: 1000 }, device, platform, browser, ua } = {}) {
+    constructor(options = {}) {
+        const { viewport = { width: 1000, height: 1000 }, device, platform, browser, ua } = options;
         this._device = device;
         this._platform = platform;
         this._browser = browser;
@@ -336,4 +341,4 @@ class MockDriver {
         return '<MockDriver>';
     }
 }
-module.exports = { MockDriver };
+exports.MockDriver = MockDriver;

package/dist/fake/spec-driver.js

@@ -1,66 +1,104 @@
-const utils = require('@applitools/utils');
-const spec = {
-    isDriver(driver) {
-        return driver && driver.constructor.name === 'MockDriver';
-    },
-    isElement(element) {
-        return utils.types.has(element, 'id');
-    },
-    isSelector(selector) {
-        return utils.types.isString(selector) || utils.types.has(selector, ['using', 'value']);
-    },
-    transformSelector(selector) {
-        return selector.selector || selector;
-    },
-    isStaleElementError() {
-        return false;
-    },
-    isEqualElements(_driver, element1, element2) {
-        return element1.id === element2.id;
-    },
-    executeScript(driver, script, ...args) {
-        return driver.executeScript(script, args);
-    },
-    findElement(driver, selector, parent) {
-        return driver.findElement(selector.selector || selector, parent);
-    },
-    findElements(driver, selector, parent) {
-        return driver.findElements(selector.selector || selector, parent);
-    },
-    mainContext(driver) {
-        return driver.switchToFrame(null);
-    },
-    parentContext(driver) {
-        return driver.switchToParentFrame();
-    },
-    childContext(driver, reference) {
-        return driver.switchToFrame(reference);
-    },
-    takeScreenshot(driver) {
-        return driver.takeScreenshot();
-    },
-    getDriverInfo(driver) {
-        return driver.info;
-    },
-    async getWindowSize(driver) {
-        const rect = await driver.getWindowRect();
-        return rect;
-    },
-    async setWindowSize(driver, size) {
-        await driver.setWindowRect(size);
-    },
-    async getUrl(driver) {
-        if (this._isNative)
-            return null;
-        return driver.getUrl();
-    },
-    async getTitle(driver) {
-        if (this._isNative)
-            return null;
-        return driver.getTitle();
-    },
-    async visit(driver, url) {
-        await driver.visit(url);
-    },
+"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;
 };
-module.exports = { spec };
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.visit = exports.getTitle = exports.getUrl = exports.setWindowSize = exports.getWindowSize = exports.getDriverInfo = exports.takeScreenshot = exports.childContext = exports.parentContext = exports.mainContext = exports.findElements = exports.findElement = exports.executeScript = exports.isEqualElements = exports.isStaleElementError = exports.transformSelector = exports.isSelector = exports.isElement = exports.isDriver = void 0;
+const utils = __importStar(require("@applitools/utils"));
+function isDriver(driver) {
+    return driver && driver.constructor.name === 'MockDriver';
+}
+exports.isDriver = isDriver;
+function isElement(element) {
+    return utils.types.has(element, 'id');
+}
+exports.isElement = isElement;
+function isSelector(selector) {
+    return utils.types.isString(selector) || utils.types.has(selector, ['using', 'value']);
+}
+exports.isSelector = isSelector;
+function transformSelector(selector) {
+    return utils.types.has(selector, 'selector') ? selector.selector : selector;
+}
+exports.transformSelector = transformSelector;
+function isStaleElementError() {
+    return false;
+}
+exports.isStaleElementError = isStaleElementError;
+async function isEqualElements(_driver, element1, element2) {
+    return element1.id === element2.id;
+}
+exports.isEqualElements = isEqualElements;
+async function executeScript(driver, script, arg) {
+    return driver.executeScript(script, [arg]);
+}
+exports.executeScript = executeScript;
+async function findElement(driver, selector, parent) {
+    return driver.findElement(selector, parent);
+}
+exports.findElement = findElement;
+async function findElements(driver, selector, parent) {
+    return driver.findElements(selector, parent);
+}
+exports.findElements = findElements;
+async function mainContext(driver) {
+    return driver.switchToFrame(null);
+}
+exports.mainContext = mainContext;
+async function parentContext(driver) {
+    return driver.switchToParentFrame();
+}
+exports.parentContext = parentContext;
+async function childContext(driver, element) {
+    return driver.switchToFrame(element);
+}
+exports.childContext = childContext;
+async function takeScreenshot(driver) {
+    return driver.takeScreenshot();
+}
+exports.takeScreenshot = takeScreenshot;
+async function getDriverInfo(driver) {
+    return driver.info;
+}
+exports.getDriverInfo = getDriverInfo;
+async function getWindowSize(driver) {
+    const rect = await driver.getWindowRect();
+    return rect;
+}
+exports.getWindowSize = getWindowSize;
+async function setWindowSize(driver, size) {
+    await driver.setWindowRect(size);
+}
+exports.setWindowSize = setWindowSize;
+async function getUrl(driver) {
+    if (this._isNative)
+        return null;
+    return driver.getUrl();
+}
+exports.getUrl = getUrl;
+async function getTitle(driver) {
+    if (this._isNative)
+        return null;
+    return driver.getTitle();
+}
+exports.getTitle = getTitle;
+async function visit(driver, url) {
+    await driver.visit(url);
+}
+exports.visit = visit;

package/dist/index.js

@@ -6,25 +6,10 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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 __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-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.fake = void 0;
 __exportStar(require("./driver"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./element"), exports);
-__exportStar(require("./fake/mock-driver"), exports);
-exports.fake = __importStar(require("./fake/spec-driver"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/driver",
-  "version": "1.2.5",
+  "version": "1.3.1",
   "description": "Applitools universal framework wrapper",
   "keywords": [
     "applitools",
@@ -16,7 +16,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git://github.com/applitools/eyes.sdk.javascript1.git"
+    "url": "git://github.com/applitools/eyes.sdk.javascript1.git",
+    "directory": "packages/driver"
   },
   "license": "SEE LICENSE IN LICENSE",
   "author": {
@@ -25,12 +26,22 @@
   },
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
-  "directories": {
-    "lib": "./src",
-    "test": "./test"
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./fake": {
+      "default": "./dist/fake/index.js",
+      "types": "./types/fake/index.d.ts"
+    }
   },
+  "files": [
+    "dist",
+    "types"
+  ],
   "scripts": {
-    "lint": "eslint '**/*.ts' '**/*.js'",
+    "lint": "eslint '**/*.ts'",
     "build": "tsc",
     "test": "mocha --no-timeouts -r ts-node/register ./test/**/*.spec.ts",
     "deps": "bongo deps",
@@ -45,11 +56,11 @@
   },
   "dependencies": {
     "@applitools/snippets": "2.1.7",
-    "@applitools/types": "1.0.14",
-    "@applitools/utils": "1.2.3"
+    "@applitools/types": "1.0.20",
+    "@applitools/utils": "1.2.4"
   },
   "devDependencies": {
-    "@applitools/sdk-release-kit": "0.13.3",
+    "@applitools/sdk-release-kit": "0.13.4",
     "@types/mocha": "^9.0.0",
     "@types/node": "^16.3.3",
     "@typescript-eslint/eslint-plugin": "^4.28.3",

package/types/capabilities.d.ts

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

package/types/context.d.ts

@@ -0,0 +1,71 @@
+import type * as types from '@applitools/types';
+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> | {
+    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;
+};
+export declare class Context<TDriver, TContext, TElement, TSelector> {
+    private _target;
+    private _driver;
+    private _parent;
+    private _element;
+    private _reference;
+    private _scrollingElement;
+    private _state;
+    private _logger;
+    private _utils;
+    private _isReference;
+    protected readonly _spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+    constructor(options: {
+        spec: types.SpecDriver<TDriver, TContext, TElement, TSelector>;
+        context?: TContext | Context<TDriver, TContext, TElement, TSelector>;
+        driver?: Driver<TDriver, TContext, TElement, TSelector>;
+        parent?: 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;
+    });
+    get target(): TContext;
+    get driver(): Driver<TDriver, TContext, TElement, TSelector>;
+    get parent(): Context<TDriver, TContext, TElement, TSelector> | null;
+    get main(): Context<TDriver, TContext, TElement, TSelector>;
+    get path(): Context<TDriver, TContext, TElement, TSelector>[];
+    get isMain(): boolean;
+    get isCurrent(): boolean;
+    get isInitialized(): boolean;
+    get isRef(): boolean;
+    init(): Promise<this>;
+    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>>;
+    element(elementOrSelector: TElement | types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
+    elements(elementOrSelector: TElement | types.Selector<TSelector>): 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>;
+    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[]>;
+    private preserveInnerOffset;
+    private preserveContextRegions;
+    private preserveScrollingRegion;
+}