@serenity-js/core 3.25.0 → 3.25.2

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

@@ -1,21 +1,21 @@
 import { Ability } from '../abilities';
 import { Notepad } from './Notepad';
 /**
- * An {@apilink Ability} that enables an {@apilink Actor} to remember information
+ * An [`Ability`](https://serenity-js.org/api/core/class/Ability/) that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to remember information
  * to be recalled during a test scenario.
  *
- * Under the hood, {@apilink TakeNotes} uses a {@apilink Notepad}, which state
+ * Under the hood, [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) uses a [`Notepad`](https://serenity-js.org/api/core/class/Notepad/), which state
  * can be populated both during initialisation or while the test scenario is executed.
  * Populating the notepad when it's initialised can be useful to associate authentication credentials
  * or personal details with a given actor, while dynamic recording of notes during a test scenario
  * can be useful when the data to be recorded is not known upfront - for example when we want
  * the actor to remember a JWT stored in the browser and then use it when sending API requests.
  *
- * **Pro tip:** {@apilink TakeNotes}, {@apilink Notepad} and {@apilink notes} can be typed
+ * **Pro tip:** [`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/) can be typed
  * using [TypeScript generics](https://www.typescriptlang.org/docs/handbook/2/generics.html)
  * to help you avoid typos when specifying note names.
  *
- * See [notes](/api/core/function/notes) and {@apilink Notepad} for more usage examples.
+ * See [notes](https://serenity-js.org/api/core/function/notes) and [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) for more usage examples.
  *
  * ## Remembering and retrieving a value
  *
@@ -223,20 +223,20 @@ import { Notepad } from './Notepad';
  *
  * ## Learn more
  *
- * - [notes](/api/core/function/notes)
- * - {@apilink Notepad}
+ * - [notes](https://serenity-js.org/api/core/function/notes)
+ * - [`Notepad`](https://serenity-js.org/api/core/class/Notepad/)
  *
  * @group Notes
  */
 export declare class TakeNotes<Notes_Type extends Record<any, any>> extends Ability {
     readonly notepad: Notepad<Notes_Type>;
     /**
-     * Initialises an {@apilink Ability} to {@apilink TakeNotes} with {@apilink Notepad.empty}.
+     * Initialises an [`Ability`](https://serenity-js.org/api/core/class/Ability/) to [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) with [`Notepad.empty`](https://serenity-js.org/api/core/class/Notepad/#empty).
      */
     static usingAnEmptyNotepad<N extends Record<any, any>>(): TakeNotes<N>;
     /**
-     * Initialises an {@apilink Ability} to {@apilink TakeNotes} using
-     * a {@apilink Notepad.with} some initial state.
+     * Initialises an [`Ability`](https://serenity-js.org/api/core/class/Ability/) to [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) using
+     * a [`Notepad.with`](https://serenity-js.org/api/core/class/Notepad/#with) some initial state.
      *
      * @param notepad
      */

package/lib/screenplay/notes/TakeNotes.js

@@ -4,21 +4,21 @@ exports.TakeNotes = void 0;
 const abilities_1 = require("../abilities");
 const Notepad_1 = require("./Notepad");
 /**
- * An {@apilink Ability} that enables an {@apilink Actor} to remember information
+ * An [`Ability`](https://serenity-js.org/api/core/class/Ability/) that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to remember information
  * to be recalled during a test scenario.
  *
- * Under the hood, {@apilink TakeNotes} uses a {@apilink Notepad}, which state
+ * Under the hood, [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) uses a [`Notepad`](https://serenity-js.org/api/core/class/Notepad/), which state
  * can be populated both during initialisation or while the test scenario is executed.
  * Populating the notepad when it's initialised can be useful to associate authentication credentials
  * or personal details with a given actor, while dynamic recording of notes during a test scenario
  * can be useful when the data to be recorded is not known upfront - for example when we want
  * the actor to remember a JWT stored in the browser and then use it when sending API requests.
  *
- * **Pro tip:** {@apilink TakeNotes}, {@apilink Notepad} and {@apilink notes} can be typed
+ * **Pro tip:** [`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/) can be typed
  * using [TypeScript generics](https://www.typescriptlang.org/docs/handbook/2/generics.html)
  * to help you avoid typos when specifying note names.
  *
- * See [notes](/api/core/function/notes) and {@apilink Notepad} for more usage examples.
+ * See [notes](https://serenity-js.org/api/core/function/notes) and [`Notepad`](https://serenity-js.org/api/core/class/Notepad/) for more usage examples.
  *
  * ## Remembering and retrieving a value
  *
@@ -226,22 +226,22 @@ const Notepad_1 = require("./Notepad");
  *
  * ## Learn more
  *
- * - [notes](/api/core/function/notes)
- * - {@apilink Notepad}
+ * - [notes](https://serenity-js.org/api/core/function/notes)
+ * - [`Notepad`](https://serenity-js.org/api/core/class/Notepad/)
  *
  * @group Notes
  */
 class TakeNotes extends abilities_1.Ability {
     notepad;
     /**
-     * Initialises an {@apilink Ability} to {@apilink TakeNotes} with {@apilink Notepad.empty}.
+     * Initialises an [`Ability`](https://serenity-js.org/api/core/class/Ability/) to [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) with [`Notepad.empty`](https://serenity-js.org/api/core/class/Notepad/#empty).
      */
     static usingAnEmptyNotepad() {
         return TakeNotes.using(Notepad_1.Notepad.empty());
     }
     /**
-     * Initialises an {@apilink Ability} to {@apilink TakeNotes} using
-     * a {@apilink Notepad.with} some initial state.
+     * Initialises an [`Ability`](https://serenity-js.org/api/core/class/Ability/) to [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/) using
+     * a [`Notepad.with`](https://serenity-js.org/api/core/class/Notepad/#with) some initial state.
      *
      * @param notepad
      */

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

@@ -1,9 +1,9 @@
 import type { NotepadAdapter } from './NotepadAdapter';
 /**
- * Alias for {@apilink Notepad.notes}.
+ * Alias for [`Notepad.notes`](https://serenity-js.org/api/core/class/Notepad/#notes).
  *
- * **Pro tip:** `notes<T>().get(subject)` returns a {@apilink NotepadAdapter} to make accessing the APIs
- * of the underlying type easier. Check {@apilink NotepadAdapter} for more examples.
+ * **Pro tip:** `notes<T>().get(subject)` returns a [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/) to make accessing the APIs
+ * of the underlying type easier. Check [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/) for more examples.
  *
  * ## Working with untyped notes
  *
@@ -107,9 +107,9 @@ import type { NotepadAdapter } from './NotepadAdapter';
  *
  * ## Learn more
  *
- * - {@apilink NotepadAdapter}
- * - {@apilink Notepad.notes}
- * - {@apilink QuestionAdapter}
+ * - [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/)
+ * - [`Notepad.notes`](https://serenity-js.org/api/core/class/Notepad/#notes)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * @group Notes
  */

package/lib/screenplay/notes/notes.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.notes = void 0;
 const Notepad_1 = require("./Notepad");
 /**
- * Alias for {@apilink Notepad.notes}.
+ * Alias for [`Notepad.notes`](https://serenity-js.org/api/core/class/Notepad/#notes).
  *
- * **Pro tip:** `notes<T>().get(subject)` returns a {@apilink NotepadAdapter} to make accessing the APIs
- * of the underlying type easier. Check {@apilink NotepadAdapter} for more examples.
+ * **Pro tip:** `notes<T>().get(subject)` returns a [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/) to make accessing the APIs
+ * of the underlying type easier. Check [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/) for more examples.
  *
  * ## Working with untyped notes
  *
@@ -110,9 +110,9 @@ const Notepad_1 = require("./Notepad");
  *
  * ## Learn more
  *
- * - {@apilink NotepadAdapter}
- * - {@apilink Notepad.notes}
- * - {@apilink QuestionAdapter}
+ * - [`NotepadAdapter`](https://serenity-js.org/api/core/class/NotepadAdapter/)
+ * - [`Notepad.notes`](https://serenity-js.org/api/core/class/Notepad/#notes)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * @group Notes
  */

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

@@ -1,17 +1,17 @@
 import type { Answerable } from '../Answerable';
 /**
- * Describes an {@apilink Actor} who can answer a {@apilink Question} about the system under test.
+ * Describes an [`Actor`](https://serenity-js.org/api/core/class/Actor/) who can answer a [`Question`](https://serenity-js.org/api/core/class/Question/) about the system under test.
  *
  * ## Learn more
  *
- * - {@apilink Question}
- * - {@apilink Actor}
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Actors
  */
 export interface AnswersQuestions {
     /**
-     * Makes the {@apilink Actor} evaluate an {@apilink Answerable}
+     * Makes the [`Actor`](https://serenity-js.org/api/core/class/Actor/) evaluate an [`Answerable`](https://serenity-js.org/api/core/#Answerable)
      * and return the value it holds.
      */
     answer<T>(answerable: Answerable<T>): Promise<T>;

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

@@ -2,24 +2,24 @@ import type { Answerable } from '../Answerable';
 import type { Question } from '../Question';
 import type { MetaQuestion } from './MetaQuestion';
 /**
- * A chainable meta-question is a {@apilink MetaQuestion} that can be answered
- * in the context of another {@apilink Answerable},
+ * A chainable meta-question is a [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/) that can be answered
+ * in the context of another [`Answerable`](https://serenity-js.org/api/core/#Answerable),
  * and form a chain of transformations.
  *
- * {@apilink MetaQuestion|Meta questions} are typically used when filtering a {@apilink List}.
+ * [Meta-questions](https://serenity-js.org/api/core/interface/MetaQuestion/) are typically used when filtering a [`List`](https://serenity-js.org/api/core/class/List/).
  *
  * ## Learn more
- * - {@apilink List}
+ * - [`List`](https://serenity-js.org/api/core/class/List/)
  *
  * @group Questions
  */
 export interface ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type extends Question<unknown>> extends MetaQuestion<Supported_Context_Type, Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>> {
     /**
-     * Answers the given `ChainableMetaQuestion` in the context of another {@apilink Answerable}
+     * Answers the given `ChainableMetaQuestion` in the context of another [`Answerable`](https://serenity-js.org/api/core/#Answerable)
      * and returns another `ChainableMetaQuestion` ready for further chaining.
      *
      * #### Learn more
-     * - {@apilink List}
+     * - [`List`](https://serenity-js.org/api/core/class/List/)
      */
     of(context: Answerable<Supported_Context_Type>): Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>;
 }

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

@@ -6,7 +6,7 @@ import { Task } from '../Task';
 import type { Expectation } from './Expectation';
 /**
  * A [flow control statement](https://en.wikipedia.org/wiki/Control_flow)
- * that enables an {@apilink Actor} to decide between two alternate series of {@apilink Activity|activities}.
+ * that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to decide between two alternate series of [activities](https://serenity-js.org/api/core/class/Activity/).
  *
  * Think of it as a Screenplay Pattern equivalent of the traditional `if` statement.
  *
@@ -54,7 +54,7 @@ export declare class Check<Actual> extends Task {
     protected constructor(actual: Answerable<Actual>, expectation: Expectation<Actual>, activities: Activity[], alternativeActivities?: Activity[]);
     /**
      * @param alternativeActivities
-     *  A sequence of {@apilink Activity|activities} to perform when the {@apilink Expectation} is not met.
+     *  A sequence of [activities](https://serenity-js.org/api/core/class/Activity/) to perform when the [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) is not met.
      */
     otherwise(...alternativeActivities: Activity[]): Task;
     /**

package/lib/screenplay/questions/Check.js

@@ -6,7 +6,7 @@ const Task_1 = require("../Task");
 const expectations_1 = require("./expectations");
 /**
  * A [flow control statement](https://en.wikipedia.org/wiki/Control_flow)
- * that enables an {@apilink Actor} to decide between two alternate series of {@apilink Activity|activities}.
+ * that enables an [`Actor`](https://serenity-js.org/api/core/class/Actor/) to decide between two alternate series of [activities](https://serenity-js.org/api/core/class/Activity/).
  *
  * Think of it as a Screenplay Pattern equivalent of the traditional `if` statement.
  *
@@ -63,7 +63,7 @@ class Check extends Task_1.Task {
     }
     /**
      * @param alternativeActivities
-     *  A sequence of {@apilink Activity|activities} to perform when the {@apilink Expectation} is not met.
+     *  A sequence of [activities](https://serenity-js.org/api/core/class/Activity/) to perform when the [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) is not met.
      */
     otherwise(...alternativeActivities) {
         return new Check(this.actual, this.expectation, this.activities, alternativeActivities);

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

@@ -1,6 +1,6 @@
 /**
- * Configuration options for {@apilink Question.formattedValue} and
- * the [`the`](/api/core/function/the/) function.
+ * Configuration options for [`Question.formattedValue`](https://serenity-js.org/api/core/class/Question/#formattedValue) and
+ * the [`the`](https://serenity-js.org/api/core/function/the/) function.
  *
  * @group Questions
  */

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

@@ -9,8 +9,11 @@ type AnswerableArguments<Arguments extends Array<unknown>> = {
     [Index in keyof Arguments]: Answerable<Arguments[Index]>;
 };
 /**
- * Defines an expectation to be used with {@apilink @apilink Wait.until}, {@apilink Check.whether}, {@apilink Ensure.that}
- * and as part of the Page Element Query Language with {@apilink PageElements.where} and {@apilink List.where}.
+ * Defines an expectation to be used with [`Wait.until`](https://serenity-js.org/api/core/class/Wait/#until),
+ * [`Check.whether`](https://serenity-js.org/api/core/class/Check/#whether),
+ * [`Ensure.that`](https://serenity-js.org/api/assertions/class/Ensure/#that)
+ * and as part of the Page Element Query Language with [`PageElements.where`](https://serenity-js.org/api/web/class/PageElements/#where)
+ * and [`List.where`](https://serenity-js.org/api/core/class/List/#where).
  *
  * @group Expectations
  */
@@ -18,7 +21,7 @@ export declare class Expectation<Actual> extends Describable {
     private readonly functionName;
     private readonly predicate;
     /**
-     * A factory method to that makes defining custom {@apilink Expectation|expectations} easier
+     * A factory method to that makes defining custom [expectations](https://serenity-js.org/api/core/class/Expectation/) easier
      *
      * #### Defining a custom expectation
      *
@@ -89,22 +92,22 @@ export declare class Expectation<Actual> extends Describable {
      * ```
      *
      * #### Learn more
-     * - {@apilink Ensure}
-     * - {@apilink Check}
-     * - {@apilink Wait}
+     * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+     * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+     * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
      *
      * @param functionName
-     *  Name of the expectation function to be used when producing an {@apilink AssertionError}
+     *  Name of the expectation function to be used when producing an [`AssertionError`](https://serenity-js.org/api/core/class/AssertionError/)
      *
      * @param relationship
      *  Human-readable description of the relationship between the `expected` and the `actual` values.
-     *  Used when reporting {@apilink Activity|activities} performed by an {@apilink Actor|actor}
+     *  Used when reporting [activities](https://serenity-js.org/api/core/class/Activity/) performed by an [actor](https://serenity-js.org/api/core/class/Actor/)
      *
      * @param predicate
      */
     static define<Actual_Type, PredicateArguments extends Array<unknown>>(functionName: string, relationship: ((...answerableArguments: AnswerableArguments<PredicateArguments>) => Answerable<string>) | Answerable<string>, predicate: (actual: Actual_Type, ...predicateArguments: PredicateArguments) => Promise<boolean> | boolean): (...answerableArguments: AnswerableArguments<PredicateArguments>) => Expectation<Actual_Type>;
     /**
-     * Used to define a simple {@apilink Expectation}
+     * Used to define a simple [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
      *
      * #### Simple parameterised expectation
      *
@@ -133,9 +136,9 @@ export declare class Expectation<Actual> extends Describable {
         soThat: (simplifiedPredicate: (actualValue: Actual_Type, expectedValue: Expected_Type) => Promise<boolean> | boolean) => Expectation<Actual_Type>;
     };
     /**
-     * Used to compose {@apilink Expectation|expectations}.
+     * Used to compose [expectations](https://serenity-js.org/api/core/class/Expectation/).
      *
-     * #### Composing {@apilink Expectation|expectations}
+     * #### Composing [expectations](https://serenity-js.org/api/core/class/Expectation/)
      *
      * ```ts
      * import { actorCalled, Expectation } from '@serenity-js/core'
@@ -167,9 +170,9 @@ export declare class Expectation<Actual> extends Describable {
     };
     protected constructor(functionName: string, description: Answerable<string>, predicate: Predicate<Actual>);
     /**
-     * Returns a {@apilink QuestionAdapter} that resolves to {@apilink ExpectationOutcome}
-     * indicating that the {@apilink ExpectationMet|expectation was met}
-     * or that the {@apilink ExpectationNotMet|expectation was not met}
+     * Returns a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to [`ExpectationOutcome`](https://serenity-js.org/api/core/class/ExpectationOutcome/)
+     * indicating that the [expectation was met](https://serenity-js.org/api/core/class/ExpectationMet/)
+     * or that the [expectation was not met](https://serenity-js.org/api/core/class/ExpectationNotMet/)
      *
      * @param actual
      */

package/lib/screenplay/questions/Expectation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Expectation.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Expectation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,KAChF,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;AAErD,KAAK,mBAAmB,CAAC,SAAS,SAAS,KAAK,CAAC,OAAO,CAAC,IAAI;KAAG,KAAK,IAAI,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;CAAE,CAAC;AAE1H;;;;;GAKG;AACH,qBAAa,WAAW,CAAC,MAAM,CAAE,SAAQ,WAAW;IAiO5C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAjO9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoFG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,SAAS,KAAK,CAAC,OAAO,CAAC,EAChE,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,CAAC,CAAC,GAAG,mBAAmB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EAC5H,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAC1G,CAAC,GAAG,mBAAmB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,WAAW,CAAC,WAAW,CAAC;IAmChG;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG;QACtH,MAAM,EAAE,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC;KACrJ;IAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG;QAC9C,YAAY,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC;KACrF;IAcD,SAAS,aACY,YAAY,EAAE,MAAM,EACrC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,EACd,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC;IAKjD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIzE;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI;CAKrD"}
+{"version":3,"file":"Expectation.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Expectation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,KAChF,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;AAErD,KAAK,mBAAmB,CAAC,SAAS,SAAS,KAAK,CAAC,OAAO,CAAC,IAAI;KAAG,KAAK,IAAI,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;CAAE,CAAC;AAE1H;;;;;;;;GAQG;AACH,qBAAa,WAAW,CAAC,MAAM,CAAE,SAAQ,WAAW;IAiO5C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAjO9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoFG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,SAAS,KAAK,CAAC,OAAO,CAAC,EAChE,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,CAAC,CAAC,GAAG,mBAAmB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EAC5H,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAC1G,CAAC,GAAG,mBAAmB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,WAAW,CAAC,WAAW,CAAC;IAmChG;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG;QACtH,MAAM,EAAE,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC;KACrJ;IAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG;QAC9C,YAAY,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC;KACrF;IAcD,SAAS,aACY,YAAY,EAAE,MAAM,EACrC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,EACd,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC;IAKjD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIzE;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI;CAKrD"}

package/lib/screenplay/questions/Expectation.js

@@ -7,8 +7,11 @@ const index_1 = require("../index");
 const Question_1 = require("../Question");
 const questions_1 = require("../questions");
 /**
- * Defines an expectation to be used with {@apilink @apilink Wait.until}, {@apilink Check.whether}, {@apilink Ensure.that}
- * and as part of the Page Element Query Language with {@apilink PageElements.where} and {@apilink List.where}.
+ * Defines an expectation to be used with [`Wait.until`](https://serenity-js.org/api/core/class/Wait/#until),
+ * [`Check.whether`](https://serenity-js.org/api/core/class/Check/#whether),
+ * [`Ensure.that`](https://serenity-js.org/api/assertions/class/Ensure/#that)
+ * and as part of the Page Element Query Language with [`PageElements.where`](https://serenity-js.org/api/web/class/PageElements/#where)
+ * and [`List.where`](https://serenity-js.org/api/core/class/List/#where).
  *
  * @group Expectations
  */
@@ -16,7 +19,7 @@ class Expectation extends questions_1.Describable {
     functionName;
     predicate;
     /**
-     * A factory method to that makes defining custom {@apilink Expectation|expectations} easier
+     * A factory method to that makes defining custom [expectations](https://serenity-js.org/api/core/class/Expectation/) easier
      *
      * #### Defining a custom expectation
      *
@@ -87,16 +90,16 @@ class Expectation extends questions_1.Describable {
      * ```
      *
      * #### Learn more
-     * - {@apilink Ensure}
-     * - {@apilink Check}
-     * - {@apilink Wait}
+     * - [`Ensure`](https://serenity-js.org/api/assertions/class/Ensure/)
+     * - [`Check`](https://serenity-js.org/api/core/class/Check/)
+     * - [`Wait`](https://serenity-js.org/api/core/class/Wait/)
      *
      * @param functionName
-     *  Name of the expectation function to be used when producing an {@apilink AssertionError}
+     *  Name of the expectation function to be used when producing an [`AssertionError`](https://serenity-js.org/api/core/class/AssertionError/)
      *
      * @param relationship
      *  Human-readable description of the relationship between the `expected` and the `actual` values.
-     *  Used when reporting {@apilink Activity|activities} performed by an {@apilink Actor|actor}
+     *  Used when reporting [activities](https://serenity-js.org/api/core/class/Activity/) performed by an [actor](https://serenity-js.org/api/core/class/Actor/)
      *
      * @param predicate
      */
@@ -121,7 +124,7 @@ class Expectation extends questions_1.Describable {
         }, 'name', { value: functionName, writable: false });
     }
     /**
-     * Used to define a simple {@apilink Expectation}
+     * Used to define a simple [`Expectation`](https://serenity-js.org/api/core/class/Expectation/)
      *
      * #### Simple parameterised expectation
      *
@@ -163,9 +166,9 @@ class Expectation extends questions_1.Describable {
         });
     }
     /**
-     * Used to compose {@apilink Expectation|expectations}.
+     * Used to compose [expectations](https://serenity-js.org/api/core/class/Expectation/).
      *
-     * #### Composing {@apilink Expectation|expectations}
+     * #### Composing [expectations](https://serenity-js.org/api/core/class/Expectation/)
      *
      * ```ts
      * import { actorCalled, Expectation } from '@serenity-js/core'
@@ -207,9 +210,9 @@ class Expectation extends questions_1.Describable {
         this.predicate = predicate;
     }
     /**
-     * Returns a {@apilink QuestionAdapter} that resolves to {@apilink ExpectationOutcome}
-     * indicating that the {@apilink ExpectationMet|expectation was met}
-     * or that the {@apilink ExpectationNotMet|expectation was not met}
+     * Returns a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to [`ExpectationOutcome`](https://serenity-js.org/api/core/class/ExpectationOutcome/)
+     * indicating that the [expectation was met](https://serenity-js.org/api/core/class/ExpectationMet/)
+     * or that the [expectation was not met](https://serenity-js.org/api/core/class/ExpectationNotMet/)
      *
      * @param actual
      */

package/lib/screenplay/questions/Expectation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Expectation.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Expectation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Expectation.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Expectation.ts"],"names":[],"mappings":"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"}

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

@@ -7,8 +7,8 @@ import type { AnswersQuestions, ChainableMetaQuestion, MetaQuestion } from '../q
 import { Task } from '../Task';
 import type { Expectation } from './Expectation';
 /**
- * Serenity/JS Screenplay Pattern-style wrapper around {@apilink Array}
- * and array-like structures - see {@apilink PageElements}.
+ * Serenity/JS Screenplay Pattern-style wrapper around [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+ * and array-like structures - see [`PageElement`](https://serenity-js.org/api/web/class/PageElements/).
  *
  * @group Questions
  */
@@ -33,10 +33,10 @@ export declare abstract class List<Item_Type> extends Question<Promise<Array<Ite
 }
 /**
  * Serenity/JS Screenplay Pattern-style wrapper around
- * a {@apilink ChainableMetaQuestion} representing a collection
- * that can be resolved in `Supported_Context_Type` of another {@apilink Question}.
+ * a [`ChainableMetaQuestion`](https://serenity-js.org/api/core/interface/ChainableMetaQuestion/) representing a collection
+ * that can be resolved in `Supported_Context_Type` of another [`Question`](https://serenity-js.org/api/core/class/Question/).
  *
- * For example, {@apilink PageElements.located} returns `MetaList<PageElement>`,
+ * For example, [`PageElements.located`](https://serenity-js.org/api/web/class/PageElements/#located) returns `MetaList<PageElement>`,
  * which allows for the collection of page elements to be resolved in the context
  * of dynamically-provided root element.
  *

package/lib/screenplay/questions/List.js

@@ -7,8 +7,8 @@ const Question_1 = require("../Question");
 const Task_1 = require("../Task");
 const expectations_1 = require("./expectations");
 /**
- * Serenity/JS Screenplay Pattern-style wrapper around {@apilink Array}
- * and array-like structures - see {@apilink PageElements}.
+ * Serenity/JS Screenplay Pattern-style wrapper around [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+ * and array-like structures - see [`PageElement`](https://serenity-js.org/api/web/class/PageElements/).
  *
  * @group Questions
  */
@@ -99,10 +99,10 @@ class ArrayList extends List {
 }
 /**
  * Serenity/JS Screenplay Pattern-style wrapper around
- * a {@apilink ChainableMetaQuestion} representing a collection
- * that can be resolved in `Supported_Context_Type` of another {@apilink Question}.
+ * a [`ChainableMetaQuestion`](https://serenity-js.org/api/core/interface/ChainableMetaQuestion/) representing a collection
+ * that can be resolved in `Supported_Context_Type` of another [`Question`](https://serenity-js.org/api/core/class/Question/).
  *
- * For example, {@apilink PageElements.located} returns `MetaList<PageElement>`,
+ * For example, [`PageElements.located`](https://serenity-js.org/api/web/class/PageElements/#located) returns `MetaList<PageElement>`,
  * which allows for the collection of page elements to be resolved in the context
  * of dynamically-provided root element.
  *

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

@@ -27,8 +27,10 @@ export declare class Masked {
      *   );
      * ```
      *
-     * @param parameter - An {@link Answerable} representing the masked value.
-     * @returns A {@link QuestionAdapter} representing the masked value.
+     * @param parameter
+     *  An [`Answerable`](https://serenity-js.org/api/core/#Answerable) representing the masked value.
+     * @returns
+     *  A [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) representing the masked value.
      */
     static valueOf(parameter: Answerable<string>): QuestionAdapter<string>;
 }

package/lib/screenplay/questions/Masked.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Masked.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Masked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IAEf;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;CAGzE"}
+{"version":3,"file":"Masked.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Masked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IAEf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;CAGzE"}

package/lib/screenplay/questions/Masked.js

@@ -29,8 +29,10 @@ class Masked {
      *   );
      * ```
      *
-     * @param parameter - An {@link Answerable} representing the masked value.
-     * @returns A {@link QuestionAdapter} representing the masked value.
+     * @param parameter
+     *  An [`Answerable`](https://serenity-js.org/api/core/#Answerable) representing the masked value.
+     * @returns
+     *  A [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) representing the masked value.
      */
     static valueOf(parameter) {
         return Question_1.Question.about('[a masked value]', async (actor) => actor.answer(parameter));

package/lib/screenplay/questions/Masked.js.map

@@ -1 +1 @@
-{"version":3,"file":"Masked.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Masked.ts"],"names":[],"mappings":";;;AACA,0CAA6D;AAE7D;;;;;;;;;;GAUG;AACH,MAAa,MAAM;IAEf;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,SAA6B;QACxC,OAAO,mBAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,CAAC;CACJ;AAvBD,wBAuBC"}
+{"version":3,"file":"Masked.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Masked.ts"],"names":[],"mappings":";;;AACA,0CAA6D;AAE7D;;;;;;;;;;GAUG;AACH,MAAa,MAAM;IAEf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,OAAO,CAAC,SAA6B;QACxC,OAAO,mBAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,CAAC;CACJ;AAzBD,wBAyBC"}

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

@@ -1,30 +1,30 @@
 import type { Answerable } from '../Answerable';
 import type { Question } from '../Question';
 /**
- * A meta-question is a {@apilink Question} that can be answered
- * in the context of another {@apilink Answerable},
+ * A meta-question is a [`Question`](https://serenity-js.org/api/core/class/Question/) that can be answered
+ * in the context of another [`Answerable`](https://serenity-js.org/api/core/#Answerable),
  * typically to transform its value.
  *
- * For example, the question {@apilink Text.of} can be answered in the context
- * of a {@apilink PageElement} to return its text content.
+ * For example, the question [`Text.of`](https://serenity-js.org/api/web/class/Text/#of) can be answered in the context
+ * of a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) to return its text content.
  *
- * {@apilink MetaQuestion|Meta questions} are typically used when filtering a {@apilink List}.
+ * [Meta-questions](https://serenity-js.org/api/core/interface/MetaQuestion/) are typically used when filtering a [`List`](https://serenity-js.org/api/core/class/List/).
  *
  * ## Learn more
- * - {@apilink List}
+ * - [`List`](https://serenity-js.org/api/core/class/List/)
  *
  * @group Questions
  */
 export interface MetaQuestion<Supported_Context_Type, Returned_Question_Type extends Question<unknown>> {
     /**
-     * Answers the given `MetaQuestion` in the context of another {@apilink Answerable}.
+     * Answers the given `MetaQuestion` in the context of another [`Answerable`](https://serenity-js.org/api/core/#Answerable).
      *
      * #### Learn more
-     * - {@apilink List}
+     * - [`List`](https://serenity-js.org/api/core/class/List/)
      */
     of(context: Answerable<Supported_Context_Type>): Returned_Question_Type;
     /**
-     * Human-readable description of this {@apilink MetaQuestion},
+     * Human-readable description of this [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/),
      * typically involving the description of the subject.
      *
      * For example, a description of a meta question obout "the text of an element"

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

@@ -3,8 +3,8 @@ import type { JSONValue } from 'tiny-types';
 import { TinyType } from 'tiny-types';
 import * as util from 'util';
 /**
- * A placeholder value signifying that a {@apilink Question}
- * has not been answered by an {@apilink Actor} when producing an {@apilink ExpectationOutcome}.
+ * A placeholder value signifying that a [`Question`](https://serenity-js.org/api/core/class/Question/)
+ * has not been answered by an [`Actor`](https://serenity-js.org/api/core/class/Actor/) when producing an [`ExpectationOutcome`](https://serenity-js.org/api/core/class/ExpectationOutcome/).
  * This happens when Serenity/JS decides that answering a given question
  * won't affect the outcome.
  *

package/lib/screenplay/questions/Unanswered.js

@@ -27,8 +27,8 @@ exports.Unanswered = void 0;
 const tiny_types_1 = require("tiny-types");
 const util = __importStar(require("util")); // eslint-disable-line unicorn/import-style
 /**
- * A placeholder value signifying that a {@apilink Question}
- * has not been answered by an {@apilink Actor} when producing an {@apilink ExpectationOutcome}.
+ * A placeholder value signifying that a [`Question`](https://serenity-js.org/api/core/class/Question/)
+ * has not been answered by an [`Actor`](https://serenity-js.org/api/core/class/Actor/) when producing an [`ExpectationOutcome`](https://serenity-js.org/api/core/class/ExpectationOutcome/).
  * This happens when Serenity/JS decides that answering a given question
  * won't affect the outcome.
  *