@serenity-js/core 3.23.2 → 3.24.0

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

@@ -53,7 +53,7 @@ import type { UsesAbilities } from './UsesAbilities';
  * Note how {@apilink BrowseTheWebWithPlaywright}, {@apilink BrowseTheWebWithWebdriverIO}, and {@apilink BrowseTheWebWithProtractor}
  * all **extend** the base ability to {@apilink BrowseTheWeb}.
  *
- * #### Playwright Test
+ * #### Playwright
  *
  * ```typescript
  * import { actorCalled } from '@serenity-js/core'
@@ -62,7 +62,7 @@ import type { UsesAbilities } from './UsesAbilities';
  *
  * const browser = await chromium.launch({ headless: true })              // integration library
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithPlaywright.using(browser))                   // tool-specific ability
  * ```
  *
@@ -72,7 +72,7 @@ import type { UsesAbilities } from './UsesAbilities';
  * import { actorCalled } from '@serenity-js/core'
  * import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio' // Serenity/JS integration module
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))                  // tool-specific ability
  * ```
  *
@@ -83,7 +83,7 @@ import type { UsesAbilities } from './UsesAbilities';
  * import { BrowseTheWebWithProtractor } from '@serenity-js/protractor'   // Serenity/JS integration module
  * import { protractor } from 'protractor'                                // integration library
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithProtractor.using(protractor.browser))        // tool-specific ability
  * ```
  *
@@ -241,9 +241,11 @@ import type { UsesAbilities } from './UsesAbilities';
  * ### Defining a custom interaction using the custom ability
  *
  * ```ts
+ * import { Answerable, Interaction, the } from '@serenity-js/core'
+ *
  * // A custom interaction using the actor's ability:
- * const Call = (phoneNumber: string) =>
- *   Interaction.where(`#actor calls ${ phoneNumber }`, async actor => {
+ * const Call = (phoneNumber: Answerable<string>) =>
+ *   Interaction.where(the`#actor calls ${ phoneNumber }`, async actor => {
  *     await MakePhoneCalls.as(actor).dial(phoneNumber)
  *   })
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"Ability.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Ability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiWG;AACH,8BAAsB,OAAO;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,OAAO,EACvB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,aAAa,GACrB,CAAC;CAGP"}
+{"version":3,"file":"Ability.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/Ability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmWG;AACH,8BAAsB,OAAO;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,OAAO,EACvB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,aAAa,GACrB,CAAC;CAGP"}

package/lib/screenplay/abilities/Ability.js

@@ -54,7 +54,7 @@ exports.Ability = void 0;
  * Note how {@apilink BrowseTheWebWithPlaywright}, {@apilink BrowseTheWebWithWebdriverIO}, and {@apilink BrowseTheWebWithProtractor}
  * all **extend** the base ability to {@apilink BrowseTheWeb}.
  *
- * #### Playwright Test
+ * #### Playwright
  *
  * ```typescript
  * import { actorCalled } from '@serenity-js/core'
@@ -63,7 +63,7 @@ exports.Ability = void 0;
  *
  * const browser = await chromium.launch({ headless: true })              // integration library
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithPlaywright.using(browser))                   // tool-specific ability
  * ```
  *
@@ -73,7 +73,7 @@ exports.Ability = void 0;
  * import { actorCalled } from '@serenity-js/core'
  * import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio' // Serenity/JS integration module
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))                  // tool-specific ability
  * ```
  *
@@ -84,7 +84,7 @@ exports.Ability = void 0;
  * import { BrowseTheWebWithProtractor } from '@serenity-js/protractor'   // Serenity/JS integration module
  * import { protractor } from 'protractor'                                // integration library
  *
- * actorCalled('Trevor')                                                  // generic actor
+ * await actorCalled('Trevor')                                            // generic actor
  *   .whoCan(BrowseTheWebWithProtractor.using(protractor.browser))        // tool-specific ability
  * ```
  *
