@serenity-js/core 3.0.0-rc.33 → 3.0.0-rc.34

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.0.0-rc.34](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.33...v3.0.0-rc.34) (2022-11-21)
+
+
+### Bug Fixes
+
+* **core:** interaction to Wait should fail after the timeout ([5403394](https://github.com/serenity-js/serenity-js/commit/54033946873e20a18ad1076c77f841b3856f2478)), closes [#1339](https://github.com/serenity-js/serenity-js/issues/1339)
+
+
+
+
+
 # [3.0.0-rc.33](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.32...v3.0.0-rc.33) (2022-11-07)
 
 

package/lib/config/ClassDescription.d.ts

@@ -47,7 +47,7 @@
  * For example, `./my-reporter:MyReporter` would be interpreted as a request to load the `MyReporter` type from `./my-reporter` file, located
  * relative to the [working directory](https://nodejs.org/api/process.html#processcwd) of the current Node.js process.
  *
- * @group Configuration
+ * @group Serenity
  */
 export declare type ClassDescription = string | // e.g. '@serenity-js/core:StreamReporter'
 [

package/lib/config/SerenityConfig.d.ts

@@ -13,7 +13,7 @@ import { ClassDescription } from './ClassDescription';
  * - {@apilink ClassDescription}
  * - {@apilink Stage.waitForNextCue}
  *
- * @group Configuration
+ * @group Serenity
  */
 export declare abstract class SerenityConfig {
     /**

package/lib/config/SerenityConfig.js

@@ -12,7 +12,7 @@ exports.SerenityConfig = void 0;
  * - {@apilink ClassDescription}
  * - {@apilink Stage.waitForNextCue}
  *
- * @group Configuration
+ * @group Serenity
  */
 class SerenityConfig {
 }

package/lib/errors/ListItemNotFoundError.d.ts

@@ -0,0 +1,20 @@
+import { JSONObject } from 'tiny-types';
+import { RuntimeError } from './RuntimeError';
+/**
+ * Thrown to indicate that an {@apilink Interaction}, a {@apilink Task} or a test scenario
+ * can't be executed due to no items are found in a list.
+ *
+ * For example, it's not possible to get the first() or the last() item of a list
+ * if the list is empty.
+ *
+ * @group Errors
+ */
+export declare class ListItemNotFoundError extends RuntimeError {
+    static fromJSON(serialised: JSONObject): ListItemNotFoundError;
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this {@apilink ListItemNotFoundError}, if any
+     */
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ListItemNotFoundError.d.ts.map

package/lib/errors/ListItemNotFoundError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemNotFoundError.d.ts","sourceRoot":"","sources":["../../src/errors/ListItemNotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IAEnD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,qBAAqB;IAW9D;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/lib/errors/ListItemNotFoundError.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListItemNotFoundError = void 0;
+const ErrorSerialiser_1 = require("./ErrorSerialiser");
+const RuntimeError_1 = require("./RuntimeError");
+/**
+ * Thrown to indicate that an {@apilink Interaction}, a {@apilink Task} or a test scenario
+ * can't be executed due to no items are found in a list.
+ *
+ * For example, it's not possible to get the first() or the last() item of a list
+ * if the list is empty.
+ *
+ * @group Errors
+ */
+class ListItemNotFoundError extends RuntimeError_1.RuntimeError {
+    static fromJSON(serialised) {
+        const error = new ListItemNotFoundError(serialised.message, ErrorSerialiser_1.ErrorSerialiser.deserialise(serialised.cause));
+        error.stack = serialised.stack;
+        return error;
+    }
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this {@apilink ListItemNotFoundError}, if any
+     */
+    constructor(message, cause) {
+        super(ListItemNotFoundError, message, cause);
+    }
+}
+exports.ListItemNotFoundError = ListItemNotFoundError;
+//# sourceMappingURL=ListItemNotFoundError.js.map

package/lib/errors/ListItemNotFoundError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemNotFoundError.js","sourceRoot":"","sources":["../../src/errors/ListItemNotFoundError.ts"],"names":[],"mappings":";;;AAEA,uDAAoD;AACpD,iDAA8C;AAE9C;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,2BAAY;IAEnD,MAAM,CAAC,QAAQ,CAAC,UAAsB;QAClC,MAAM,KAAK,GAAG,IAAI,qBAAqB,CACnC,UAAU,CAAC,OAAiB,EAC5B,iCAAe,CAAC,WAAW,CAAC,UAAU,CAAC,KAA2B,CAAC,CACtE,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAe,CAAC;QAEzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,qBAAqB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACJ;AApBD,sDAoBC"}

package/lib/errors/index.d.ts

@@ -3,6 +3,7 @@ export { ConfigurationError } from './ConfigurationError';
 export { ErrorSerialiser } from './ErrorSerialiser';
 export { ErrorStackParser } from './ErrorStackParser';
 export { ImplementationPendingError } from './ImplementationPendingError';
+export { ListItemNotFoundError } from './ListItemNotFoundError';
 export { LogicError } from './LogicError';
 export { RuntimeError } from './RuntimeError';
 export { TestCompromisedError } from './TestCompromisedError';

package/lib/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnknownError = exports.TimeoutExpiredError = exports.TestCompromisedError = exports.RuntimeError = exports.LogicError = exports.ImplementationPendingError = exports.ErrorStackParser = exports.ErrorSerialiser = exports.ConfigurationError = exports.AssertionError = void 0;
+exports.UnknownError = exports.TimeoutExpiredError = exports.TestCompromisedError = exports.RuntimeError = exports.LogicError = exports.ListItemNotFoundError = exports.ImplementationPendingError = exports.ErrorStackParser = exports.ErrorSerialiser = exports.ConfigurationError = exports.AssertionError = void 0;
 const AssertionError_1 = require("./AssertionError");
 const ConfigurationError_1 = require("./ConfigurationError");
 const ErrorSerialiser_1 = require("./ErrorSerialiser");
@@ -20,6 +20,8 @@ var ErrorStackParser_1 = require("./ErrorStackParser");
 Object.defineProperty(exports, "ErrorStackParser", { enumerable: true, get: function () { return ErrorStackParser_1.ErrorStackParser; } });
 var ImplementationPendingError_2 = require("./ImplementationPendingError");
 Object.defineProperty(exports, "ImplementationPendingError", { enumerable: true, get: function () { return ImplementationPendingError_2.ImplementationPendingError; } });
+var ListItemNotFoundError_1 = require("./ListItemNotFoundError");
+Object.defineProperty(exports, "ListItemNotFoundError", { enumerable: true, get: function () { return ListItemNotFoundError_1.ListItemNotFoundError; } });
 var LogicError_2 = require("./LogicError");
 Object.defineProperty(exports, "LogicError", { enumerable: true, get: function () { return LogicError_2.LogicError; } });
 var RuntimeError_1 = require("./RuntimeError");

package/lib/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,6DAA0D;AAC1D,uDAAoD;AACpD,6EAA0E;AAC1E,6CAA0C;AAC1C,iEAA8D;AAC9D,+DAA4D;AAC5D,iDAA8C;AAE9C,iCAAe,CAAC,kBAAkB,CAC9B,+BAAc,EACd,uCAAkB,EAClB,uDAA0B,EAC1B,uBAAU,EACV,2CAAoB,EACpB,yCAAmB,EACnB,2BAAY,CACf,CAAC;AAEF,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,6DAA0D;AAC1D,uDAAoD;AACpD,6EAA0E;AAC1E,6CAA0C;AAC1C,iEAA8D;AAC9D,+DAA4D;AAC5D,iDAA8C;AAE9C,iCAAe,CAAC,kBAAkB,CAC9B,+BAAc,EACd,uCAAkB,EAClB,uDAA0B,EAC1B,uBAAU,EACV,2CAAoB,EACpB,yCAAmB,EACnB,2BAAY,CACf,CAAC;AAEF,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/lib/io/format.d.ts

@@ -54,13 +54,13 @@ import { Answerable } from '../screenplay';
  * @param config
  *  `markQuestions`: boolean - if set to true, descriptions of questions passed in as arguments will be surrounded with double angled brackets, i.e. `<<description>>`
  *
- * @group Answerables
+ * @group Questions
  */
 export declare function format(config: {
     markQuestions: boolean;
 }): (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>) => string;
-/** @group Answerables */
+/** @group Questions */
 export declare const f: (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>) => string;
-/** @group Answerables */
+/** @group Questions */
 export declare const d: (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>) => string;
 //# sourceMappingURL=format.d.ts.map

package/lib/io/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/io/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAS/I;AAED,yBAAyB;AACzB,eAAO,MAAM,CAAC,cAZ0D,oBAAoB,mBAAmB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,MAY1F,CAAC;AAEjD,yBAAyB;AACzB,eAAO,MAAM,CAAC,cAf0D,oBAAoB,mBAAmB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,MAezF,CAAC"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/io/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAS/I;AAED,uBAAuB;AACvB,eAAO,MAAM,CAAC,cAZ0D,oBAAoB,mBAAmB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,MAY1F,CAAC;AAEjD,uBAAuB;AACvB,eAAO,MAAM,CAAC,cAf0D,oBAAoB,mBAAmB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,MAezF,CAAC"}

package/lib/io/format.js

@@ -57,7 +57,7 @@ const inspected_1 = require("./inspected");
  * @param config
  *  `markQuestions`: boolean - if set to true, descriptions of questions passed in as arguments will be surrounded with double angled brackets, i.e. `<<description>>`
  *
- * @group Answerables
+ * @group Questions
  */
 function format(config) {
     return (templates, ...placeholders) => {
@@ -70,8 +70,8 @@ function format(config) {
     };
 }
 exports.format = format;
-/** @group Answerables */
+/** @group Questions */
 exports.f = format({ markQuestions: true });
-/** @group Answerables */
+/** @group Questions */
 exports.d = format({ markQuestions: false });
 //# sourceMappingURL=format.js.map

package/lib/io/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/io/format.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,SAAgB,MAAM,CAAC,MAAkC;IACrD,OAAO,CAAC,SAA+B,EAAE,GAAG,YAAoC,EAAU,EAAE;QACxF,OAAO,SAAS;aACX,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM;YACzC,CAAC,CAAC,CAAE,QAAQ,EAAE,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAE;YACjG,CAAC,CAAC,CAAE,QAAQ,CAAE,CAAC;aAClB,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACzC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAA;AACL,CAAC;AATD,wBASC;AAED,yBAAyB;AACZ,QAAA,CAAC,GAAG,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;AAEjD,yBAAyB;AACZ,QAAA,CAAC,GAAG,MAAM,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/io/format.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,SAAgB,MAAM,CAAC,MAAkC;IACrD,OAAO,CAAC,SAA+B,EAAE,GAAG,YAAoC,EAAU,EAAE;QACxF,OAAO,SAAS;aACX,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM;YACzC,CAAC,CAAC,CAAE,QAAQ,EAAE,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAE;YACjG,CAAC,CAAC,CAAE,QAAQ,CAAE,CAAC;aAClB,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACzC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAA;AACL,CAAC;AATD,wBASC;AAED,uBAAuB;AACV,QAAA,CAAC,GAAG,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;AAEjD,uBAAuB;AACV,QAAA,CAAC,GAAG,MAAM,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/lib/screenplay/Ability.d.ts

@@ -157,7 +157,7 @@
  * - {@apilink CallAnApi}
  * - {@apilink TakeNotes}
  *
- * @group Screenplay Pattern
+ * @group Abilities
  */
 export interface Ability {
 }

package/lib/screenplay/Activity.d.ts

@@ -9,7 +9,7 @@ import { AnswersQuestions, PerformsActivities, UsesAbilities } from './actor';
  * - {@apilink PerformsActivities}
  * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export declare abstract class Activity {
     #private;

package/lib/screenplay/Activity.js

@@ -28,7 +28,7 @@ const io_1 = require("../io");
  * - {@apilink PerformsActivities}
  * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 class Activity {
     constructor(description, location = Activity.callerLocation(5)) {

package/lib/screenplay/Answerable.d.ts

@@ -3,7 +3,7 @@ import { Question } from './Question';
  * A union type that provides a convenient way to represent any value
  * that can be resolved by {@apilink Actor.answer}.
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type Answerable<T> = Question<Promise<T>> | Question<T> | Promise<T> | T;
 //# sourceMappingURL=Answerable.d.ts.map

package/lib/screenplay/Answered.d.ts

@@ -7,7 +7,7 @@ import { Question } from './Question';
  * Answered<Answerable<T>> === T
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type Answered<T> = T extends null | undefined ? T : T extends Question<Promise<infer A>> | Question<infer A> | Promise<infer A> ? Awaited<A> : T;
 //# sourceMappingURL=Answered.d.ts.map

package/lib/screenplay/Interaction.d.ts

@@ -40,7 +40,7 @@ import { AnswersQuestions, CollectsArtifacts, UsesAbilities } from './actor';
  *   )
  * ```
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export declare abstract class Interaction extends Activity {
     /**

package/lib/screenplay/Interaction.js

@@ -42,7 +42,7 @@ const Activity_1 = require("./Activity");
  *   )
  * ```
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 class Interaction extends Activity_1.Activity {
     /**

package/lib/screenplay/Optional.d.ts

@@ -14,7 +14,7 @@ import { Answerable } from './Answerable';
  *   and if all the links of the property chain leading to the entry of interest exist too
  *   (so `books` is present, and so is `books[0]`, `books[0].author`, `books[0].author.name`).
  *
- * @group Answerables
+ * @group Questions
  */
 export interface Optional {
     /**

package/lib/screenplay/Question.d.ts

@@ -94,7 +94,7 @@ import { WithAnswerableProperties } from './WithAnswerableProperties';
  * - {@apilink Ability}
  * - {@apilink QuestionAdapter}
  *
- * @group Screenplay Pattern
+ * @group Questions
  */
 export declare abstract class Question<T> {
     /**
@@ -223,7 +223,7 @@ declare global {
  * - both methods and fields of the wrapped object can be used as {@apilink Question|questions} or {@apilink Interactions|interactions}
  * - method parameters of the wrapped object will accept {@apilink Answerable|Answerable<T>}
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type QuestionAdapterFieldDecorator<Original_Type> = {
     [Field in keyof Omit<Original_Type, keyof QuestionStatement<Original_Type>>]: Original_Type[Field] extends (...args: infer OriginalParameters) => infer OriginalMethodResult ? (...args: {
@@ -236,7 +236,7 @@ export declare type QuestionAdapterFieldDecorator<Original_Type> = {
  * {@apilink QuestionAdapter} proxies the methods and fields of the wrapped object recursively,
  * allowing them to be used as either a {@apilink Question} or an {@apilink Interaction}.
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type QuestionAdapter<T> = Question<Promise<T>> & Interaction & {
     isPresent(): Question<Promise<boolean>>;

package/lib/screenplay/Question.js

@@ -95,7 +95,7 @@ const Interaction_1 = require("./Interaction");
  * - {@apilink Ability}
  * - {@apilink QuestionAdapter}
  *
- * @group Screenplay Pattern
+ * @group Questions
  */
 class Question {
     /**

package/lib/screenplay/RecursivelyAnswered.d.ts

@@ -32,7 +32,7 @@ import { Question } from './Question';
  * // RequestConfiguration === RecursivelyAnswered<WithAnswerableProperties<RequestConfiguration>>
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type RecursivelyAnswered<T> = T extends null | undefined ? T : T extends Question<Promise<infer A>> | Question<infer A> | Promise<infer A> ? RecursivelyAnswered<Awaited<A>> : T extends object ? {
     [K in keyof T]: RecursivelyAnswered<T[K]>;

package/lib/screenplay/Task.d.ts

@@ -51,7 +51,7 @@ import { PerformsActivities } from './actor';
  * - {@apilink Activity}
  * - {@apilink Actor}
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export declare abstract class Task extends Activity {
     /**

package/lib/screenplay/Task.js

@@ -54,7 +54,7 @@ const Activity_1 = require("./Activity");
  * - {@apilink Activity}
  * - {@apilink Actor}
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 class Task extends Activity_1.Activity {
     /**

package/lib/screenplay/WithAnswerableProperties.d.ts

@@ -25,7 +25,7 @@ import { Question } from './Question';
  * const answer: RequestConfiguration = await actorCalled('Annie').answer(question);
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export declare type WithAnswerableProperties<T> = T extends null | undefined ? T : T extends Question<Promise<infer A>> | Question<infer A> | Promise<infer A> ? Answerable<A> : T extends object ? {
     [K in keyof T]: WithAnswerableProperties<T[K]>;

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

@@ -16,7 +16,7 @@ import { UsesAbilities } from './UsesAbilities';
  * - {@apilink Cast}
  * - {@apilink Stage}
  *
- * @group Screenplay Pattern
+ * @group Actors
  */
 export declare class Actor implements PerformsActivities, UsesAbilities, CanHaveAbilities<Actor>, AnswersQuestions, CollectsArtifacts {
     readonly name: string;

package/lib/screenplay/actor/Actor.js

@@ -15,7 +15,7 @@ const Question_1 = require("../Question");
  * - {@apilink Cast}
  * - {@apilink Stage}
  *
- * @group Screenplay Pattern
+ * @group Actors
  */
 class Actor {
     // todo: Actor should have execution strategies

package/lib/screenplay/interactions/Wait.js

@@ -278,20 +278,27 @@ function waitUntil(expectation, pollingInterval) {
     let delay;
     let pollingActive = false;
     async function poll() {
+        async function nextPollingInterval() {
+            if (pollingActive) {
+                delay = waitFor(pollingInterval);
+                await delay.start();
+                await poll();
+            }
+        }
         try {
             const expectationIsMet = await expectation();
             if (expectationIsMet) {
                 delay === null || delay === void 0 ? void 0 : delay.stop();
                 return;
             }
-            if (pollingActive) {
-                delay = waitFor(pollingInterval);
-                await delay.start();
-                await poll();
-            }
+            await nextPollingInterval();
         }
         catch (error) {
             delay === null || delay === void 0 ? void 0 : delay.stop();
+            if (error instanceof errors_1.ListItemNotFoundError) {
+                await nextPollingInterval();
+                return;
+            }
             throw error;
         }
     }

package/lib/screenplay/interactions/Wait.js.map

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

package/lib/screenplay/questions/List.js

@@ -40,7 +40,7 @@ class List extends Question_1.Question {
         return Question_1.Question.about(`the first of ${this.subject}`, async (actor) => {
             const items = await this.answeredBy(actor);
             if (items.length === 0) {
-                throw new errors_1.LogicError((0, io_1.d) `Can't retrieve the first item from a list with 0 items: ${items}`);
+                throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the first item from a list with 0 items: ${items}`);
             }
             return items[0];
         });
@@ -49,7 +49,7 @@ class List extends Question_1.Question {
         return Question_1.Question.about(`the last of ${this.subject}`, async (actor) => {
             const items = await this.answeredBy(actor);
             if (items.length === 0) {
-                throw new errors_1.LogicError((0, io_1.d) `Can't retrieve the last item from a list with 0 items: ${items}`);
+                throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the last item from a list with 0 items: ${items}`);
             }
             return items[items.length - 1];
         });
@@ -58,7 +58,7 @@ class List extends Question_1.Question {
         return Question_1.Question.about(`the ${ordinal(index + 1)} of ${this.subject}`, async (actor) => {
             const items = await this.answeredBy(actor);
             if (index < 0 || items.length <= index) {
-                throw new errors_1.LogicError(`Can't retrieve the ${ordinal(index)} item from a list with ${items.length} items: ` + (0, io_1.d) `${items}`);
+                throw new errors_1.ListItemNotFoundError(`Can't retrieve the ${ordinal(index)} item from a list with ${items.length} items: ` + (0, io_1.d) `${items}`);
             }
             return items[index];
         });

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

@@ -1 +1 @@
-{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":";;;AAAA,yCAA0C;AAC1C,iCAA6B;AAG7B,0CAAwD;AACxD,kCAA+B;AAE/B,iDAAgD;AAGhD;;;;;GAKG;AACH,MAAa,IAAgB,SAAQ,mBAA8B;IAO/D,YACuB,UAAwC;QAE3D,KAAK,EAAE,CAAC;QAFW,eAAU,GAAV,UAAU,CAA8B;QAG3D,IAAI,CAAC,OAAO,GAAG,IAAA,MAAC,EAAA,GAAI,UAAW,EAAE,CAAC;IACtC,CAAC;IATD,MAAM,CAAC,EAAE,CAAK,UAAiC;QAC3C,OAAO,IAAI,IAAI,CAAK,UAAU,CAAC,CAAC;IACpC,CAAC;IASD,YAAY,CACR,QAA+E;QAE/E,OAAO,IAAI,IAAI,CACX,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAC5D,CAAC;IACN,CAAC;IAED,OAAO,CAAC,QAA2G;QAC/G,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CACD,QAAqE,EACrE,WAAqC;QAErC,OAAO,IAAI,IAAI,CACX,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAC1D,CAAC;IACd,CAAC;IAED,KAAK;QACD,OAAO,mBAAQ,CAAC,KAAK,CAAC,iBAAkB,IAAI,CAAC,OAAQ,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACnE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK;QACD,OAAO,mBAAQ,CAAC,KAAK,CAAC,gBAAiB,IAAI,CAAC,OAAQ,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAClE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;gBACpB,MAAM,IAAI,mBAAU,CAAC,IAAA,MAAC,EAAA,2DAA4D,KAAM,EAAE,CAAC,CAAA;aAC9F;YAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI;QACA,OAAO,mBAAQ,CAAC,KAAK,CAAC,eAAgB,IAAI,CAAC,OAAQ,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACjE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;gBACpB,MAAM,IAAI,mBAAU,CAAC,IAAA,MAAC,EAAA,0DAA2D,KAAM,EAAE,CAAC,CAAA;aAC7F;YAED,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,GAAG,CAAC,KAAa;QACb,OAAO,mBAAQ,CAAC,KAAK,CAAC,OAAQ,OAAO,CAAC,KAAK,GAAG,CAAC,CAAE,OAAQ,IAAI,CAAC,OAAQ,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACpF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE;gBACpC,MAAM,IAAI,mBAAU,CAAC,sBAAuB,OAAO,CAAC,KAAK,CAAE,0BAA2B,KAAK,CAAC,MAAO,UAAU,GAAG,IAAA,MAAC,EAAA,GAAI,KAAM,EAAE,CAAC,CAAA;aACjI;YAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvD,IAAI,CAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YAC7B,MAAM,IAAI,mBAAU,CAAC,IAAA,MAAC,EAAA,kDAAmD,UAAW,SAAS,CAAC,CAAC;SAClG;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAhGD,oBAgGC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,KAAa;IAC1B,MACI,SAAS,GAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EACpC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IAE1C,QAAQ,IAAI,EAAE;QACV,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;YAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;YAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC;YAC1C,OAAO,KAAK,GAAG,IAAI,CAAC;QACxB;YACI,OAAO,KAAK,GAAG,IAAI,CAAC;KAC3B;AACL,CAAC;AAED;;GAEG;AACH,MAAM,KACF,SAAQ,mBAAmC;IAI3C,YACqB,UAAwC,EACxC,QAAqE,EACrE,WAAqC,EACtD,eAAuB;QAEvB,KAAK,EAAE,CAAC;QALS,eAAU,GAAV,UAAU,CAA8B;QACxC,aAAQ,GAAR,QAAQ,CAA6D;QACrE,gBAAW,GAAX,WAAW,CAA0B;QAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,YAAY,KAAK;YAC3C,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,CAAC;QAEf,IAAI,CAAC,OAAO,GAAG,eAAe,GAAG,MAAM,GAAG,IAAA,MAAC,EAAA,IAAK,QAAS,SAAU,WAAY,EAAE,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,IAAI;YACA,MAAM,UAAU,GAAM,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAgB,EAAE,CAAC;YAEhC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;gBAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAA4B,CAAC;gBACjE,MAAM,kBAAkB,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBAEjF,IAAI,kBAAkB,YAAY,6BAAc,EAAE;oBAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBACtB;aACJ;YAED,OAAO,OAAO,CAAC;SAClB;QAAC,OAAO,KAAK,EAAE;YACZ,MAAM,IAAI,mBAAU,CAAC,IAAA,MAAC,EAAA,qBAAsB,IAAI,CAAC,QAAS,kBAAmB,IAAI,CAAC,UAAW,SAAU,IAAI,CAAC,WAAY,EAAE,EAAE,KAAK,CAAC,CAAC;SACtI;IACL,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,YAA0C,SAAQ,mBAA0C;IAI9F,YACqB,UAAwC,EACxC,OAA8E,EAC/F,eAAuB;QAEvB,KAAK,EAAE,CAAC;QAJS,eAAU,GAAV,UAAU,CAA8B;QACxC,YAAO,GAAP,OAAO,CAAuE;QAK/F,IAAI,CAAC,OAAO,GAAG,eAAe,GAAG,IAAA,MAAC,EAAA,cAAe,IAAI,CAAC,OAAQ,EAAE,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,UAAU,GAAqB,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzE,MAAM,MAAM,GAAuB,EAAE,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;YAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;SACzD;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAuB,SAAQ,WAAI;IAErC,YACqB,UAAwC,EACxC,OAAe,EACf,EAAqG;QAEtH,KAAK,CAAC,wBAAyB,OAAQ,EAAE,CAAC,CAAC;QAJ1B,eAAU,GAAV,UAAU,CAA8B;QACxC,YAAO,GAAP,OAAO,CAAQ;QACf,OAAE,GAAF,EAAE,CAAmG;IAG1H,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAY;QACxB,MAAM,UAAU,GAAqB,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzE,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE;YAC9C,MAAM,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;SACrD;IACL,CAAC;CACJ"}
+{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":"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"}

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

@@ -12,7 +12,7 @@ import { Question } from '../Question';
  * ## Learn more
  * - {@apilink List}
  *
- * @group Answerables
+ * @group Questions
  */
 export interface MetaQuestion<Supported_Answerable_Type extends Answerable<any>, Answer> {
     /**

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

@@ -57,7 +57,7 @@ import { QuestionAdapter } from '../Question';
  * - {@apilink Question.describedAs}
  * - {@apilink QuestionAdapter}
  *
- * @group Answerables
+ * @group Questions
  *
  * @param templates
  * @param parameters

package/lib/screenplay/questions/q.js

@@ -59,7 +59,7 @@ const Question_1 = require("../Question");
  * - {@apilink Question.describedAs}
  * - {@apilink QuestionAdapter}
  *
- * @group Answerables
+ * @group Questions
  *
  * @param templates
  * @param parameters

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.d.ts

@@ -55,11 +55,12 @@ import { StageCrewMember } from '../../StageCrewMember';
  *         ]
  *         // other Serenity/JS config
  *     },
- *   },
- *   // other WebdriverIO config
+ *     // other WebdriverIO config
  * }
  * ```
  *
+ * [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *
  * @group Stage
  */
 export declare class ArtifactArchiver implements StageCrewMember {

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArtifactArchiver.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/artifact-archiver/ArtifactArchiver.ts"],"names":[],"mappings":"AAGA,OAAO,EAQH,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAQ,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IAkChD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,KAAK,CAAC;IAjClB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,eAAe;IAQpE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAMrE;;;;OAIG;gBAEkB,UAAU,EAAE,UAAU,EAC/B,KAAK,CAAC,EAAE,KAAK;IAIzB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA8BlC,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,yBAAyB;CAoBpC"}
+{"version":3,"file":"ArtifactArchiver.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/artifact-archiver/ArtifactArchiver.ts"],"names":[],"mappings":"AAGA,OAAO,EAQH,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAQ,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IAkChD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,KAAK,CAAC;IAjClB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,eAAe;IAQpE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAMrE;;;;OAIG;gBAEkB,UAAU,EAAE,UAAU,EAC/B,KAAK,CAAC,EAAE,KAAK;IAIzB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA8BlC,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,yBAAyB;CAoBpC"}

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.js

@@ -59,11 +59,12 @@ const Hash_1 = require("./Hash");
  *         ]
  *         // other Serenity/JS config
  *     },
- *   },
- *   // other WebdriverIO config
+ *     // other WebdriverIO config
  * }
  * ```
  *
+ * [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *
  * @group Stage
  */
 class ArtifactArchiver {

package/lib/stage/crew/artifact-archiver/ArtifactArchiver.js.map

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

package/lib/stage/queues/DomainEventQueue.d.ts

@@ -1,7 +1,7 @@
 import { DomainEvent } from '../../events';
 import { CorrelationId } from '../../model';
 /**
- * @package
+ * @group Stage
  */
 export declare class DomainEventQueue {
     private readonly queue;

package/lib/stage/queues/DomainEventQueue.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomainEventQueue = void 0;
 const tiny_types_1 = require("tiny-types");
 /**
- * @package
+ * @group Stage
  */
 class DomainEventQueue {
     constructor(...items) {

package/lib/stage/queues/DomainEventQueues.d.ts

@@ -2,7 +2,7 @@ import { DomainEvent } from '../../events';
 import { CorrelationId } from '../../model';
 import { DomainEventQueue } from './DomainEventQueue';
 /**
- * @package
+ * @group Stage
  */
 export declare class DomainEventQueues {
     private readonly queueIndex;

package/lib/stage/queues/DomainEventQueues.js

@@ -6,7 +6,7 @@ const events_1 = require("../../events");
 const format_1 = require("../../io/format");
 const DomainEventQueue_1 = require("./DomainEventQueue");
 /**
- * @package
+ * @group Stage
  */
 class DomainEventQueues {
     constructor() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/core",
-  "version": "3.0.0-rc.33",
+  "version": "3.0.0-rc.34",
   "description": "Serenity/JS Screenplay, reporting engine and core interfaces.",
   "author": {
     "name": "Jan Molak",
@@ -44,15 +44,15 @@
     "validate-npm-package-name": "^4.0.0"
   },
   "devDependencies": {
-    "@types/chai": "^4.3.3",
+    "@types/chai": "^4.3.4",
     "@types/cuid": "^1.3.1",
     "@types/diff": "^5.0.2",
     "@types/filenamify": "^2.0.2",
     "@types/mocha": "^9.1.1",
-    "@types/semver": "^7.3.12",
+    "@types/semver": "^7.3.13",
     "@types/validate-npm-package-name": "^4.0.0",
     "assertion-error-formatter": "^3.0.0",
-    "memfs": "^3.4.7",
+    "memfs": "^3.4.12",
     "mocha": "^10.0.0",
     "nyc": "15.1.0",
     "ts-node": "^10.9.1",
@@ -70,5 +70,5 @@
     "node": "^14 || ^16 || ^18",
     "npm": "^6 || ^7 || ^8"
   },
-  "gitHead": "e61091eca7bdd3d93dedf14fd26eb3a1f58a3435"
+  "gitHead": "5b0ad14a0b673fdb541ec89ac67dc631db562018"
 }

package/src/config/ClassDescription.ts

@@ -47,7 +47,7 @@
  * For example, `./my-reporter:MyReporter` would be interpreted as a request to load the `MyReporter` type from `./my-reporter` file, located
  * relative to the [working directory](https://nodejs.org/api/process.html#processcwd) of the current Node.js process.
  *
- * @group Configuration
+ * @group Serenity
  */
 export type ClassDescription =
     string |            // e.g. '@serenity-js/core:StreamReporter'

package/src/config/SerenityConfig.ts

@@ -14,7 +14,7 @@ import { ClassDescription } from './ClassDescription';
  * - {@apilink ClassDescription}
  * - {@apilink Stage.waitForNextCue}
  *
- * @group Configuration
+ * @group Serenity
  */
 export abstract class SerenityConfig {
 

package/src/errors/ListItemNotFoundError.ts

@@ -0,0 +1,35 @@
+import { JSONObject } from 'tiny-types';
+
+import { ErrorSerialiser } from './ErrorSerialiser';
+import { RuntimeError } from './RuntimeError';
+
+/**
+ * Thrown to indicate that an {@apilink Interaction}, a {@apilink Task} or a test scenario
+ * can't be executed due to no items are found in a list.
+ *
+ * For example, it's not possible to get the first() or the last() item of a list
+ * if the list is empty.
+ *
+ * @group Errors
+ */
+export class ListItemNotFoundError extends RuntimeError {
+
+    static fromJSON(serialised: JSONObject): ListItemNotFoundError {
+        const error = new ListItemNotFoundError(
+            serialised.message as string,
+            ErrorSerialiser.deserialise(serialised.cause as string | undefined),
+        );
+
+        error.stack = serialised.stack as string;
+
+        return error;
+    }
+
+    /**
+     * @param message - Human-readable description of the error
+     * @param [cause] - The root cause of this {@apilink ListItemNotFoundError}, if any
+     */
+    constructor(message: string, cause?: Error) {
+        super(ListItemNotFoundError, message, cause);
+    }
+}

package/src/errors/index.ts

@@ -22,6 +22,7 @@ export { ConfigurationError } from './ConfigurationError';
 export { ErrorSerialiser } from './ErrorSerialiser';
 export { ErrorStackParser } from './ErrorStackParser';
 export { ImplementationPendingError } from './ImplementationPendingError';
+export { ListItemNotFoundError } from './ListItemNotFoundError';
 export { LogicError } from './LogicError';
 export { RuntimeError } from './RuntimeError';
 export { TestCompromisedError } from './TestCompromisedError';

package/src/io/format.ts

@@ -56,7 +56,7 @@ import { inspected } from './inspected';
  * @param config
  *  `markQuestions`: boolean - if set to true, descriptions of questions passed in as arguments will be surrounded with double angled brackets, i.e. `<<description>>`
  *
- * @group Answerables
+ * @group Questions
  */
 export function format(config: { markQuestions: boolean }): (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>) => string {
     return (templates: TemplateStringsArray, ...placeholders: Array<Answerable<any>>): string => {
@@ -69,8 +69,8 @@ export function format(config: { markQuestions: boolean }): (templates: Template
     }
 }
 
-/** @group Answerables */
+/** @group Questions */
 export const f = format({ markQuestions: true });
 
-/** @group Answerables */
+/** @group Questions */
 export const d = format({ markQuestions: false });

package/src/screenplay/Ability.ts

@@ -157,7 +157,7 @@
  * - {@apilink CallAnApi}
  * - {@apilink TakeNotes}
  *
- * @group Screenplay Pattern
+ * @group Abilities
  */
 export interface Ability {  // eslint-disable-line @typescript-eslint/no-empty-interface
 }

package/src/screenplay/Activity.ts

@@ -13,7 +13,7 @@ import { AnswersQuestions, PerformsActivities, UsesAbilities } from './actor';
  * - {@apilink PerformsActivities}
  * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export abstract class Activity {
 

package/src/screenplay/Answerable.ts

@@ -4,6 +4,6 @@ import { Question } from './Question';
  * A union type that provides a convenient way to represent any value
  * that can be resolved by {@apilink Actor.answer}.
  *
- * @group Answerables
+ * @group Questions
  */
 export type Answerable<T> = Question<Promise<T>> | Question<T> | Promise<T> | T;

package/src/screenplay/Answered.ts

@@ -8,7 +8,7 @@ import { Question } from './Question';
  * Answered<Answerable<T>> === T
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export type Answered<T> =
     T extends null | undefined ? T :          // special case for `null | undefined` when not in `--strictNullChecks` mode

package/src/screenplay/Interaction.ts

@@ -41,7 +41,7 @@ import { Actor, AnswersQuestions, CollectsArtifacts, UsesAbilities } from './act
  *   )
  * ```
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export abstract class Interaction extends Activity {
 

package/src/screenplay/Optional.ts

@@ -15,7 +15,7 @@ import { Answerable } from './Answerable';
  *   and if all the links of the property chain leading to the entry of interest exist too
  *   (so `books` is present, and so is `books[0]`, `books[0].author`, `books[0].author.name`).
  *
- * @group Answerables
+ * @group Questions
  */
 export interface Optional {
     /**

package/src/screenplay/Question.ts

@@ -99,7 +99,7 @@ import { WithAnswerableProperties } from './WithAnswerableProperties';
  * - {@apilink Ability}
  * - {@apilink QuestionAdapter}
  *
- * @group Screenplay Pattern
+ * @group Questions
  */
 export abstract class Question<T> {
 
@@ -378,7 +378,7 @@ declare global {
  * - both methods and fields of the wrapped object can be used as {@apilink Question|questions} or {@apilink Interactions|interactions}
  * - method parameters of the wrapped object will accept {@apilink Answerable|Answerable<T>}
  *
- * @group Answerables
+ * @group Questions
  */
 export type QuestionAdapterFieldDecorator<Original_Type> = {
     [Field in keyof Omit<Original_Type, keyof QuestionStatement<Original_Type>>]:
@@ -400,7 +400,7 @@ export type QuestionAdapterFieldDecorator<Original_Type> = {
  * {@apilink QuestionAdapter} proxies the methods and fields of the wrapped object recursively,
  * allowing them to be used as either a {@apilink Question} or an {@apilink Interaction}.
  *
- * @group Answerables
+ * @group Questions
  */
 export type QuestionAdapter<T> =
     & Question<Promise<T>>

package/src/screenplay/RecursivelyAnswered.ts

@@ -33,7 +33,7 @@ import { Question } from './Question';
  * // RequestConfiguration === RecursivelyAnswered<WithAnswerableProperties<RequestConfiguration>>
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export type RecursivelyAnswered<T> =
     T extends null | undefined ? T :          // special case for `null | undefined` when not in `--strictNullChecks` mode

package/src/screenplay/Task.ts

@@ -53,7 +53,7 @@ import { PerformsActivities } from './actor';
  * - {@apilink Activity}
  * - {@apilink Actor}
  *
- * @group Screenplay Pattern
+ * @group Activities
  */
 export abstract class Task extends Activity {
 

package/src/screenplay/WithAnswerableProperties.ts

@@ -26,7 +26,7 @@ import { Question } from './Question';
  * const answer: RequestConfiguration = await actorCalled('Annie').answer(question);
  * ```
  *
- * @group Answerables
+ * @group Questions
  */
 export type WithAnswerableProperties<T> =
     T extends null | undefined ? T :

package/src/screenplay/actor/Actor.ts

@@ -21,7 +21,7 @@ import { UsesAbilities } from './UsesAbilities';
  * - {@apilink Cast}
  * - {@apilink Stage}
  *
- * @group Screenplay Pattern
+ * @group Actors
  */
 export class Actor implements
     PerformsActivities,

package/src/screenplay/interactions/Wait.ts

@@ -1,6 +1,6 @@
 import { ensure, isGreaterThanOrEqualTo, isInRange } from 'tiny-types';
 
-import { AssertionError, TimeoutExpiredError } from '../../errors';
+import { AssertionError, ListItemNotFoundError, TimeoutExpiredError } from '../../errors';
 import { d } from '../../io';
 import { Duration } from '../../model';
 import { AnswersQuestions, UsesAbilities } from '../actor';
@@ -252,7 +252,7 @@ export class WaitUntil<Actual> extends Interaction {
     pollingEvery(interval: Duration): Interaction {
         return new WaitUntil(this.actual, this.expectation, this.timeout, interval);
     }
-
+   
     /**
      * @inheritDoc
      */
@@ -268,8 +268,8 @@ export class WaitUntil<Actual> extends Interaction {
         }
 
         const timeout = timeoutAfter(this.timeout);
-        const poller  = waitUntil(expectation, this.pollingInterval);
-
+        const poller = waitUntil(expectation, this.pollingInterval);
+    
         return Promise.race([
             timeout.start(),
             poller.start(),
@@ -320,25 +320,33 @@ function waitUntil(expectation: () => Promise<boolean> | boolean, pollingInterva
     let pollingActive = false;
 
     async function poll(): Promise<void> {
+        
+        async function nextPollingInterval(): Promise<void> {
+            if (pollingActive) {
+                delay = waitFor(pollingInterval);
+                await delay.start();
+                await poll();
+            }
+        }
+
         try {
             const expectationIsMet = await expectation();
-
             if (expectationIsMet) {
                 delay?.stop();
                 return;
             }
+            await nextPollingInterval();
+        } catch (error) {
+            delay?.stop();
 
-            if (pollingActive) {
-                delay = waitFor(pollingInterval);
-
-                await delay.start();
-
-                await poll();
+            if (error instanceof ListItemNotFoundError) {
+                await nextPollingInterval();
+                return;
             }
-        } catch (error) {
-            delay?.stop()
+
             throw error;
         }
+
     }
 
     return {

package/src/screenplay/questions/List.ts

@@ -1,4 +1,4 @@
-import { LogicError } from '../../errors';
+import { ListItemNotFoundError, LogicError } from '../../errors';
 import { d } from '../../io';
 import { Actor, AnswersQuestions, UsesAbilities } from '../actor';
 import { Answerable } from '../Answerable';
@@ -61,7 +61,7 @@ export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
             const items = await this.answeredBy(actor);
 
             if (items.length === 0) {
-                throw new LogicError(d`Can't retrieve the first item from a list with 0 items: ${ items }`)
+                throw new ListItemNotFoundError(d`Can't retrieve the first item from a list with 0 items: ${ items }`)
             }
 
             return items[0];
@@ -73,7 +73,7 @@ export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
             const items = await this.answeredBy(actor);
 
             if (items.length === 0) {
-                throw new LogicError(d`Can't retrieve the last item from a list with 0 items: ${ items }`)
+                throw new ListItemNotFoundError(d`Can't retrieve the last item from a list with 0 items: ${ items }`)
             }
 
             return items[items.length - 1];
@@ -85,7 +85,7 @@ export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
             const items = await this.answeredBy(actor);
 
             if (index < 0 || items.length <= index) {
-                throw new LogicError(`Can't retrieve the ${ ordinal(index) } item from a list with ${ items.length } items: ` + d`${ items }`)
+                throw new ListItemNotFoundError(`Can't retrieve the ${ ordinal(index) } item from a list with ${ items.length } items: ` + d`${ items }`)
             }
 
             return items[index];

package/src/screenplay/questions/MetaQuestion.ts

@@ -13,7 +13,7 @@ import { Question } from '../Question';
  * ## Learn more
  * - {@apilink List}
  *
- * @group Answerables
+ * @group Questions
  */
 export interface MetaQuestion<Supported_Answerable_Type extends Answerable<any>, Answer> {
 

package/src/screenplay/questions/q.ts

@@ -58,7 +58,7 @@ import { Question, QuestionAdapter } from '../Question';
  * - {@apilink Question.describedAs}
  * - {@apilink QuestionAdapter}
  *
- * @group Answerables
+ * @group Questions
  *
  * @param templates
  * @param parameters

package/src/stage/crew/artifact-archiver/ArtifactArchiver.ts

@@ -70,11 +70,12 @@ import { Hash } from './Hash';
  *         ]
  *         // other Serenity/JS config
  *     },
- *   },
- *   // other WebdriverIO config
+ *     // other WebdriverIO config
  * }
  * ```
  *
+ * [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *
  * @group Stage
  */
 export class ArtifactArchiver implements StageCrewMember {

package/src/stage/queues/DomainEventQueue.ts

@@ -4,7 +4,7 @@ import { DomainEvent } from '../../events';
 import { CorrelationId } from '../../model';
 
 /**
- * @package
+ * @group Stage
  */
 export class DomainEventQueue {
     private readonly queue: Array<DomainEvent & { sceneId: CorrelationId }>;

package/src/stage/queues/DomainEventQueues.ts

@@ -5,7 +5,7 @@ import { CorrelationId, ScenarioDetails } from '../../model';
 import { DomainEventQueue } from './DomainEventQueue';
 
 /**
- * @package
+ * @group Stage
  */
 export class DomainEventQueues {