@serenity-js/web 3.25.0 → 3.25.2

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) {

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

@@ -1,11 +1,11 @@
 import type { Timestamp } from '@serenity-js/core';
 /**
- * A data structure describing a {@apilink Cookie} to be set, or one that's been read.
+ * A data structure describing a [`Cookie`](https://serenity-js.org/api/web/class/Cookie/) to be set, or one that's been read.
  *
  * ## Learn more
  *
- * - {@apilink Cookie}
- * - {@apilink Page.cookie}
+ * - [`Cookie`](https://serenity-js.org/api/web/class/Cookie/)
+ * - [`Page.cookie`](https://serenity-js.org/api/web/class/Page/#cookie)
  *
  * @group Models
  */
@@ -29,7 +29,7 @@ export interface CookieData {
      */
     path?: string;
     /**
-     * The {@apilink Timestamp} describing the point in time when this cookie expires.
+     * The [timestamp](https://serenity-js.org/api/core/class/Timestamp/) describing the point in time when this cookie expires.
      */
     expiry?: Timestamp;
     /**

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

@@ -1,13 +1,13 @@
 /**
- * Represents keyboard keys that aren't text, and that can be used with the {@apilink Interaction|interaction} to {@apilink Press}.
+ * Represents keyboard keys that aren't text, and that can be used with the [interaction](https://serenity-js.org/api/core/class/Interaction/) to [`Press`](https://serenity-js.org/api/web/class/Press/).
  *
- * **Note:** Modifier keys like {@apilink Key.Shift}, {@apilink Key.Alt} and {@apilink Key.Meta} (a.k.a. "Command" on Mac) will stay pressed,
+ * **Note:** Modifier keys like [`Key.Shift`](https://serenity-js.org/api/web/class/Key/#Shift), [`Key.Alt`](https://serenity-js.org/api/web/class/Key/#Alt) and [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta) (a.k.a. "Command" on Mac) will stay pressed,
  * so there's no need to depress them.
  *
  * ## Learn more
  *
- * - {@apilink Press}
- * - {@apilink Page.sendKeys}
+ * - [`Press`](https://serenity-js.org/api/web/class/Press/)
+ * - [`Page.sendKeys`](https://serenity-js.org/api/web/class/Page/#sendKeys)
  * - [W3C WebDriver Spec: Keyboard Actions](https://w3c.github.io/webdriver/webdriver-spec.html#keyboard-actions)
  * - [Selenium WebDriver: Inputs](https://github.com/SeleniumHQ/selenium/blob/trunk/javascript/node/selenium-webdriver/lib/input.js#L46)
  * - [WebdriverIO: Constants](https://github.com/webdriverio/webdriverio/blob/main/packages/wdio-utils/src/constants.ts#L5)

package/lib/screenplay/models/Key.js

@@ -2,15 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Key = void 0;
 /**
- * Represents keyboard keys that aren't text, and that can be used with the {@apilink Interaction|interaction} to {@apilink Press}.
+ * Represents keyboard keys that aren't text, and that can be used with the [interaction](https://serenity-js.org/api/core/class/Interaction/) to [`Press`](https://serenity-js.org/api/web/class/Press/).
  *
- * **Note:** Modifier keys like {@apilink Key.Shift}, {@apilink Key.Alt} and {@apilink Key.Meta} (a.k.a. "Command" on Mac) will stay pressed,
+ * **Note:** Modifier keys like [`Key.Shift`](https://serenity-js.org/api/web/class/Key/#Shift), [`Key.Alt`](https://serenity-js.org/api/web/class/Key/#Alt) and [`Key.Meta`](https://serenity-js.org/api/web/class/Key/#Meta) (a.k.a. "Command" on Mac) will stay pressed,
  * so there's no need to depress them.
  *
  * ## Learn more
  *
- * - {@apilink Press}
- * - {@apilink Page.sendKeys}
+ * - [`Press`](https://serenity-js.org/api/web/class/Press/)
+ * - [`Page.sendKeys`](https://serenity-js.org/api/web/class/Page/#sendKeys)
  * - [W3C WebDriver Spec: Keyboard Actions](https://w3c.github.io/webdriver/webdriver-spec.html#keyboard-actions)
  * - [Selenium WebDriver: Inputs](https://github.com/SeleniumHQ/selenium/blob/trunk/javascript/node/selenium-webdriver/lib/input.js#L46)
  * - [WebdriverIO: Constants](https://github.com/webdriverio/webdriverio/blob/main/packages/wdio-utils/src/constants.ts#L5)

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

@@ -4,14 +4,14 @@ import type { PageElement } from './PageElement';
 import { RootLocator } from './RootLocator';
 import { ByCss, type Selector } from './selectors';
 /**
- * {@apilink Locator} uses a {@apilink Selector} to locate a {@apilink PageElement} or {@apilink PageElements}
- * within the {@apilink Page}.
+ * [`Locator`](https://serenity-js.org/api/web/class/Locator/) uses a [`Selector`](https://serenity-js.org/api/web/class/Selector/) to locate a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) or [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
+ * within the [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * ## Learn more
- * - {@apilink RootLocator}
- * - {@apilink Page.locate}
- * - {@apilink PageElement}
- * - {@apilink PageElements}
+ * - [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/)
+ * - [`Page.locate`](https://serenity-js.org/api/web/class/Page/#locate)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
  *
  * @group Models
  */
@@ -29,10 +29,10 @@ export declare abstract class Locator<Native_Element_Type, Native_Selector_Type
     abstract closestTo(child: Locator<Native_Element_Type>): Locator<Native_Element_Type>;
     abstract locate(child: Locator<Native_Element_Type>): Locator<Native_Element_Type>;
     /**
-     * Expresses {@apilink ByCss}, {@apilink ById}, or {@apilink ByTagName} as a {@apilink ByCss} selector.
+     * Expresses [`ByCss`](https://serenity-js.org/api/web/class/ByCss/), [`ById`](https://serenity-js.org/api/web/class/ById/), or [`ByTagName`](https://serenity-js.org/api/web/class/ByTagName/) as a [`ByCss`](https://serenity-js.org/api/web/class/ByCss/) selector.
      *
      * @throws LogicError
-     *  if the `selector` can't be expressed as {@apilink ByCss}
+     *  if the `selector` can't be expressed as [`ByCss`](https://serenity-js.org/api/web/class/ByCss/)
      *
      * @param selector
      * @protected

package/lib/screenplay/models/Locator.js

@@ -30,14 +30,14 @@ const util = __importStar(require("util")); // eslint-disable-line unicorn/impor
 const RootLocator_1 = require("./RootLocator");
 const selectors_1 = require("./selectors");
 /**
- * {@apilink Locator} uses a {@apilink Selector} to locate a {@apilink PageElement} or {@apilink PageElements}
- * within the {@apilink Page}.
+ * [`Locator`](https://serenity-js.org/api/web/class/Locator/) uses a [`Selector`](https://serenity-js.org/api/web/class/Selector/) to locate a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) or [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
+ * within the [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * ## Learn more
- * - {@apilink RootLocator}
- * - {@apilink Page.locate}
- * - {@apilink PageElement}
- * - {@apilink PageElements}
+ * - [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/)
+ * - [`Page.locate`](https://serenity-js.org/api/web/class/Page/#locate)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
  *
  * @group Models
  */
@@ -59,10 +59,10 @@ class Locator extends RootLocator_1.RootLocator {
         await this.parent.switchToMainFrame();
     }
     /**
-     * Expresses {@apilink ByCss}, {@apilink ById}, or {@apilink ByTagName} as a {@apilink ByCss} selector.
+     * Expresses [`ByCss`](https://serenity-js.org/api/web/class/ByCss/), [`ById`](https://serenity-js.org/api/web/class/ById/), or [`ByTagName`](https://serenity-js.org/api/web/class/ByTagName/) as a [`ByCss`](https://serenity-js.org/api/web/class/ByCss/) selector.
      *
      * @throws LogicError
-     *  if the `selector` can't be expressed as {@apilink ByCss}
+     *  if the `selector` can't be expressed as [`ByCss`](https://serenity-js.org/api/web/class/ByCss/)
      *
      * @param selector
      * @protected

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

@@ -119,10 +119,10 @@ import type { SwitchableOrigin } from './SwitchableOrigin';
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
- * - {@apilink Optional}
- * - {@apilink Switchable}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
  *
  * @group Models
  */
@@ -132,12 +132,12 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
     protected modalDialogHandler: ModalDialogHandler;
     readonly id: CorrelationId;
     /**
-     * Creates a {@apilink QuestionAdapter} representing the currently active {@apilink Page}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) representing the currently active [`Page`](https://serenity-js.org/api/web/class/Page/).
      */
     static current(): QuestionAdapter<Page>;
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.name}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.name`](https://serenity-js.org/api/web/class/Page/#name)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired name
      *
@@ -155,8 +155,8 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      */
     static whichName(expectation: Expectation<string>): QuestionAdapter<Page>;
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.title}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.title`](https://serenity-js.org/api/web/class/Page/#title)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired title
      *
@@ -174,8 +174,8 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      */
     static whichTitle(expectation: Expectation<string>): QuestionAdapter<Page>;
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.url}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.url`](https://serenity-js.org/api/web/class/Page/#url)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired URL
      *
@@ -195,19 +195,19 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
     private static findMatchingPage;
     constructor(session: BrowsingSession<Page<Native_Element_Type>>, rootLocator: RootLocator<Native_Element_Type>, modalDialogHandler: ModalDialogHandler, id: CorrelationId);
     /**
-     * Creates a {@apilink PageElement} wrapping a native element.
+     * Creates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) wrapping a native element.
      *
      * @param nativeElement
      */
     abstract createPageElement(nativeElement: Native_Element_Type): PageElement<Native_Element_Type>;
     /**
-     * Creates a {@apilink PageElement}, retrieving an element located by {@apilink Selector}.
+     * Creates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/), retrieving an element located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
      *
      * @param selector
      */
     abstract locate(selector: Selector): PageElement<Native_Element_Type>;
     /**
-     * Creates {@apilink PageElements}, retrieving a collection of elements located by {@apilink Selector}.
+     * Creates [`PageElement`](https://serenity-js.org/api/web/class/PageElements/), retrieving a collection of elements located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
      *
      * @param selector
      */
@@ -228,7 +228,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
     abstract navigateTo(destination: string): Promise<void>;
     /**
      * Causes the browser to traverse one step backward in the joint session history
-     * of the current {@apilink Page} (the current top-level browsing context).
+     * of the current [`Page`](https://serenity-js.org/api/web/class/Page/) (the current top-level browsing context).
      *
      * This is equivalent to pressing the back button in the browser UI,
      * or calling [`window.history.back`](https://developer.mozilla.org/en-US/docs/Web/API/History/back).
@@ -236,18 +236,18 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
     abstract navigateBack(): Promise<void>;
     /**
      * Causes the browser to traverse one step forward in the joint session history
-     * of the current {@apilink Page} (the current top-level browsing context).
+     * of the current [`Page`](https://serenity-js.org/api/web/class/Page/) (the current top-level browsing context).
      *
      * This is equivalent to pressing the back button in the browser UI,
      * or calling [`window.history.forward`](https://developer.mozilla.org/en-US/docs/Web/API/History/forward).
      */
     abstract navigateForward(): Promise<void>;
     /**
-     * Causes the browser to reload the {@apilink Page} in the current top-level browsing context.
+     * Causes the browser to reload the [`Page`](https://serenity-js.org/api/web/class/Page/) in the current top-level browsing context.
      */
     abstract reload(): Promise<void>;
     /**
-     * Send a sequence of {@apilink Key} strokes to the active element.
+     * Send a sequence of [`Key`](https://serenity-js.org/api/web/class/Key/) strokes to the active element.
      *
      * @param keys
      *  Keys to enter
@@ -273,7 +273,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      * If the script has a return value (i.e. if the script contains a `return` statement),
      * then the following steps will be taken for resolving this functions return value:
      *
-     * - For a {@apilink PageElement}, the value will resolve to a [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement)
+     * - For a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/), the value will resolve to a [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement)
      * - `null` and `undefined` return values will resolve to `null`
      * - `boolean`, `number`, and `string` values will resolve as is
      * - Functions will resolve to their string representation
@@ -291,7 +291,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      *
      * #### Learn more
      * - [Selenium WebDriver: JavaScript Executor](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeAsyncScript-java.lang.String-java.lang.Object...-)
-     * - {@apilink Page.lastScriptExecutionResult}
+     * - [`Page.lastScriptExecutionResult`](https://serenity-js.org/api/web/class/Page/#lastScriptExecutionResult)
      *
      * @param script
      * @param args
@@ -309,7 +309,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      * 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 Page.executeScript},
+     * Unlike executing synchronous JavaScript with [`Page.executeScript`](https://serenity-js.org/api/web/class/Page/#executeScript),
      * 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,
@@ -318,7 +318,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      * The following steps will be taken for resolving this functions return value against
      * the first argument to the script's callback function:
      *
-     * - For a {@apilink PageElement}, the value will resolve to a [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement)
+     * - For a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/), the value will resolve to a [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement)
      * - `null` and `undefined` return values will resolve to `null`
      * - `boolean`, `number`, and `string` values will resolve as is
      * - Functions will resolve to their string representation
@@ -347,21 +347,21 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      *
      * #### Learn more
      * - [Selenium WebDriver: JavaScript Executor](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeAsyncScript-java.lang.String-java.lang.Object...-)
-     * - {@apilink Page.lastScriptExecutionResult}
+     * - [`Page.lastScriptExecutionResult`](https://serenity-js.org/api/web/class/Page/#lastScriptExecutionResult)
      *
      * @param script
      * @param args
      */
     abstract executeAsyncScript<Result, Parameters extends any[]>(script: string | ((...args: [...parameters: Parameters, callback: (result: Result) => void]) => void), ...args: Parameters): Promise<Result>;
     /**
-     * Returns the last result of calling {@apilink Page.executeAsyncScript}
-     * or {@apilink Page.executeScript}
+     * Returns the last result of calling [`Page.executeAsyncScript`](https://serenity-js.org/api/web/class/Page/#executeAsyncScript)
+     * or [`Page.executeScript`](https://serenity-js.org/api/web/class/Page/#executeScript)
      */
     abstract lastScriptExecutionResult<R = any>(): R;
     /**
      * Take a screenshot of the top-level browsing context's viewport.
      *
-     * @throws {@apilink BrowserWindowClosedError}
+     * @throws [`BrowserWindowClosedError`](https://serenity-js.org/api/web/class/BrowserWindowClosedError/)
      *  When the page you're trying to take the screenshot of has already been closed
      *
      * @return
@@ -369,14 +369,14 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      */
     abstract takeScreenshot(): Promise<string>;
     /**
-     * Retrieves a cookie identified by `name` and visible to this {@apilink Page}.
+     * Retrieves a cookie identified by `name` and visible to this [`Page`](https://serenity-js.org/api/web/class/Page/).
      *
      * @param name
      */
     abstract cookie(name: string): Promise<Cookie>;
     /**
-     * Adds a single cookie with {@apilink CookieData} to the cookie store associated
-     * with the active {@apilink Page}'s address.
+     * Adds a single cookie with [`CookieData`](https://serenity-js.org/api/web/interface/CookieData/) to the cookie store associated
+     * with the active [`Page`](https://serenity-js.org/api/web/class/Page/)'s address.
      *
      * @param cookieData
      */
@@ -427,8 +427,8 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      * to the previous context when needed.
      *
      * ## Learn more
-     * - {@apilink Switch}
-     * - {@apilink Switchable}
+     * - [`Switch`](https://serenity-js.org/api/web/class/Switch/)
+     * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
      */
     switchTo(): Promise<SwitchableOrigin>;
     /**
@@ -440,7 +440,7 @@ export declare abstract class Page<Native_Element_Type = any> implements Optiona
      */
     abstract closeOthers(): Promise<void>;
     /**
-     * Returns the {@apilink ModalDialogHandler} for the current {@apilink Page}.
+     * Returns the [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/) for the current [`Page`](https://serenity-js.org/api/web/class/Page/).
      */
     modalDialog(): ModalDialogHandler;
     /**

package/lib/screenplay/models/Page.js

@@ -110,10 +110,10 @@ const abilities_1 = require("../abilities");
  *
  * ## Learn more
  *
- * - {@apilink BrowseTheWeb}
- * - {@apilink PageElement}
- * - {@apilink Optional}
- * - {@apilink Switchable}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
  *
  * @group Models
  */
@@ -123,7 +123,7 @@ class Page {
     modalDialogHandler;
     id;
     /**
-     * Creates a {@apilink QuestionAdapter} representing the currently active {@apilink Page}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) representing the currently active [`Page`](https://serenity-js.org/api/web/class/Page/).
      */
     static current() {
         return core_1.Question.about('current page', actor => {
@@ -131,8 +131,8 @@ class Page {
         });
     }
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.name}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.name`](https://serenity-js.org/api/web/class/Page/#name)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired name
      *
@@ -155,8 +155,8 @@ class Page {
         });
     }
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.title}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.title`](https://serenity-js.org/api/web/class/Page/#title)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired title
      *
@@ -179,8 +179,8 @@ class Page {
         });
     }
     /**
-     * Creates a {@apilink QuestionAdapter} that resolves to a {@apilink Page} which {@apilink Page.url}
-     * meets the {@apilink Expectation|`expectation`}.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.url`](https://serenity-js.org/api/web/class/Page/#url)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
      *
      * #### Switching to a page with the desired URL
      *
@@ -227,8 +227,8 @@ class Page {
      * to the previous context when needed.
      *
      * ## Learn more
-     * - {@apilink Switch}
-     * - {@apilink Switchable}
+     * - [`Switch`](https://serenity-js.org/api/web/class/Switch/)
+     * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
      */
     async switchTo() {
         const originalPage = await this.session.currentPage();
@@ -240,7 +240,7 @@ class Page {
         };
     }
     /**
-     * Returns the {@apilink ModalDialogHandler} for the current {@apilink Page}.
+     * Returns the [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/) for the current [`Page`](https://serenity-js.org/api/web/class/Page/).
      */
     modalDialog() {
         return this.modalDialogHandler;