@serenity-js/web 3.0.0-rc.9 → 3.0.1

package/lib/screenplay/models/dialogs/ModalDialogHandler.d.ts

@@ -0,0 +1,38 @@
+import { ModalDialog } from './ModalDialog';
+/**
+ * Represent the strategy to use with any upcoming {@apilink ModalDialog} windows.
+ *
+ * ## Learn more
+ *
+ * - {@apilink ModalDialog}
+ * - {@apilink Page.modalDialog}
+ *
+ * @group Models
+ */
+export declare abstract class ModalDialogHandler {
+    protected modalDialog: ModalDialog;
+    protected constructor(modalDialog?: ModalDialog);
+    /**
+     * Configures the handler to accept the next JavaScript modal dialog.
+     */
+    abstract acceptNext(): Promise<void>;
+    /**
+     * Configures the handler to accept the next JavaScript `prompt``
+     * with a given `text` value.
+     */
+    abstract acceptNextWithValue(text: string | number): Promise<void>;
+    /**
+     * Configures the handler to dismiss the next JavaScript modal dialog.
+     */
+    abstract dismissNext(): Promise<void>;
+    /**
+     * Resets the handler to its default state.
+     */
+    abstract reset(): Promise<void>;
+    /**
+     * Returns the most recently handled {@apilink ModalDialog},
+     * or {@apilink AbsentModalDialog} when no dialogs have been handled yet.
+     */
+    last(): Promise<ModalDialog>;
+}
+//# sourceMappingURL=ModalDialogHandler.d.ts.map

package/lib/screenplay/models/dialogs/ModalDialogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogHandler.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/dialogs/ModalDialogHandler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;GASG;AACH,8BAAsB,kBAAkB;IAEd,SAAS,CAAC,WAAW,EAAE,WAAW;IAAxD,SAAS,aAAuB,WAAW,GAAE,WAAqC;IAIlF;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;CAGrC"}

package/lib/screenplay/models/dialogs/ModalDialogHandler.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalDialogHandler = void 0;
+const tiny_types_1 = require("tiny-types");
+const AbsentModalDialog_1 = require("./AbsentModalDialog");
+/**
+ * Represent the strategy to use with any upcoming {@apilink ModalDialog} windows.
+ *
+ * ## Learn more
+ *
+ * - {@apilink ModalDialog}
+ * - {@apilink Page.modalDialog}
+ *
+ * @group Models
+ */
+class ModalDialogHandler {
+    constructor(modalDialog = new AbsentModalDialog_1.AbsentModalDialog()) {
+        this.modalDialog = modalDialog;
+        (0, tiny_types_1.ensure)('modalDialog', modalDialog, (0, tiny_types_1.isDefined)());
+    }
+    /**
+     * Returns the most recently handled {@apilink ModalDialog},
+     * or {@apilink AbsentModalDialog} when no dialogs have been handled yet.
+     */
+    async last() {
+        return this.modalDialog;
+    }
+}
+exports.ModalDialogHandler = ModalDialogHandler;
+//# sourceMappingURL=ModalDialogHandler.js.map

package/lib/screenplay/models/dialogs/ModalDialogHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogHandler.js","sourceRoot":"","sources":["../../../../src/screenplay/models/dialogs/ModalDialogHandler.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAE/C,2DAAwD;AAGxD;;;;;;;;;GASG;AACH,MAAsB,kBAAkB;IAEpC,YAAgC,cAA2B,IAAI,qCAAiB,EAAE;QAAlD,gBAAW,GAAX,WAAW,CAAuC;QAC9E,IAAA,mBAAM,EAAC,aAAa,EAAE,WAAW,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;IACpD,CAAC;IAuBD;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;CACJ;AAlCD,gDAkCC"}

package/lib/screenplay/models/dialogs/index.d.ts

@@ -0,0 +1,6 @@
+export * from './AbsentModalDialog';
+export * from './AcceptedModalDialog';
+export * from './DismissedModalDialog';
+export * from './ModalDialog';
+export * from './ModalDialogHandler';
+//# sourceMappingURL=index.d.ts.map

package/lib/screenplay/models/dialogs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/dialogs/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/lib/screenplay/models/dialogs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = 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];
+}));
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AbsentModalDialog"), exports);
+__exportStar(require("./AcceptedModalDialog"), exports);
+__exportStar(require("./DismissedModalDialog"), exports);
+__exportStar(require("./ModalDialog"), exports);
+__exportStar(require("./ModalDialogHandler"), exports);
+//# sourceMappingURL=index.js.map

