@serenity-js/web 3.25.0 → 3.25.2

package/lib/screenplay/questions/Text.js

@@ -5,10 +5,10 @@ const core_1 = require("@serenity-js/core");
 const io_1 = require("@serenity-js/core/lib/io");
 const models_1 = require("../models");
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
  * the visible (i.e. not hidden by CSS) [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText) of:
- * - a given {@apilink PageElement}
- * - a group of {@apilink PageElements}
+ * - a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - a group of [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
  *
  * The result includes the visible text of any sub-elements, without any leading or trailing whitespace.
  *
@@ -23,7 +23,7 @@ const models_1 = require("../models");
  * </ul>
  * ```
  *
- * ## Retrieve text of a single {@apilink PageElement}
+ * ## Retrieve text of a single [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -41,7 +41,7 @@ const models_1 = require("../models");
  *   )
  * ```
  *
- * ## Retrieve text of multiple {@apilink PageElements}
+ * ## Retrieve text of multiple [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -61,7 +61,7 @@ const models_1 = require("../models");
  *   )
  * ```
  *
- * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ * ## Using as filter in [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -84,21 +84,21 @@ const models_1 = require("../models");
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 class Text {
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the text of a single {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the text of a single [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/lib/screenplay/questions/Value.d.ts

@@ -1,15 +1,15 @@
 import type { MetaQuestionAdapter, QuestionAdapter } from '@serenity-js/core';
 import { PageElement } from '../models';
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * the `value` attribute of a given {@apilink PageElement}.
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+ * the `value` attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  * ```html
  * <input type="text" id="username" value="Alice" />
  * ```
  *
- * ## Retrieve the `value` of a given {@apilink PageElement}
+ * ## Retrieve the `value` of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -26,7 +26,7 @@ import { PageElement } from '../models';
  *   )
  * ```
  *
- * ## Using Value as {@apilink QuestionAdapter}
+ * ## Using Value as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -47,21 +47,21 @@ import { PageElement } from '../models';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 export declare class Value {
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the `value` attribute of a given {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the `value` attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/lib/screenplay/questions/Value.js

@@ -4,15 +4,15 @@ exports.Value = void 0;
 const core_1 = require("@serenity-js/core");
 const models_1 = require("../models");
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * the `value` attribute of a given {@apilink PageElement}.
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+ * the `value` attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  * ```html
  * <input type="text" id="username" value="Alice" />
  * ```
  *
- * ## Retrieve the `value` of a given {@apilink PageElement}
+ * ## Retrieve the `value` of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -29,7 +29,7 @@ const models_1 = require("../models");
  *   )
  * ```
  *
- * ## Using Value as {@apilink QuestionAdapter}
+ * ## Using Value as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -50,21 +50,21 @@ const models_1 = require("../models");
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 class Value {
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the `value` attribute of a given {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the `value` attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/lib/stage/crew/photographer/Photographer.d.ts

@@ -2,8 +2,9 @@ import type { DomainEvent } from '@serenity-js/core/lib/events';
 import type { Stage, StageCrewMember } from '@serenity-js/core/lib/stage';
 import * as strategies from './strategies';
 /**
- * The Photographer is a {@apilink StageCrewMember} who takes screenshots
- * using the web browser associated with the {@apilink Actor} that is currently {@apilink actorInTheSpotlight|in the spotlight}.
+ * The Photographer is a [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) who takes screenshots
+ * using the web browser associated with the [actor](https://serenity-js.org/api/core/class/Actor/) that is
+ * currently [in the spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
  *
  * ## Registering Photographer programmatically
  *
@@ -49,7 +50,7 @@ import * as strategies from './strategies';
  * ```
  *
  * #### Learn more
