@serenity-js/core 3.43.0 → 3.43.1

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.43.1](https://github.com/serenity-js/serenity-js/compare/v3.43.0...v3.43.1) (2026-05-11)
+
+
+### Bug Fixes
+
+* **core:** updated API docs ([38b86f4](https://github.com/serenity-js/serenity-js/commit/38b86f4190b5d3c6a64fd0042c87ac187f847f89))
+
+
+
+
+
 # [3.43.0](https://github.com/serenity-js/serenity-js/compare/v3.42.2...v3.43.0) (2026-05-11)
 
 

package/esm/config/SerenityConfig.d.ts

@@ -35,7 +35,7 @@ export declare abstract class SerenityConfig {
      * The maximum amount of time between [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [SceneFinished](https://serenity-js.org/api/core-events/class/SceneFinished/) events
      * that Serenity/JS should wait for any post-scenario
      * async operations to complete. Those include generating the screenshots,
-     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/interface/Discardable/), and so on.
+     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/class/Discardable/), and so on.
      *
      * Defaults to 5 seconds.
      *

package/esm/config/SerenityConfig.js

@@ -30,7 +30,7 @@ export class SerenityConfig {
      * The maximum amount of time between [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [SceneFinished](https://serenity-js.org/api/core-events/class/SceneFinished/) events
      * that Serenity/JS should wait for any post-scenario
      * async operations to complete. Those include generating the screenshots,
-     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/interface/Discardable/), and so on.
+     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/class/Discardable/), and so on.
      *
      * Defaults to 5 seconds.
      *

package/esm/events/SceneFinishes.d.ts

@@ -5,7 +5,7 @@ import { DomainEvent } from './DomainEvent.js';
 /**
  * Emitted by a Serenity/JS test runner adapter, right before a test and all its associated test hooks finish.
  * Triggers any clean-up operations that might be required, such as discarding of
- * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
+ * the [discardable](https://serenity-js.org/api/core/class/Discardable/) abilities.
  *
  * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
  * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result

package/esm/events/SceneFinishes.js

@@ -5,7 +5,7 @@ import { DomainEvent } from './DomainEvent.js';
 /**
  * Emitted by a Serenity/JS test runner adapter, right before a test and all its associated test hooks finish.
  * Triggers any clean-up operations that might be required, such as discarding of
- * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
+ * the [discardable](https://serenity-js.org/api/core/class/Discardable/) abilities.
  *
  * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
  * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result

package/esm/events/actor/ActorStageExitCompleted.d.ts

@@ -4,7 +4,7 @@ import { Timestamp } from '../../screenplay/index.js';
 import { AsyncOperationCompleted } from '../AsyncOperationCompleted.js';
 /**
  * Emitted when an [`Actor`](https://serenity-js.org/api/core/class/Actor/) and its abilities
- * are correctly [released](https://serenity-js.org/api/core/interface/Discardable/) either
+ * are correctly [released](https://serenity-js.org/api/core/class/Discardable/) either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event
  * for actors initialised within the scope of a test scenario,
  * or upon the [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) event

package/esm/events/actor/ActorStageExitCompleted.js

@@ -4,7 +4,7 @@ import { Timestamp } from '../../screenplay/index.js';
 import { AsyncOperationCompleted } from '../AsyncOperationCompleted.js';
 /**
  * Emitted when an [`Actor`](https://serenity-js.org/api/core/class/Actor/) and its abilities
- * are correctly [released](https://serenity-js.org/api/core/interface/Discardable/) either
+ * are correctly [released](https://serenity-js.org/api/core/class/Discardable/) either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event
  * for actors initialised within the scope of a test scenario,
  * or upon the [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) event

package/esm/events/actor/ActorStageExitFailed.d.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 import { AsyncOperationFailed } from '../AsyncOperationFailed.js';
 /**
- * Emitted when [releasing](https://serenity-js.org/api/core/interface/Discardable/) an
+ * Emitted when [releasing](https://serenity-js.org/api/core/class/Discardable/) an
  * [`Actor`](https://serenity-js.org/api/core/class/Actor/) or its abilities
  * resulted in an error either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event

package/esm/events/actor/ActorStageExitFailed.js

@@ -3,7 +3,7 @@ import { CorrelationId } from '../../model/index.js';
 import { Timestamp } from '../../screenplay/index.js';
 import { AsyncOperationFailed } from '../AsyncOperationFailed.js';
 /**
- * Emitted when [releasing](https://serenity-js.org/api/core/interface/Discardable/) an
+ * Emitted when [releasing](https://serenity-js.org/api/core/class/Discardable/) an
  * [`Actor`](https://serenity-js.org/api/core/class/Actor/) or its abilities
  * resulted in an error either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event

package/esm/events/actor/ActorStageExitStarts.d.ts

@@ -7,7 +7,7 @@ import { DomainEvent } from '../DomainEvent.js';
  * [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) events
  * to notify the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
  * about the final state of the [actors](https://serenity-js.org/api/core/class/Actor/) and their abilities
- * before they're [released](https://serenity-js.org/api/core/interface/Discardable/).
+ * before they're [released](https://serenity-js.org/api/core/class/Discardable/).
  *
  * @group Events
  */

package/esm/events/actor/ActorStageExitStarts.js

@@ -7,7 +7,7 @@ import { DomainEvent } from '../DomainEvent.js';
  * [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) events
  * to notify the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
  * about the final state of the [actors](https://serenity-js.org/api/core/class/Actor/) and their abilities
- * before they're [released](https://serenity-js.org/api/core/interface/Discardable/).
+ * before they're [released](https://serenity-js.org/api/core/class/Discardable/).
  *
  * @group Events
  */

package/esm/screenplay/Actor.d.ts

@@ -130,8 +130,8 @@ export declare class Actor implements PerformsActivities, UsesAbilities, CanHave
      */
     currentTime(): Timestamp;
     /**
-     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
-     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/class/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
      */
     dismiss(): Promise<void>;
     /**

package/esm/screenplay/Actor.js

@@ -154,8 +154,8 @@ export class Actor {
         return this.stage.currentTime();
     }
     /**
-     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
-     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/class/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
      */
     dismiss() {
         return this.findAbilitiesWhere(Discardable.isDiscardable)

package/esm/screenplay/abilities/Ability.d.ts

@@ -42,8 +42,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  * From the technical perspective, an **ability** is an [adapter](https://en.wikipedia.org/wiki/Adapter_pattern)
  * around an interface-specific integration library, such as a web browser driver, an HTTP client, a database client, and so on.
  * You give an actor an ability, and it's the ability's responsibility to provide a consistent API around the integration library and deal with any of its quirks.
- * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/interface/Initialisable/),
- * the process of [freeing up any resources](https://serenity-js.org/api/core/interface/Discardable/) they hold,
+ * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/class/Initialisable/),
+ * the process of [freeing up any resources](https://serenity-js.org/api/core/class/Discardable/) they hold,
  * as well as managing any state associated with the library.
  *
  * ### Portable interactions with web interfaces
@@ -268,8 +268,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * Abilities that rely on resources that need to be initialised before they can be used,
  * or discarded before the actor is dismissed can implement
- * the [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * or [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/) interfaces, respectively.
+ * the [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * or [`Discardable`](https://serenity-js.org/api/core/class/Discardable/) interfaces, respectively.
  *
  * ### Defining a custom ability to `QueryPostgresDB`
  *
@@ -351,8 +351,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * ## Learn more
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * - [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
  * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)

package/esm/screenplay/abilities/Ability.js

@@ -39,8 +39,8 @@
  * From the technical perspective, an **ability** is an [adapter](https://en.wikipedia.org/wiki/Adapter_pattern)
  * around an interface-specific integration library, such as a web browser driver, an HTTP client, a database client, and so on.
  * You give an actor an ability, and it's the ability's responsibility to provide a consistent API around the integration library and deal with any of its quirks.
- * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/interface/Initialisable/),
- * the process of [freeing up any resources](https://serenity-js.org/api/core/interface/Discardable/) they hold,
+ * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/class/Initialisable/),
+ * the process of [freeing up any resources](https://serenity-js.org/api/core/class/Discardable/) they hold,
  * as well as managing any state associated with the library.
  *
  * ### Portable interactions with web interfaces
@@ -265,8 +265,8 @@
  *
  * Abilities that rely on resources that need to be initialised before they can be used,
  * or discarded before the actor is dismissed can implement
- * the [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * or [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/) interfaces, respectively.
+ * the [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * or [`Discardable`](https://serenity-js.org/api/core/class/Discardable/) interfaces, respectively.
  *
  * ### Defining a custom ability to `QueryPostgresDB`
  *
@@ -348,8 +348,8 @@
  *
  * ## Learn more
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * - [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
  * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)

package/esm/screenplay/abilities/Discardable.d.ts

@@ -2,7 +2,7 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to free up
  * the resources it uses, e.g. disconnect from a database.
  *
- * This [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
+ * This [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
  * - when [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/), for actors instantiated after [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. within a test scenario or in a "before each" hook
  * - when [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/), for actors instantiated before [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. in a "before all" hook
  *
@@ -13,7 +13,7 @@
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
  *
  * @group Abilities
  */

package/esm/screenplay/abilities/Discardable.js

@@ -2,7 +2,7 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to free up
  * the resources it uses, e.g. disconnect from a database.
  *
- * This [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
+ * This [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
  * - when [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/), for actors instantiated after [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. within a test scenario or in a "before each" hook
  * - when [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/), for actors instantiated before [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. in a "before all" hook
  *
@@ -13,7 +13,7 @@
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
  *
  * @group Abilities
  */

package/esm/screenplay/abilities/Initialisable.d.ts

@@ -2,13 +2,13 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to initialise
  * the resources it uses, e.g. establish a database connection.
  *
- * The [`Initialisable.initialise`](https://serenity-js.org/api/core/interface/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
- * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
+ * The [`Initialisable.initialise`](https://serenity-js.org/api/core/class/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
+ * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
  *
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  *
  * @group Abilities
  */
@@ -16,9 +16,9 @@ export declare abstract class Initialisable {
     static isInitialisable<T>(value: T): value is T & Initialisable;
     /**
      * Initialises the ability. Invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
-     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false.
+     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false.
      *
-     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) so that it returns `true`
+     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) so that it returns `true`
      * when the ability has been successfully initialised.
      */
     abstract initialise(): Promise<void> | void;

package/esm/screenplay/abilities/Initialisable.js

@@ -2,13 +2,13 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to initialise
  * the resources it uses, e.g. establish a database connection.
  *
- * The [`Initialisable.initialise`](https://serenity-js.org/api/core/interface/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
- * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
+ * The [`Initialisable.initialise`](https://serenity-js.org/api/core/class/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
+ * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
  *
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  *
  * @group Abilities
  */

package/esm/stage/ActorLifecycleManager.d.ts

@@ -27,7 +27,7 @@ export type StageFocus = 'foreground' | 'background';
  * By default, actors created before the actual test scenario starts, e.g. in beforeAll hooks, are placed in the `'background'` focus area.
  * When a [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) event is announced,
  * the focus switches to `'foreground'`. When a [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/)
- * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/interface/Discardable/)
+ * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/class/Discardable/)
  * and focus returns to `'background'`.
  *
  * ## Custom lifecycle management

package/esm/stage/ActorLifecycleManager.js

@@ -19,7 +19,7 @@ import { Actor, ScheduleWork } from '../screenplay/index.js';
  * By default, actors created before the actual test scenario starts, e.g. in beforeAll hooks, are placed in the `'background'` focus area.
  * When a [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) event is announced,
  * the focus switches to `'foreground'`. When a [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/)
- * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/interface/Discardable/)
+ * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/class/Discardable/)
  * and focus returns to `'background'`.
  *
  * ## Custom lifecycle management

package/lib/config/SerenityConfig.d.ts

@@ -35,7 +35,7 @@ export declare abstract class SerenityConfig {
      * The maximum amount of time between [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [SceneFinished](https://serenity-js.org/api/core-events/class/SceneFinished/) events
      * that Serenity/JS should wait for any post-scenario
      * async operations to complete. Those include generating the screenshots,
-     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/interface/Discardable/), and so on.
+     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/class/Discardable/), and so on.
      *
      * Defaults to 5 seconds.
      *

package/lib/config/SerenityConfig.js

@@ -33,7 +33,7 @@ class SerenityConfig {
      * The maximum amount of time between [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [SceneFinished](https://serenity-js.org/api/core-events/class/SceneFinished/) events
      * that Serenity/JS should wait for any post-scenario
      * async operations to complete. Those include generating the screenshots,
-     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/interface/Discardable/), and so on.
+     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/class/Discardable/), and so on.
      *
      * Defaults to 5 seconds.
      *

package/lib/events/SceneFinishes.d.ts

@@ -5,7 +5,7 @@ import { DomainEvent } from './DomainEvent.js';
 /**
  * Emitted by a Serenity/JS test runner adapter, right before a test and all its associated test hooks finish.
  * Triggers any clean-up operations that might be required, such as discarding of
- * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
+ * the [discardable](https://serenity-js.org/api/core/class/Discardable/) abilities.
  *
  * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
  * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result

package/lib/events/SceneFinishes.js

@@ -8,7 +8,7 @@ const DomainEvent_js_1 = require("./DomainEvent.js");
 /**
  * Emitted by a Serenity/JS test runner adapter, right before a test and all its associated test hooks finish.
  * Triggers any clean-up operations that might be required, such as discarding of
- * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
+ * the [discardable](https://serenity-js.org/api/core/class/Discardable/) abilities.
  *
  * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
  * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result

package/lib/events/actor/ActorStageExitCompleted.d.ts

@@ -4,7 +4,7 @@ import { Timestamp } from '../../screenplay/index.js';
 import { AsyncOperationCompleted } from '../AsyncOperationCompleted.js';
 /**
  * Emitted when an [`Actor`](https://serenity-js.org/api/core/class/Actor/) and its abilities
- * are correctly [released](https://serenity-js.org/api/core/interface/Discardable/) either
+ * are correctly [released](https://serenity-js.org/api/core/class/Discardable/) either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event
  * for actors initialised within the scope of a test scenario,
  * or upon the [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) event

package/lib/events/actor/ActorStageExitCompleted.js

@@ -7,7 +7,7 @@ const index_js_2 = require("../../screenplay/index.js");
 const AsyncOperationCompleted_js_1 = require("../AsyncOperationCompleted.js");
 /**
  * Emitted when an [`Actor`](https://serenity-js.org/api/core/class/Actor/) and its abilities
- * are correctly [released](https://serenity-js.org/api/core/interface/Discardable/) either
+ * are correctly [released](https://serenity-js.org/api/core/class/Discardable/) either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event
  * for actors initialised within the scope of a test scenario,
  * or upon the [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) event

package/lib/events/actor/ActorStageExitFailed.d.ts

@@ -1,7 +1,7 @@
 import type { JSONObject } from 'tiny-types';
 import { AsyncOperationFailed } from '../AsyncOperationFailed.js';
 /**
- * Emitted when [releasing](https://serenity-js.org/api/core/interface/Discardable/) an
+ * Emitted when [releasing](https://serenity-js.org/api/core/class/Discardable/) an
  * [`Actor`](https://serenity-js.org/api/core/class/Actor/) or its abilities
  * resulted in an error either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event

package/lib/events/actor/ActorStageExitFailed.js

@@ -6,7 +6,7 @@ const index_js_2 = require("../../model/index.js");
 const index_js_3 = require("../../screenplay/index.js");
 const AsyncOperationFailed_js_1 = require("../AsyncOperationFailed.js");
 /**
- * Emitted when [releasing](https://serenity-js.org/api/core/interface/Discardable/) an
+ * Emitted when [releasing](https://serenity-js.org/api/core/class/Discardable/) an
  * [`Actor`](https://serenity-js.org/api/core/class/Actor/) or its abilities
  * resulted in an error either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event

package/lib/events/actor/ActorStageExitStarts.d.ts

@@ -7,7 +7,7 @@ import { DomainEvent } from '../DomainEvent.js';
  * [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) events
  * to notify the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
  * about the final state of the [actors](https://serenity-js.org/api/core/class/Actor/) and their abilities
- * before they're [released](https://serenity-js.org/api/core/interface/Discardable/).
+ * before they're [released](https://serenity-js.org/api/core/class/Discardable/).
  *
  * @group Events
  */

package/lib/events/actor/ActorStageExitStarts.js

@@ -10,7 +10,7 @@ const DomainEvent_js_1 = require("../DomainEvent.js");
  * [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) events
  * to notify the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
  * about the final state of the [actors](https://serenity-js.org/api/core/class/Actor/) and their abilities
- * before they're [released](https://serenity-js.org/api/core/interface/Discardable/).
+ * before they're [released](https://serenity-js.org/api/core/class/Discardable/).
  *
  * @group Events
  */

package/lib/screenplay/Actor.d.ts

@@ -130,8 +130,8 @@ export declare class Actor implements PerformsActivities, UsesAbilities, CanHave
      */
     currentTime(): Timestamp;
     /**
-     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
-     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/class/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
      */
     dismiss(): Promise<void>;
     /**

package/lib/screenplay/Actor.js

@@ -157,8 +157,8 @@ class Actor {
         return this.stage.currentTime();
     }
     /**
-     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
-     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/class/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
      */
     dismiss() {
         return this.findAbilitiesWhere(index_js_5.Discardable.isDiscardable)

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

@@ -42,8 +42,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  * From the technical perspective, an **ability** is an [adapter](https://en.wikipedia.org/wiki/Adapter_pattern)
  * around an interface-specific integration library, such as a web browser driver, an HTTP client, a database client, and so on.
  * You give an actor an ability, and it's the ability's responsibility to provide a consistent API around the integration library and deal with any of its quirks.
- * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/interface/Initialisable/),
- * the process of [freeing up any resources](https://serenity-js.org/api/core/interface/Discardable/) they hold,
+ * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/class/Initialisable/),
+ * the process of [freeing up any resources](https://serenity-js.org/api/core/class/Discardable/) they hold,
  * as well as managing any state associated with the library.
  *
  * ### Portable interactions with web interfaces
@@ -268,8 +268,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * Abilities that rely on resources that need to be initialised before they can be used,
  * or discarded before the actor is dismissed can implement
- * the [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * or [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/) interfaces, respectively.
+ * the [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * or [`Discardable`](https://serenity-js.org/api/core/class/Discardable/) interfaces, respectively.
  *
  * ### Defining a custom ability to `QueryPostgresDB`
  *
@@ -351,8 +351,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * ## Learn more
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * - [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
  * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)

package/lib/screenplay/abilities/Ability.js

@@ -42,8 +42,8 @@ exports.Ability = void 0;
  * From the technical perspective, an **ability** is an [adapter](https://en.wikipedia.org/wiki/Adapter_pattern)
  * around an interface-specific integration library, such as a web browser driver, an HTTP client, a database client, and so on.
  * You give an actor an ability, and it's the ability's responsibility to provide a consistent API around the integration library and deal with any of its quirks.
- * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/interface/Initialisable/),
- * the process of [freeing up any resources](https://serenity-js.org/api/core/interface/Discardable/) they hold,
+ * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/class/Initialisable/),
+ * the process of [freeing up any resources](https://serenity-js.org/api/core/class/Discardable/) they hold,
  * as well as managing any state associated with the library.
  *
  * ### Portable interactions with web interfaces
@@ -268,8 +268,8 @@ exports.Ability = void 0;
  *
  * Abilities that rely on resources that need to be initialised before they can be used,
  * or discarded before the actor is dismissed can implement
- * the [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * or [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/) interfaces, respectively.
+ * the [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * or [`Discardable`](https://serenity-js.org/api/core/class/Discardable/) interfaces, respectively.
  *
  * ### Defining a custom ability to `QueryPostgresDB`
  *
@@ -351,8 +351,8 @@ exports.Ability = void 0;
  *
  * ## Learn more
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * - [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
  * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)

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

@@ -2,7 +2,7 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to free up
  * the resources it uses, e.g. disconnect from a database.
  *
- * This [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
+ * This [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
  * - when [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/), for actors instantiated after [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. within a test scenario or in a "before each" hook
  * - when [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/), for actors instantiated before [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. in a "before all" hook
  *
@@ -13,7 +13,7 @@
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
  *
  * @group Abilities
  */

package/lib/screenplay/abilities/Discardable.js

@@ -5,7 +5,7 @@ exports.Discardable = void 0;
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to free up
  * the resources it uses, e.g. disconnect from a database.
  *
- * This [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
+ * This [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
  * - when [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/), for actors instantiated after [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. within a test scenario or in a "before each" hook
  * - when [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/), for actors instantiated before [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. in a "before all" hook
  *
@@ -16,7 +16,7 @@ exports.Discardable = void 0;
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
  *
  * @group Abilities
  */

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

@@ -2,13 +2,13 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to initialise
  * the resources it uses, e.g. establish a database connection.
  *
- * The [`Initialisable.initialise`](https://serenity-js.org/api/core/interface/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
- * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
+ * The [`Initialisable.initialise`](https://serenity-js.org/api/core/class/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
+ * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
  *
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  *
  * @group Abilities
  */
@@ -16,9 +16,9 @@ export declare abstract class Initialisable {
     static isInitialisable<T>(value: T): value is T & Initialisable;
     /**
      * Initialises the ability. Invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
-     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false.
+     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false.
      *
-     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) so that it returns `true`
+     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) so that it returns `true`
      * when the ability has been successfully initialised.
      */
     abstract initialise(): Promise<void> | void;

package/lib/screenplay/abilities/Initialisable.js

@@ -5,13 +5,13 @@ exports.Initialisable = void 0;
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to initialise
  * the resources it uses, e.g. establish a database connection.
  *
- * The [`Initialisable.initialise`](https://serenity-js.org/api/core/interface/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
- * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
+ * The [`Initialisable.initialise`](https://serenity-js.org/api/core/class/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
+ * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
  *
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  *
  * @group Abilities
  */

package/lib/stage/ActorLifecycleManager.d.ts

@@ -27,7 +27,7 @@ export type StageFocus = 'foreground' | 'background';
  * By default, actors created before the actual test scenario starts, e.g. in beforeAll hooks, are placed in the `'background'` focus area.
  * When a [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) event is announced,
  * the focus switches to `'foreground'`. When a [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/)
- * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/interface/Discardable/)
+ * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/class/Discardable/)
  * and focus returns to `'background'`.
  *
  * ## Custom lifecycle management

package/lib/stage/ActorLifecycleManager.js

@@ -22,7 +22,7 @@ const index_js_4 = require("../screenplay/index.js");
  * By default, actors created before the actual test scenario starts, e.g. in beforeAll hooks, are placed in the `'background'` focus area.
  * When a [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) event is announced,
  * the focus switches to `'foreground'`. When a [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/)
- * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/interface/Discardable/)
+ * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/class/Discardable/)
  * and focus returns to `'background'`.
  *
  * ## Custom lifecycle management

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.43.0",
+  "version": "3.43.1",
   "description": "The core Serenity/JS framework, providing the Screenplay Pattern interfaces, as well as the test reporting and integration infrastructure",
   "author": {
     "name": "Jan Molak",
@@ -345,5 +345,5 @@
   "engines": {
     "node": "^20 || ^22 || ^24"
   },
-  "gitHead": "96ffb7ecba111082c92d7b107fef007d9f56bb83"
+  "gitHead": "b7cc8abc2e54e11707f1b3611df16c4bcdadcf62"
 }

package/src/config/SerenityConfig.ts

@@ -39,7 +39,7 @@ export abstract class SerenityConfig {
      * The maximum amount of time between [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [SceneFinished](https://serenity-js.org/api/core-events/class/SceneFinished/) events
      * that Serenity/JS should wait for any post-scenario
      * async operations to complete. Those include generating the screenshots,
-     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/interface/Discardable/), and so on.
+     * saving reports to disk, [dismissing the actors](https://serenity-js.org/api/core/class/Discardable/), and so on.
      *
      * Defaults to 5 seconds.
      *

package/src/events/SceneFinishes.ts

@@ -9,7 +9,7 @@ import { DomainEvent } from './DomainEvent.js';
 /**
  * Emitted by a Serenity/JS test runner adapter, right before a test and all its associated test hooks finish.
  * Triggers any clean-up operations that might be required, such as discarding of
- * the [discardable](https://serenity-js.org/api/core/interface/Discardable/) abilities.
+ * the [discardable](https://serenity-js.org/api/core/class/Discardable/) abilities.
  *
  * The `outcome` property contains the test outcome determined so far, before any cleanup operations.
  * This allows stage crew members like the WebdriverIO notifier to invoke hooks with the test result

package/src/events/actor/ActorStageExitCompleted.ts

@@ -6,7 +6,7 @@ import { AsyncOperationCompleted } from '../AsyncOperationCompleted.js';
 
 /**
  * Emitted when an [`Actor`](https://serenity-js.org/api/core/class/Actor/) and its abilities
- * are correctly [released](https://serenity-js.org/api/core/interface/Discardable/) either
+ * are correctly [released](https://serenity-js.org/api/core/class/Discardable/) either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event
  * for actors initialised within the scope of a test scenario,
  * or upon the [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) event

package/src/events/actor/ActorStageExitFailed.ts

@@ -6,7 +6,7 @@ import { Timestamp } from '../../screenplay/index.js';
 import { AsyncOperationFailed } from '../AsyncOperationFailed.js';
 
 /**
- * Emitted when [releasing](https://serenity-js.org/api/core/interface/Discardable/) an
+ * Emitted when [releasing](https://serenity-js.org/api/core/class/Discardable/) an
  * [`Actor`](https://serenity-js.org/api/core/class/Actor/) or its abilities
  * resulted in an error either
  * upon the [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) event

package/src/events/actor/ActorStageExitStarts.ts

@@ -10,7 +10,7 @@ import { DomainEvent } from '../DomainEvent.js';
  * [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) events
  * to notify the [stage crew members](https://serenity-js.org/api/core/interface/StageCrewMember/)
  * about the final state of the [actors](https://serenity-js.org/api/core/class/Actor/) and their abilities
- * before they're [released](https://serenity-js.org/api/core/interface/Discardable/).
+ * before they're [released](https://serenity-js.org/api/core/class/Discardable/).
  *
  * @group Events
  */

package/src/screenplay/Actor.ts

@@ -190,8 +190,8 @@ export class Actor implements PerformsActivities,
     }
 
     /**
-     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method on any
-     * [discardable](https://serenity-js.org/api/core/interface/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
+     * Instructs the actor to invoke [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method on any
+     * [discardable](https://serenity-js.org/api/core/class/Discardable/) [ability](https://serenity-js.org/api/core/class/Ability/) it's been configured with.
      */
     dismiss(): Promise<void> {
         return this.findAbilitiesWhere(Discardable.isDiscardable)

package/src/screenplay/abilities/Ability.ts

@@ -43,8 +43,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  * From the technical perspective, an **ability** is an [adapter](https://en.wikipedia.org/wiki/Adapter_pattern)
  * around an interface-specific integration library, such as a web browser driver, an HTTP client, a database client, and so on.
  * You give an actor an ability, and it's the ability's responsibility to provide a consistent API around the integration library and deal with any of its quirks.
- * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/interface/Initialisable/),
- * the process of [freeing up any resources](https://serenity-js.org/api/core/interface/Discardable/) they hold,
+ * Abilities **encapsulate integration libraries** and handle their [configuration and initialisation](https://serenity-js.org/api/core/class/Initialisable/),
+ * the process of [freeing up any resources](https://serenity-js.org/api/core/class/Discardable/) they hold,
  * as well as managing any state associated with the library.
  *
  * ### Portable interactions with web interfaces
@@ -269,8 +269,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * Abilities that rely on resources that need to be initialised before they can be used,
  * or discarded before the actor is dismissed can implement
- * the [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * or [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/) interfaces, respectively.
+ * the [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * or [`Discardable`](https://serenity-js.org/api/core/class/Discardable/) interfaces, respectively.
  *
  * ### Defining a custom ability to `QueryPostgresDB`
  *
@@ -352,8 +352,8 @@ import type { UsesAbilities } from './UsesAbilities.js';
  *
  * ## Learn more
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * - [`CallAnApi`](https://serenity-js.org/api/rest/class/CallAnApi/)
  * - [`TakeNotes`](https://serenity-js.org/api/core/class/TakeNotes/)

package/src/screenplay/abilities/Discardable.ts

@@ -2,7 +2,7 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to free up
  * the resources it uses, e.g. disconnect from a database.
  *
- * This [`Discardable.discard`](https://serenity-js.org/api/core/interface/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
+ * This [`Discardable.discard`](https://serenity-js.org/api/core/class/Discardable/#discard) method is invoked directly by the [actor](https://serenity-js.org/api/core/class/Actor/), and indirectly by the [stage](https://serenity-js.org/api/core/class/Stage/):
  * - when [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/), for actors instantiated after [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. within a test scenario or in a "before each" hook
  * - when [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/), for actors instantiated before [SceneStarts](https://serenity-js.org/api/core-events/class/SceneStarts/) - e.g. in a "before all" hook
  *
@@ -13,7 +13,7 @@
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Initialisable`](https://serenity-js.org/api/core/interface/Initialisable/)
+ * - [`Initialisable`](https://serenity-js.org/api/core/class/Initialisable/)
  *
  * @group Abilities
  */

package/src/screenplay/abilities/Initialisable.ts

@@ -2,13 +2,13 @@
  * An interface to be implemented by any [`Ability`](https://serenity-js.org/api/core/class/Ability/) that needs to initialise
  * the resources it uses, e.g. establish a database connection.
  *
- * The [`Initialisable.initialise`](https://serenity-js.org/api/core/interface/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
- * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
+ * The [`Initialisable.initialise`](https://serenity-js.org/api/core/class/Initialisable/#initialise) method is invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
+ * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false. This is to avoid initialising abilities more than once.
  *
  * ## Learn more
  * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
  * - [`AbilityType`](https://serenity-js.org/api/core/#AbilityType)
- * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
+ * - [`Discardable`](https://serenity-js.org/api/core/class/Discardable/)
  *
  * @group Abilities
  */
@@ -23,9 +23,9 @@ export abstract class Initialisable {
 
     /**
      * Initialises the ability. Invoked whenever [`Actor.attemptsTo`](https://serenity-js.org/api/core/class/Actor/#attemptsTo) method is called,
-     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) returns false.
+     * but **only when** [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) returns false.
      *
-     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/interface/Initialisable/#isInitialised) so that it returns `true`
+     * Make sure to implement [`Initialisable.isInitialised`](https://serenity-js.org/api/core/class/Initialisable/#isInitialised) so that it returns `true`
      * when the ability has been successfully initialised.
      */
     abstract initialise(): Promise<void> | void;

package/src/stage/ActorLifecycleManager.ts

@@ -34,7 +34,7 @@ export type StageFocus = 'foreground' | 'background';
  * By default, actors created before the actual test scenario starts, e.g. in beforeAll hooks, are placed in the `'background'` focus area.
  * When a [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) event is announced,
  * the focus switches to `'foreground'`. When a [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/)
- * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/interface/Discardable/)
+ * event is announced, foreground actors are dismissed, their abilities [discarded](https://serenity-js.org/api/core/class/Discardable/)
  * and focus returns to `'background'`.
  *
  * ## Custom lifecycle management