@@ -242,9 +242,11 @@ exports.Ability = void 0;
  * ### Defining a custom interaction using the custom ability
  *
  * ```ts
+ * import { Answerable, Interaction, the } from '@serenity-js/core'
+ *
  * // A custom interaction using the actor's ability:
- * const Call = (phoneNumber: string) =>
- *   Interaction.where(`#actor calls ${ phoneNumber }`, async actor => {
+ * const Call = (phoneNumber: Answerable<string>) =>
+ *   Interaction.where(the`#actor calls ${ phoneNumber }`, async actor => {
  *     await MakePhoneCalls.as(actor).dial(phoneNumber)
  *   })
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"Ability.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Ability.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiWG;AACH,MAAsB,OAAO;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,EAAE,CAEL,KAAoB;QAEpB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAM,CAAC;IACtC,CAAC;CACJ;AA7CD,0BA6CC"}
+{"version":3,"file":"Ability.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/Ability.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmWG;AACH,MAAsB,OAAO;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,EAAE,CAEL,KAAoB;QAEpB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAM,CAAC;IACtC,CAAC;CACJ;AA7CD,0BA6CC"}

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

@@ -6,7 +6,7 @@ import type { Ability } from './Ability';
  * #### Retrieving an ability from an interaction
  *
  * ```ts
- * import { Ability, actorCalled, Interaction } from '@serenity-js/core';
+ * import { Ability, Answerable, actorCalled, Interaction, the } from '@serenity-js/core';
  *
  * class MakePhoneCalls extends Ability {
  *   static using(phone: Phone) {
@@ -22,8 +22,8 @@ import type { Ability } from './Ability';
  *   }
  * }
  *
- * const Call = (phoneNumber: string) =>
- *   Interaction.where(`#actor calls ${ phoneNumber }`, async actor => {
+ * const Call = (phoneNumber: Answerable<string>) =>
+ *   Interaction.where(the`#actor calls ${ phoneNumber }`, async actor => {
  *     await MakePhoneCalls.as(actor).dial(phoneNumber)
  *   });
  *

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

@@ -15,7 +15,6 @@ export declare class AnswerQuestions extends Ability {
     protected readonly actor: AnswersQuestions & UsesAbilities;
     constructor(actor: AnswersQuestions & UsesAbilities);
     answer<T>(answerable: Answerable<T>): Promise<T>;
-    private static isAPromise;
     private static isDefined;
 }
 //# sourceMappingURL=AnswerQuestions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AnswerQuestions.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/AnswerQuestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC5B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa;gBAAvC,KAAK,EAAE,gBAAgB,GAAG,aAAa;IAItE,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAahD,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,SAAS;CAG3B"}
+{"version":3,"file":"AnswerQuestions.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/AnswerQuestions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC5B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa;gBAAvC,KAAK,EAAE,gBAAgB,GAAG,aAAa;IAItE,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAahD,OAAO,CAAC,MAAM,CAAC,SAAS;CAG3B"}

