@serenity-js/core 3.42.2 → 3.43.1

package/lib/screenplay/Actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/screenplay/Actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAG,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAA8B,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,OAAO,EAAsC,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,KAAM,YAAW,kBAAkB,EAC5C,aAAa,EACb,gBAAgB,CAAC,KAAK,CAAC,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS;aAUW,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAT1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;gBAG1D,IAAI,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EAC7B,SAAS,GAAE,OAAO,EAAO;IAS7B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAc5D;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK;IAMtC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUvD;;OAEG;IACH,WAAW,IAAI,SAAS;IAIxB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAMlB;;;;;OAKG;IACH,MAAM,IAAI,eAAe;IAOzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAKnB"}
+{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/screenplay/Actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAG,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,OAAO,EAAkE,MAAM,sBAAsB,CAAC;AAC/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,KAAM,YAAW,kBAAkB,EAC5C,aAAa,EACb,gBAAgB,CAAC,KAAK,CAAC,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS;aAUW,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAT1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;gBAG1D,IAAI,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EAC7B,SAAS,GAAE,OAAO,EAAO;IAS7B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAc5D;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK;IAMtC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUvD;;OAEG;IACH,WAAW,IAAI,SAAS;IAIxB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAMlB;;;;;OAKG;IACH,MAAM,IAAI,eAAe;IAOzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAKnB"}

package/lib/screenplay/Actor.js

@@ -157,11 +157,11 @@ 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.findAbilitiesOfType('discard')
+        return this.findAbilitiesWhere(index_js_5.Discardable.isDiscardable)
             .reduce((previous, ability) => previous.then(() => ability.discard()), Promise.resolve(void 0));
     }
     /**
@@ -186,7 +186,7 @@ class Actor {
         };
     }
     initialiseAbilities() {
-        return this.findAbilitiesOfType('initialise', 'isInitialised')
+        return this.findAbilitiesWhere(index_js_5.Initialisable.isInitialisable)
             .filter(ability => !ability.isInitialised())
             .reduce((previous, ability) => previous
             .then(() => ability.initialise())
@@ -194,11 +194,10 @@ class Actor {
             throw new index_js_1.TestCompromisedError(`${this.name} couldn't initialise the ability to ${ability.constructor.name}`, error);
         }), Promise.resolve(void 0));
     }
-    findAbilitiesOfType(...methodNames) {
+    findAbilitiesWhere(filter) {
         const abilitiesFrom = (map) => Array.from(map.values());
-        const abilitiesWithDesiredMethods = (ability) => methodNames.every(methodName => typeof (ability[methodName]) === 'function');
         return abilitiesFrom(this.abilities)
-            .filter(abilitiesWithDesiredMethods);
+            .filter(filter);
     }
     findAbilityTo(doSomething) {
         return this.abilities.get(doSomething.abilityType().name);

package/lib/screenplay/Actor.js.map

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

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,14 +13,15 @@
  * ## 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
  */
