@serenity-js/web 3.25.0 → 3.25.1

package/lib/screenplay/questions/LastScriptExecution.js

@@ -4,8 +4,8 @@ exports.LastScriptExecution = void 0;
 const core_1 = require("@serenity-js/core");
 const abilities_1 = require("../abilities");
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * a returns the result of the last script executed via {@apilink ExecuteScript}.
+ * 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
+ * a returns the result of the last script executed via [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/).
  *
  * ## Executing a script and reading the result
  *
@@ -21,7 +21,7 @@ const abilities_1 = require("../abilities");
  *   )
  * ```
  *
- * ## Using LastScriptExecution as {@apilink QuestionAdapter}
+ * ## Using LastScriptExecution as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -39,15 +39,15 @@ const abilities_1 = require("../abilities");
  * ```
  *
  * ## Learn more
- * - {@apilink ExecuteScript}
- * - {@apilink BrowseTheWeb}
- * - {@apilink QuestionAdapter}
+ * - [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * @group Questions
  */
 class LastScriptExecution {
     /**
-     * Enables asserting on the result of a function executed via {@apilink ExecuteScript}.
+     * Enables asserting on the result of a function executed via [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/).
      */
     static result() {
         return core_1.Question.about(`last script execution result`, async (actor) => {

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

@@ -1,21 +1,21 @@
 import type { Answerable, QuestionAdapter } from '@serenity-js/core';
 import type { PageElement } from '../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
  * options and values selected in a
  * [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
  *
  * ## Learn more
- * - {@apilink Select}
- * - {@apilink BrowseTheWeb}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`Select`](https://serenity-js.org/api/web/class/Select/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 export declare class Selected {
     /**
-     * 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
      * a single [option](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
      *
@@ -57,14 +57,14 @@ export declare class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.value}
+     * - [`Select.value`](https://serenity-js.org/api/web/class/Select/#value)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valueOf(pageElement: Answerable<PageElement>): QuestionAdapter<string>;
     /**
-     * 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
      * values of [options](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
@@ -106,14 +106,14 @@ export declare class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.values}
+     * - [`Select.values`](https://serenity-js.org/api/web/class/Select/#values)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valuesOf(pageElement: Answerable<PageElement>): QuestionAdapter<Array<string>>;
     /**
-     * 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
      * a single option selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -156,14 +156,14 @@ export declare class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.option}
+     * - [`Select.option`](https://serenity-js.org/api/web/class/Select/#option)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionIn(pageElement: Answerable<PageElement>): QuestionAdapter<string>;
     /**
-     * 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
      * options selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -206,10 +206,10 @@ export declare class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.options}
+     * - [`Select.options`](https://serenity-js.org/api/web/class/Select/#options)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionsIn(pageElement: Answerable<PageElement>): QuestionAdapter<Array<string>>;
 }

package/lib/screenplay/questions/Selected.js

@@ -3,21 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Selected = void 0;
 const core_1 = require("@serenity-js/core");
 /**
- * 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
  * options and values selected in a
  * [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
  *
  * ## Learn more
- * - {@apilink Select}
- * - {@apilink BrowseTheWeb}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`Select`](https://serenity-js.org/api/web/class/Select/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 class Selected {
     /**
-     * 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
      * a single [option](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
      *
@@ -59,10 +59,10 @@ class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.value}
+     * - [`Select.value`](https://serenity-js.org/api/web/class/Select/#value)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valueOf(pageElement) {
         return core_1.Question.about((0, core_1.the) `value selected in ${pageElement}`, async (actor) => {
@@ -74,7 +74,7 @@ class Selected {
         });
     }
     /**
-     * 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
      * values of [options](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
@@ -116,10 +116,10 @@ class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.values}
+     * - [`Select.values`](https://serenity-js.org/api/web/class/Select/#values)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valuesOf(pageElement) {
         return core_1.Question.about((0, core_1.the) `values selected in ${pageElement}`, async (actor) => {
@@ -131,7 +131,7 @@ class Selected {
         });
     }
     /**
-     * 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
      * a single option selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -174,10 +174,10 @@ class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.option}
+     * - [`Select.option`](https://serenity-js.org/api/web/class/Select/#option)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionIn(pageElement) {
         return core_1.Question.about((0, core_1.the) `option selected in ${pageElement}`, async (actor) => {
@@ -189,7 +189,7 @@ class Selected {
         });
     }
     /**
-     * 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
      * options selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -232,10 +232,10 @@ class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.options}
+     * - [`Select.options`](https://serenity-js.org/api/web/class/Select/#options)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionsIn(pageElement) {
         return core_1.Question.about((0, core_1.the) `options selected in ${pageElement}`, async (actor) => {

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

@@ -2,10 +2,10 @@ import type { Answerable, MetaQuestionAdapter, QuestionAdapter } from '@serenity
 import type { PageElements } from '../models';
 import { PageElement } from '../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.
  *
@@ -20,7 +20,7 @@ import { PageElement } from '../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'
@@ -38,7 +38,7 @@ import { PageElement } from '../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'
@@ -58,7 +58,7 @@ import { PageElement } from '../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'
@@ -81,32 +81,32 @@ 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 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
      */
     static of(pageElement: QuestionAdapter<PageElement> | PageElement): MetaQuestionAdapter<PageElement, string>;
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the text of a group of {@apilink PageElements}.
+     * 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 group of [`PageElement`](https://serenity-js.org/api/web/class/PageElements/).
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElements
      */

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"}