package/lib/screenplay/abilities/AnswerQuestions.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnswerQuestions = void 0;
+const io_1 = require("../../io");
 const Question_1 = require("../Question");
 const Ability_1 = require("./Ability");
 /**
@@ -19,7 +20,7 @@ class AnswerQuestions extends Ability_1.Ability {
         this.actor = actor;
     }
     answer(answerable) {
-        if (AnswerQuestions.isDefined(answerable) && AnswerQuestions.isAPromise(answerable)) {
+        if (AnswerQuestions.isDefined(answerable) && io_1.ValueInspector.isPromise(answerable)) {
             return answerable;
         }
         if (AnswerQuestions.isDefined(answerable) && Question_1.Question.isAQuestion(answerable)) {
@@ -27,9 +28,6 @@ class AnswerQuestions extends Ability_1.Ability {
         }
         return Promise.resolve(answerable);
     }
-    static isAPromise(v) {
-        return Object.prototype.hasOwnProperty.call(v, 'then');
-    }
     static isDefined(v) {
         return !(v === undefined || v === null);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"AnswerQuestions.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/AnswerQuestions.ts"],"names":[],"mappings":";;;AACA,0CAAuC;AAEvC,uCAAoC;AAGpC;;;;;;;;GAQG;AACH,MAAa,eAAgB,SAAQ,iBAAO;IACT;IAA/B,YAA+B,KAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,UAAK,GAAL,KAAK,CAAkC;IAEtE,CAAC;IAED,MAAM,CAAI,UAAyB;QAE/B,IAAI,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YACjF,OAAO,UAAU,CAAC;SACrB;QAED,IAAI,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,mBAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE;YAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;SACzD;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,UAAe,CAAC,CAAC;IAC5C,CAAC;IAEO,MAAM,CAAC,UAAU,CAAI,CAAgB;QACzC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAEO,MAAM,CAAC,SAAS,CAAI,CAAgB;QACxC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5C,CAAC;CACJ;AAzBD,0CAyBC"}
+{"version":3,"file":"AnswerQuestions.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/AnswerQuestions.ts"],"names":[],"mappings":";;;AAAA,iCAA0C;AAE1C,0CAAuC;AAEvC,uCAAoC;AAGpC;;;;;;;;GAQG;AACH,MAAa,eAAgB,SAAQ,iBAAO;IACT;IAA/B,YAA+B,KAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,UAAK,GAAL,KAAK,CAAkC;IAEtE,CAAC;IAED,MAAM,CAAI,UAAyB;QAE/B,IAAI,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,mBAAc,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;YAC/E,OAAO,UAAU,CAAC;SACrB;QAED,IAAI,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,mBAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE;YAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;SACzD;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,UAAe,CAAC,CAAC;IAC5C,CAAC;IAEO,MAAM,CAAC,SAAS,CAAI,CAAgB;QACxC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5C,CAAC;CACJ;AArBD,0CAqBC"}

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

@@ -2,7 +2,9 @@ import type { EmitsDomainEvents } from '../../events';
 import type { Outcome } from '../../model';
 import type { PerformsActivities } from '../activities/PerformsActivities';
 import type { Activity } from '../Activity';
-import { Ability } from './index';
+import type { AnswersQuestions } from '../questions';
+import { Ability } from './Ability';
+import type { UsesAbilities } from './UsesAbilities';
 /**
  * An {@apilink Ability} that enables an {@apilink Actor} to perform a given {@apilink Activity}.
  *
@@ -13,11 +15,11 @@ import { Ability } from './index';
  * @group Abilities
  */
 export declare class PerformActivities extends Ability {
-    protected readonly actor: PerformsActivities & {
+    protected readonly actor: AnswersQuestions & UsesAbilities & PerformsActivities & {
         name: string;
     };
     protected readonly stage: EmitsDomainEvents;
-    constructor(actor: PerformsActivities & {
+    constructor(actor: AnswersQuestions & UsesAbilities & PerformsActivities & {
         name: string;
     }, stage: EmitsDomainEvents);
     perform(activity: Activity): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"PerformActivities.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/PerformActivities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EACR,OAAO,EAEV,MAAM,aAAa,CAAC;AAUrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAEtC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAC/D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB;gBADxB,KAAK,EAAE,kBAAkB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAC5C,KAAK,EAAE,iBAAiB;IAKzC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhD,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,OAAO;IAYjD,OAAO,CAAC,SAAS;IAOjB,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;CAO/C"}
+{"version":3,"file":"PerformActivities.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/PerformActivities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AAU9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAEtC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,kBAAkB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAClG,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB;gBADxB,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,kBAAkB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAC/E,KAAK,EAAE,iBAAiB;IAKzC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyChD,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,OAAO;IAYjD,OAAO,CAAC,SAAS;IAOjB,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;CAO/C"}

package/lib/screenplay/abilities/PerformActivities.js

@@ -4,9 +4,10 @@ exports.PerformActivities = void 0;
 const tiny_types_1 = require("tiny-types");
 const errors_1 = require("../../errors");
 const events_1 = require("../../events");
+const io_1 = require("../../io");
 const model_1 = require("../../model");
 const Interaction_1 = require("../Interaction");
-const index_1 = require("./index");
+const Ability_1 = require("./Ability");
 /**
  * An {@apilink Ability} that enables an {@apilink Actor} to perform a given {@apilink Activity}.
  *
@@ -16,7 +17,7 @@ const index_1 = require("./index");
  *
  * @group Abilities
  */
-class PerformActivities extends index_1.Ability {
+class PerformActivities extends Ability_1.Ability {
     actor;
     stage;
     constructor(actor, stage) {
@@ -26,7 +27,7 @@ class PerformActivities extends index_1.Ability {
     }
     async perform(activity) {
         const sceneId = this.stage.currentSceneId();
-        const details = this.detailsOf(activity);
+        const details = this.detailsOf(this.nameOf(activity), activity.instantiationLocation());
         const activityId = this.stage.assignNewActivityId(details);
         const [activityStarts, activityFinished] = activity instanceof Interaction_1.Interaction
             ? [events_1.InteractionStarts, events_1.InteractionFinished]
@@ -34,7 +35,8 @@ class PerformActivities extends index_1.Ability {
         try {
             this.stage.announce(new activityStarts(sceneId, activityId, details, this.stage.currentTime()));
             await activity.performAs(this.actor);
-            this.stage.announce(new activityFinished(sceneId, activityId, details, new model_1.ExecutionSuccessful(), this.stage.currentTime()));
+            const name = await activity.describedBy(this.actor);
+            this.stage.announce(new activityFinished(sceneId, activityId, this.detailsOf(name, activity.instantiationLocation()), new model_1.ExecutionSuccessful(), this.stage.currentTime()));
         }
         catch (error) {
             this.stage.announce(new activityFinished(sceneId, activityId, details, this.outcomeFor(error), this.stage.currentTime()));
@@ -54,14 +56,14 @@ class PerformActivities extends index_1.Ability {
             : new model_1.ExecutionFailedWithError(error))
             .else(_ => new model_1.ExecutionFailedWithError(error));
     }
-    detailsOf(activity) {
-        return new model_1.ActivityDetails(new model_1.Name(this.nameOf(activity)), activity.instantiationLocation());
+    detailsOf(name, instantiationLocation) {
+        return new model_1.ActivityDetails(new model_1.Name(name), instantiationLocation);
     }
     nameOf(activity) {
-        const template = activity.toString() === ({}).toString()
-            ? `#actor performs ${activity.constructor.name}`
-            : activity.toString();
-        return template.replace('#actor', this.actor.name);
+        const template = io_1.ValueInspector.hasItsOwnToString(activity)
+            ? activity.toString()
+            : `#actor performs ${activity.constructor.name}`;
+        return template.replaceAll('#actor', this.actor.name);
     }
 }
 exports.PerformActivities = PerformActivities;

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

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

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

@@ -17,7 +17,7 @@ export interface CollectsArtifacts {
      *
      * ```ts
      * import * as fs from 'node:fs'
-     * import { Answerable, Interaction } from '@serenity-js/core'
+     * import { Answerable, Interaction, the } from '@serenity-js/core'
      * import { Path } from '@serenity-js/core/lib/io'
      * import { Name, TextData } from '@serenity-js/core/lib/model'
      *
@@ -34,7 +34,7 @@ export interface CollectsArtifacts {
      *     })
      *
      *   static textData = (contents: Answerable<string>, name?: string): Interaction =>
-     *     Interaction.where(`#actor attaches text data`, async actor => {
+     *     Interaction.where(the`#actor attaches text data`, async actor => {
      *       const data = await actor.answer(contents);
      *
      *       actor.collect(

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

@@ -1 +1 @@
-{"version":3,"file":"NotepadAdapter.d.ts","sourceRoot":"","sources":["../../../src/screenplay/notes/NotepadAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAE,YAAW,eAAe,CAAC,KAAK,CAAC;IAEzF;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;IAM5E;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAMnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,WAAW;IAI3H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;IAM/E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,IAAI,WAAW;IAMpB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC;IAM/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC;IAMrC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGrB"}
+{"version":3,"file":"NotepadAdapter.d.ts","sourceRoot":"","sources":["../../../src/screenplay/notes/NotepadAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAE,YAAW,eAAe,CAAC,KAAK,CAAC;IAEzF;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;IAM5E;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAMnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,WAAW;IAI3H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CAAC,OAAO,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;IAM/E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,IAAI,WAAW;IAMpB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC;IAM/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC;IAMrC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGrB"}

package/lib/screenplay/notes/NotepadAdapter.js

@@ -4,6 +4,7 @@ exports.NotepadAdapter = void 0;
 const io_1 = require("../../io");
 const Interaction_1 = require("../Interaction");
 const Question_1 = require("../Question");
+const questions_1 = require("../questions");
 const TakeNotes_1 = require("./TakeNotes");
 /**
  * Serenity/JS Screenplay Pattern-style adapter for the {@apilink Notepad},
@@ -50,7 +51,7 @@ class NotepadAdapter {
     get(subject) {
         return Question_1.Question.about(`a note of ${String(subject)}`, actor => {
             return TakeNotes_1.TakeNotes.as(actor).notepad.get(subject);
-        });
+        }).describedAs(Question_1.Question.formattedValue());
     }
     /**
      * Resolves a given `Answerable<value>` and stores it in the notepad,
@@ -197,7 +198,7 @@ class NotepadAdapter {
      * - {@apilink Notepad.clear}
      */
     clear() {
-        return Interaction_1.Interaction.where('#actor clears their notepad', actor => {
+        return Interaction_1.Interaction.where((0, questions_1.the) `#actor clears ${new NumberOfNotes()} from their notepad`, actor => {
             return TakeNotes_1.TakeNotes.as(actor).notepad.clear();
         });
     }
@@ -225,7 +226,7 @@ class NotepadAdapter {
      * - {@apilink Notepad.size}
      */
     size() {
-        return Question_1.Question.about('number of notes', async (actor) => {
+        return Question_1.Question.about((0, questions_1.the) `${new NumberOfNotes()}`, async (actor) => {
             return TakeNotes_1.TakeNotes.as(actor).notepad.size();
         });
     }
@@ -279,7 +280,7 @@ exports.NotepadAdapter = NotepadAdapter;
 class ChainableNoteSetter extends Interaction_1.Interaction {
     notes;
     constructor(notes) {
-        super(`#actor takes note of ${(0, io_1.commaSeparated)(Object.keys(notes))}`);
+        super(new DescriptionOfNotes(notes));
         this.notes = notes;
     }
     set(subject, value) {
@@ -296,4 +297,43 @@ class ChainableNoteSetter extends Interaction_1.Interaction {
         }
     }
 }
+class DescriptionOfNotes extends Question_1.Question {
+    notes;
+    options;
+    constructor(notes, options) {
+        super(`#actor takes notes: ${Object.keys(notes).join(', ')}`);
+        this.notes = notes;
+        this.options = options;
+    }
+    async answeredBy(actor) {
+        const noteNames = Object.keys(this.notes);
+        const maxWidth = noteNames.reduce((max, name) => Math.max(max, name.length), 0);
+        const list = await (0, io_1.asyncMap)(noteNames, async (noteName) => {
+            const label = `${noteName}:`.padEnd(maxWidth + 1);
+            const noteDescription = await actor.answer(Question_1.Question.formattedValue(this.options).of(this.notes[noteName]));
+            return `- ${label} ${noteDescription}`;
+        });
+        return [
+            `#actor takes notes:`,
+            ...list,
+        ].join('\n');
+    }
+    async describedBy(actor) {
+        return this.answeredBy(actor);
+    }
+}
+class NumberOfNotes extends Question_1.Question {
+    constructor() {
+        super('notes');
+    }
+    async answeredBy(actor) {
+        return TakeNotes_1.TakeNotes.as(actor).notepad.size();
+    }
+    async describedBy(actor) {
+        const count = await this.answeredBy(actor);
+        return count === 1
+            ? '1 note'
+            : `${count} notes`;
+    }
+}
 //# sourceMappingURL=NotepadAdapter.js.map

package/lib/screenplay/notes/NotepadAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotepadAdapter.js","sourceRoot":"","sources":["../../../src/screenplay/notes/NotepadAdapter.ts"],"names":[],"mappings":";;;AAEA,iCAA0C;AAG1C,gDAA6C;AAE7C,0CAAuC;AAGvC,2CAAwC;AAExC;;;;;;;GAOG;AACH,MAAa,cAAc;IAEvB;;;;;;;;;;;OAWG;IACH,GAAG,CAA8B,OAAgB;QAC7C,OAAO,mBAAQ,CAAC,KAAK,CAAC,aAAc,MAAM,CAAC,OAAO,CAAE,SAAS,EAAE,KAAK,CAAC,EAAE;YACnE,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAA8B,OAAgB;QAC7C,OAAO,mBAAQ,CAAC,KAAK,CAAC,aAAc,MAAM,CAAC,OAAO,CAAE,EAAE,EAAE,KAAK,CAAC,EAAE;YAC5D,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,GAAG,CAA8B,OAAgB,EAAE,KAAiC;QAChF,OAAO,IAAI,mBAAmB,CAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAuB,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CAA8B,OAAgB;QAChD,OAAO,mBAAQ,CAAC,KAAK,CAAC,4BAA6B,MAAM,CAAC,OAAO,CAAE,EAAE,EAAE,KAAK,CAAC,EAAE;YAC3E,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK;QACD,OAAO,yBAAW,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,EAAE;YAC5D,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI;QACA,OAAO,mBAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACnD,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9C,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM;QACF,OAAO,mBAAQ,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9D,OAAO,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAgB,CAAC;QAC9D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;AA1QD,wCA0QC;AAMD;;GAEG;AACH,MAAM,mBAAoD,SAAQ,yBAAW;IAE5C;IAA7B,YAA6B,KAAwB;QACjD,KAAK,CAAC,wBAAyB,IAAA,mBAAc,EAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAE,EAAE,CAAC,CAAC;QAD7C,UAAK,GAAL,KAAK,CAAmB;IAErD,CAAC;IAED,GAAG,CAAwB,OAAU,EAAE,KAA2B;QAC9D,OAAO,IAAI,mBAAmB,CAAC;YAC3B,GAAG,IAAI,CAAC,KAAK;YACb,CAAC,OAAO,CAAC,EAAE,KAAK;SACE,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAuC;QAEnD,MAAM,OAAO,GAAG,qBAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QAE5C,KAAK,MAAM,CAAE,OAAO,EAAE,KAAK,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YACzD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SAChC;IACL,CAAC;CACJ"}
+{"version":3,"file":"NotepadAdapter.js","sourceRoot":"","sources":["../../../src/screenplay/notes/NotepadAdapter.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+import type { UsesAbilities } from '../abilities/UsesAbilities';
+import type { Answerable } from '../Answerable';
+import type { AnswersQuestions } from './AnswersQuestions';
+declare const descriptionField: unique symbol;
+/**
+ * @group Questions
+ */
+export declare abstract class Describable {
+    private [descriptionField];
+    protected constructor(description: Answerable<string>);
+    /**
+     * Resolves the description of this object in the context of the provided `actor`.
+     *
+     * @param actor
+     */
+    describedBy(actor: AnswersQuestions & UsesAbilities & {
+        name: string;
+    }): Promise<string>;
+    protected setDescription(description: Answerable<string>): void;
+    protected getDescription(): Answerable<string>;
+    /**
+     * Returns a human-readable description of this object.
+     */
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=Describable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Describable.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Describable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,QAAA,MAAM,gBAAgB,eAAwB,CAAC;AAE/C;;GAEG;AACH,8BAAsB,WAAW;IAE7B,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAqB;IAE/C,SAAS,aAAa,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC;IAIrD;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9F,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI;IAI/D,SAAS,CAAC,cAAc,IAAI,UAAU,CAAC,MAAM,CAAC;IAI9C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAOrB"}

package/lib/screenplay/questions/Describable.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Describable = void 0;
+const ValueInspector_1 = require("../../io/reflection/ValueInspector");
+const descriptionField = Symbol('description');
+/**
+ * @group Questions
+ */
+class Describable {
+    [descriptionField];
+    constructor(description) {
+        this[descriptionField] = description;
+    }
+    /**
+     * Resolves the description of this object in the context of the provided `actor`.
+     *
+     * @param actor
+     */
+    async describedBy(actor) {
+        const description = await actor.answer(this[descriptionField]);
+        return description.replaceAll('#actor', actor.name);
+    }
+    setDescription(description) {
+        this[descriptionField] = description;
+    }
+    getDescription() {
+        return this[descriptionField];
+    }
+    /**
+     * Returns a human-readable description of this object.
+     */
+    toString() {
+        if (ValueInspector_1.ValueInspector.isPromise(this[descriptionField])) {
+            return 'Promise';
+        }
+        return String(this[descriptionField]);
+    }
+}
+exports.Describable = Describable;
+//# sourceMappingURL=Describable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Describable.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Describable.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAKpE,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAE/C;;GAEG;AACH,MAAsB,WAAW;IAErB,CAAC,gBAAgB,CAAC,CAAqB;IAE/C,YAAsB,WAA+B;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,KAA0D;QACxE,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAE/D,OAAO,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAES,cAAc,CAAC,WAA+B;QACpD,IAAI,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC;IACzC,CAAC;IAES,cAAc;QACpB,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,IAAI,+BAAc,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAClD,OAAO,SAAS,CAAC;SACpB;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC1C,CAAC;CACJ;AArCD,kCAqCC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Configuration options for {@apilink Question.formattedValue} and
+ * the [`the`](/api/core/function/the/) function.
+ *
+ * @group Questions
+ */
+export interface DescriptionFormattingOptions {
+    /**
+     * The maximum length of the string representation of the value.
+     * String representations longer than this value will be truncated and appended with an ellipsis.
+     */
+    maxLength: number;
+}
+//# sourceMappingURL=DescriptionFormattingOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptionFormattingOptions.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/DescriptionFormattingOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IACzC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/lib/screenplay/questions/DescriptionFormattingOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DescriptionFormattingOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptionFormattingOptions.js","sourceRoot":"","sources":["../../../src/screenplay/questions/DescriptionFormattingOptions.ts"],"names":[],"mappings":""}

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

@@ -1,4 +1,5 @@
-import type { Answerable, AnswersQuestions, QuestionAdapter } from '../';
+import type { Answerable, AnswersQuestions, QuestionAdapter } from '../index';
+import { Describable } from '../questions';
 import type { ExpectationOutcome } from './expectations';
 /**
  * @group Expectations
@@ -13,9 +14,8 @@ type AnswerableArguments<Arguments extends Array<unknown>> = {
  *
  * @group Expectations
  */
-export declare class Expectation<Actual> {
+export declare class Expectation<Actual> extends Describable {
     private readonly functionName;
-    private description;
     private readonly predicate;
     /**
      * A factory method to that makes defining custom {@apilink Expectation|expectations} easier
@@ -102,7 +102,7 @@ export declare class Expectation<Actual> {
      *
      * @param predicate
      */
-    static define<Actual_Type, PredicateArguments extends Array<unknown>>(functionName: string, relationship: ((...answerableArguments: AnswerableArguments<PredicateArguments>) => string) | string, predicate: (actual: Actual_Type, ...predicateArguments: PredicateArguments) => Promise<boolean> | boolean): (...answerableArguments: AnswerableArguments<PredicateArguments>) => Expectation<Actual_Type>;
+    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}
      *
@@ -165,7 +165,7 @@ export declare class Expectation<Actual> {
     static to<Actual_Type>(relationshipName: string): {
         soThatActual: (expectation: Expectation<Actual_Type>) => Expectation<Actual_Type>;
     };
-    protected constructor(functionName: string, description: string, predicate: Predicate<Actual>);
+    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}
@@ -177,11 +177,7 @@ export declare class Expectation<Actual> {
     /**
      * @inheritDoc
      */
-    describedAs(subject: string): this;
-    /**
-     * @inheritDoc
-     */
-    toString(): string;
+    describedAs(description: Answerable<string>): this;
 }
 export {};
 //# sourceMappingURL=Expectation.d.ts.map

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":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAEzE,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;IA+NvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IA/N9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,MAAM,CAAC,GAAG,MAAM,EACpG,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;IAiChG;;;;;;;;;;;;;;;;;;;;;;;;;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,EAC7B,WAAW,EAAE,MAAM,EACV,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC;IAIjD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIzE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGrB"}
+{"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"}