@serenity-js/web 3.25.0 → 3.25.1

package/lib/screenplay/interactions/Select.js

@@ -6,19 +6,19 @@ const io_1 = require("@serenity-js/core/lib/io");
 const stringified_1 = require("@serenity-js/core/lib/io/stringified");
 const models_1 = require("../models");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
+ * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/) who has the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * to select an option from a [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select),
  * either by its display name, or by value.
  *
  * ## Learn more
- * - {@apilink Selected}
+ * - [`Selected`](https://serenity-js.org/api/web/class/Selected/)
  *
  * @group Activities
  */
 class Select {
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
      * to select a single [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * with a given [`value`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option#attr-value).,
      *
@@ -59,12 +59,12 @@ class Select {
      * ```
      *
      * #### Learn more
-     * - {@apilink Selected.valueOf}
-     * - {@apilink PageElement}
+     * - [`Selected.valueOf`](https://serenity-js.org/api/web/class/Selected/#valueOf)
+     * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
      *
      * @param value
      *  A value of the [`option` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@apilink Actor} to select
+     *  for the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to select
      */
     static value(value) {
         return {
@@ -76,8 +76,8 @@ class Select {
         };
     }
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
      * to select multiple [`<option>` elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * identified by their [`value`s](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option#attr-value).
      *
@@ -119,12 +119,12 @@ class Select {
      *
      * #### Learn more
      *
-     * - {@apilink Selected.valuesOf}
-     * - {@apilink PageElement}
+     * - [`Selected.valuesOf`](https://serenity-js.org/api/web/class/Selected/#valuesOf)
+     * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
      *
      * @param values
      *  Values of the [`option` elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@apilink Actor} to select
+     *  for the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to select
      */
     static values(...values) {
         return {
@@ -137,8 +137,8 @@ class Select {
         };
     }
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
      * to select a single [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * with a given description.
      *
@@ -182,12 +182,12 @@ class Select {
      * ```
      *
      * #### Learn more
-     * - {@apilink Selected.optionIn}
-     * - {@apilink PageElement}
+     * - [`Selected.optionIn`](https://serenity-js.org/api/web/class/Selected/#optionIn)
+     * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
      *
      * @param value
      *  Text of the [`option` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@apilink Actor} to select
+     *  for the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to select
      */
     static option(value) {
         return {
@@ -199,8 +199,8 @@ class Select {
         };
     }
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
      * to select multiple [`<option>` elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * identified by their descriptions.
      *
@@ -245,12 +245,12 @@ class Select {
      * ```
      *
      * #### Learn more
-     * - {@apilink Selected.optionsIn}
-     * - {@apilink PageElement}
+     * - [`Selected.optionsIn`](https://serenity-js.org/api/web/class/Selected/#optionsIn)
+     * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
      *
      * @param values
      *  Text of the [`option` elements  ](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@apilink Actor} to select
+     *  for the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to select
      */
     static options(...values) {
         return {

package/lib/screenplay/interactions/Switch.d.ts

@@ -2,17 +2,17 @@ import type { Activity, Answerable, AnswersQuestions, UsesAbilities } from '@ser
 import { Interaction, Task } from '@serenity-js/core';
 import type { Switchable } from '../models';
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to switch the context for future activities to a {@apilink Switchable}, such as a {@apilink Page} or a {@apilink PageElement}.
+ * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/) who has the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/), such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
- * Please note that when the {@apilink PageElement} implementing {@apilink Switchable} represents an {@apilink iframe},
- * using {@apilink Switch} will result in switching the top-level browsing context to that {@apilink iframe}.
+ * Please note that when the [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) implementing [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/) represents an [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
+ * using [`Switch`](https://serenity-js.org/api/web/class/Switch/) will result in switching the top-level browsing context to that [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe).
  *
- * When the {@apilink PageElement} represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
- * using {@apilink Switch} sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
+ * When the [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
+ * using [`Switch`](https://serenity-js.org/api/web/class/Switch/) sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
  * on the specified element. Assuming it can be focused.
  *
- * **Note:** The focused element is the element which will receive keyboard {@apilink Press} events by default.
+ * **Note:** The focused element is the element which will receive keyboard [press](https://serenity-js.org/api/web/class/Press/) events by default.
  *
  * ## Perform activities in the context of an iframe
  *
@@ -95,27 +95,27 @@ import type { Switchable } from '../models';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink Switchable}
- * - {@apilink SwitchableOrigin}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+ * - [`SwitchableOrigin`](https://serenity-js.org/api/web/interface/SwitchableOrigin/)
  *
  * @group Activities
  */
 export declare class Switch extends Interaction {
     private readonly switchable;
     /**
-     * Instructs the {@apilink Actor}
-     * to switch the context for future activities to a {@apilink Switchable},
-     * such as a {@apilink Page} or a {@apilink PageElement}.
+     * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/),
+     * such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * @param switchable
      */
     static to(switchable: Answerable<Switchable>): Switch;
     protected constructor(switchable: Answerable<Switchable>);
     /**
-     * Instructs the {@apilink Actor}
-     * to switch the context for future activities to a {@apilink Switchable},
-     * such as a {@apilink Page} or a {@apilink PageElement},
+     * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/),
+     * such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/),
      * perform a sequence of `activities`, and then switch the context back.
      *
      * @param activities

package/lib/screenplay/interactions/Switch.js

@@ -3,17 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Switch = void 0;
 const core_1 = require("@serenity-js/core");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to switch the context for future activities to a {@apilink Switchable}, such as a {@apilink Page} or a {@apilink PageElement}.
+ * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/) who has the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/), such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
- * Please note that when the {@apilink PageElement} implementing {@apilink Switchable} represents an {@apilink iframe},
- * using {@apilink Switch} will result in switching the top-level browsing context to that {@apilink iframe}.
+ * Please note that when the [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) implementing [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/) represents an [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
+ * using [`Switch`](https://serenity-js.org/api/web/class/Switch/) will result in switching the top-level browsing context to that [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe).
  *
- * When the {@apilink PageElement} represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
- * using {@apilink Switch} sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
+ * When the [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
+ * using [`Switch`](https://serenity-js.org/api/web/class/Switch/) sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
  * on the specified element. Assuming it can be focused.
  *
- * **Note:** The focused element is the element which will receive keyboard {@apilink Press} events by default.
+ * **Note:** The focused element is the element which will receive keyboard [press](https://serenity-js.org/api/web/class/Press/) events by default.
  *
  * ## Perform activities in the context of an iframe
  *
@@ -96,18 +96,18 @@ const core_1 = require("@serenity-js/core");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink Switchable}
- * - {@apilink SwitchableOrigin}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+ * - [`SwitchableOrigin`](https://serenity-js.org/api/web/interface/SwitchableOrigin/)
  *
  * @group Activities
  */
 class Switch extends core_1.Interaction {
     switchable;
     /**
-     * Instructs the {@apilink Actor}
-     * to switch the context for future activities to a {@apilink Switchable},
-     * such as a {@apilink Page} or a {@apilink PageElement}.
+     * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/),
+     * such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * @param switchable
      */
@@ -119,9 +119,9 @@ class Switch extends core_1.Interaction {
         this.switchable = switchable;
     }
     /**
-     * Instructs the {@apilink Actor}
-     * to switch the context for future activities to a {@apilink Switchable},
-     * such as a {@apilink Page} or a {@apilink PageElement},
+     * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+     * to switch the context for future activities to a [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/),
+     * such as a [`Page`](https://serenity-js.org/api/web/class/Page/) or a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/),
      * perform a sequence of `activities`, and then switch the context back.
      *
      * @param activities

package/lib/screenplay/interactions/TakeScreenshot.d.ts

@@ -1,10 +1,12 @@
 import type { Answerable, AnswersQuestions, CollectsArtifacts, UsesAbilities } from '@serenity-js/core';
 import { Interaction } from '@serenity-js/core';
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to take a screenshot and emit an {@apilink Artifact},
- * which can then be persisted by {@apilink ArtifactArchiver}
- * and reported by [Serenity BDD reporter](/api/serenity-bdd).
+ * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/)
+ * who has the [ability](https://serenity-js.org/api/core/class/Ability/)
+ * to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * to take a screenshot and emit an artifact,
+ * which can then be persisted by [`ArtifactArchiver`](https://serenity-js.org/api/core/class/ArtifactArchiver/)
+ * and reported by [Serenity BDD reporter](https://serenity-js.org/api/serenity-bdd).
  *
  * #### Taking a screenshot
  *
@@ -21,20 +23,19 @@ import { Interaction } from '@serenity-js/core';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink CollectsArtifacts}
- * - {@apilink Artifact}
- * - {@apilink ArtifactArchiver}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`CollectsArtifacts`](https://serenity-js.org/api/core/interface/CollectsArtifacts/)
+ * - [`ArtifactArchiver`](https://serenity-js.org/api/core/class/ArtifactArchiver/)
  *
  * @group Activities
  */
 export declare class TakeScreenshot extends Interaction {
     private readonly name;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param name
-     *  The name to give the emitted {@apilink Artifact}
+     *  The name to give the emitted artifact
      */
     static of(name: Answerable<string>): Interaction;
     protected constructor(name: Answerable<string>);

package/lib/screenplay/interactions/TakeScreenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TakeScreenshot.d.ts","sourceRoot":"","sources":["../../../src/screenplay/interactions/TakeScreenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxG,OAAO,EAAE,WAAW,EAAO,MAAM,mBAAmB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAYrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAV3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,WAAW;IAIhD,SAAS,aAA8B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;IAI/D;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAU9F"}
+{"version":3,"file":"TakeScreenshot.d.ts","sourceRoot":"","sources":["../../../src/screenplay/interactions/TakeScreenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxG,OAAO,EAAE,WAAW,EAAO,MAAM,mBAAmB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAYrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAV3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,WAAW;IAIhD,SAAS,aAA8B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;IAI/D;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAU9F"}

package/lib/screenplay/interactions/TakeScreenshot.js

@@ -5,10 +5,12 @@ const core_1 = require("@serenity-js/core");
 const model_1 = require("@serenity-js/core/lib/model");
 const abilities_1 = require("../abilities");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to take a screenshot and emit an {@apilink Artifact},
- * which can then be persisted by {@apilink ArtifactArchiver}
- * and reported by [Serenity BDD reporter](/api/serenity-bdd).
+ * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/)
+ * who has the [ability](https://serenity-js.org/api/core/class/Ability/)
+ * to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * to take a screenshot and emit an artifact,
+ * which can then be persisted by [`ArtifactArchiver`](https://serenity-js.org/api/core/class/ArtifactArchiver/)
+ * and reported by [Serenity BDD reporter](https://serenity-js.org/api/serenity-bdd).
  *
  * #### Taking a screenshot
  *
@@ -25,20 +27,19 @@ const abilities_1 = require("../abilities");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink CollectsArtifacts}
- * - {@apilink Artifact}
- * - {@apilink ArtifactArchiver}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`CollectsArtifacts`](https://serenity-js.org/api/core/interface/CollectsArtifacts/)
+ * - [`ArtifactArchiver`](https://serenity-js.org/api/core/class/ArtifactArchiver/)
  *
  * @group Activities
  */
 class TakeScreenshot extends core_1.Interaction {
     name;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param name
-     *  The name to give the emitted {@apilink Artifact}
+     *  The name to give the emitted artifact
      */
     static of(name) {
         return new TakeScreenshot(name);

package/lib/screenplay/interactions/TakeScreenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"TakeScreenshot.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/TakeScreenshot.ts"],"names":[],"mappings":";;;AACA,4CAAqD;AACrD,uDAA0D;AAE1D,4CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,cAAe,SAAQ,kBAAW;IAYJ;IAVvC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,IAAwB;QAC9B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,YAAuC,IAAwB;QAC3D,KAAK,CAAC,IAAA,UAAG,EAAA,gCAAiC,IAAK,EAAE,CAAC,CAAC;QADhB,SAAI,GAAJ,IAAI,CAAoB;IAE/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QACvE,MAAM,IAAI,GAAY,MAAM,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,MAAM,UAAU,GAAM,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,IAAI,GAAY,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,KAAK,CAAC,OAAO,CACT,aAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAC5B,IAAI,YAAI,CAAC,IAAI,CAAC,CACjB,CAAC;IACN,CAAC;CACJ;AA7BD,wCA6BC"}
+{"version":3,"file":"TakeScreenshot.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/TakeScreenshot.ts"],"names":[],"mappings":";;;AACA,4CAAqD;AACrD,uDAA0D;AAE1D,4CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAa,cAAe,SAAQ,kBAAW;IAYJ;IAVvC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,IAAwB;QAC9B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,YAAuC,IAAwB;QAC3D,KAAK,CAAC,IAAA,UAAG,EAAA,gCAAiC,IAAK,EAAE,CAAC,CAAC;QADhB,SAAI,GAAJ,IAAI,CAAoB;IAE/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QACvE,MAAM,IAAI,GAAY,MAAM,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,MAAM,UAAU,GAAM,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,IAAI,GAAY,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,KAAK,CAAC,OAAO,CACT,aAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAC5B,IAAI,YAAI,CAAC,IAAI,CAAC,CACjB,CAAC;IACN,CAAC;CACJ;AA7BD,wCA6BC"}

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

@@ -3,7 +3,7 @@
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb.browserCapabilities}
+ * - [`BrowseTheWeb.browserCapabilities`](https://serenity-js.org/api/web/class/BrowseTheWeb/#browserCapabilities)
  *
  * @group Models
  */

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

@@ -14,41 +14,41 @@ export declare abstract class BrowsingSession<Page_Type extends Page> {
     protected readonly pages: Map<CorrelationId, Page_Type>;
     closePagesOtherThan(pageOfInterest: Page_Type): Promise<void>;
     /**
-     * Opens a new browser page and associates it with a {@apilink Page} object.
+     * Opens a new browser page and associates it with a [`Page`](https://serenity-js.org/api/web/class/Page/) object.
      */
     protected abstract registerCurrentPage(): Promise<Page_Type>;
     /**
-     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this browsing session.
+     * Returns [basic meta-data](https://serenity-js.org/api/web/interface/BrowserCapabilities/) about the browser associated with this browsing session.
      */
     abstract browserCapabilities(): Promise<BrowserCapabilities>;
     /**
-     * Returns a {@apilink Page} representing the currently active top-level browsing context.
+     * Returns a [`Page`](https://serenity-js.org/api/web/class/Page/) representing the currently active top-level browsing context.
      */
     currentPage(): Promise<Page_Type>;
     /**
-     * Registers specified {@apilink Page|pages} to be managed by this {@apilink BrowsingSession}.
+     * Registers specified [pages](https://serenity-js.org/api/web/class/Page/) to be managed by this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
      *
      * @param pages
      */
     register(...pages: Page_Type[]): void;
     /**
-     * Informs this {@apilink BrowsingSession} that it should no longer manage {@apilink Page|pages}
+     * Informs this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) that it should no longer manage [pages](https://serenity-js.org/api/web/class/Page/)
      * identified by the given `pageIds`.
      *
      * @param pageIds
      */
     deregister(...pageIds: CorrelationId[]): void;
     /**
-     * Returns a {@apilink Page|pages} representing all the available
+     * Returns a [pages](https://serenity-js.org/api/web/class/Page/) representing all the available
      * top-level browsing context, e.g. all the open browser tabs.
      */
     allPages(): Promise<Array<Page_Type>>;
     /**
-     * Returns the ids of any {@apilink Page|pages} this {@apilink BrowsingSession} is aware of.
+     * Returns the ids of any [pages](https://serenity-js.org/api/web/class/Page/) this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) is aware of.
      */
     registeredPageIds(): Array<CorrelationId>;
     /**
-     * Informs the {@apilink BrowsingSession} that the "current page" has changed to `page`.
+     * Informs the [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) that the "current page" has changed to `page`.
      *
      * Please note that different Web integration tools have a different definition of what a "current page" is.
      * For example, Selenium or WebdriverIO use a single "focused" window that a developer

package/lib/screenplay/models/BrowsingSession.js

@@ -22,7 +22,7 @@ class BrowsingSession {
         await this.changeCurrentPageTo(pageOfInterest);
     }
     /**
-     * Returns a {@apilink Page} representing the currently active top-level browsing context.
+     * Returns a [`Page`](https://serenity-js.org/api/web/class/Page/) representing the currently active top-level browsing context.
      */
     async currentPage() {
         if (!this.currentBrowserPage || !await this.currentBrowserPage.isPresent()) {
@@ -31,7 +31,7 @@ class BrowsingSession {
         return this.currentBrowserPage;
     }
     /**
-     * Registers specified {@apilink Page|pages} to be managed by this {@apilink BrowsingSession}.
+     * Registers specified [pages](https://serenity-js.org/api/web/class/Page/) to be managed by this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
      *
      * @param pages
      */
@@ -41,7 +41,7 @@ class BrowsingSession {
         }
     }
     /**
-     * Informs this {@apilink BrowsingSession} that it should no longer manage {@apilink Page|pages}
+     * Informs this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) that it should no longer manage [pages](https://serenity-js.org/api/web/class/Page/)
      * identified by the given `pageIds`.
      *
      * @param pageIds
@@ -52,20 +52,20 @@ class BrowsingSession {
         }
     }
     /**
-     * Returns a {@apilink Page|pages} representing all the available
+     * Returns a [pages](https://serenity-js.org/api/web/class/Page/) representing all the available
      * top-level browsing context, e.g. all the open browser tabs.
      */
     async allPages() {
         return Array.from(this.pages.values());
     }
     /**
-     * Returns the ids of any {@apilink Page|pages} this {@apilink BrowsingSession} is aware of.
+     * Returns the ids of any [pages](https://serenity-js.org/api/web/class/Page/) this [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) is aware of.
      */
     registeredPageIds() {
         return Array.from(this.pages.keys());
     }
     /**
-     * Informs the {@apilink BrowsingSession} that the "current page" has changed to `page`.
+     * Informs the [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/) that the "current page" has changed to `page`.
      *
      * Please note that different Web integration tools have a different definition of what a "current page" is.
      * For example, Selenium or WebdriverIO use a single "focused" window that a developer

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

@@ -2,7 +2,7 @@ import type { Answerable, Optional, QuestionAdapter, WithAnswerableProperties }
 import { Interaction, Timestamp } from '@serenity-js/core';
 import type { CookieData } from './CookieData';
 /**
- * A Screenplay Pattern-style model responsible for managing cookies available to the current {@apilink Page}.
+ * A Screenplay Pattern-style model responsible for managing cookies available to the current [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * ## Checking if a cookie exists
  *
@@ -63,21 +63,21 @@ import type { CookieData } from './CookieData';
  * ```
  *
  * ## Learn more
- * - {@apilink CookieData}
- * - {@apilink Page.cookie}
+ * - [`CookieData`](https://serenity-js.org/api/web/interface/CookieData/)
+ * - [`Page.cookie`](https://serenity-js.org/api/web/class/Page/#cookie)
  *
  * @group Models
  */
 export declare abstract class Cookie implements Optional {
     protected readonly cookieName: string;
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to {@apilink Cookie} identified by `name`.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to [`Cookie`](https://serenity-js.org/api/web/class/Cookie/) identified by `name`.
      *
      * @param name
      */
     static called(name: Answerable<string>): QuestionAdapter<Cookie>;
     /**
-     * Sets a cookie for the current {@apilink Page}. Note that {@apilink CookieData} can be either a plain-old JavaScript object, or an {@apilink Answerable} {@apilink WithAnswerableProperties}.
+     * Sets a cookie for the current [`Page`](https://serenity-js.org/api/web/class/Page/). Note that [`CookieData`](https://serenity-js.org/api/web/interface/CookieData/) can be either a plain-old JavaScript object, or an [`Answerable`](https://serenity-js.org/api/core/#Answerable) [`WithAnswerableProperties`](https://serenity-js.org/api/core/#WithAnswerableProperties).
      *
      * :::info
      * Make sure that the actor performing this interaction is on the page that should receive the cookie.
@@ -88,7 +88,7 @@ export declare abstract class Cookie implements Optional {
      */
     static set(cookieData: Answerable<WithAnswerableProperties<CookieData>>): Interaction;
     /**
-     * Creates an {@apilink Interaction|interaction} to delete all cookies available to the current {@apilink Page}..
+     * Creates an [interaction](https://serenity-js.org/api/core/class/Interaction/) to delete all cookies available to the current [`Page`](https://serenity-js.org/api/web/class/Page/)..
      */
     static deleteAll(): Interaction;
     private cookie;
@@ -101,7 +101,7 @@ export declare abstract class Cookie implements Optional {
      * Checks if a given cookie is set.
      *
      * #### Learn more
-     * - {@apilink Optional}
+     * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
      */
     isPresent(): Promise<boolean>;
     /**
@@ -134,7 +134,7 @@ export declare abstract class Cookie implements Optional {
      * Returns the expiry date of a given cookie
      *
      * #### Learn more
-     * - {@apilink Timestamp}
+     * - [`Timestamp`](https://serenity-js.org/api/core/class/Timestamp/)
      */
     expiry(): Promise<Timestamp>;
     /**
@@ -147,11 +147,11 @@ export declare abstract class Cookie implements Optional {
      * This method is to be implemented by test integration tool-specific adapters.
      *
      * **Please note**: you don't need to implement any response caching here
-     * since it is covered by {@apilink Cookie.lazyLoadCookie} method.
+     * since it is covered by [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).lazyLoadCookie} method.
      */
     protected abstract read(): Promise<CookieData>;
     /**
-     * Invokes {@apilink Cookie.read} and caches the result in memory.
+     * Invokes `Cookie.read` and caches the result in memory.
      */
     private lazyLoadCookie;
 }

package/lib/screenplay/models/Cookie.js

@@ -6,7 +6,7 @@ const tiny_types_1 = require("tiny-types");
 const errors_1 = require("../../errors");
 const abilities_1 = require("../abilities");
 /**
- * A Screenplay Pattern-style model responsible for managing cookies available to the current {@apilink Page}.
+ * A Screenplay Pattern-style model responsible for managing cookies available to the current [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * ## Checking if a cookie exists
  *
@@ -67,15 +67,15 @@ const abilities_1 = require("../abilities");
  * ```
  *
  * ## Learn more
- * - {@apilink CookieData}
- * - {@apilink Page.cookie}
+ * - [`CookieData`](https://serenity-js.org/api/web/interface/CookieData/)
+ * - [`Page.cookie`](https://serenity-js.org/api/web/class/Page/#cookie)
  *
  * @group Models
  */
 class Cookie {
     cookieName;
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to {@apilink Cookie} identified by `name`.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to [`Cookie`](https://serenity-js.org/api/web/class/Cookie/) identified by `name`.
      *
      * @param name
      */
@@ -87,7 +87,7 @@ class Cookie {
         });
     }
     /**
-     * Sets a cookie for the current {@apilink Page}. Note that {@apilink CookieData} can be either a plain-old JavaScript object, or an {@apilink Answerable} {@apilink WithAnswerableProperties}.
+     * Sets a cookie for the current [`Page`](https://serenity-js.org/api/web/class/Page/). Note that [`CookieData`](https://serenity-js.org/api/web/interface/CookieData/) can be either a plain-old JavaScript object, or an [`Answerable`](https://serenity-js.org/api/core/#Answerable) [`WithAnswerableProperties`](https://serenity-js.org/api/core/#WithAnswerableProperties).
      *
      * :::info
      * Make sure that the actor performing this interaction is on the page that should receive the cookie.
@@ -114,7 +114,7 @@ class Cookie {
         });
     }
     /**
-     * Creates an {@apilink Interaction|interaction} to delete all cookies available to the current {@apilink Page}..
+     * Creates an [interaction](https://serenity-js.org/api/core/class/Interaction/) to delete all cookies available to the current [`Page`](https://serenity-js.org/api/web/class/Page/)..
      */
     static deleteAll() {
         return core_1.Interaction.where(`#actor deletes all cookies`, async (actor) => {
@@ -137,7 +137,7 @@ class Cookie {
      * Checks if a given cookie is set.
      *
      * #### Learn more
-     * - {@apilink Optional}
+     * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
      */
     async isPresent() {
         try {
@@ -196,14 +196,14 @@ class Cookie {
      * Returns the expiry date of a given cookie
      *
      * #### Learn more
-     * - {@apilink Timestamp}
+     * - [`Timestamp`](https://serenity-js.org/api/core/class/Timestamp/)
      */
     async expiry() {
         const cookie = await this.lazyLoadCookie();
         return cookie.expiry;
     }
     /**
-     * Invokes {@apilink Cookie.read} and caches the result in memory.
+     * Invokes `Cookie.read` and caches the result in memory.
      */
     async lazyLoadCookie() {
         if (!this.cookie) {