package/lib/screenplay/models/dialogs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/models/dialogs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,wDAAsC;AACtC,yDAAuC;AACvC,gDAA8B;AAC9B,uDAAqC"}

package/lib/screenplay/models/index.d.ts

@@ -1,8 +1,16 @@
+export * from './BrowserCapabilities';
+export * from './BrowsingSession';
 export * from './Cookie';
 export * from './CookieData';
+export * from './dialogs';
+export * from './Key';
 export * from './Locator';
-export * from './ModalDialog';
 export * from './Page';
 export * from './PageElement';
 export * from './PageElements';
+export * from './RootLocator';
+export * from './SelectOption';
 export * from './selectors';
+export * from './Switchable';
+export * from './SwitchableOrigin';
+//# sourceMappingURL=index.d.ts.map

package/lib/screenplay/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/lib/screenplay/models/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];
@@ -10,12 +14,19 @@ 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);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BrowserCapabilities"), exports);
+__exportStar(require("./BrowsingSession"), exports);
 __exportStar(require("./Cookie"), exports);
 __exportStar(require("./CookieData"), exports);
+__exportStar(require("./dialogs"), exports);
+__exportStar(require("./Key"), exports);
 __exportStar(require("./Locator"), exports);
-__exportStar(require("./ModalDialog"), exports);
 __exportStar(require("./Page"), exports);
 __exportStar(require("./PageElement"), exports);
 __exportStar(require("./PageElements"), exports);
+__exportStar(require("./RootLocator"), exports);
+__exportStar(require("./SelectOption"), exports);
 __exportStar(require("./selectors"), exports);
+__exportStar(require("./Switchable"), exports);
+__exportStar(require("./SwitchableOrigin"), exports);
 //# sourceMappingURL=index.js.map

package/lib/screenplay/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,gDAA8B;AAC9B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,oDAAkC;AAClC,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,wCAAsB;AACtB,4CAA0B;AAC1B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,+CAA6B;AAC7B,qDAAmC"}

package/lib/screenplay/models/selectors/By.d.ts

@@ -4,10 +4,48 @@ import { ByCssContainingText } from './ByCssContainingText';
 import { ById } from './ById';
 import { ByTagName } from './ByTagName';
 import { ByXPath } from './ByXPath';
+/**
+ * @group Models
+ */
 export declare class By {
+    /**
+     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+     *
+     * @param selector
+     */
     static css(selector: Answerable<string>): Question<Promise<ByCss>>;
+    /**
+     * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+     * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+     *
+     * @param selector
+     * @param text
+     */
     static cssContainingText(selector: Answerable<string>, text: Answerable<string>): Question<Promise<ByCssContainingText>>;
+    /**
+     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+     * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
+     *
+     * @param selector
+     */
+    static deepCss(selector: Answerable<string>): Question<Promise<ByCss>>;
+    /**
+     * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+     *
+     * @param selector
+     */
     static id(selector: Answerable<string>): Question<Promise<ById>>;
+    /**
+     * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+     *
+     * @param selector
+     */
     static tagName(selector: Answerable<string>): Question<Promise<ByTagName>>;
+    /**
+     * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+     *
+     * @param selector
+     */
     static xpath(selector: Answerable<string>): Question<Promise<ByXPath>>;
 }
+//# sourceMappingURL=By.d.ts.map

package/lib/screenplay/models/selectors/By.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"By.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/By.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,qBAAa,EAAE;IAEX;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAOlE;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAQxH;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAOtE;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAOhE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAO1E;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;CAMzE"}

package/lib/screenplay/models/selectors/By.js

@@ -4,16 +4,32 @@ exports.By = void 0;
 const core_1 = require("@serenity-js/core");
 const ByCss_1 = require("./ByCss");
 const ByCssContainingText_1 = require("./ByCssContainingText");
+const ByDeepCss_1 = require("./ByDeepCss");
 const ById_1 = require("./ById");
 const ByTagName_1 = require("./ByTagName");
 const ByXPath_1 = require("./ByXPath");