- * - {@apilink SerenityOptions}
+ * - [`SerenityOptions`](https://serenity-js.org/api/playwright-test/interface/SerenityOptions/)
  *
  * ## Using Photographer with WebdriverIO
  *
@@ -140,11 +141,11 @@ import * as strategies from './strategies';
  * ```
  *
  * ## Learn more
- * - {@apilink Stage}
- * - {@apilink StageCrewMember}
- * - {@apilink TakePhotosBeforeAndAfterInteractions}
- * - {@apilink TakePhotosOfFailures}
- * - {@apilink TakePhotosOfInteractions}
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/)
+ * - [`TakePhotosBeforeAndAfterInteractions`](https://serenity-js.org/api/web/class/TakePhotosBeforeAndAfterInteractions/)
+ * - [`TakePhotosOfFailures`](https://serenity-js.org/api/web/class/TakePhotosOfFailures/)
+ * - [`TakePhotosOfInteractions`](https://serenity-js.org/api/web/class/TakePhotosOfInteractions/)
  *
  * @group Stage
  */
@@ -152,16 +153,16 @@ export declare class Photographer implements StageCrewMember {
     private readonly photoTakingStrategy;
     private stage?;
     /**
-     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
-     * as per the specified {@apilink PhotoTakingStrategy}.
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
      *
      * @param strategy
-     *  A no-arg constructor function that instantiates a {@apilink PhotoTakingStrategy}
+     *  A no-arg constructor function that instantiates a [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/)
      */
     static whoWill(strategy: new () => strategies.PhotoTakingStrategy): StageCrewMember;
     /**
-     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
-     * as per the specified {@apilink PhotoTakingStrategy}.
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
      *
      * @param config
      */
@@ -170,15 +171,15 @@ export declare class Photographer implements StageCrewMember {
     }): StageCrewMember;
     constructor(photoTakingStrategy: strategies.PhotoTakingStrategy, stage?: Stage);
     /**
-     * Assigns this {@apilink StageCrewMember} to a given {@apilink Stage}.
+     * Assigns this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) to a given [`Stage`](https://serenity-js.org/api/core/class/Stage/).
      *
      * @param stage
-     *  An instance of a {@apilink Stage} this {@apilink StageCrewMember} will be assigned to
+     *  An instance of a [`Stage`](https://serenity-js.org/api/core/class/Stage/) this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) will be assigned to
      */
     assignedTo(stage: Stage): StageCrewMember;
     /**
-     * Handles {@apilink DomainEvent} objects emitted by the {@apilink Stage}
-     * this {@apilink StageCrewMember} is assigned to.
+     * Handles [`DomainEvent`](https://serenity-js.org/api/core-events/class/DomainEvent/) objects emitted by the [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     * this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) is assigned to.
      *
      * @param event
      */

package/lib/stage/crew/photographer/Photographer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Photographer.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkJG;AACH,qBAAa,YAAa,YAAW,eAAe;IAqC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,KAAK,CAAC;IApClB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,UAAU,CAAC,mBAAmB,GAAG,eAAe;IAInF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,MAAM,OAAO,UAAU,EAAE,qBAAqB,CAAC,CAAA;KAAE,GAAG,eAAe;gBAkBzF,mBAAmB,EAAE,UAAU,CAAC,mBAAmB,EAC5D,KAAK,CAAC,EAAE,KAAK;IAIzB;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAarC"}
+{"version":3,"file":"Photographer.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,qBAAa,YAAa,YAAW,eAAe;IAqC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,KAAK,CAAC;IApClB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,UAAU,CAAC,mBAAmB,GAAG,eAAe;IAInF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,MAAM,OAAO,UAAU,EAAE,qBAAqB,CAAC,CAAA;KAAE,GAAG,eAAe;gBAkBzF,mBAAmB,EAAE,UAAU,CAAC,mBAAmB,EAC5D,KAAK,CAAC,EAAE,KAAK;IAIzB;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAarC"}

package/lib/stage/crew/photographer/Photographer.js

@@ -28,8 +28,9 @@ const core_1 = require("@serenity-js/core");
 const events_1 = require("@serenity-js/core/lib/events");
 const strategies = __importStar(require("./strategies"));
 /**
- * The Photographer is a {@apilink StageCrewMember} who takes screenshots
- * using the web browser associated with the {@apilink Actor} that is currently {@apilink actorInTheSpotlight|in the spotlight}.
+ * The Photographer is a [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) who takes screenshots
+ * using the web browser associated with the [actor](https://serenity-js.org/api/core/class/Actor/) that is
+ * currently [in the spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
  *
  * ## Registering Photographer programmatically
  *
@@ -75,7 +76,7 @@ const strategies = __importStar(require("./strategies"));
  * ```
  *
  * #### Learn more
- * - {@apilink SerenityOptions}
+ * - [`SerenityOptions`](https://serenity-js.org/api/playwright-test/interface/SerenityOptions/)
  *
  * ## Using Photographer with WebdriverIO
  *
@@ -166,11 +167,11 @@ const strategies = __importStar(require("./strategies"));
  * ```
  *
  * ## Learn more
- * - {@apilink Stage}
- * - {@apilink StageCrewMember}
- * - {@apilink TakePhotosBeforeAndAfterInteractions}
- * - {@apilink TakePhotosOfFailures}
- * - {@apilink TakePhotosOfInteractions}
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/)
+ * - [`TakePhotosBeforeAndAfterInteractions`](https://serenity-js.org/api/web/class/TakePhotosBeforeAndAfterInteractions/)
+ * - [`TakePhotosOfFailures`](https://serenity-js.org/api/web/class/TakePhotosOfFailures/)
+ * - [`TakePhotosOfInteractions`](https://serenity-js.org/api/web/class/TakePhotosOfInteractions/)
  *
  * @group Stage
  */
@@ -178,18 +179,18 @@ class Photographer {
     photoTakingStrategy;
     stage;
     /**
-     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
-     * as per the specified {@apilink PhotoTakingStrategy}.
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
      *
      * @param strategy
-     *  A no-arg constructor function that instantiates a {@apilink PhotoTakingStrategy}
+     *  A no-arg constructor function that instantiates a [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/)
      */
     static whoWill(strategy) {
         return new Photographer(new strategy());
     }
     /**
-     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
-     * as per the specified {@apilink PhotoTakingStrategy}.
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
      *
      * @param config
      */
@@ -209,18 +210,18 @@ class Photographer {
         this.stage = stage;
     }
     /**
-     * Assigns this {@apilink StageCrewMember} to a given {@apilink Stage}.
+     * Assigns this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) to a given [`Stage`](https://serenity-js.org/api/core/class/Stage/).
      *
      * @param stage
-     *  An instance of a {@apilink Stage} this {@apilink StageCrewMember} will be assigned to
+     *  An instance of a [`Stage`](https://serenity-js.org/api/core/class/Stage/) this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) will be assigned to
      */
     assignedTo(stage) {
         this.stage = stage;
         return this;
     }
     /**
-     * Handles {@apilink DomainEvent} objects emitted by the {@apilink Stage}
-     * this {@apilink StageCrewMember} is assigned to.
+     * Handles [`DomainEvent`](https://serenity-js.org/api/core-events/class/DomainEvent/) objects emitted by the [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     * this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) is assigned to.
      *
      * @param event
      */

package/lib/stage/crew/photographer/Photographer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Photographer.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAmE;AAEnE,yDAAgF;AAGhF,yDAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkJG;AACH,MAAa,YAAY;IAqCA;IACT;IApCZ;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAkD;QAC7D,OAAO,IAAI,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAA4E;QACxF,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE;YAC3B,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA,CAAI,yBAAyB;YAErJ,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE;gBACzD,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE,CAAC,CAAC;aACxE;YAED,MAAM,IAAI,yBAAkB,CACxB,IAAK,MAAM,CAAC,QAAS,6CAA6C;gBAClE,yBAA0B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAE,GAAG,CAC/D,CAAC;SACL;QAED,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,YACqB,mBAAmD,EAC5D,KAAa;QADJ,wBAAmB,GAAnB,mBAAmB,CAAgC;QAC5D,UAAK,GAAL,KAAK,CAAQ;IAEzB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAY;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAE,IAAI,CAAC,KAAK,EAAE;YACd,MAAM,IAAI,iBAAU,CAAC,8FAA8F,CAAC,CAAC;SACxH;QAED,IAAI,CAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,KAAK,YAAY,uBAAc,IAAI,KAAK,YAAY,yBAAgB,EAAE;YACtE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;SACnE;IACL,CAAC;CACJ;AAxED,oCAwEC"}
+{"version":3,"file":"Photographer.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAmE;AAEnE,yDAAgF;AAGhF,yDAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,MAAa,YAAY;IAqCA;IACT;IApCZ;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAkD;QAC7D,OAAO,IAAI,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAA4E;QACxF,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE;YAC3B,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA,CAAI,yBAAyB;YAErJ,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE;gBACzD,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE,CAAC,CAAC;aACxE;YAED,MAAM,IAAI,yBAAkB,CACxB,IAAK,MAAM,CAAC,QAAS,6CAA6C;gBAClE,yBAA0B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAE,GAAG,CAC/D,CAAC;SACL;QAED,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,YACqB,mBAAmD,EAC5D,KAAa;QADJ,wBAAmB,GAAnB,mBAAmB,CAAgC;QAC5D,UAAK,GAAL,KAAK,CAAQ;IAEzB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAY;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAE,IAAI,CAAC,KAAK,EAAE;YACd,MAAM,IAAI,iBAAU,CAAC,8FAA8F,CAAC,CAAC;SACxH;QAED,IAAI,CAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,KAAK,YAAY,uBAAc,IAAI,KAAK,YAAY,yBAAgB,EAAE;YACtE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;SACnE;IACL,CAAC;CACJ;AAxED,oCAwEC"}

package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.d.ts

@@ -1,20 +1,20 @@
 import type { Stage } from '@serenity-js/core';
 import type { ActivityFinished, ActivityStarts, DomainEvent } from '@serenity-js/core/lib/events';
 /**
- * Configures the {@apilink Photographer} to take {@apilink Photo|photos}, a.k.a. screenshots,
- * of the {@apilink Activity} performed by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos, a.k.a. screenshots,
+ * of the [`Activity`](https://serenity-js.org/api/core/class/Activity/) performed by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
  * when desired conditions are met.
  *
  * @group Stage
  */
 export declare abstract class PhotoTakingStrategy {
     /**
-     * Takes a photo of the web browser used by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
+     * Takes a photo of the web browser used by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
      *
      * #### Learn more
-     * - {@apilink ActivityStarts}
-     * - {@apilink ActivityFinished}
-     * - {@apilink Stage}
+     * - [ActivityStarts](https://serenity-js.org/api/core-events/class/ActivityStarts/)
+     * - [ActivityFinished](https://serenity-js.org/api/core-events/class/ActivityFinished/)
+     * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
      *
      * @param event
      * @param stage

package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js

@@ -6,20 +6,20 @@ const events_1 = require("@serenity-js/core/lib/events");
 const model_1 = require("@serenity-js/core/lib/model");
 const screenplay_1 = require("../../../../screenplay");
 /**
- * Configures the {@apilink Photographer} to take {@apilink Photo|photos}, a.k.a. screenshots,
- * of the {@apilink Activity} performed by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos, a.k.a. screenshots,
+ * of the [`Activity`](https://serenity-js.org/api/core/class/Activity/) performed by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
  * when desired conditions are met.
  *
  * @group Stage
  */
 class PhotoTakingStrategy {
     /**
-     * Takes a photo of the web browser used by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
+     * Takes a photo of the web browser used by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
      *
      * #### Learn more
-     * - {@apilink ActivityStarts}
-     * - {@apilink ActivityFinished}
-     * - {@apilink Stage}
+     * - [ActivityStarts](https://serenity-js.org/api/core-events/class/ActivityStarts/)
+     * - [ActivityFinished](https://serenity-js.org/api/core-events/class/ActivityFinished/)
+     * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
      *
      * @param event
      * @param stage

package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.d.ts

@@ -2,9 +2,9 @@ import type { DomainEvent } from '@serenity-js/core/lib/events';
 import { InteractionFinished, InteractionStarts } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots) **both before and after**
- * every single {@apilink Interaction} performed
- * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots) **both before and after**
+ * every single [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
  *
  * **Please note** that this strategy will result in _a lot_ of screenshots being taken,
  * which will seriously affect the performance of your tests.

package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js

@@ -4,9 +4,9 @@ exports.TakePhotosBeforeAndAfterInteractions = void 0;
 const events_1 = require("@serenity-js/core/lib/events");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots) **both before and after**
- * every single {@apilink Interaction} performed
- * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots) **both before and after**
+ * every single [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
  *
  * **Please note** that this strategy will result in _a lot_ of screenshots being taken,
  * which will seriously affect the performance of your tests.

package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.d.ts

@@ -2,9 +2,9 @@ import type { DomainEvent } from '@serenity-js/core/lib/events';
 import { InteractionFinished } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
- * when then {@apilink Interaction} performed
- * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
  * results in an error.
  *
  * This strategy works best when you are interested in the screenshots only when

package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js

@@ -5,9 +5,9 @@ const events_1 = require("@serenity-js/core/lib/events");
 const model_1 = require("@serenity-js/core/lib/model");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
- * when then {@apilink Interaction} performed
- * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
  * results in an error.
  *
  * This strategy works best when you are interested in the screenshots only when

package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.d.ts

@@ -2,9 +2,9 @@ import type { DomainEvent } from '@serenity-js/core/lib/events';
 import { InteractionFinished } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
- * when then {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
- * performs any {@apilink Interaction}.
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * performs any [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
  *
  * This strategy works best when you want the results of your automated tests
  * to become comprehensive living documentation of your system.

package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js

@@ -4,9 +4,9 @@ exports.TakePhotosOfInteractions = void 0;
 const events_1 = require("@serenity-js/core/lib/events");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
- * when then {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
- * performs any {@apilink Interaction}.
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * performs any [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
  *
  * This strategy works best when you want the results of your automated tests
  * to become comprehensive living documentation of your system.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@serenity-js/web",
-  "version": "3.25.0",
-  "description": "Serenity/JS Screenplay Pattern APIs for the Web",
+  "version": "3.25.2",
+  "description": "Serenity/JS Screenplay Pattern library offering a flexible, web driver-agnostic approach to interacting with web-based user interfaces and components, suitable for various testing contexts",
   "author": {
     "name": "Jan Molak",
     "email": "jan.molak@smartcodeltd.co.uk",
@@ -45,8 +45,8 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/assertions": "3.25.0",
-    "@serenity-js/core": "3.25.0",
+    "@serenity-js/assertions": "3.25.2",
+    "@serenity-js/core": "3.25.2",
     "tiny-types": "1.22.0"
   },
   "devDependencies": {
@@ -59,5 +59,5 @@
     "ts-node": "10.9.2",
     "typescript": "5.2.2"
   },
-  "gitHead": "22657b685b6002f75b2569db54f4bea31ab91d12"
+  "gitHead": "98b68da1e04a8fcbb255dca509b7bc9c322a3b6b"
 }

package/src/errors/BrowserWindowClosedError.ts

@@ -5,8 +5,8 @@ import { LogicError } from '@serenity-js/core';
  * that's already been closed.
  *
  * ## Learn more
- * - {@apilink TakeScreenshot}
- * - {@apilink Page.takeScreenshot}
+ * - [`TakeScreenshot`](https://serenity-js.org/api/web/class/TakeScreenshot/)
+ * - [`Page.takeScreenshot`](https://serenity-js.org/api/web/class/Page/#takeScreenshot)
  *
  * @group Errors
  */

package/src/errors/CookieMissingError.ts

@@ -5,8 +5,8 @@ import { RuntimeError } from '@serenity-js/core';
  * you're trying to retrieve has not been set yet.
  *
  * ## Learn more
- * - {@apilink Cookie}
- * - {@apilink RuntimeError}
+ * - [`Cookie`](https://serenity-js.org/api/web/class/Cookie/)
+ * - [`RuntimeError`](https://serenity-js.org/api/core/class/RuntimeError/)
  *
  * @group Errors
  */

package/src/errors/ModalDialogObstructsScreenshotError.ts

@@ -4,9 +4,9 @@ import { LogicError } from '@serenity-js/core';
  * Thrown when the presence of a JavaScript dialog obstructs taking a screenshot.
  *
  * ## Learn more
- * - {@apilink Photographer}
- * - {@apilink LogicError}
- * - {@apilink TakeScreenshot}
+ * - [`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
  */

package/src/expectations/isActive.ts

@@ -9,18 +9,18 @@ const isElementActive = Expectation.define(
 );
 
 /**
- * {@apilink Expectation} that an element is "active", which means it resolves to `true` when:
- *  - the element {@apilink isPresent|is present} in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)
- *  - {@apilink PageElement.isActive} resolves to `true`
+ * [`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
- * - {@apilink PageElement.isActive}
- * - {@apilink Expectation}
- * - {@apilink Check}
- * - {@apilink Ensure}
- * - {@apilink Wait}
+ * - [`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
  */