@serenity-js/web 3.25.0 → 3.25.2

package/lib/screenplay/interactions/ExecuteScript.js

@@ -6,19 +6,19 @@ const io_1 = require("@serenity-js/core/lib/io");
 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}
+ * 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 inject a script into the browser and execute it in the context of the current browser tab.
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink LastScriptExecution.result}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`LastScriptExecution.result`](https://serenity-js.org/api/web/class/LastScriptExecution/#result)
  *
  * @group Activities
  */
 class ExecuteScript {
     /**
-     * Instantiates a version of this {@apilink Interaction}
+     * Instantiates a version of this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
      * configured to load a script from `sourceUrl`.
      *
      * @param sourceUrl
@@ -28,7 +28,7 @@ class ExecuteScript {
         return new ExecuteScriptFromUrl(sourceUrl);
     }
     /**
-     * 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 execute an asynchronous script within the context of the current browser tab.
      *
      * The script fragment will be executed as the body of an anonymous function.
@@ -37,20 +37,20 @@ class ExecuteScript {
      *
      * Any arguments provided in addition to the script will be included as script arguments and may be referenced
      * using the `arguments` object. Arguments may be a `boolean`, `number`, `string`
-     * or {@apilink PageElement}.
+     * or [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      * Arrays and objects may also be used as script arguments as long as each item adheres
      * to the types previously mentioned.
      *
-     * Unlike executing synchronous JavaScript with {@apilink ExecuteScript.sync},
+     * Unlike executing synchronous JavaScript with [`ExecuteScript.sync`](https://serenity-js.org/api/web/class/ExecuteScript/#sync),
      * scripts executed with this function must explicitly signal they are finished by invoking the provided callback.
      *
      * This callback will always be injected into the executed function as the last argument,
      * and thus may be referenced with `arguments[arguments.length - 1]`.
      *
      * If the script invokes the `callback` with a return value, this will be made available
-     * via the {@apilink LastScriptExecution.result}.
+     * via the [`LastScriptExecution.result`](https://serenity-js.org/api/web/class/LastScriptExecution/#result).
      *
-     * **Please note** that in order to signal an error in the `script` you need to throw an {@apilink Error}
+     * **Please note** that in order to signal an error in the `script` you need to throw an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error)
      * instead of passing it to the callback function.
      *
      * #### Executing an async script
@@ -109,7 +109,7 @@ class ExecuteScript {
      *
      * #### Passing PageElement arguments to an async script
      *
-     * Serenity/JS automatically converts {@link PageElement} objects passed as arguments to the script
+     * Serenity/JS automatically converts [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects passed as arguments to the script
      * into their corresponding DOM elements.
      *
      * ```ts
@@ -133,7 +133,7 @@ class ExecuteScript {
      *
      * #### Using nested data structures containing PageElement objects
      *
-     * Serenity/JS automatically converts any {@link PageElement} objects
+     * Serenity/JS automatically converts any [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects
      * contained in nested data structures passed to the script
      * into their corresponding DOM elements.
      *
@@ -163,7 +163,7 @@ class ExecuteScript {
      * ```
      *
      * #### Learn more
-     * - {@apilink LastScriptExecution.result}
+     * - [`LastScriptExecution.result`](https://serenity-js.org/api/web/class/LastScriptExecution/#result)
      *
      * @param script
      *  The script to be executed
@@ -172,10 +172,10 @@ class ExecuteScript {
         return new ExecuteAsynchronousScript(`#actor executes an asynchronous script`, script);
     }
     /**
-     * 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 execute a synchronous script within the context of the current browser tab.
      *
-     * If the script returns a value, it will be made available via {@apilink LastScriptExecution.result}.
+     * If the script returns a value, it will be made available via [`LastScriptExecution.result`](https://serenity-js.org/api/web/class/LastScriptExecution/#result).
      *
      * #### Executing a sync script as string and reading the result
      *
@@ -223,7 +223,7 @@ class ExecuteScript {
      *
      * #### Passing PageElement arguments to a sync script
      *
-     * Serenity/JS automatically converts {@link PageElement} objects passed as arguments to the script
+     * Serenity/JS automatically converts [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects passed as arguments to the script
      * into their corresponding DOM elements.
      *
      * ```ts
@@ -244,7 +244,7 @@ class ExecuteScript {
      *
      * #### Using nested data structures containing PageElement objects
      *
-     * Serenity/JS automatically converts any {@link PageElement} objects
+     * Serenity/JS automatically converts any [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects
      * contained in nested data structures passed to the script
      * into their corresponding DOM elements.
      *
@@ -271,7 +271,7 @@ class ExecuteScript {
      * ```
      *
      * #### Learn more
-     * - {@apilink LastScriptExecution.result}
+     * - [`LastScriptExecution.result`](https://serenity-js.org/api/web/class/LastScriptExecution/#result)
      *
      * @param script
      *  The script to be executed
@@ -285,7 +285,7 @@ exports.ExecuteScript = ExecuteScript;
  * Allows for a script to be executed to be parametrised.
  *
  * ## Learn more
- * -  {@apilink ExecuteScript}
+ * -  [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/)
  *
  * @group Activities
  */

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

@@ -2,8 +2,8 @@ import type { Answerable, AnswersQuestions, Interaction, UsesAbilities } from '@
 import type { PageElement } from '../models';
 import { PageElementInteraction } from './PageElementInteraction';
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to hover the mouse pointer over a given {@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 hover the mouse pointer over a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  * ```html
@@ -45,15 +45,15 @@ import { PageElementInteraction } from './PageElementInteraction';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 export declare class Hover extends PageElementInteraction {
     private readonly element;
     /**
-     * Instantiates this {@apilink Interaction}
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
      *
      * @param pageElement
      *  The element to be hovered over

package/lib/screenplay/interactions/Hover.js

@@ -4,8 +4,8 @@ exports.Hover = void 0;
 const core_1 = require("@serenity-js/core");
 const PageElementInteraction_1 = require("./PageElementInteraction");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to hover the mouse pointer over a given {@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 hover the mouse pointer over a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  * ```html
@@ -47,15 +47,15 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 class Hover extends PageElementInteraction_1.PageElementInteraction {
     element;
     /**
-     * Instantiates this {@apilink Interaction}
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
      *
      * @param pageElement
      *  The element to be hovered over

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

@@ -1,19 +1,19 @@
 import type { Answerable } from '@serenity-js/core';
 import { Interaction } from '@serenity-js/core';
 /**
- * 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 navigate to a specific destination, as well as back and forth in the browser history,
  * or reload the current page.
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  *
  * @group Activities
  */
 export declare class Navigate {
     /**
-     * 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 navigate to a given URL.
      *
      * The URL can be:
@@ -51,19 +51,19 @@ export declare class Navigate {
      *
      * #### Learn more
      *
-     * - {@apilink Page.navigateTo}
+     * - [`Page.navigateTo`](https://serenity-js.org/api/web/class/Page/#navigateTo)
      * - [WebdriverIO: Configuration Options](https://webdriver.io/docs/options/#baseurl)
      * - [Playwright: Browser](https://playwright.dev/docs/api/class-browser#browser-new-context)
      * - [Playwright: Test Options](https://playwright.dev/docs/api/class-testoptions#test-options-base-url)
      * - [Protractor: Configuration](https://github.com/angular/protractor/blob/master/lib/config.ts)
      *
      * @param url
-     *  An absolute URL or path an {@apilink Actor}
+     *  An absolute URL or path an [`Actor`](https://serenity-js.org/api/core/class/Actor/)
      *  should navigate to
      */
     static to(url: Answerable<string>): Interaction;
     /**
-     * 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 navigate back one page in the joint session history of the current top-level browsing context.
      *
      * #### Navigate back in browsing history
@@ -87,7 +87,7 @@ export declare class Navigate {
      */
     static back(): Interaction;
     /**
-     * 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 navigate forward one page in the joint session history of the current top-level browsing context.
      *
      * #### Navigate forward in browsing history
@@ -112,7 +112,7 @@ export declare class Navigate {
      */
     static forward(): Interaction;
     /**
-     * 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 reload the current page.
      *
      * #### Navigate to path relative to baseUrl

package/lib/screenplay/interactions/Navigate.js

@@ -4,19 +4,19 @@ exports.Navigate = void 0;
 const core_1 = require("@serenity-js/core");
 const abilities_1 = require("../abilities");
 /**
- * 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 navigate to a specific destination, as well as back and forth in the browser history,
  * or reload the current page.
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  *
  * @group Activities
  */
 class Navigate {
     /**
-     * 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 navigate to a given URL.
      *
      * The URL can be:
@@ -54,21 +54,21 @@ class Navigate {
      *
      * #### Learn more
      *
-     * - {@apilink Page.navigateTo}
+     * - [`Page.navigateTo`](https://serenity-js.org/api/web/class/Page/#navigateTo)
      * - [WebdriverIO: Configuration Options](https://webdriver.io/docs/options/#baseurl)
      * - [Playwright: Browser](https://playwright.dev/docs/api/class-browser#browser-new-context)
      * - [Playwright: Test Options](https://playwright.dev/docs/api/class-testoptions#test-options-base-url)
      * - [Protractor: Configuration](https://github.com/angular/protractor/blob/master/lib/config.ts)
      *
      * @param url
-     *  An absolute URL or path an {@apilink Actor}
+     *  An absolute URL or path an [`Actor`](https://serenity-js.org/api/core/class/Actor/)
      *  should navigate to
      */
     static to(url) {
         return new NavigateToUrl(url);
     }
     /**
-     * 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 navigate back one page in the joint session history of the current top-level browsing context.
      *
      * #### Navigate back in browsing history
@@ -97,7 +97,7 @@ class Navigate {
         });
     }
     /**
-     * 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 navigate forward one page in the joint session history of the current top-level browsing context.
      *
      * #### Navigate forward in browsing history
@@ -127,7 +127,7 @@ class Navigate {
         });
     }
     /**
-     * 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 reload the current page.
      *
      * #### Navigate to path relative to baseUrl

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

@@ -3,17 +3,17 @@ import { Interaction } from '@serenity-js/core';
 import type { FileSystemLocation } from '@serenity-js/core/lib/io';
 import type { PageElement } from '../models';
 /**
- * A base class for interactions with {@apilink PageElement} objects.
+ * A base class for interactions with [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects.
  *
  * **Note:** The recommended way to implement custom interactions
- * in your code is to use the {@apilink Interaction.where} factory method.
+ * in your code is to use the [`Interaction.where`](https://serenity-js.org/api/core/class/Interaction/#where) factory method.
  *
  * @group Activities
  */
 export declare abstract class PageElementInteraction extends Interaction {
     protected constructor(description: Answerable<string>, location?: FileSystemLocation);
     /**
-     * Returns the resolved {@apilink PageElement}, or throws a {@apilink LogicError}
+     * Returns the resolved [`PageElement`](https://serenity-js.org/api/web/class/PageElement/), or throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
      * if the element is `undefined`.
      *
      * @param actor

package/lib/screenplay/interactions/PageElementInteraction.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PageElementInteraction = void 0;
 const core_1 = require("@serenity-js/core");
 /**
- * A base class for interactions with {@apilink PageElement} objects.
+ * A base class for interactions with [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) objects.
  *
  * **Note:** The recommended way to implement custom interactions
- * in your code is to use the {@apilink Interaction.where} factory method.
+ * in your code is to use the [`Interaction.where`](https://serenity-js.org/api/core/class/Interaction/#where) factory method.
  *
  * @group Activities
  */
@@ -15,7 +15,7 @@ class PageElementInteraction extends core_1.Interaction {
         super(description, location);
     }
     /**
-     * Returns the resolved {@apilink PageElement}, or throws a {@apilink LogicError}
+     * Returns the resolved [`PageElement`](https://serenity-js.org/api/web/class/PageElement/), or throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
      * if the element is `undefined`.
      *
      * @param actor

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

@@ -4,16 +4,16 @@ import type { PageElement } from '../models';
 import { Key } from '../models';
 import { PageElementInteraction } from './PageElementInteraction';
 /**
- * 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 send a key press or a sequence of keys to a Web element.
  *
  * **Note:** On macOS, some keyboard shortcuts might not work
  * with the [`devtools` protocol](https://webdriver.io/docs/automationProtocols/#devtools-protocol).
  *
  *  For example:
- *  - to *copy*, instead of {@apilink Key.Meta}+`C`, use {@apilink Key.Control}+{@apilink Key.Insert}
- *  - to *cut*, instead of {@apilink Key.Meta}+`X`, use {@apilink Key.Control}+{@apilink Key.Delete}
- *  - to *paste*, instead of {@apilink Key.Meta}+`V`, use {@apilink Key.Shift}+{@apilink Key.Insert}
+ *  - to *copy*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`C`, use [`Key.Control`](https://serenity-js.org/api/web/class/Key/#Control)+[`Key.Insert`](https://serenity-js.org/api/web/class/Key/#Insert)
+ *  - to *cut*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`X`, use [`Key.Control`](https://serenity-js.org/api/web/class/Key/#Control)+[`Key.Delete`](https://serenity-js.org/api/web/class/Key/#Delete)
+ *  - to *paste*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`V`, use [`Key.Shift`](https://serenity-js.org/api/web/class/Key/#Shift)+[`Key.Insert`](https://serenity-js.org/api/web/class/Key/#Insert)
  *
  * ## Example widget
  *
@@ -51,18 +51,18 @@ import { PageElementInteraction } from './PageElementInteraction';
  *
  * ## Learn more
  *
- * - {@apilink Key}
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`Key`](https://serenity-js.org/api/web/class/Key/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 export declare class Press extends PageElementInteraction {
     private readonly keys;
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
-     * to press a sequence of {@apilink Key|keys},
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
+     * to press a sequence of [keys](https://serenity-js.org/api/web/class/Key/),
      *
      * When no `field` is specified, the key sequence will be sent to the currently focused element,
      * and if no element is focused - to the `document.body` to handle.

package/lib/screenplay/interactions/Press.js

@@ -7,16 +7,16 @@ const abilities_1 = require("../abilities");
 const models_1 = require("../models");
 const PageElementInteraction_1 = require("./PageElementInteraction");
 /**
- * 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 send a key press or a sequence of keys to a Web element.
  *
  * **Note:** On macOS, some keyboard shortcuts might not work
  * with the [`devtools` protocol](https://webdriver.io/docs/automationProtocols/#devtools-protocol).
  *
  *  For example:
- *  - to *copy*, instead of {@apilink Key.Meta}+`C`, use {@apilink Key.Control}+{@apilink Key.Insert}
- *  - to *cut*, instead of {@apilink Key.Meta}+`X`, use {@apilink Key.Control}+{@apilink Key.Delete}
- *  - to *paste*, instead of {@apilink Key.Meta}+`V`, use {@apilink Key.Shift}+{@apilink Key.Insert}
+ *  - to *copy*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`C`, use [`Key.Control`](https://serenity-js.org/api/web/class/Key/#Control)+[`Key.Insert`](https://serenity-js.org/api/web/class/Key/#Insert)
+ *  - to *cut*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`X`, use [`Key.Control`](https://serenity-js.org/api/web/class/Key/#Control)+[`Key.Delete`](https://serenity-js.org/api/web/class/Key/#Delete)
+ *  - to *paste*, instead of [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta)+`V`, use [`Key.Shift`](https://serenity-js.org/api/web/class/Key/#Shift)+[`Key.Insert`](https://serenity-js.org/api/web/class/Key/#Insert)
  *
  * ## Example widget
  *
@@ -54,18 +54,18 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  *
  * ## Learn more
  *
- * - {@apilink Key}
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`Key`](https://serenity-js.org/api/web/class/Key/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 class Press extends PageElementInteraction_1.PageElementInteraction {
     keys;
     /**
-     * Instantiates an {@apilink Interaction|interaction}
-     * that instructs the {@apilink Actor|actor}
-     * to press a sequence of {@apilink Key|keys},
+     * Instantiates an [interaction](https://serenity-js.org/api/core/class/Interaction/)
+     * that instructs the [actor](https://serenity-js.org/api/core/class/Actor/)
+     * to press a sequence of [keys](https://serenity-js.org/api/web/class/Key/),
      *
      * When no `field` is specified, the key sequence will be sent to the currently focused element,
      * and if no element is focused - to the `document.body` to handle.

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

@@ -2,8 +2,8 @@ import type { Answerable, AnswersQuestions, Interaction, UsesAbilities } from '@
 import type { PageElement } from '../models';
 import { PageElementInteraction } from './PageElementInteraction';
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to perform a right click on a given {@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 perform a right click on a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * This is typically used to open a [custom context menu](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event)
  * on a given Web element, since it's not possible to interact with the standard context menu offered by your browser.
@@ -60,15 +60,15 @@ import { PageElementInteraction } from './PageElementInteraction';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 export declare class RightClick extends PageElementInteraction {
     private readonly pageElement;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param pageElement
      *  The element to be right-clicked on

package/lib/screenplay/interactions/RightClick.js

@@ -4,8 +4,8 @@ exports.RightClick = void 0;
 const core_1 = require("@serenity-js/core");
 const PageElementInteraction_1 = require("./PageElementInteraction");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to perform a right click on a given {@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 perform a right click on a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * This is typically used to open a [custom context menu](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event)
  * on a given Web element, since it's not possible to interact with the standard context menu offered by your browser.
@@ -62,15 +62,15 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 class RightClick extends PageElementInteraction_1.PageElementInteraction {
     pageElement;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param pageElement
      *  The element to be right-clicked on

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

@@ -2,8 +2,8 @@ import type { Answerable, AnswersQuestions, UsesAbilities } from '@serenity-js/c
 import { Interaction } from '@serenity-js/core';
 import type { PageElement } from '../models';
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to scroll until a given {@apilink PageElement} comes into view.
+ * 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 scroll until a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) comes into view.
  *
  * ## Example widget
  *
@@ -43,15 +43,15 @@ import type { PageElement } from '../models';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 export declare class Scroll extends Interaction {
     private readonly element;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param pageElement
      *  The element to scroll to

package/lib/screenplay/interactions/Scroll.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Scroll = void 0;
 const core_1 = require("@serenity-js/core");
 /**
- * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * to scroll until a given {@apilink PageElement} comes into view.
+ * 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 scroll until a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) comes into view.
  *
  * ## Example widget
  *
@@ -44,15 +44,15 @@ const core_1 = require("@serenity-js/core");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * @group Activities
  */
 class Scroll extends core_1.Interaction {
     element;
     /**
-     * Instantiates this {@apilink Interaction}.
+     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
      *
      * @param pageElement
      *  The element to scroll to