+/**
+ * @group Models
+ */
 class By {
+    /**
+     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+     *
+     * @param selector
+     */
     static css(selector) {
         return core_1.Question.about((0, core_1.f) `by css (${selector})`, async (actor) => {
             const bySelector = await actor.answer(selector);
             return new ByCss_1.ByCss(bySelector);
         });
     }
+    /**
+     * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+     * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+     *
+     * @param selector
+     * @param text
+     */
     static cssContainingText(selector, text) {
         return core_1.Question.about((0, core_1.f) `by css (${selector}) containing text ${text}`, async (actor) => {
             const bySelector = await actor.answer(selector);
@@ -21,18 +37,45 @@ class By {
             return new ByCssContainingText_1.ByCssContainingText(bySelector, textSelector);
         });
     }
+    /**
+     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+     * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
+     *
+     * @param selector
+     */
+    static deepCss(selector) {
+        return core_1.Question.about((0, core_1.f) `by deep css (${selector})`, async (actor) => {
+            const bySelector = await actor.answer(selector);
+            return new ByDeepCss_1.ByDeepCss(bySelector);
+        });
+    }
+    /**
+     * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+     *
+     * @param selector
+     */
     static id(selector) {
         return core_1.Question.about((0, core_1.f) `by id (${selector})`, async (actor) => {
             const bySelector = await actor.answer(selector);
             return new ById_1.ById(bySelector);
         });
     }
+    /**
+     * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+     *
+     * @param selector
+     */
     static tagName(selector) {
         return core_1.Question.about((0, core_1.f) `by tag name (${selector})`, async (actor) => {
             const bySelector = await actor.answer(selector);
             return new ByTagName_1.ByTagName(bySelector);
         });
     }
+    /**
+     * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+     *
+     * @param selector
+     */
     static xpath(selector) {
         return core_1.Question.about((0, core_1.f) `by xpath (${selector})`, async (actor) => {
             const bySelector = await actor.answer(selector);

package/lib/screenplay/models/selectors/By.js.map

@@ -1 +1 @@
-{"version":3,"file":"By.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/By.ts"],"names":[],"mappings":";;;AAAA,4CAA4D;AAE5D,mCAAgC;AAChC,+DAA4D;AAC5D,iCAA8B;AAC9B,2CAAwC;AACxC,uCAAoC;AAEpC,MAAa,EAAE;IACX,MAAM,CAAC,GAAG,CAAC,QAA4B;QACnC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,WAAW,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACzD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,aAAK,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,QAA4B,EAAE,IAAwB;QAC3E,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,WAAW,QAAQ,qBAAsB,IAAK,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACnF,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,IAAI,yCAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,QAA4B;QAClC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,UAAU,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACxD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,WAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAA4B;QACvC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,gBAAgB,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,qBAAS,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAA4B;QACrC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,aAAa,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC3D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,iBAAO,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AApCD,gBAoCC"}
+{"version":3,"file":"By.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/By.ts"],"names":[],"mappings":";;;AAAA,4CAA4D;AAE5D,mCAAgC;AAChC,+DAA4D;AAC5D,2CAAwC;AACxC,iCAA8B;AAC9B,2CAAwC;AACxC,uCAAoC;AAEpC;;GAEG;AACH,MAAa,EAAE;IAEX;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,QAA4B;QACnC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,WAAW,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACzD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,aAAK,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAA4B,EAAE,IAAwB;QAC3E,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,WAAW,QAAQ,qBAAsB,IAAK,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACnF,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,IAAI,yCAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,QAA4B;QACvC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,gBAAgB,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,qBAAS,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,QAA4B;QAClC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,UAAU,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACxD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,WAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAA4B;QACvC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,gBAAgB,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,qBAAS,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAA4B;QACrC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,aAAa,QAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC3D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,IAAI,iBAAO,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA7ED,gBA6EC"}

package/lib/screenplay/models/selectors/ByCss.d.ts

@@ -1,5 +1,13 @@
 import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.css}
+ *
+ * @group Models
+ */
 export declare class ByCss extends Selector {
     readonly value: string;
     constructor(value: string);
 }
+//# sourceMappingURL=ByCss.d.ts.map

package/lib/screenplay/models/selectors/ByCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByCss.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,QAAQ;aACH,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAG5C"}

package/lib/screenplay/models/selectors/ByCss.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ByCss = void 0;
 const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.css}
+ *
+ * @group Models
+ */
 class ByCss extends Selector_1.Selector {
     constructor(value) {
         super();

package/lib/screenplay/models/selectors/ByCss.js.map

@@ -1 +1 @@
-{"version":3,"file":"ByCss.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCss.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,MAAa,KAAM,SAAQ,mBAAQ;IAC/B,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,sBAIC"}
+{"version":3,"file":"ByCss.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCss.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;GAMG;AACH,MAAa,KAAM,SAAQ,mBAAQ;IAC/B,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,sBAIC"}

package/lib/screenplay/models/selectors/ByCssContainingText.d.ts

@@ -1,6 +1,15 @@
 import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+ * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.cssContainingText}
+ *
+ * @group Models
+ */
 export declare class ByCssContainingText extends Selector {
     readonly value: string;
     readonly text: string;
     constructor(value: string, text: string);
 }
+//# sourceMappingURL=ByCssContainingText.d.ts.map

package/lib/screenplay/models/selectors/ByCssContainingText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByCssContainingText.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCssContainingText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;aACjB,KAAK,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;gBAA3C,KAAK,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAG1E"}

package/lib/screenplay/models/selectors/ByCssContainingText.js

@@ -2,6 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ByCssContainingText = void 0;
 const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+ * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.cssContainingText}
+ *
+ * @group Models
+ */
 class ByCssContainingText extends Selector_1.Selector {
     constructor(value, text) {
         super();

package/lib/screenplay/models/selectors/ByCssContainingText.js.map

@@ -1 +1 @@
-{"version":3,"file":"ByCssContainingText.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCssContainingText.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,MAAa,mBAAoB,SAAQ,mBAAQ;IAC7C,YAA4B,KAAa,EAAkB,IAAY;QACnE,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;IAEvE,CAAC;CACJ;AAJD,kDAIC"}
+{"version":3,"file":"ByCssContainingText.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByCssContainingText.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC7C,YAA4B,KAAa,EAAkB,IAAY;QACnE,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;IAEvE,CAAC;CACJ;AAJD,kDAIC"}

package/lib/screenplay/models/selectors/ByDeepCss.d.ts

@@ -0,0 +1,14 @@
+import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+ * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
+ *
+ * **Pro tip:** Instantiate using {@apilink By.deepCss}
+ *
+ * @group Models
+ */
+export declare class ByDeepCss extends Selector {
+    readonly value: string;
+    constructor(value: string);
+}
+//# sourceMappingURL=ByDeepCss.d.ts.map

package/lib/screenplay/models/selectors/ByDeepCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByDeepCss.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByDeepCss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aACP,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAG5C"}

package/lib/screenplay/models/selectors/ByDeepCss.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ByDeepCss = void 0;
+const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+ * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
+ *
+ * **Pro tip:** Instantiate using {@apilink By.deepCss}
+ *
+ * @group Models
+ */
+class ByDeepCss extends Selector_1.Selector {
+    constructor(value) {
+        super();
+        this.value = value;
+    }
+}
+exports.ByDeepCss = ByDeepCss;
+//# sourceMappingURL=ByDeepCss.js.map

package/lib/screenplay/models/selectors/ByDeepCss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByDeepCss.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByDeepCss.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAa,SAAU,SAAQ,mBAAQ;IACnC,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,8BAIC"}

package/lib/screenplay/models/selectors/ById.d.ts

@@ -1,5 +1,13 @@
 import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.id}
+ *
+ * @group Models
+ */
 export declare class ById extends Selector {
     readonly value: string;
     constructor(value: string);
 }
+//# sourceMappingURL=ById.d.ts.map

package/lib/screenplay/models/selectors/ById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ById.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ById.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,QAAQ;aACF,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAG5C"}

package/lib/screenplay/models/selectors/ById.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ById = void 0;
 const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.id}
+ *
+ * @group Models
+ */
 class ById extends Selector_1.Selector {
     constructor(value) {
         super();

package/lib/screenplay/models/selectors/ById.js.map

@@ -1 +1 @@
-{"version":3,"file":"ById.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ById.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,MAAa,IAAK,SAAQ,mBAAQ;IAC9B,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,oBAIC"}
+{"version":3,"file":"ById.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ById.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;GAMG;AACH,MAAa,IAAK,SAAQ,mBAAQ;IAC9B,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,oBAIC"}

package/lib/screenplay/models/selectors/ByTagName.d.ts

@@ -1,5 +1,13 @@
 import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.tagName}
+ *
+ * @group Models
+ */
 export declare class ByTagName extends Selector {
     readonly value: string;
     constructor(value: string);
 }
+//# sourceMappingURL=ByTagName.d.ts.map

package/lib/screenplay/models/selectors/ByTagName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByTagName.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByTagName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aACP,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAG5C"}

package/lib/screenplay/models/selectors/ByTagName.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ByTagName = void 0;
 const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.tagName}
+ *
+ * @group Models
+ */
 class ByTagName extends Selector_1.Selector {
     constructor(value) {
         super();

package/lib/screenplay/models/selectors/ByTagName.js.map

@@ -1 +1 @@
-{"version":3,"file":"ByTagName.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByTagName.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,MAAa,SAAU,SAAQ,mBAAQ;IACnC,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,8BAIC"}
+{"version":3,"file":"ByTagName.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByTagName.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;GAMG;AACH,MAAa,SAAU,SAAQ,mBAAQ;IACnC,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,8BAIC"}

package/lib/screenplay/models/selectors/ByXPath.d.ts

@@ -1,5 +1,13 @@
 import { Selector } from './Selector';
+/**
+ * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.xpath}
+ *
+ * @group Models
+ */
 export declare class ByXPath extends Selector {
     readonly value: string;
     constructor(value: string);
 }
+//# sourceMappingURL=ByXPath.d.ts.map

package/lib/screenplay/models/selectors/ByXPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ByXPath.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByXPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,QAAQ;aACL,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAG5C"}

package/lib/screenplay/models/selectors/ByXPath.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ByXPath = void 0;
 const Selector_1 = require("./Selector");
+/**
+ * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+ *
+ * **Pro tip:** Instantiate using {@apilink By.xpath}
+ *
+ * @group Models
+ */
 class ByXPath extends Selector_1.Selector {
     constructor(value) {
         super();

package/lib/screenplay/models/selectors/ByXPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"ByXPath.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByXPath.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,MAAa,OAAQ,SAAQ,mBAAQ;IACjC,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,0BAIC"}
+{"version":3,"file":"ByXPath.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/ByXPath.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC;;;;;;GAMG;AACH,MAAa,OAAQ,SAAQ,mBAAQ;IACjC,YAA4B,KAAa;QACrC,KAAK,EAAE,CAAC;QADgB,UAAK,GAAL,KAAK,CAAQ;IAEzC,CAAC;CACJ;AAJD,0BAIC"}

package/lib/screenplay/models/selectors/Selector.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Describes a selector you use to identify a {@apilink PageElement} or a group of {@apilink PageElements}.
+ *
+ * @group Models
+ */
 export declare abstract class Selector {
     toString(): string;
 }
+//# sourceMappingURL=Selector.d.ts.map

package/lib/screenplay/models/selectors/Selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selector.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/Selector.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,8BAAsB,QAAQ;IAE1B,QAAQ,IAAI,MAAM;CAMrB"}

package/lib/screenplay/models/selectors/Selector.js

@@ -2,9 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Selector = void 0;
 const core_1 = require("@serenity-js/core");
+/**
+ * Describes a selector you use to identify a {@apilink PageElement} or a group of {@apilink PageElements}.
+ *
+ * @group Models
+ */
 class Selector {
     toString() {
-        const selectorDescription = this.constructor.name.replace(/([a-z]+)([A-Z])/g, '$1 $2').toLowerCase();
+        const selectorDescription = this.constructor.name.replace(/([a-z])([A-Z])/g, '$1 $2').toLowerCase();
         const parametersDescription = Object.keys(this).map(field => (0, core_1.f) `${this[field]}`).join(', ');
         return `${selectorDescription} (${parametersDescription})`;
     }

package/lib/screenplay/models/selectors/Selector.js.map

@@ -1 +1 @@
-{"version":3,"file":"Selector.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/Selector.ts"],"names":[],"mappings":";;;AAAA,4CAAsC;AAEtC,MAAsB,QAAQ;IAE1B,QAAQ;QACJ,MAAM,mBAAmB,GAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACvG,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,QAAC,EAAA,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3F,OAAO,GAAI,mBAAoB,KAAM,qBAAsB,GAAG,CAAC;IACnE,CAAC;CACJ;AARD,4BAQC"}
+{"version":3,"file":"Selector.js","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/Selector.ts"],"names":[],"mappings":";;;AAAA,4CAAsC;AAEtC;;;;GAIG;AACH,MAAsB,QAAQ;IAE1B,QAAQ;QACJ,MAAM,mBAAmB,GAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACtG,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,QAAC,EAAA,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3F,OAAO,GAAI,mBAAoB,KAAM,qBAAsB,GAAG,CAAC;IACnE,CAAC;CACJ;AARD,4BAQC"}

package/lib/screenplay/models/selectors/index.d.ts

@@ -1,7 +1,9 @@
 export * from './By';
 export * from './ByCss';
 export * from './ByCssContainingText';
+export * from './ByDeepCss';
 export * from './ById';
 export * from './ByTagName';
 export * from './ByXPath';
 export * from './Selector';
+//# sourceMappingURL=index.d.ts.map

package/lib/screenplay/models/selectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/selectors/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}