-export interface Discardable {
+export declare abstract class Discardable {
+    static isDiscardable<T>(value: T): value is T & Discardable;
     /**
      * Discards the resources associated with this ability.
      */
-    discard(): Promise<void> | void;
+    abstract discard(): Promise<void> | void;
 }
 //# sourceMappingURL=Discardable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Discardable.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Discardable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,WAAW;IAExB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC"}
+{"version":3,"file":"Discardable.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Discardable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,WAAW;IAE7B,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,WAAW;IAK3D;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAC3C"}

package/lib/screenplay/abilities/Discardable.js

@@ -1,3 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+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/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
+ *
+ * Note that events such as [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/) and [`TestRunFinishes`](https://serenity-js.org/api/core-events/class/TestRunFinishes/) are emitted by Serenity/JS test runner adapters,
+ * such as `@serenity-js/cucumber`, `@serenity-js/mocha`, `@serenity-js/jasmine`, and so on.
+ * Consult their respective readmes to learn how to register them with your test runner of choice.
+ *
+ * ## 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/class/Initialisable/)
+ *
+ * @group Abilities
+ */
+class Discardable {
+    static isDiscardable(value) {
+        return typeof (value['discard']) === 'function'
+            && value['discard'].length === 0;
+    }
+}
+exports.Discardable = Discardable;
 //# sourceMappingURL=Discardable.js.map

package/lib/screenplay/abilities/Discardable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Discardable.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Discardable.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Discardable.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Discardable.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAsB,WAAW;IAE7B,MAAM,CAAC,aAAa,CAAI,KAAQ;QAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,UAAU;eACxC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACzC,CAAC;CAMJ;AAXD,kCAWC"}

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

@@ -2,25 +2,26 @@
  * 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
  */
-export interface Initialisable {
+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.
      */
-    initialise(): Promise<void> | void;
+    abstract initialise(): Promise<void> | void;
     /**
      * Should return `true` when all the resources that the given ability needs
      * have been initialised. Should return `false` if the [`Actor`](https://serenity-js.org/api/core/class/Actor/) should
@@ -28,6 +29,6 @@ export interface Initialisable {
      *
      * @returns {boolean}
      */
-    isInitialised(): boolean;
+    abstract isInitialised(): boolean;
 }
 //# sourceMappingURL=Initialisable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Initialisable.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Initialisable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAE1B;;;;;;OAMG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnC;;;;;;OAMG;IACH,aAAa,IAAI,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"Initialisable.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Initialisable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,8BAAsB,aAAa;IAE/B,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,aAAa;IAO/D;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAE3C;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,IAAI,OAAO;CACpC"}

package/lib/screenplay/abilities/Initialisable.js

@@ -1,3 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+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/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/class/Discardable/)
+ *
+ * @group Abilities
+ */
+class Initialisable {
+    static isInitialisable(value) {
+        return typeof (value['initialise']) === 'function'
+            && value['initialise'].length === 0
+            && typeof value['isInitialised'] === 'function'
+            && value['isInitialised'].length === 0;
+    }
+}
+exports.Initialisable = Initialisable;
 //# sourceMappingURL=Initialisable.js.map

package/lib/screenplay/abilities/Initialisable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Initialisable.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Initialisable.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Initialisable.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Initialisable.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,MAAsB,aAAa;IAE/B,MAAM,CAAC,eAAe,CAAI,KAAQ;QAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,UAAU;eAC3C,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;eAChC,OAAO,KAAK,CAAC,eAAe,CAAC,KAAK,UAAU;eAC5C,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/C,CAAC;CAmBJ;AA1BD,sCA0BC"}

package/lib/stage/ActorLifecycleManager.d.ts

@@ -0,0 +1,191 @@
+import type { Clock, Duration } from '../screenplay/index.js';
+import { Actor } from '../screenplay/index.js';
+import type { Cast } from './Cast.js';
+import type { Stage } from './Stage.js';
+/**
+ * Represents the focus area where actors are tracked.
+ *
+ * - `'foreground'` - Scene-scoped actors that are dismissed when a scene finishes
+ * - `'background'` - Test run-scoped actors that persist across scenes and are dismissed when the test run finishes
+ *
+ * @group Stage
+ */
+export type StageFocus = 'foreground' | 'background';
+/**
+ * Manages the lifecycle of [actors](https://serenity-js.org/api/core/class/Actor/) on the [stage](https://serenity-js.org/api/core/class/Stage/),
+ * including their creation, retrieval, and tracking of which actors are in the foreground (scene-scoped)
+ * versus background (test run-scoped).
+ *
+ * The `ActorLifecycleManager` is responsible for:
+ * - Instantiating and caching actors via the configured [cast](https://serenity-js.org/api/core/class/Cast/)
+ * - Tracking which actor is currently in the spotlight (active)
+ * - Managing the focus area (foreground vs background) where new actors are created
+ * - Providing access to actors for dismissal when scenes or test runs finish
+ *
+ * ## Default behaviour
+ *
+ * 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/class/Discardable/)
+ * and focus returns to `'background'`.
+ *
+ * ## Custom lifecycle management
+ *
+ * Test runner adapters like [`@serenity-js/playwright-test`](https://serenity-js.org/api/playwright-test/),
+ * where test execution and reporting happen in separate processes, can inject a custom `ActorLifecycleManager` instance
+ * to control actor lifecycle programmatically.
+ *
+ * ```typescript
+ * const actorLifecycleManager = new ActorLifecycleManager(cast, clock, interactionTimeout);
+ * const serenity = new Serenity(clock, cueTimeout, actorLifecycleManager);
+ *
+ * // At the start of each test:
+ * actorLifecycleManager.switchFocus('foreground');
+ * ```
+ *
+ * ## Learn more
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
+ *
+ * @group Stage
+ */
+export declare class ActorLifecycleManager {
+    protected cast: Cast;
+    protected readonly clock: Clock;
+    protected interactionTimeout: Duration;
+    /**
+     * The most recent actor referenced via the {@apilink actor} method
+     */
+    private currentActor?;
+    /**
+     * The scene in which the spotlight was last set.
+     * Used to detect when the spotlight shifts to a different scene context.
+     */
+    private currentActorScene;
+    private currentFocusValue;
+    private actors;
+    protected stage: Stage;
+    constructor(cast: Cast, clock: Clock, interactionTimeout: Duration);
+    /**
+     * Configures the manager with new settings.
+     *
+     * @param options - Configuration options
+     * @param options.interactionTimeout - The maximum time to wait for an interaction to complete
+     */
+    configure({ interactionTimeout }: {
+        interactionTimeout: Duration;
+    }): void;
+    /**
+     * Associates this manager with a [`Stage`](https://serenity-js.org/api/core/class/Stage/) instance.
+     *
+     * This method is called automatically by the `Stage` during construction.
+     * It establishes the bidirectional relationship between the manager and the stage,
+     * allowing the manager to emit [domain events](https://serenity-js.org/api/core-events/class/DomainEvent/)
+     * when actors enter the stage or are spotlighted.
+     *
+     * @param stage - The Stage instance to associate with this manager
+     */
+    assignTo(stage: Stage): void;
+    /**
+     * Configures the manager to use the provided [cast](https://serenity-js.org/api/core/class/Cast/) for preparing actors.
+     *
+     * @param actors - The cast to use for preparing new actors
+     *
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
+     *  If the provided cast is not defined or doesn't have a `prepare` method
+     */
+    engage(actors: Cast): void;
+    /**
+     * Returns the current [cast](https://serenity-js.org/api/core/class/Cast/) used for preparing actors.
+     *
+     * @returns The currently configured cast
+     */
+    currentCast(): Cast;
+    /**
+     * Instantiates a new [`Actor`](https://serenity-js.org/api/core/class/Actor/) or fetches an existing one
+     * identified by their name if they've already been instantiated.
+     *
+     * When a new actor is instantiated, an [`ActorEntersStage`](https://serenity-js.org/api/core-events/class/ActorEntersStage/)
+     * event is announced. When the spotlight shifts to a different actor (or the same actor in a different scene),
+     * an [`ActorSpotlighted`](https://serenity-js.org/api/core-events/class/ActorSpotlighted/) event is announced.
+     *
+     * Actors are first looked up in the `'background'` focus area, then in `'foreground'`.
+     * New actors are always created in the current focus area.
+     *
+     * @param name - Case-sensitive name of the Actor, e.g. `Alice`
+     * @returns The actor with the given name
+     */
+    actor(name: string): Actor;
+    private prepareActor;
+    private typeOf;
+    private existingActorCalled;
+    /**
+     * Returns `true` if there is an [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the spotlight, `false` otherwise.
+     *
+     * @returns `true` if an actor is currently spotlighted
+     */
+    hasActorInTheSpotlight(): boolean;
+    /**
+     * Returns the last [`Actor`](https://serenity-js.org/api/core/class/Actor/) instantiated
+     * via [`actor`](https://serenity-js.org/api/core/class/ActorLifecycleManager/#actor).
+     *
+     * @returns The currently spotlighted actor
+     *
+     * @throws [`LogicError`](https://serenity-js.org/api/core/class/LogicError/)
+     *  If no [`Actor`](https://serenity-js.org/api/core/class/Actor/) has been activated yet
+     */
+    actorInTheSpotlight(): Actor;
+    /**
+     * Switches the focus to the specified stage area.
+     *
+     * Actors created after this call will be added to the specified area.
+     * This method is typically called automatically by the [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     * in response to [`SceneStarts`](https://serenity-js.org/api/core-events/class/SceneStarts/) and
+     * [`SceneFinishes`](https://serenity-js.org/api/core-events/class/SceneFinishes/) events.
+     *
+     * Test runner adapters can also call this method directly to control actor lifecycle
+     * when scene events are not available (e.g., in Playwright Test where the reporter
+     * runs in a separate process).
+     *
+     * @param focus - The focus area to switch to: `'foreground'` for scene-scoped actors,
+     *                `'background'` for test run-scoped actors
+     */
+    switchFocus(focus: StageFocus): void;
+    /**
+     * Returns the current focus area.
+     *
+     * @returns The current focus: `'foreground'` or `'background'`
+     */
+    currentFocus(): StageFocus;
+    /**
+     * Returns all actors in the specified focus area.
+     *
+     * This method is used by the [`Stage`](https://serenity-js.org/api/core/class/Stage/) to retrieve
+     * actors for dismissal when scenes or test runs finish.
+     *
+     * @param focus - The focus area to retrieve actors from
+     * @returns An array of actors in the specified focus area
+     */
+    actorsIn(focus: StageFocus): Actor[];
+    /**
+     * Clears the spotlight if the current actor is in the specified focus area.
+     *
+     * This ensures that after actors in a focus area are dismissed, the spotlight
+     * doesn't reference a dismissed actor.
+     *
+     * @param focus - The focus area to check
+     */
+    clearSpotlightIfIn(focus: StageFocus): void;
+    /**
+     * Clears all actors from the specified focus area.
+     *
+     * This method is called by the [`Stage`](https://serenity-js.org/api/core/class/Stage/) after
+     * actors have been dismissed to remove them from the internal tracking maps.
+     *
+     * @param focus - The focus area to clear
+     */
+    clearActorsIn(focus: StageFocus): void;
+}
+//# sourceMappingURL=ActorLifecycleManager.d.ts.map

package/lib/stage/ActorLifecycleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorLifecycleManager.d.ts","sourceRoot":"","sources":["../../src/stage/ActorLifecycleManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAgB,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,qBAAqB;IAuB1B,SAAS,CAAC,IAAI,EAAE,IAAI;IACpB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAC/B,SAAS,CAAC,kBAAkB,EAAE,QAAQ;IAvB1C;;OAEG;IACH,OAAO,CAAC,YAAY,CAAC,CAAQ;IAE7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAA+C;IAExE,OAAO,CAAC,iBAAiB,CAA4B;IAErD,OAAO,CAAC,MAAM,CAGb;IAED,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBAGT,IAAI,EAAE,IAAI,EACD,KAAK,EAAE,KAAK,EACrB,kBAAkB,EAAE,QAAQ;IAI1C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE;QAAE,kBAAkB,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI;IAIzE;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAI1B;;;;OAIG;IACH,WAAW,IAAI,IAAI;IAInB;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAwCjC,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;IACI,sBAAsB,IAAI,OAAO;IAIxC;;;;;;;;OAQG;IACI,mBAAmB,IAAI,KAAK;IAQnC;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIpC;;;;OAIG;IACH,YAAY,IAAI,UAAU;IAI1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,EAAE;IAIpC;;;;;;;OAOG;IACH,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAS3C;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAGzC"}