@serenity-js/web 3.41.1 → 3.42.0

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.42.0](https://github.com/serenity-js/serenity-js/compare/v3.41.2...v3.42.0) (2026-03-19)
+
+
+### Bug Fixes
+
+* **web:** add Symbol.hasInstance to Key class for ESM/CJS compatibility ([6820f0e](https://github.com/serenity-js/serenity-js/commit/6820f0e0ca7d4a8f67ee316f300d2f5a71c290ba))
+
+
+### Features
+
+* **core:** add ESM/CJS dual build support for web packages ([94c5a64](https://github.com/serenity-js/serenity-js/commit/94c5a6423dc369477bbabbacee5a54f8fca20209))
+
+
+
+
+
+## [3.41.2](https://github.com/serenity-js/serenity-js/compare/v3.41.1...v3.41.2) (2026-03-05)
+
+**Note:** Version bump only for package @serenity-js/web
+
+
+
+
+
 ## [3.41.1](https://github.com/serenity-js/serenity-js/compare/v3.41.0...v3.41.1) (2026-02-27)
 
 **Note:** Version bump only for package @serenity-js/web

package/esm/errors/BrowserWindowClosedError.d.ts

@@ -0,0 +1,15 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when you're trying to take a screenshot of a browser window
+ * that's already been closed.
+ *
+ * ## Learn more
+ * - [`TakeScreenshot`](https://serenity-js.org/api/web/class/TakeScreenshot/)
+ * - [`Page.takeScreenshot`](https://serenity-js.org/api/web/class/Page/#takeScreenshot)
+ *
+ * @group Errors
+ */
+export declare class BrowserWindowClosedError extends LogicError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=BrowserWindowClosedError.d.ts.map

package/esm/errors/BrowserWindowClosedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWindowClosedError.d.ts","sourceRoot":"","sources":["../../src/errors/BrowserWindowClosedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBACxC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/esm/errors/BrowserWindowClosedError.js

@@ -0,0 +1,17 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when you're trying to take a screenshot of a browser window
+ * that's already been closed.
+ *
+ * ## Learn more
+ * - [`TakeScreenshot`](https://serenity-js.org/api/web/class/TakeScreenshot/)
+ * - [`Page.takeScreenshot`](https://serenity-js.org/api/web/class/Page/#takeScreenshot)
+ *
+ * @group Errors
+ */
+export class BrowserWindowClosedError extends LogicError {
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+//# sourceMappingURL=BrowserWindowClosedError.js.map

package/esm/errors/BrowserWindowClosedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWindowClosedError.js","sourceRoot":"","sources":["../../src/errors/BrowserWindowClosedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACpD,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;CACJ"}

package/esm/errors/CookieMissingError.d.ts

@@ -0,0 +1,15 @@
+import { RuntimeError } from '@serenity-js/core';
+/**
+ * Thrown when the [cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
+ * you're trying to retrieve has not been set yet.
+ *
+ * ## Learn more
+ * - [`Cookie`](https://serenity-js.org/api/web/class/Cookie/)
+ * - [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ *
+ * @group Errors
+ */
+export declare class CookieMissingError extends RuntimeError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=CookieMissingError.d.ts.map

package/esm/errors/CookieMissingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieMissingError.d.ts","sourceRoot":"","sources":["../../src/errors/CookieMissingError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/esm/errors/CookieMissingError.js

@@ -0,0 +1,17 @@
+import { RuntimeError } from '@serenity-js/core';
+/**
+ * Thrown when the [cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
+ * you're trying to retrieve has not been set yet.
+ *
+ * ## Learn more
+ * - [`Cookie`](https://serenity-js.org/api/web/class/Cookie/)
+ * - [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
+ *
+ * @group Errors
+ */
+export class CookieMissingError extends RuntimeError {
+    constructor(message, cause) {
+        super(CookieMissingError, message, cause);
+    }
+}
+//# sourceMappingURL=CookieMissingError.js.map

package/esm/errors/CookieMissingError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieMissingError.js","sourceRoot":"","sources":["../../src/errors/CookieMissingError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAChD,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACJ"}

package/esm/errors/ModalDialogObstructsScreenshotError.d.ts

@@ -0,0 +1,15 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when the presence of a JavaScript dialog obstructs taking a screenshot.
+ *
+ * ## Learn more
+ * - [`Photographer`](https://serenity-js.org/api/web/class/Photographer/)
+ * - [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+ * - [`TakeScreenshot`](https://serenity-js.org/api/web/class/TakeScreenshot/)
+ *
+ * @group Errors
+ */
+export declare class ModalDialogObstructsScreenshotError extends LogicError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ModalDialogObstructsScreenshotError.d.ts.map

package/esm/errors/ModalDialogObstructsScreenshotError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogObstructsScreenshotError.d.ts","sourceRoot":"","sources":["../../src/errors/ModalDialogObstructsScreenshotError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,qBAAa,mCAAoC,SAAQ,UAAU;gBACnD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/esm/errors/ModalDialogObstructsScreenshotError.js

@@ -0,0 +1,17 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when the presence of a JavaScript dialog obstructs taking a screenshot.
+ *
+ * ## Learn more
+ * - [`Photographer`](https://serenity-js.org/api/web/class/Photographer/)
+ * - [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+ * - [`TakeScreenshot`](https://serenity-js.org/api/web/class/TakeScreenshot/)
+ *
+ * @group Errors
+ */
+export class ModalDialogObstructsScreenshotError extends LogicError {
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+//# sourceMappingURL=ModalDialogObstructsScreenshotError.js.map

package/esm/errors/ModalDialogObstructsScreenshotError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogObstructsScreenshotError.js","sourceRoot":"","sources":["../../src/errors/ModalDialogObstructsScreenshotError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,OAAO,mCAAoC,SAAQ,UAAU;IAC/D,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;CACJ"}

package/esm/errors/index.d.ts

@@ -0,0 +1,4 @@
+export * from './BrowserWindowClosedError.js';
+export * from './CookieMissingError.js';
+export * from './ModalDialogObstructsScreenshotError.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC"}

package/esm/errors/index.js

@@ -0,0 +1,4 @@
+export * from './BrowserWindowClosedError.js';
+export * from './CookieMissingError.js';
+export * from './ModalDialogObstructsScreenshotError.js';
+//# sourceMappingURL=index.js.map

package/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC"}

package/esm/expectations/index.d.ts

@@ -0,0 +1,6 @@
+export * from './isActive.js';
+export * from './isClickable.js';
+export * from './isEnabled.js';
+export * from './isSelected.js';
+export * from './isVisible.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/expectations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/esm/expectations/index.js

@@ -0,0 +1,6 @@
+export * from './isActive.js';
+export * from './isClickable.js';
+export * from './isEnabled.js';
+export * from './isSelected.js';
+export * from './isVisible.js';
+//# sourceMappingURL=index.js.map

package/esm/expectations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/esm/expectations/isActive.d.ts

@@ -0,0 +1,20 @@
+import { Expectation } from '@serenity-js/core';
+import type { PageElement } from '../screenplay/index.js';
+/**
+ * [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is "active", which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isActive`](https://serenity-js.org/api/web/class/PageElement/#isActive) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isActive`](https://serenity-js.org/api/web/class/PageElement/#isActive)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export declare function isActive(): Expectation<PageElement>;
+//# sourceMappingURL=isActive.d.ts.map

package/esm/expectations/isActive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isActive.d.ts","sourceRoot":"","sources":["../../src/expectations/isActive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,IAAI,WAAW,CAAC,WAAW,CAAC,CAKnD"}

package/esm/expectations/isActive.js

@@ -0,0 +1,23 @@
+import { and, isPresent } from '@serenity-js/assertions';
+import { Expectation } from '@serenity-js/core';
+const isElementActive = Expectation.define('isActive', 'become active', (actual) => actual.isActive());
+/**
+ * [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is "active", which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isActive`](https://serenity-js.org/api/web/class/PageElement/#isActive) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isActive`](https://serenity-js.org/api/web/class/PageElement/#isActive)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export function isActive() {
+    return Expectation.to('become active').soThatActual(and(isPresent(), isElementActive()));
+}
+//# sourceMappingURL=isActive.js.map

package/esm/expectations/isActive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isActive.js","sourceRoot":"","sources":["../../src/expectations/isActive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CACtC,UAAU,EAAE,eAAe,EAC3B,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAC7C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ;IACpB,OAAO,WAAW,CAAC,EAAE,CAAc,eAAe,CAAC,CAAC,YAAY,CAAC,GAAG,CAChE,SAAS,EAAE,EACX,eAAe,EAAE,CACpB,CAAC,CAAC;AACP,CAAC"}

package/esm/expectations/isClickable.d.ts

@@ -0,0 +1,20 @@
+import { Expectation } from '@serenity-js/core';
+import type { PageElement } from '../screenplay/index.js';
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is clickable, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isClickable`](https://serenity-js.org/api/web/class/PageElement/#isClickable) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isClickable`](https://serenity-js.org/api/web/class/PageElement/#isClickable)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export declare function isClickable(): Expectation<PageElement>;
+//# sourceMappingURL=isClickable.d.ts.map

package/esm/expectations/isClickable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClickable.d.ts","sourceRoot":"","sources":["../../src/expectations/isClickable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAAC,WAAW,CAAC,CAKtD"}

package/esm/expectations/isClickable.js

@@ -0,0 +1,23 @@
+import { and, isPresent } from '@serenity-js/assertions';
+import { Expectation } from '@serenity-js/core';
+const isElementClickable = Expectation.define('isClickable', 'become clickable', (actual) => actual.isClickable());
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is clickable, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isClickable`](https://serenity-js.org/api/web/class/PageElement/#isClickable) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isClickable`](https://serenity-js.org/api/web/class/PageElement/#isClickable)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export function isClickable() {
+    return Expectation.to('become clickable').soThatActual(and(isPresent(), isElementClickable()));
+}
+//# sourceMappingURL=isClickable.js.map

package/esm/expectations/isClickable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClickable.js","sourceRoot":"","sources":["../../src/expectations/isClickable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CACzC,aAAa,EAAE,kBAAkB,EACjC,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAChD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,WAAW,CAAC,EAAE,CAAc,kBAAkB,CAAC,CAAC,YAAY,CAAC,GAAG,CACnE,SAAS,EAAE,EACX,kBAAkB,EAAE,CACvB,CAAC,CAAC;AACP,CAAC"}

package/esm/expectations/isEnabled.d.ts

@@ -0,0 +1,20 @@
+import { Expectation } from '@serenity-js/core';
+import type { PageElement } from '../screenplay/index.js';
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is enabled, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isEnabled`](https://serenity-js.org/api/web/class/PageElement/#isEnabled) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isEnabled`](https://serenity-js.org/api/web/class/PageElement/#isEnabled)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export declare function isEnabled(): Expectation<PageElement>;
+//# sourceMappingURL=isEnabled.d.ts.map

package/esm/expectations/isEnabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEnabled.d.ts","sourceRoot":"","sources":["../../src/expectations/isEnabled.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAAC,WAAW,CAAC,CAKpD"}

package/esm/expectations/isEnabled.js

@@ -0,0 +1,23 @@
+import { and, isPresent } from '@serenity-js/assertions';
+import { Expectation } from '@serenity-js/core';
+const isElementEnabled = Expectation.define('isEnabled', 'become enabled', (actual) => actual.isEnabled());
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is enabled, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isEnabled`](https://serenity-js.org/api/web/class/PageElement/#isEnabled) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isEnabled`](https://serenity-js.org/api/web/class/PageElement/#isEnabled)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export function isEnabled() {
+    return Expectation.to('become enabled').soThatActual(and(isPresent(), isElementEnabled()));
+}
+//# sourceMappingURL=isEnabled.js.map

package/esm/expectations/isEnabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEnabled.js","sourceRoot":"","sources":["../../src/expectations/isEnabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CACvC,WAAW,EAAE,gBAAgB,EAC7B,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS;IACrB,OAAO,WAAW,CAAC,EAAE,CAAc,gBAAgB,CAAC,CAAC,YAAY,CAAC,GAAG,CACjE,SAAS,EAAE,EACX,gBAAgB,EAAE,CACrB,CAAC,CAAC;AACP,CAAC"}

package/esm/expectations/isSelected.d.ts

@@ -0,0 +1,20 @@
+import { Expectation } from '@serenity-js/core';
+import type { PageElement } from '../screenplay/index.js';
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an `<option>` or `<input>` element is selected, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isSelected`](https://serenity-js.org/api/web/class/PageElement/#isSelected) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isSelected`](https://serenity-js.org/api/web/class/PageElement/#isSelected)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export declare function isSelected(): Expectation<PageElement>;
+//# sourceMappingURL=isSelected.d.ts.map

package/esm/expectations/isSelected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSelected.d.ts","sourceRoot":"","sources":["../../src/expectations/isSelected.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAAC,WAAW,CAAC,CAKrD"}

package/esm/expectations/isSelected.js

@@ -0,0 +1,23 @@
+import { and, isPresent } from '@serenity-js/assertions';
+import { Expectation } from '@serenity-js/core';
+const isElementSelected = Expectation.define('isSelected', 'become selected', (actual) => actual.isSelected());
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an `<option>` or `<input>` element is selected, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isSelected`](https://serenity-js.org/api/web/class/PageElement/#isSelected) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isSelected`](https://serenity-js.org/api/web/class/PageElement/#isSelected)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export function isSelected() {
+    return Expectation.to('become selected').soThatActual(and(isPresent(), isElementSelected()));
+}
+//# sourceMappingURL=isSelected.js.map

package/esm/expectations/isSelected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSelected.js","sourceRoot":"","sources":["../../src/expectations/isSelected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CACxC,YAAY,EAAE,iBAAiB,EAC/B,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAC/C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU;IACtB,OAAO,WAAW,CAAC,EAAE,CAAc,iBAAiB,CAAC,CAAC,YAAY,CAAC,GAAG,CAClE,SAAS,EAAE,EACX,iBAAiB,EAAE,CACtB,CAAC,CAAC;AACP,CAAC"}

package/esm/expectations/isVisible.d.ts

@@ -0,0 +1,20 @@
+import { Expectation } from '@serenity-js/core';
+import type { PageElement } from '../screenplay/index.js';
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is visible, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isVisible`](https://serenity-js.org/api/web/class/PageElement/#isVisible) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isVisible`](https://serenity-js.org/api/web/class/PageElement/#isVisible)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export declare function isVisible(): Expectation<PageElement>;
+//# sourceMappingURL=isVisible.d.ts.map

package/esm/expectations/isVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isVisible.d.ts","sourceRoot":"","sources":["../../src/expectations/isVisible.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAAC,WAAW,CAAC,CAKpD"}

package/esm/expectations/isVisible.js

@@ -0,0 +1,23 @@
+import { and, isPresent } from '@serenity-js/assertions';
+import { Expectation } from '@serenity-js/core';
+const isElementVisible = Expectation.define('isVisible', 'become visible', (actual) => actual.isVisible());
+/**
+ *  [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is visible, which means it resolves to `true` when:
+ *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
+ *  - [`PageElement.isVisible`](https://serenity-js.org/api/web/class/PageElement/#isVisible) resolves to `true`
+ *
+ *  If the above conditions are not met, the expectation resolves to `false`.
+ *
+ * ## Learn more
+ * - [`PageElement.isVisible`](https://serenity-js.org/api/web/class/PageElement/#isVisible)
+ * - [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
+ * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+ * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+ * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
+ *
+ * @group Expectations
+ */
+export function isVisible() {
+    return Expectation.to('become visible').soThatActual(and(isPresent(), isElementVisible()));
+}
+//# sourceMappingURL=isVisible.js.map

package/esm/expectations/isVisible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isVisible.js","sourceRoot":"","sources":["../../src/expectations/isVisible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CACvC,WAAW,EAAE,gBAAgB,EAC7B,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS;IACrB,OAAO,WAAW,CAAC,EAAE,CAAc,gBAAgB,CAAC,CAAC,YAAY,CAAC,GAAG,CACjE,SAAS,EAAE,EACX,gBAAgB,EAAE,CACrB,CAAC,CAAC;AACP,CAAC"}

package/esm/index.d.ts

@@ -0,0 +1,5 @@
+export * from './errors/index.js';
+export * from './expectations/index.js';
+export * from './screenplay/index.js';
+export * from './stage/index.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/esm/index.js

@@ -0,0 +1,5 @@
+export * from './errors/index.js';
+export * from './expectations/index.js';
+export * from './screenplay/index.js';
+export * from './stage/index.js';
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/esm/screenplay/abilities/BrowseTheWeb.d.ts

@@ -0,0 +1,98 @@
+import { Ability } from '@serenity-js/core';
+import type { BrowserCapabilities, BrowsingSession, Page } from '../models/index.js';
+/**
+ * The [ability](https://serenity-js.org/api/core/class/Ability/) to `BrowseTheWeb` enables an [actor](https://serenity-js.org/api/core/class/Actor/)
+ * to [interact with](https://serenity-js.org/api/core/class/Interaction/) and [retrieve information from](https://serenity-js.org/api/core/class/Question/) Web-based user interfaces.
+ *
+ * `BrowseTheWeb` wraps test integration tools such as [Playwright](https://serenity-js.org/api/playwright),
+ * [Protractor](https://serenity-js.org/api/protractor), or [WebdriverIO](https://serenity-js.org/api/webdriverio),
+ * and together with Serenity/JS Web models, such as [`Page`](https://serenity-js.org/api/web/class/Page/) or [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) - offers a standardised way
+ * to write Web-based tests following the Screenplay Pattern.
+ *
+ * The consistent and portable design of abstractions provided by the [`@serenity-js/web` module](https://serenity-js.org/api/web)
+ * also helps to make your tests portable across the various test integration tools and helps to make your test
+ * code easier to reuse across projects and teams.
+ *
+ * ## Giving the actors an ability to `BrowseTheWeb`
+ *
+ * To give an [actor](https://serenity-js.org/api/core/class/Actor/) an ability to `BrowseTheWeb`, provide the **integration tool-specific implementation**
+ * via [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan) in [`Cast.prepare`](https://serenity-js.org/api/core/class/Cast/#prepare), or via [`Cast.where`](https://serenity-js.org/api/core/class/Cast/#where).
+ *
+ * ```ts
+ * import { beforeEach } from 'mocha'
+ * import { engage, Actor, Cast } from '@serenity-js/core'
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
+ * import { Browser, chromium } from 'playwright'
+ *
+ * beforeEach(async () => {
+ *   const browser = await chromium.launch({ headless: true })
+ *
+ *   engage(
+ *     BrowseTheWebWithPlaywright.using(browser),
+ *   )
+ * })
+ * ```
+ *
+ * ### Learn more
+ *
+ * To learn more about using Serenity/JS with your chosen test integration tool, follow their respective documentation:
+ *
+ * - [`BrowseTheWebWithPlaywright`](https://serenity-js.org/api/playwright/class/BrowseTheWebWithPlaywright/)
+ * - [`BrowseTheWebWithProtractor`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/)
+ * - [`BrowseTheWebWithWebdriverIO`](https://serenity-js.org/api/webdriverio/class/BrowseTheWebWithWebdriverIO/)
+ *
+ * ## Using the ability to `BrowseTheWeb`
+ *
+ * To use the ability to `BrowseTheWeb` in a custom [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+ * or [`Question`](https://serenity-js.org/api/core/class/Question/), use the **generic** method [`BrowseTheWeb.as`](https://serenity-js.org/api/core/class/Ability/#as)
+ * to retrieve it.
+ *
+ * This generic method retrieves the integration tool-specific implementation of [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) present on the [`Actor`](https://serenity-js.org/api/core/class/Actor/),
+ * such as [`BrowseTheWebWithPlaywright`](https://serenity-js.org/api/playwright/class/BrowseTheWebWithPlaywright/)
+ * or [`BrowseTheWebWithWebdriverIO`](https://serenity-js.org/api/webdriverio/class/BrowseTheWebWithWebdriverIO/), using [`Actor.abilityTo`](https://serenity-js.org/api/core/class/Actor/#abilityTo).
+ *
+ * This decoupling mechanism helps to make your test code portable across test integration tools,
+ * since the only part of your test suite that needs to know about the test integration tool used are the actors.
+ * The rest of your test code, so [tasks](https://serenity-js.org/api/core/class/Task/), [interactions](https://serenity-js.org/api/core/class/Interaction/), and [questions](https://serenity-js.org/api/core/class/Question/),
+ * remain fully agnostic of the underlying tool.
+ *
+ * ```ts
+ * import { BrowseTheWeb, Question } from '@serenity-js/web'
+ *
+ * const BrowserDetails = () =>
+ *  Question.about('browser details', async actor => {
+ *    const capabilities = await BrowseTheWeb.as(actor).browserCapabilities();
+ *    return ${ capabilities.browserName } ${ capabilities.browserVersion }`;
+ *  })
+ * ```
+ *
+ * **Pro tip:** Use the specific `BrowseTheWebWith<test integration tool name>` to give the actor the ability,
+ * and generic `BrowseTheWeb.as(actor)` to retrieve it.
+ *
+ * ### Learn more
+ *
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor.whoCan`](https://serenity-js.org/api/core/class/Actor/#whoCan)
+ * - [`Cast.where`](https://serenity-js.org/api/core/class/Cast/#where)
+ * - [`Cast.prepare`](https://serenity-js.org/api/core/class/Cast/#prepare)
+ *
+ * @group Abilities
+ */
+export declare abstract class BrowseTheWeb<Native_Element_Type = any> extends Ability {
+    protected readonly session: BrowsingSession<Page<Native_Element_Type>>;
+    constructor(session: BrowsingSession<Page<Native_Element_Type>>);
+    /**
+     * Returns a [`Page`](https://serenity-js.org/api/web/class/Page/) representing the currently active browser tab.
+     */
+    currentPage(): Promise<Page<Native_Element_Type>>;
+    /**
+     * Returns an array of [pages](https://serenity-js.org/api/web/class/Page/) representing all the browser tabs
+     * available in the current [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
+     */
+    allPages(): Promise<Array<Page<Native_Element_Type>>>;
+    /**
+     * Returns [basic meta-data](https://serenity-js.org/api/web/interface/BrowserCapabilities/) about the browser associated with this ability.
+     */
+    browserCapabilities(): Promise<BrowserCapabilities>;
+}
+//# sourceMappingURL=BrowseTheWeb.d.ts.map

package/esm/screenplay/abilities/BrowseTheWeb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowseTheWeb.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,8BAAsB,YAAY,CAAC,mBAAmB,GAAG,GAAG,CAAE,SAAQ,OAAO;IAE7D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBAAnD,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAIlF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAIvD;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAIrD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAG5D"}