@serenity-js/core 3.25.0 → 3.25.2

package/lib/screenplay/abilities/UsesAbilities.d.ts

@@ -1,22 +1,22 @@
 import type { Ability } from './Ability';
 import type { AbilityType } from './AbilityType';
 /**
- * Describes an {@apilink Actor} who can use their {@apilink Ability|abilities} to perform an {@apilink Activity}
- * or answer a {@apilink Question}.
+ * Describes an [`Actor`](https://serenity-js.org/api/core/class/Actor/) who can use their [abilities](https://serenity-js.org/api/core/class/Ability/) to perform an [`Activity`](https://serenity-js.org/api/core/class/Activity/)
+ * or answer a [`Question`](https://serenity-js.org/api/core/class/Question/).
  *
  * ## Learn more
  *
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Actors
  */
 export interface UsesAbilities {
     /**
-     * Provides access to the {@apilink Actor|actor's} {@apilink Ability} to do something
+     * Provides access to the [actor's](https://serenity-js.org/api/core/class/Actor/) [`Ability`](https://serenity-js.org/api/core/class/Ability/) to do something
      *
      * @param doSomething
-     *  The type of ability to look up, e.g. {@apilink BrowseTheWeb} or {@apilink CallAnApi}
+     *  The type of ability to look up, e.g. [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) or [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
      */
     abilityTo<T extends Ability>(doSomething: AbilityType<T>): T;
 }

package/lib/screenplay/activities/PerformsActivities.d.ts

@@ -1,19 +1,19 @@
 import type { Activity } from '../Activity';
 /**
- * Describes an {@apilink Actor} who can perform a sequence of {@apilink Activity|Activities},
- * such as {@apilink Task|tasks} or {@apilink Interaction|interactions}.
+ * Describes an [`Actor`](https://serenity-js.org/api/core/class/Actor/) who can perform a sequence of [activities](https://serenity-js.org/api/core/class/Activity/),
+ * such as [tasks](https://serenity-js.org/api/core/class/Task/) or [interactions](https://serenity-js.org/api/core/class/Interaction/).
  *
  * ## Learn more
- * - {@apilink Activity}
- * - {@apilink Interaction}
- * - {@apilink Task}
- * - {@apilink Actor}
+ * - [`Activity`](https://serenity-js.org/api/core/class/Activity/)
+ * - [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+ * - [`Task`](https://serenity-js.org/api/core/class/Task/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Actors
  */
 export interface PerformsActivities {
     /**
-     * Makes the {@apilink Actor} attempt to perform a sequence of {@apilink Activity|Activities}.
+     * Makes the [`Actor`](https://serenity-js.org/api/core/class/Actor/) attempt to perform a sequence of [activities](https://serenity-js.org/api/core/class/Activity/).
      */
     attemptsTo: (...activities: Activity[]) => Promise<void>;
 }

package/lib/screenplay/artifacts/CollectsArtifacts.d.ts

@@ -1,17 +1,16 @@
 import type { Artifact, Name } from '../../model';
 /**
- * Describes an {@apilink Actor} who can collect {@apilink Artifact|Artifacts}, such as {@apilink Photo|Photos} or {@apilink JSONData},
+ * Describes an [`Actor`](https://serenity-js.org/api/core/class/Actor/) who can collect artifacts, such as photos or `JSON` data.,
  * while the scenario is being executed
  *
  * ## Learn more
- * - {@apilink Artifact}
- * - {@apilink Actor}
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Actors
  */
 export interface CollectsArtifacts {
     /**
-     * Makes the {@apilink Actor} collect an {@apilink Artifact} so that it can be included in the test report.
+     * Makes the [`Actor`](https://serenity-js.org/api/core/class/Actor/) collect an artifact so that it can be included in the test report.
      *
      * #### Implementing a custom interaction to attach artifacts
      *
@@ -68,7 +67,7 @@ export interface CollectsArtifacts {
      * ```
      *
      * @param artifact
-     *  The artifact to be collected, such as {@apilink JSONData}
+     *  The artifact to be collected, such as `JSON` data.
      *
      * @param name
      *  The name of the artifact to make it easy to recognise in the test report

package/lib/screenplay/artifacts/CollectsArtifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollectsArtifacts.d.ts","sourceRoot":"","sources":["../../../src/screenplay/artifacts/CollectsArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAClD"}
+{"version":3,"file":"CollectsArtifacts.d.ts","sourceRoot":"","sources":["../../../src/screenplay/artifacts/CollectsArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAClD"}

package/lib/screenplay/debugging/Debug.d.ts

@@ -6,7 +6,7 @@ import { Interaction } from '../Interaction';
 import type { AnswersQuestions } from '../questions';
 import type { DebuggingResult } from './DebuggingResult';
 /**
- * Instructs the {@apilink Actor|actor} to evaluate and {@apilink Log|log} the provided {@apilink Answerable|answerable} values.
+ * Instructs the [actor](https://serenity-js.org/api/core/class/Actor/) to evaluate and [log](https://serenity-js.org/api/core/class/Log/) the provided [answerable](https://serenity-js.org/api/core/#Answerable) values.
  *
  * Since this interaction **accepts a callback function** that receives the evaluated results,
  * the best way to use it is while **running the test scenario via a Node.js debugger**.
@@ -14,8 +14,8 @@ import type { DebuggingResult } from './DebuggingResult';
  *
  * ## Debugging Answerable values
  *
- * {@apilink Debug.values} accepts a callback function that receives an array of {@apilink DebuggingResult} objects,
- * as well as the result of evaluating each provided {@apilink Answerable|answerable} with {@apilink Actor.answer}.
+ * [`Debug.values`](https://serenity-js.org/api/core/class/Debug/#values) accepts a callback function that receives an array of [`DebuggingResult`](https://serenity-js.org/api/core/interface/DebuggingResult/) objects,
+ * as well as the result of evaluating each provided [answerable](https://serenity-js.org/api/core/#Answerable) with [`Actor.answer`](https://serenity-js.org/api/core/class/Actor/#answer).
  *
  * ```typescript
  * import { actorCalled, Debug } from '@serenity-js/core'
@@ -38,8 +38,9 @@ import type { DebuggingResult } from './DebuggingResult';
  * provides features that allow for [experimenting with web UI locators](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright#tune-locators)
  * while the test is paused at breakpoint.
  *
- * Since this functionality is specific to [Playwright](/api/playwright), you can use it by passing {@apilink PlaywrightPage.current|`PlaywrightPage.current().nativePage()`}
- * to Serenity/JS {@apilink Debug.values}. Also make sure to name the evaluated value `page`, as this is the variable name that the Playwright VSCode extension expects.
+ * Since this functionality is specific to [Playwright](https://serenity-js.org/api/playwright),
+ * you can use it by passing [`PlaywrightPage.current().nativePage()`](https://serenity-js.org/api/playwright/class/PlaywrightPage/#current)
+ * to Serenity/JS [`Debug.values`](https://serenity-js.org/api/core/class/Debug/#values). Also make sure to name the evaluated value `page`, as this is the variable name that the Playwright VSCode extension expects.
  *
  * ```typescript
  * import { actorCalled, Debug } from '@serenity-js/core'
@@ -70,7 +71,7 @@ export declare class Debug<Values extends Array<Answerable<unknown>>> extends In
     private readonly debuggerFunction;
     private readonly values;
     /**
-     * Instructs the {@apilink Actor|actor} to evaluate the provided `values`,
+     * Instructs the [actor](https://serenity-js.org/api/core/class/Actor/) to evaluate the provided `values`,
      * log the results, and then pass them to your `debuggerFunction`.
      *
      * To use this interaction, run your test scenario in the Node.js debugger

package/lib/screenplay/debugging/Debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../../src/screenplay/debugging/Debug.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAE,SAAQ,WAAW;IAmCzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAIjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IArC3B;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,gBAAgB,EAAE,CACvE,OAAO,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,EACtE,GAAG,OAAO,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,KACjE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,MAAM,GAAG,WAAW;IAQ1D;;;;;;;;;OASG;IACH,SAAS,aACL,WAAW,EAAE,MAAM,EACF,gBAAgB,EAAE,CAC/B,gBAAgB,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,EAC/E,GAAG,IAAI,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,KAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACR,MAAM,EAAE,MAAM;IAKnC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuC9F"}
+{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../../src/screenplay/debugging/Debug.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBAAa,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAE,SAAQ,WAAW;IAmCzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAIjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IArC3B;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,gBAAgB,EAAE,CACvE,OAAO,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,EACtE,GAAG,OAAO,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,KACjE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,MAAM,GAAG,WAAW;IAQ1D;;;;;;;;;OASG;IACH,SAAS,aACL,WAAW,EAAE,MAAM,EACF,gBAAgB,EAAE,CAC/B,gBAAgB,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,EAC/E,GAAG,IAAI,EAAE;SAAI,KAAK,IAAI,MAAM,MAAM,GAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAAE,KAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACR,MAAM,EAAE,MAAM;IAKnC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuC9F"}

package/lib/screenplay/debugging/Debug.js

@@ -7,7 +7,7 @@ const stringified_1 = require("../../io/stringified");
 const model_1 = require("../../model");
 const Interaction_1 = require("../Interaction");
 /**
- * Instructs the {@apilink Actor|actor} to evaluate and {@apilink Log|log} the provided {@apilink Answerable|answerable} values.
+ * Instructs the [actor](https://serenity-js.org/api/core/class/Actor/) to evaluate and [log](https://serenity-js.org/api/core/class/Log/) the provided [answerable](https://serenity-js.org/api/core/#Answerable) values.
  *
  * Since this interaction **accepts a callback function** that receives the evaluated results,
  * the best way to use it is while **running the test scenario via a Node.js debugger**.
@@ -15,8 +15,8 @@ const Interaction_1 = require("../Interaction");
  *
  * ## Debugging Answerable values
  *
- * {@apilink Debug.values} accepts a callback function that receives an array of {@apilink DebuggingResult} objects,
- * as well as the result of evaluating each provided {@apilink Answerable|answerable} with {@apilink Actor.answer}.
+ * [`Debug.values`](https://serenity-js.org/api/core/class/Debug/#values) accepts a callback function that receives an array of [`DebuggingResult`](https://serenity-js.org/api/core/interface/DebuggingResult/) objects,
+ * as well as the result of evaluating each provided [answerable](https://serenity-js.org/api/core/#Answerable) with [`Actor.answer`](https://serenity-js.org/api/core/class/Actor/#answer).
  *
  * ```typescript
  * import { actorCalled, Debug } from '@serenity-js/core'
@@ -39,8 +39,9 @@ const Interaction_1 = require("../Interaction");
  * provides features that allow for [experimenting with web UI locators](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright#tune-locators)
  * while the test is paused at breakpoint.
  *
- * Since this functionality is specific to [Playwright](/api/playwright), you can use it by passing {@apilink PlaywrightPage.current|`PlaywrightPage.current().nativePage()`}
- * to Serenity/JS {@apilink Debug.values}. Also make sure to name the evaluated value `page`, as this is the variable name that the Playwright VSCode extension expects.
+ * Since this functionality is specific to [Playwright](https://serenity-js.org/api/playwright),
+ * you can use it by passing [`PlaywrightPage.current().nativePage()`](https://serenity-js.org/api/playwright/class/PlaywrightPage/#current)
+ * to Serenity/JS [`Debug.values`](https://serenity-js.org/api/core/class/Debug/#values). Also make sure to name the evaluated value `page`, as this is the variable name that the Playwright VSCode extension expects.
  *
  * ```typescript
  * import { actorCalled, Debug } from '@serenity-js/core'
@@ -71,7 +72,7 @@ class Debug extends Interaction_1.Interaction {
     debuggerFunction;
     values;
     /**
-     * Instructs the {@apilink Actor|actor} to evaluate the provided `values`,
+     * Instructs the [actor](https://serenity-js.org/api/core/class/Actor/) to evaluate the provided `values`,
      * log the results, and then pass them to your `debuggerFunction`.
      *
      * To use this interaction, run your test scenario in the Node.js debugger

package/lib/screenplay/debugging/Debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../../../src/screenplay/debugging/Debug.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAC/C,iCAA6B;AAC7B,sDAAmD;AACnD,uCAA6C;AAK7C,gDAA6C;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAa,KAAiD,SAAQ,yBAAW;IAmCxD;IAIA;IArCrB;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAA4C,gBAGhC,EAAE,GAAG,MAAc;QACxC,OAAO,IAAI,KAAK,CACZ,iBAAkB,MAAM,CAAC,MAAO,SAAS,EACzC,gBAAgB,EAChB,MAAM,CACT,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACH,YACI,WAAmB,EACF,gBAGQ,EACR,MAAc;QAE/B,KAAK,CAAC,WAAW,CAAC,CAAC;QANF,qBAAgB,GAAhB,gBAAgB,CAGR;QACR,WAAM,GAAN,MAAM,CAAQ;IAGnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QAEvE,MAAM,OAAO,GAAG,EAAmE,CAAC;QAEpF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE;YAE7B,MAAM,MAAM,GAA6B;gBACrC,WAAW,EAAE,IAAA,MAAC,EAAA,GAAI,KAAM,EAAE;gBAC1B,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,SAAS;aACnB,CAAC;YAEF,IAAI;gBACA,MAAM,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC5C;YACD,OAAO,KAAK,EAAE;gBACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;aACxB;YAED,KAAK,CAAC,OAAO,CACT,gBAAQ,CAAC,QAAQ,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,KAAK,EAAE,IAAA,yBAAW,EAAC,MAAM,CAAC,KAAK,CAAC;oBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACf,CAAC,CAAC,wBAAe,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;wBACzC,CAAC,CAAC,MAAM,CAAC,KAAK;iBACrB,CAAC;aACL,CAAC,EACF,IAAI,YAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAC/B,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACxB;QAED,IAAI,CAAC,gBAAgB,CACjB,OAAO,EACP,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAA2D,CACnG,CAAC;IACN,CAAC;CACJ;AAtFD,sBAsFC"}
+{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../../../src/screenplay/debugging/Debug.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAC/C,iCAA6B;AAC7B,sDAAmD;AACnD,uCAA6C;AAK7C,gDAA6C;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAa,KAAiD,SAAQ,yBAAW;IAmCxD;IAIA;IArCrB;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAA4C,gBAGhC,EAAE,GAAG,MAAc;QACxC,OAAO,IAAI,KAAK,CACZ,iBAAkB,MAAM,CAAC,MAAO,SAAS,EACzC,gBAAgB,EAChB,MAAM,CACT,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACH,YACI,WAAmB,EACF,gBAGQ,EACR,MAAc;QAE/B,KAAK,CAAC,WAAW,CAAC,CAAC;QANF,qBAAgB,GAAhB,gBAAgB,CAGR;QACR,WAAM,GAAN,MAAM,CAAQ;IAGnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QAEvE,MAAM,OAAO,GAAG,EAAmE,CAAC;QAEpF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE;YAE7B,MAAM,MAAM,GAA6B;gBACrC,WAAW,EAAE,IAAA,MAAC,EAAA,GAAI,KAAM,EAAE;gBAC1B,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,SAAS;aACnB,CAAC;YAEF,IAAI;gBACA,MAAM,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC5C;YACD,OAAO,KAAK,EAAE;gBACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;aACxB;YAED,KAAK,CAAC,OAAO,CACT,gBAAQ,CAAC,QAAQ,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,KAAK,EAAE,IAAA,yBAAW,EAAC,MAAM,CAAC,KAAK,CAAC;oBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACf,CAAC,CAAC,wBAAe,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;wBACzC,CAAC,CAAC,MAAM,CAAC,KAAK;iBACrB,CAAC;aACL,CAAC,EACF,IAAI,YAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAC/B,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACxB;QAED,IAAI,CAAC,gBAAgB,CACjB,OAAO,EACP,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAA2D,CACnG,CAAC;IACN,CAAC;CACJ;AAtFD,sBAsFC"}

package/lib/screenplay/debugging/DebuggingResult.d.ts

@@ -1,5 +1,5 @@
 /**
- * An interface describing debugging data received by the callback function passed to {@apilink Debug.values}.
+ * An interface describing debugging data received by the callback function passed to [`Debug.values`](https://serenity-js.org/api/core/class/Debug/#values).
  *
  * @group Activities
  */

package/lib/screenplay/debugging/Log.d.ts

@@ -4,10 +4,12 @@ import type { CollectsArtifacts } from '../artifacts';
 import { Interaction } from '../Interaction';
 import type { AnswersQuestions } from '../questions';
 /**
- * Instructs the {@apilink Actor} to {@apilink CollectsArtifacts|collect} arbitrary static values and answers to {@apilink Answerable|Answerables},
- * so that they can be sent to the {@apilink StageCrewMember|StageCrewMembers}
- * and printed to the terminal by the {@apilink ConsoleReporter}
- * or attached to the HTML report by the {@apilink SerenityBDDReporter}.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+ * to [collect](https://serenity-js.org/api/core/interface/CollectsArtifacts/) arbitrary static values
+ * and answers to [answerables](https://serenity-js.org/api/core/#Answerable),
+ * so that they can be sent to the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
+ * and printed to the terminal by the [`ConsoleReporter`](https://serenity-js.org/api/console-reporter/class/ConsoleReporter/)
+ * or attached to the HTML report by the [`SerenityBDDReporter`](https://serenity-js.org/api/serenity-bdd/class/SerenityBDDReporter/).
  *
  * ## Logging static and `Answerable` values
  *
@@ -25,7 +27,7 @@ import type { AnswersQuestions } from '../questions';
 export declare class Log extends Interaction {
     private readonly items;
     /**
-     * Instantiates a new {@apilink Interaction|interaction} to {@apilink Log}
+     * Instantiates a new [interaction](https://serenity-js.org/api/core/class/Interaction/) to [`Log`](https://serenity-js.org/api/core/class/Log/)
      *
      * Note that this method accepts [variable number of arguments](https://www.typescriptlang.org/docs/handbook/functions.html#rest-parameters),
      * so that you can easily log several values at the same time.

package/lib/screenplay/debugging/Log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../../../src/screenplay/debugging/Log.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,GAAI,SAAQ,WAAW;IAoB5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAlB1B;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW;IAIzD;;;OAGG;IACH,SAAS,aACY,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAKlD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAW9F"}
+{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../../../src/screenplay/debugging/Log.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,GAAI,SAAQ,WAAW;IAoB5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAlB1B;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW;IAIzD;;;OAGG;IACH,SAAS,aACY,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAKlD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAW9F"}

package/lib/screenplay/debugging/Log.js

@@ -6,10 +6,12 @@ const stringified_1 = require("../../io/stringified");
 const model_1 = require("../../model");
 const Interaction_1 = require("../Interaction");
 /**
- * Instructs the {@apilink Actor} to {@apilink CollectsArtifacts|collect} arbitrary static values and answers to {@apilink Answerable|Answerables},
- * so that they can be sent to the {@apilink StageCrewMember|StageCrewMembers}
- * and printed to the terminal by the {@apilink ConsoleReporter}
- * or attached to the HTML report by the {@apilink SerenityBDDReporter}.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+ * to [collect](https://serenity-js.org/api/core/interface/CollectsArtifacts/) arbitrary static values
+ * and answers to [answerables](https://serenity-js.org/api/core/#Answerable),
+ * so that they can be sent to the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
+ * and printed to the terminal by the [`ConsoleReporter`](https://serenity-js.org/api/console-reporter/class/ConsoleReporter/)
+ * or attached to the HTML report by the [`SerenityBDDReporter`](https://serenity-js.org/api/serenity-bdd/class/SerenityBDDReporter/).
  *
  * ## Logging static and `Answerable` values
  *
@@ -27,7 +29,7 @@ const Interaction_1 = require("../Interaction");
 class Log extends Interaction_1.Interaction {
     items;
     /**
-     * Instantiates a new {@apilink Interaction|interaction} to {@apilink Log}
+     * Instantiates a new [interaction](https://serenity-js.org/api/core/class/Interaction/) to [`Log`](https://serenity-js.org/api/core/class/Log/)
      *
      * Note that this method accepts [variable number of arguments](https://www.typescriptlang.org/docs/handbook/functions.html#rest-parameters),
      * so that you can easily log several values at the same time.

package/lib/screenplay/debugging/Log.js.map

@@ -1 +1 @@
-{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../../src/screenplay/debugging/Log.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAC7B,sDAAmD;AACnD,uCAA6C;AAI7C,gDAA6C;AAG7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,GAAI,SAAQ,yBAAW;IAoBX;IAlBrB;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAA6B;QACvC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YACqB,KAA6B;QAE9C,KAAK,CAAC,gBAAiB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,MAAC,EAAA,GAAI,IAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAE,EAAE,CAAC,CAAC;QAFrD,UAAK,GAAL,KAAK,CAAwB;IAGlD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QACvE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAE3B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEtC,KAAK,CAAC,OAAO,CACT,gBAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,EAAE,CAAC,EAC9C,IAAI,YAAI,CAAC,IAAA,MAAC,EAAA,GAAI,IAAK,EAAE,CAAC,CACzB,CAAC;SACL;IACL,CAAC;CACJ;AAvCD,kBAuCC"}
+{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../../src/screenplay/debugging/Log.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAC7B,sDAAmD;AACnD,uCAA6C;AAI7C,gDAA6C;AAG7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,GAAI,SAAQ,yBAAW;IAoBX;IAlBrB;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAA6B;QACvC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YACqB,KAA6B;QAE9C,KAAK,CAAC,gBAAiB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,MAAC,EAAA,GAAI,IAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAE,EAAE,CAAC,CAAC;QAFrD,UAAK,GAAL,KAAK,CAAwB;IAGlD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA2D;QACvE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAE3B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEtC,KAAK,CAAC,OAAO,CACT,gBAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,EAAE,CAAC,EAC9C,IAAI,YAAI,CAAC,IAAA,MAAC,EAAA,GAAI,IAAK,EAAE,CAAC,CACzB,CAAC;SACL;IACL,CAAC;CACJ;AAvCD,kBAuCC"}

package/lib/screenplay/notes/Notepad.d.ts

@@ -1,9 +1,9 @@
 import { TinyType } from 'tiny-types';
 import { NotepadAdapter } from './NotepadAdapter';
 /**
- * Stores notes recorded by an {@apilink Actor}.
+ * Stores notes recorded by an [`Actor`](https://serenity-js.org/api/core/class/Actor/).
  *
- * See {@apilink TakeNotes} and [notes](/api/core/function/notes) for more usage examples.
+ * See [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) and [notes](https://serenity-js.org/api/core/function/notes) for more usage examples.
  *
  * ## Sharing a notepad between actors
  *
@@ -43,9 +43,9 @@ import { NotepadAdapter } from './NotepadAdapter';
  *
  * ## Learn more
  *
- * - {@apilink TakeNotes}
- * - [notes](/api/core/function/notes)
- * - {@apilink Cast}
+ * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)
+ * - [notes](https://serenity-js.org/api/core/function/notes)
+ * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
  *
  * @group Notes
  */
@@ -92,17 +92,17 @@ export declare class Notepad<Notes extends Record<any, any>> extends TinyType {
      */
     static with<N extends Record<any, any>>(notes: N): Notepad<N>;
     /**
-     * Creates a {@apilink QuestionAdapter} that simplifies access to the notes
-     * stored in this notepad. Allows the {@apilink Actor} to record, read, and remove notes.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that simplifies access to the notes
+     * stored in this notepad. Allows the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to record, read, and remove notes.
      *
      * #### Learn more
-     * - [notes](/api/core/function/notes)
-     * - {@apilink TakeNotes}
-     * - {@apilink Notepad}
+     * - [notes](https://serenity-js.org/api/core/function/notes)
+     * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)
+     * - [`Notepad`](https://serenity-js.org/api/core/class/Notepad/)
      */
     static notes<N extends Record<any, any>>(): NotepadAdapter<N>;
     /**
-     * Instantiates a {@apilink Notepad} with an initial state.
+     * Instantiates a [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) with an initial state.
      *
      * @param recordedNotes
      *  Initial state of the notepad
@@ -127,8 +127,8 @@ export declare class Notepad<Notes extends Record<any, any>> extends TinyType {
      * @returns
      *  The value of the previously recorded note.
      *
-     * @throws {@apilink LogicError}
-     *  Throws a {@apilink LogicError} if the note with a given `subject`
+     * @throws [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+     *  Throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/) if the note with a given `subject`
      *  has never been recorded.
      */
     get<Subject extends keyof Notes>(subject: Subject): Notes[Subject];

package/lib/screenplay/notes/Notepad.js

@@ -6,9 +6,9 @@ const errors_1 = require("../../errors");
 const io_1 = require("../../io");
 const NotepadAdapter_1 = require("./NotepadAdapter");
 /**
- * Stores notes recorded by an {@apilink Actor}.
+ * Stores notes recorded by an [`Actor`](https://serenity-js.org/api/core/class/Actor/).
  *
- * See {@apilink TakeNotes} and [notes](/api/core/function/notes) for more usage examples.
+ * See [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) and [notes](https://serenity-js.org/api/core/function/notes) for more usage examples.
  *
  * ## Sharing a notepad between actors
  *
@@ -48,9 +48,9 @@ const NotepadAdapter_1 = require("./NotepadAdapter");
  *
  * ## Learn more
  *
- * - {@apilink TakeNotes}
- * - [notes](/api/core/function/notes)
- * - {@apilink Cast}
+ * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)
+ * - [notes](https://serenity-js.org/api/core/function/notes)
+ * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
  *
  * @group Notes
  */
@@ -101,19 +101,19 @@ class Notepad extends tiny_types_1.TinyType {
         return new Notepad(notes);
     }
     /**
-     * Creates a {@apilink QuestionAdapter} that simplifies access to the notes
-     * stored in this notepad. Allows the {@apilink Actor} to record, read, and remove notes.
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that simplifies access to the notes
+     * stored in this notepad. Allows the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to record, read, and remove notes.
      *
      * #### Learn more
-     * - [notes](/api/core/function/notes)
-     * - {@apilink TakeNotes}
-     * - {@apilink Notepad}
+     * - [notes](https://serenity-js.org/api/core/function/notes)
+     * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)
+     * - [`Notepad`](https://serenity-js.org/api/core/class/Notepad/)
      */
     static notes() {
         return new NotepadAdapter_1.NotepadAdapter();
     }
     /**
-     * Instantiates a {@apilink Notepad} with an initial state.
+     * Instantiates a [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) with an initial state.
      *
      * @param recordedNotes
      *  Initial state of the notepad
@@ -143,8 +143,8 @@ class Notepad extends tiny_types_1.TinyType {
      * @returns
      *  The value of the previously recorded note.
      *
-     * @throws {@apilink LogicError}
-     *  Throws a {@apilink LogicError} if the note with a given `subject`
+     * @throws [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+     *  Throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/) if the note with a given `subject`
      *  has never been recorded.
      */
     get(subject) {

package/lib/screenplay/notes/NotepadAdapter.d.ts

@@ -4,10 +4,10 @@ import { Interaction } from '../Interaction';
 import type { QuestionAdapter } from '../Question';
 import type { ChainableSetter } from './ChainableSetter';
 /**
- * Serenity/JS Screenplay Pattern-style adapter for the {@apilink Notepad},
- * that makes it easier for the {@apilink Actor|actors} to access its APIs.
+ * Serenity/JS Screenplay Pattern-style adapter for the [`Notepad`](https://serenity-js.org/api/core/class/Notepad/),
+ * that makes it easier for the [actors](https://serenity-js.org/api/core/class/Actor/) to access its APIs.
  *
- * See {@apilink TakeNotes}, {@apilink Notepad} and {@apilink notes} for more examples.
+ * See [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/), [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) and [`notes`](https://serenity-js.org/api/core/function/notes/) for more examples.
  *
  * @group Notes
  */
@@ -16,7 +16,7 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * Checks if a note identified by `subject` exists in the notepad.
      *
      * #### Learn more
-     * - {@apilink Notepad.has}
+     * - [`Notepad.has`](https://serenity-js.org/api/core/class/Notepad/#has)}
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -29,7 +29,7 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * Retrieves a note, identified by `subject`, from the notepad.
      *
      * #### Learn more
-     * - {@apilink Notepad.get}
+     * - [`Notepad.get`](https://serenity-js.org/api/core/class/Notepad/#get)}
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -37,8 +37,8 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * @returns
      *  The value of the previously recorded note.
      *
-     * @throws {LogicError}
-     *  Throws a {@apilink LogicError} if the note with a given `subject`
+     * @throws
+     *  Throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/) if the note with a given `subject`
      *  has never been recorded.
      */
     get<Subject extends keyof Notes>(subject: Subject): QuestionAdapter<Notes[Subject]>;
@@ -47,9 +47,9 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * uniquely identified by its `subject`.
      *
      * **Pro tip:** calls to `set` can be chained and result in an accumulation
-     * of values to be recorded in the {@apilink Notepad}.
-     * Those values are resolved and recorded when the {@apilink Interaction}
-     * returned by this method is performed by an {@apilink Actor}.
+     * of values to be recorded in the [`Notepad`](https://serenity-js.org/api/core/class/Notepad/).
+     * Those values are resolved and recorded when the [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+     * returned by this method is performed by an [`Actor`](https://serenity-js.org/api/core/class/Actor/).
      *
      * If a note identified by a given `subject` is set multiple times,
      * the last call wins.
@@ -80,7 +80,7 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.set}
+     * - [`Notepad.set`](https://serenity-js.org/api/core/class/Notepad/#set)
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -147,7 +147,7 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.delete}
+     * - [`Notepad.delete`](https://serenity-js.org/api/core/class/Notepad/#delete)
      *
      * @param subject
      *
@@ -178,7 +178,7 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.clear}
+     * - [`Notepad.clear`](https://serenity-js.org/api/core/class/Notepad/#clear)
      */
     clear(): Interaction;
     /**
@@ -202,16 +202,16 @@ export declare class NotepadAdapter<Notes extends Record<any, any>> implements C
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.size}
+     * - [`Notepad.size`](https://serenity-js.org/api/core/class/Notepad/#size)
      */
     size(): QuestionAdapter<number>;
     /**
-     * Produces a {@apilink QuestionAdapter} that resolves to a `JSONObject`
+     * Produces a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a `JSONObject`
      * representing the resolved notes stored in the notepad.
      *
      * Note that serialisation to JSON will simplify some data types that might not be serialisable by default,
      * but are commonly used in data structures representing actor's notes.
-     * For example a {@apilink Map} will be serialised as a regular JSON object, a {@apilink Set} will be serialised as {@apilink Array}.
+     * For example a [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) will be serialised as a regular JSON object, a [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set) will be serialised as [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array).
      *
      * Additionally, notepad assumes that the data structure you use it with does not contain cyclic references.
      *

package/lib/screenplay/notes/NotepadAdapter.js

@@ -7,10 +7,10 @@ const Question_1 = require("../Question");
 const questions_1 = require("../questions");
 const TakeNotes_1 = require("./TakeNotes");
 /**
- * Serenity/JS Screenplay Pattern-style adapter for the {@apilink Notepad},
- * that makes it easier for the {@apilink Actor|actors} to access its APIs.
+ * Serenity/JS Screenplay Pattern-style adapter for the [`Notepad`](https://serenity-js.org/api/core/class/Notepad/),
+ * that makes it easier for the [actors](https://serenity-js.org/api/core/class/Actor/) to access its APIs.
  *
- * See {@apilink TakeNotes}, {@apilink Notepad} and {@apilink notes} for more examples.
+ * See [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/), [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) and [`notes`](https://serenity-js.org/api/core/function/notes/) for more examples.
  *
  * @group Notes
  */
@@ -19,7 +19,7 @@ class NotepadAdapter {
      * Checks if a note identified by `subject` exists in the notepad.
      *
      * #### Learn more
-     * - {@apilink Notepad.has}
+     * - [`Notepad.has`](https://serenity-js.org/api/core/class/Notepad/#has)}
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -36,7 +36,7 @@ class NotepadAdapter {
      * Retrieves a note, identified by `subject`, from the notepad.
      *
      * #### Learn more
-     * - {@apilink Notepad.get}
+     * - [`Notepad.get`](https://serenity-js.org/api/core/class/Notepad/#get)}
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -44,8 +44,8 @@ class NotepadAdapter {
      * @returns
      *  The value of the previously recorded note.
      *
-     * @throws {LogicError}
-     *  Throws a {@apilink LogicError} if the note with a given `subject`
+     * @throws
+     *  Throws a [`LogicError`](https://serenity-js.org/api/core/class/LogicError/) if the note with a given `subject`
      *  has never been recorded.
      */
     get(subject) {
@@ -58,9 +58,9 @@ class NotepadAdapter {
      * uniquely identified by its `subject`.
      *
      * **Pro tip:** calls to `set` can be chained and result in an accumulation
-     * of values to be recorded in the {@apilink Notepad}.
-     * Those values are resolved and recorded when the {@apilink Interaction}
-     * returned by this method is performed by an {@apilink Actor}.
+     * of values to be recorded in the [`Notepad`](https://serenity-js.org/api/core/class/Notepad/).
+     * Those values are resolved and recorded when the [`Interaction`](https://serenity-js.org/api/core/class/Interaction/)
+     * returned by this method is performed by an [`Actor`](https://serenity-js.org/api/core/class/Actor/).
      *
      * If a note identified by a given `subject` is set multiple times,
      * the last call wins.
@@ -91,7 +91,7 @@ class NotepadAdapter {
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.set}
+     * - [`Notepad.set`](https://serenity-js.org/api/core/class/Notepad/#set)
      *
      * @param subject
      *   A subject (name) that uniquely identifies a given note
@@ -160,7 +160,7 @@ class NotepadAdapter {
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.delete}
+     * - [`Notepad.delete`](https://serenity-js.org/api/core/class/Notepad/#delete)
      *
      * @param subject
      *
@@ -195,7 +195,7 @@ class NotepadAdapter {
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.clear}
+     * - [`Notepad.clear`](https://serenity-js.org/api/core/class/Notepad/#clear)
      */
     clear() {
         return Interaction_1.Interaction.where((0, questions_1.the) `#actor clears ${new NumberOfNotes()} from their notepad`, actor => {
@@ -223,7 +223,7 @@ class NotepadAdapter {
      * ```
      *
      * #### Learn more
-     * - {@apilink Notepad.size}
+     * - [`Notepad.size`](https://serenity-js.org/api/core/class/Notepad/#size)
      */
     size() {
         return Question_1.Question.about((0, questions_1.the) `${new NumberOfNotes()}`, async (actor) => {
@@ -231,12 +231,12 @@ class NotepadAdapter {
         });
     }
     /**
-     * Produces a {@apilink QuestionAdapter} that resolves to a `JSONObject`
+     * Produces a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a `JSONObject`
      * representing the resolved notes stored in the notepad.
      *
      * Note that serialisation to JSON will simplify some data types that might not be serialisable by default,
      * but are commonly used in data structures representing actor's notes.
-     * For example a {@apilink Map} will be serialised as a regular JSON object, a {@apilink Set} will be serialised as {@apilink Array}.
+     * For example a [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) will be serialised as a regular JSON object, a [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set) will be serialised as [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array).
      *
      * Additionally, notepad assumes that the data structure you use it with does not contain cyclic references.
      *