@serenity-js/core 3.9.1 → 3.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,25 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [3.10.1](https://github.com/serenity-js/serenity-js/compare/v3.10.0...v3.10.1) (2023-09-01)
7
+
8
+ **Note:** Version bump only for package @serenity-js/core
9
+
10
+
11
+
12
+
13
+
14
+ # [3.10.0](https://github.com/serenity-js/serenity-js/compare/v3.9.1...v3.10.0) (2023-08-23)
15
+
16
+
17
+ ### Features
18
+
19
+ * **web:** chainable `PageElements` ([#1864](https://github.com/serenity-js/serenity-js/issues/1864)) ([4d0c7eb](https://github.com/serenity-js/serenity-js/commit/4d0c7eb97c24fe3ae1eed702773cf3b80f104947))
20
+
21
+
22
+
23
+
24
+
6
25
  ## [3.9.1](https://github.com/serenity-js/serenity-js/compare/v3.9.0...v3.9.1) (2023-08-18)
7
26
 
8
27
 
@@ -176,14 +176,15 @@ export declare abstract class Question<T> {
176
176
  * )
177
177
  * )
178
178
  * );
179
- *
180
- * @param source
181
- * @param overrides
179
+ * ```
182
180
  *
183
181
  * #### Learn more
184
182
  * - {@apilink WithAnswerableProperties}
185
183
  * - {@apilink RecursivelyAnswered}
186
184
  * - {@apilink Answerable}
185
+ *
186
+ * @param source
187
+ * @param overrides
187
188
  */
188
189
  static fromObject<Source_Type extends object>(source: Answerable<WithAnswerableProperties<Source_Type>>, ...overrides: Array<Answerable<Partial<WithAnswerableProperties<Source_Type>>>>): QuestionAdapter<RecursivelyAnswered<Source_Type>>;
189
190
  /**
@@ -193,6 +194,13 @@ export declare abstract class Question<T> {
193
194
  * The value to check
194
195
  */
195
196
  static isAQuestion<T>(maybeQuestion: unknown): maybeQuestion is Question<T>;
197
+ /**
198
+ * Checks if the value is a {@apilink MetaQuestion}.
199
+ *
200
+ * @param maybeMetaQuestion
201
+ * The value to check
202
+ */
203
+ static isAMetaQuestion<CT, RQT extends Question<unknown>>(maybeMetaQuestion: unknown): maybeMetaQuestion is MetaQuestion<CT, RQT>;
196
204
  protected static createAdapter<AT>(statement: Question<AT>): QuestionAdapter<Awaited<AT>>;
197
205
  private static fieldDescription;
198
206
  private static methodDescription;
@@ -257,7 +265,7 @@ export type QuestionAdapter<Answer_Type> = Question<Promise<Answer_Type>> & Inte
257
265
  *
258
266
  * @group Questions
259
267
  */
260
- export type MetaQuestionAdapter<Context_Type, Answer_Type> = QuestionAdapter<Answer_Type> & MetaQuestion<Context_Type, Answer_Type>;
268
+ export type MetaQuestionAdapter<Context_Type, Answer_Type> = QuestionAdapter<Answer_Type> & MetaQuestion<Context_Type, QuestionAdapter<Answer_Type>>;
261
269
  /**
262
270
  * @package
263
271
  */
@@ -1 +1 @@
1
- {"version":3,"file":"Question.d.ts","sourceRoot":"","sources":["../../src/screenplay/Question.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Question.d.ts","sourceRoot":"","sources":["../../src/screenplay/Question.ts"],"names":[],"mappings":"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"}
@@ -185,14 +185,15 @@ class Question {
185
185
  * )
186
186
  * )
187
187
  * );
188
- *
189
- * @param source
190
- * @param overrides
188
+ * ```
191
189
  *
192
190
  * #### Learn more
193
191
  * - {@apilink WithAnswerableProperties}
194
192
  * - {@apilink RecursivelyAnswered}
195
193
  * - {@apilink Answerable}
194
+ *
195
+ * @param source
196
+ * @param overrides
196
197
  */
197
198
  static fromObject(source, ...overrides) {
198
199
  return Question.about('value', async (actor) => {
@@ -216,6 +217,17 @@ class Question {
216
217
  return !!maybeQuestion
217
218
  && typeof maybeQuestion.answeredBy === 'function';
218
219
  }
220
+ /**
221
+ * Checks if the value is a {@apilink MetaQuestion}.
222
+ *
223
+ * @param maybeMetaQuestion
224
+ * The value to check
225
+ */
226
+ static isAMetaQuestion(maybeMetaQuestion) {
227
+ return !!maybeMetaQuestion
228
+ && typeof maybeMetaQuestion['of'] === 'function'
229
+ && maybeMetaQuestion['of'].length === 1; // arity of 1
230
+ }
219
231
  static createAdapter(statement) {
220
232
  function getStatement() {
221
233
  return statement;
@@ -383,7 +395,7 @@ class MetaQuestionStatement extends QuestionStatement {
383
395
  this.metaQuestionBody = metaQuestionBody;
384
396
  }
385
397
  of(answerable) {
386
- return Question.about((0, io_1.d) `${this.toString()} of ${answerable}`, actor => actor.answer(this.metaQuestionBody(answerable)));
398
+ return Question.about(this.toString() + (0, io_1.d) ` of ${answerable}`, actor => actor.answer(this.metaQuestionBody(answerable)));
387
399
  }
388
400
  }
389
401
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"Question.js","sourceRoot":"","sources":["../../src/screenplay/Question.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAkD;AAClD,2CAA6B,CAAC,2CAA2C;AAEzE,sCAAuC;AAEvC,8BAA8C;AAG9C,+CAA4C;AAI5C,uDAAoD;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,MAAsB,QAAQ;IA6B1B,MAAM,CAAC,KAAK,CACR,WAAmB,EACnB,IAAqF,EACrF,gBAAuF;QAGvF,MAAM,SAAS,GAAG,OAAO,gBAAgB,KAAK,UAAU;YACpD,CAAC,CAAC,IAAI,qBAAqB,CAAC,WAAW,EAAE,IAAI,EAAE,gBAAgB,CAAC;YAChE,CAAC,CAAC,IAAI,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAE/C,OAAO,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6DG;IACH,MAAM,CAAC,UAAU,CACb,MAAyD,EACzD,GAAG,SAA4E;QAE/E,OAAO,QAAQ,CAAC,KAAK,CAAmC,OAAO,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC3E,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE;gBACzC,OAAO,MAAM,CAAC;aACjB;YAED,MAAM,OAAO,GAAqD,EAAE,CAAC;YAErE,KAAK,MAAM,CAAE,CAAC,EAAE,aAAa,CAAE,IAAI,CAAE,MAAM,EAAE,GAAG,SAAS,CAAE,CAAC,OAAO,EAAE,EAAE;gBACnE,OAAO,CAAC,IAAI,CACR,MAAM,iBAAiB,CAAC,KAAK,EAAE,aAAoB,EAAE,YAAa,CAAE,EAAE,CAAyD,CAClI,CAAC;aACL;YAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAI,aAAsB;QACxC,OAAO,CAAC,CAAE,aAAa;eAChB,OAAQ,aAAqB,CAAC,UAAU,KAAK,UAAU,CAAC;IACnE,CAAC;IAES,MAAM,CAAC,aAAa,CAAK,SAAuB;QACtD,SAAS,YAAY;YACjB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE;YACtD,MAAM,CAAC,cAAc;YACjB,kFAAkF;YAClF,YAAY,EACZ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBACjB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrD,QAAQ,EAAE,KAAK;aAClB,CAAC,CAAA;SACT;QAED,OAAO,IAAI,KAAK,CAA4C,YAAY,EAAE;YAEtE,GAAG,CAAC,gBAAoC,EAAE,GAAoB,EAAE,QAAa;gBACzE,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAElC,IAAI,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;iBACnD;gBAED,IAAI,GAAG,KAAK,MAAM,CAAC,WAAW,EAAE;oBAC5B,OAAO,CAAC,KAAsC,EAAE,EAAE;wBAC9C,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC7B,CAAC,CAAC;iBACL;gBAED,IAAI,GAAG,IAAI,MAAM,EAAE;oBAEf,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBAEvC,MAAM,UAAU,GAAG,OAAO,KAAK,IAAI,UAAU,CAAA;oBAC7C,MAAM,sBAAsB,GAAG,UAAU;2BAClC,MAAM,YAAY,iBAAiB;2BACnC,GAAG,KAAK,aAAa,CAAC,CAAG,4FAA4F;oBAE5H,IAAI,sBAAsB,EAAE;wBACxB,sDAAsD;wBACtD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;qBAC9B;oBAED,OAAO,UAAU;wBACb,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;wBACpB,CAAC,CAAC,KAAK,CAAC;iBACf;gBAED,IAAI,GAAG,KAAK,MAAM,EAAE;oBAChB,OAAO;iBACV;gBAED,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,KAAuC,EAAE,EAAE;oBAC5G,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAwB,CAAC,CAAC;oBAE5D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;wBACpB,OAAO,SAAS,CAAC,CAAO,mDAAmD;qBAC9E;oBAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;oBAE1B,OAAO,OAAO,KAAK,KAAK,UAAU;wBAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;wBACpB,CAAC,CAAC,KAAK,CAAC;gBAChB,CAAC,CAAC,CAAC;YACP,CAAC;YAED,GAAG,CAAC,gBAAoC,EAAE,GAAoB,EAAE,KAAU,EAAE,QAAa;gBACrF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAElC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAED,KAAK,CAAC,gBAAoC,EAAE,aAAkB,EAAE,UAAqB;gBACjF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAElC,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;oBAChF,MAAM,MAAM,GAAG,EAAS,CAAC;oBACzB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;wBAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;wBAC/C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;qBACzB;oBAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAEzC,OAAO,OAAO,KAAK,KAAK,UAAU;wBAC9B,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;wBAClB,CAAC,CAAC,KAAK,CAAC;gBAChB,CAAC,CAAC,CAAC;YACP,CAAC;YAED,cAAc,CAAC,gBAAoC;gBAC/C,OAAO,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACtD,CAAC;SACJ,CAAQ,CAAC;IACd,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAK,MAAoB,EAAE,GAAoB;QAE1E,qDAAqD;QACrD,IAAI,GAAG,KAAK,IAAI,EAAE;YACd,OAAO,GAAI,MAAO,IAAK,GAAI,EAAE,CAAC;SACjC;QAED,MAAM,eAAe,GAAG,IAAA,MAAC,EAAA,GAAI,MAAO,EAAE,CAAC;QAEvC,MAAM,gBAAgB,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3E,CAAC,CAAC,IAAK,MAAM,CAAC,GAAG,CAAE,GAAG,CAAE,cAAc;YACtC,CAAC,CAAC,IAAK,MAAM,CAAC,GAAG,CAAE,EAAE,CAAC,CAAE,oBAAoB;QAEhD,OAAO,GAAI,eAAgB,GAAI,gBAAiB,EAAE,CAAC;IACvD,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAK,MAAoB,EAAE,UAAqB;QAE5E,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAE5C,0DAA0D;QAC1D,IAAI,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9D,OAAO,GAAI,iBAAkB,IAAK,UAAU,CAAC,CAAC,CAAE,EAAE,CAAC;SACtD;QAED,MAAM,qBAAqB,GAAG;YAC1B,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,MAAC,EAAA,GAAI,CAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG;SACtD,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEX,OAAO,GAAI,iBAAkB,GAAI,qBAAsB,EAAE,CAAC;IAC9D,CAAC;IAoBD;;;;;;;;;OASG;IACI,EAAE,CAAI,OAA+C;QACxD,OAAO,QAAQ,CAAC,KAAK,CAAI,IAAA,MAAC,EAAA,GAAI,IAAK,OAAQ,OAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAClE,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAe,CAAC;YACxD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA5SD,4BA4SC;AA2DD;;GAEG;AACH,MAAM,iBAA+B,SAAQ,yBAAW;IAIpD,YACY,OAAe,EACN,IAAoG,EACrH,WAA+B,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;QAElE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAJjB,YAAO,GAAP,OAAO,CAAQ;QACN,SAAI,GAAJ,IAAI,CAAgG;QAJjH,WAAM,GAA6B,IAAI,uBAAU,EAAE,CAAC;IAQ5D,CAAC;IAED;;;OAGG;IACH,SAAS;QACL,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAuC;QACnD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,OAAoC,EAAE,OAA4B;QACnG,OAAO,IAAA,oBAAe,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEQ,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,EAAE,CAAI,OAA2D;QAC7D,OAAO,QAAQ,CAAC,KAAK,CAAI,IAAA,MAAC,EAAA,GAAI,IAAK,OAAQ,OAAQ,GAAG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAClE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAExC,IAAI,CAAE,SAAS,CAAC,MAAM,CAAC,EAAE;gBACrB,OAAO,SAAS,CAAC,CAAG,mDAAmD;aAC1E;YAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,qBACF,SAAQ,iBAA8B;IAGtC,YACI,OAAe,EACf,IAAoG,EACnF,gBAAkG;QAEnH,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFJ,qBAAgB,GAAhB,gBAAgB,CAAkF;IAGvH,CAAC;IAED,EAAE,CAAC,UAA8C;QAC7C,OAAO,QAAQ,CAAC,KAAK,CACjB,IAAA,MAAC,EAAA,GAAI,IAAI,CAAC,QAAQ,EAAG,OAAQ,UAAW,EAAE,EAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAC3D,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,SAAa,SAAQ,QAA0B;IAIjD,YAA6B,QAAqB;QAC9C,KAAK,EAAE,CAAC;QADiB,aAAQ,GAAR,QAAQ,CAAa;QAE9C,IAAI,CAAC,OAAO,GAAG,IAAA,MAAC,EAAA,GAAG,QAAQ,cAAc,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,IAAI;YACA,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE;gBACzC,OAAO,KAAK,CAAC;aAChB;YAED,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;gBACzB,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;aACjD;YAED,OAAO,IAAI,CAAC;SACf;QAAC,MAAM;YACJ,OAAO,KAAK,CAAC;SAChB;IACL,CAAC;IAEO,UAAU,CAAC,aAAkB;QACjC,OAAO,OAAO,aAAa,KAAK,QAAQ;eACjC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACnD,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,SAAS,SAAS,CAAI,KAAQ;IAC1B,OAAO,KAAK,KAAK,SAAS;WACnB,KAAK,KAAK,IAAI,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC5B,KAAuC,EACvC,UAAyD,EACzD,WAAmB,EACnB,gBAAgB,GAAG,CAAC;IAEpB,IAAI,gBAAgB,IAAI,sBAAsB,EAAE;QAC5C,MAAM,IAAI,mBAAU,CAAC,kDAAmD,sBAAuB,4CAA6C,WAAY,uCAAuC,CAAC,CAAC;KACpM;IAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAQ,CAAC;IAErD,IAAI,IAAA,kBAAQ,EAAC,MAAM,CAAC,EAAE;QAClB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,eAAe,GAAG,EAAE,CAAC;QAE3B,KAAK,MAAM,CAAE,GAAG,EAAE,KAAK,CAAE,IAAI,OAAO,EAAE;YAClC,eAAe,CAAC,IAAI,CAAC,CAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC,KAAK,EAAE,KAAY,EAAE,WAAW,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;SAClH;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,eAAe,CAAiB,CAAC;KAC9D;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACvB,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE;YACvB,eAAe,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,GAAG,CAAC,CAAM,CAAC,CAAC;SACtG;QAED,OAAO,eAA0C,CAAC;KACrD;IAED,OAAO,MAAsB,CAAC;AAClC,CAAC"}
1
+ {"version":3,"file":"Question.js","sourceRoot":"","sources":["../../src/screenplay/Question.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import type { Answerable } from '../Answerable';
2
+ import type { Question } from '../Question';
3
+ import type { MetaQuestion } from './MetaQuestion';
4
+ /**
5
+ * A chainable meta-question is a {@apilink MetaQuestion} that can be answered
6
+ * in the context of another {@apilink Answerable},
7
+ * and form a chain of transformations.
8
+ *
9
+ * {@apilink MetaQuestion|Meta questions} are typically used when filtering a {@apilink List}.
10
+ *
11
+ * ## Learn more
12
+ * - {@apilink List}
13
+ *
14
+ * @group Questions
15
+ */
16
+ export interface ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type extends Question<unknown>> extends MetaQuestion<Supported_Context_Type, Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>> {
17
+ /**
18
+ * Answers the given `ChainableMetaQuestion` in the context of another {@apilink Answerable}
19
+ * and returns another `ChainableMetaQuestion` ready for further chaining.
20
+ *
21
+ * #### Learn more
22
+ * - {@apilink List}
23
+ */
24
+ of(context: Answerable<Supported_Context_Type>): Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>;
25
+ }
26
+ //# sourceMappingURL=ChainableMetaQuestion.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ChainableMetaQuestion.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/ChainableMetaQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB,CAClC,sBAAsB,EACtB,sBAAsB,SAAS,QAAQ,CAAC,OAAO,CAAC,CAClD,SAAQ,YAAY,CAAC,sBAAsB,EAAE,sBAAsB,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;IAE1I;;;;;;OAMG;IACH,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;CACnJ"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=ChainableMetaQuestion.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ChainableMetaQuestion.js","sourceRoot":"","sources":["../../../src/screenplay/questions/ChainableMetaQuestion.ts"],"names":[],"mappings":""}
@@ -1,33 +1,80 @@
1
1
  import type { UsesAbilities } from '../abilities';
2
2
  import type { Actor } from '../Actor';
3
3
  import type { Answerable } from '../Answerable';
4
- import type { QuestionAdapter } from '../Question';
4
+ import type { MetaQuestionAdapter, QuestionAdapter } from '../Question';
5
5
  import { Question } from '../Question';
6
- import type { AnswersQuestions } from '../questions';
6
+ import type { AnswersQuestions, ChainableMetaQuestion, MetaQuestion } from '../questions';
7
7
  import { Task } from '../Task';
8
8
  import type { Expectation } from './Expectation';
9
- import type { MetaQuestion } from './MetaQuestion';
10
9
  /**
11
10
  * Serenity/JS Screenplay Pattern-style wrapper around {@apilink Array}
12
11
  * and array-like structures - see {@apilink PageElements}.
13
12
  *
14
13
  * @group Questions
15
14
  */
16
- export declare class List<Item_Type> extends Question<Promise<Item_Type[]>> {
15
+ export declare abstract class List<Item_Type> extends Question<Promise<Item_Type[]>> {
17
16
  protected readonly collection: Answerable<Array<Item_Type>>;
18
- private subject;
17
+ protected subject?: string;
18
+ static of<IT, CT, RQT extends (Question<Promise<Array<IT>>> | Question<Array<IT>>)>(collection: Answerable<Array<IT>> & ChainableMetaQuestion<CT, RQT>): MetaList<CT, IT>;
19
19
  static of<IT>(collection: Answerable<Array<IT>>): List<IT>;
20
20
  constructor(collection: Answerable<Array<Item_Type>>);
21
- eachMappedTo<Mapped_Item_Type>(question: MetaQuestion<Item_Type, Promise<Mapped_Item_Type> | Mapped_Item_Type>): List<Mapped_Item_Type>;
22
21
  forEach(callback: (current: CurrentItem<Item_Type>, index: number, items: Array<Item_Type>) => Promise<void> | void): Task;
23
- where<Answer_Type>(question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>, expectation: Expectation<Answer_Type>): this;
24
- count(): QuestionAdapter<number>;
25
- first(): QuestionAdapter<Item_Type>;
26
- last(): QuestionAdapter<Item_Type>;
27
- nth(index: number): QuestionAdapter<Item_Type>;
22
+ abstract eachMappedTo<Mapped_Item_Type>(question: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>): List<Mapped_Item_Type>;
23
+ abstract where<Answer_Type>(question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>, expectation: Expectation<Answer_Type>): List<Item_Type>;
24
+ abstract count(): QuestionAdapter<number>;
25
+ abstract first(): QuestionAdapter<Item_Type>;
26
+ abstract last(): QuestionAdapter<Item_Type>;
27
+ abstract nth(index: number): QuestionAdapter<Item_Type>;
28
28
  answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Array<Item_Type>>;
29
29
  describedAs(subject: string): this;
30
30
  toString(): string;
31
+ /**
32
+ * @param {number} index
33
+ */
34
+ protected ordinal(index: number): string;
35
+ }
36
+ /**
37
+ * Serenity/JS Screenplay Pattern-style wrapper around
38
+ * a {@apilink ChainableMetaQuestion} representing a collection
39
+ * that can be resolved in `Supported_Context_Type` of another {@apilink Question}.
40
+ *
41
+ * For example, {@apilink PageElements.located} returns `MetaList<PageElement>`,
42
+ * which allows for the collection of page elements to be resolved in the context
43
+ * of dynamically-provided root element.
44
+ *
45
+ * ```typescript
46
+ * import { By, PageElements, PageElement } from '@serenity-js/web'
47
+ *
48
+ * const firstLabel = () =>
49
+ * PageElements.located(By.css('label'))
50
+ * .first()
51
+ * .describedAs('first label')
52
+ *
53
+ * const exampleForm = () =>
54
+ * PageElement.located(By.css('form#example1'))
55
+ * .describedAs('example form')
56
+ *
57
+ * const anotherExampleForm = () =>
58
+ * PageElement.located(By.css('form#example2'))
59
+ * .describedAs('another example form')
60
+ *
61
+ * // Next, you can compose the above questions dynamically with various "contexts":
62
+ * // firstLabel().of(exampleForm())
63
+ * // firstLabel().of(anotherExampleForm())
64
+ * ```
65
+ *
66
+ * @group Questions
67
+ */
68
+ export declare class MetaList<Supported_Context_Type, Item_Type> extends List<Item_Type> implements ChainableMetaQuestion<Supported_Context_Type, MetaList<Supported_Context_Type, Item_Type>> {
69
+ protected readonly collection: Answerable<Array<Item_Type>> & ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>;
70
+ constructor(collection: Answerable<Array<Item_Type>> & ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>);
71
+ of(context: Answerable<Supported_Context_Type>): MetaList<Supported_Context_Type, Item_Type>;
72
+ eachMappedTo<Mapped_Item_Type>(question: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>): MetaList<Supported_Context_Type, Mapped_Item_Type>;
73
+ where<Answer_Type>(question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>, expectation: Expectation<Answer_Type>): MetaList<Supported_Context_Type, Item_Type>;
74
+ count(): MetaQuestionAdapter<Supported_Context_Type, number>;
75
+ first(): MetaQuestionAdapter<Supported_Context_Type, Item_Type>;
76
+ last(): MetaQuestionAdapter<Supported_Context_Type, Item_Type>;
77
+ nth(index: number): MetaQuestionAdapter<Supported_Context_Type, Item_Type>;
31
78
  }
32
79
  /**
33
80
  * @group Questions
@@ -1 +1 @@
1
- {"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,IAAI,CAAC,SAAS,CAAE,SAAQ,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAQ3D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAP/D,OAAO,CAAC,OAAO,CAAS;IAExB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;gBAKnC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAM/D,YAAY,CAAC,gBAAgB,EACzB,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC,GAChF,IAAI,CAAC,gBAAgB,CAAC;IAMzB,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI1H,KAAK,CAAC,WAAW,EACb,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,EACrE,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,GACtC,IAAI;IAMP,KAAK,IAAI,eAAe,CAAC,MAAM,CAAC;IAOhC,KAAK,IAAI,eAAe,CAAC,SAAS,CAAC;IAYnC,IAAI,IAAI,eAAe,CAAC,SAAS,CAAC;IAYlC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC;IAYxC,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAUpF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,QAAQ,IAAI,MAAM;CAGrB;AAyID;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CAChB"}
1
+ {"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.List = void 0;
3
+ exports.MetaList = exports.List = void 0;
4
4
  const errors_1 = require("../../errors");
5
5
  const io_1 = require("../../io");
6
6
  const Question_1 = require("../Question");
@@ -14,30 +14,68 @@ const expectations_1 = require("./expectations");
14
14
  */
15
15
  class List extends Question_1.Question {
16
16
  static of(collection) {
17
- return new List(collection);
17
+ if (Question_1.Question.isAMetaQuestion(collection)) {
18
+ return new MetaList(collection);
19
+ }
20
+ return new ArrayList(collection);
18
21
  }
19
22
  constructor(collection) {
20
23
  super();
21
24
  this.collection = collection;
22
- this.subject = (0, io_1.d) `${collection}`;
23
- }
24
- eachMappedTo(question) {
25
- return new List(new EachMappedTo(this.collection, question, this.subject));
26
25
  }
27
26
  forEach(callback) {
28
- return new ForEachLoop(this.collection, this.subject, callback);
27
+ return new ForEachLoop(this.collection, this.toString(), callback);
28
+ }
29
+ async answeredBy(actor) {
30
+ const collection = await actor.answer(this.collection);
31
+ if (!Array.isArray(collection)) {
32
+ throw new errors_1.LogicError((0, io_1.d) `A List has to wrap an Array-compatible object. ${collection} given.`);
33
+ }
34
+ return collection;
35
+ }
36
+ describedAs(subject) {
37
+ this.subject = subject;
38
+ return this;
39
+ }
40
+ toString() {
41
+ return this.subject ?? (0, io_1.d) `${this.collection}`;
42
+ }
43
+ /**
44
+ * @param {number} index
45
+ */
46
+ ordinal(index) {
47
+ const lastDigit = Math.abs(index) % 10, lastTwoDigits = Math.abs(index) % 100;
48
+ switch (true) {
49
+ case (lastDigit === 1 && lastTwoDigits !== 11):
50
+ return index + 'st';
51
+ case (lastDigit === 2 && lastTwoDigits !== 12):
52
+ return index + 'nd';
53
+ case (lastDigit === 3 && lastTwoDigits !== 13):
54
+ return index + 'rd';
55
+ default:
56
+ return index + 'th';
57
+ }
58
+ }
59
+ }
60
+ exports.List = List;
61
+ /**
62
+ * @package
63
+ */
64
+ class ArrayList extends List {
65
+ eachMappedTo(question) {
66
+ return new ArrayList(new EachMappedTo(this.collection, question, this.toString()));
29
67
  }
30
68
  where(question, expectation) {
31
- return new List(new Where(this.collection, question, expectation, this.subject));
69
+ return new ArrayList(new Where(this.collection, question, expectation, this.toString()));
32
70
  }
33
71
  count() {
34
- return Question_1.Question.about(`the number of ${this.subject}`, async (actor) => {
72
+ return Question_1.Question.about(`the number of ${this.toString()}`, async (actor) => {
35
73
  const items = await this.answeredBy(actor);
36
74
  return items.length;
37
75
  });
38
76
  }
39
77
  first() {
40
- return Question_1.Question.about(`the first of ${this.subject}`, async (actor) => {
78
+ return Question_1.Question.about(`the first of ${this.toString()}`, async (actor) => {
41
79
  const items = await this.answeredBy(actor);
42
80
  if (items.length === 0) {
43
81
  throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the first item from a list with 0 items: ${items}`);
@@ -46,7 +84,7 @@ class List extends Question_1.Question {
46
84
  });
47
85
  }
48
86
  last() {
49
- return Question_1.Question.about(`the last of ${this.subject}`, async (actor) => {
87
+ return Question_1.Question.about(`the last of ${this.toString()}`, async (actor) => {
50
88
  const items = await this.answeredBy(actor);
51
89
  if (items.length === 0) {
52
90
  throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the last item from a list with 0 items: ${items}`);
@@ -55,47 +93,96 @@ class List extends Question_1.Question {
55
93
  });
56
94
  }
57
95
  nth(index) {
58
- return Question_1.Question.about(`the ${ordinal(index + 1)} of ${this.subject}`, async (actor) => {
96
+ return Question_1.Question.about(`the ${this.ordinal(index + 1)} of ${this.toString()}`, async (actor) => {
59
97
  const items = await this.answeredBy(actor);
60
98
  if (index < 0 || items.length <= index) {
61
- throw new errors_1.ListItemNotFoundError(`Can't retrieve the ${ordinal(index)} item from a list with ${items.length} items: ` + (0, io_1.d) `${items}`);
99
+ throw new errors_1.ListItemNotFoundError(`Can't retrieve the ${this.ordinal(index)} item from a list with ${items.length} items: ` + (0, io_1.d) `${items}`);
62
100
  }
63
101
  return items[index];
64
102
  });
65
103
  }
66
- async answeredBy(actor) {
67
- const collection = await actor.answer(this.collection);
68
- if (!Array.isArray(collection)) {
69
- throw new errors_1.LogicError((0, io_1.d) `A List has to wrap an Array-compatible object. ${collection} given.`);
70
- }
71
- return collection;
72
- }
73
- describedAs(subject) {
74
- this.subject = subject;
75
- return this;
76
- }
77
- toString() {
78
- return this.subject;
79
- }
80
104
  }
81
- exports.List = List;
82
105
  /**
83
- * @package
84
- * @param {number} index
106
+ * Serenity/JS Screenplay Pattern-style wrapper around
107
+ * a {@apilink ChainableMetaQuestion} representing a collection
108
+ * that can be resolved in `Supported_Context_Type` of another {@apilink Question}.
109
+ *
110
+ * For example, {@apilink PageElements.located} returns `MetaList<PageElement>`,
111
+ * which allows for the collection of page elements to be resolved in the context
112
+ * of dynamically-provided root element.
113
+ *
114
+ * ```typescript
115
+ * import { By, PageElements, PageElement } from '@serenity-js/web'
116
+ *
117
+ * const firstLabel = () =>
118
+ * PageElements.located(By.css('label'))
119
+ * .first()
120
+ * .describedAs('first label')
121
+ *
122
+ * const exampleForm = () =>
123
+ * PageElement.located(By.css('form#example1'))
124
+ * .describedAs('example form')
125
+ *
126
+ * const anotherExampleForm = () =>
127
+ * PageElement.located(By.css('form#example2'))
128
+ * .describedAs('another example form')
129
+ *
130
+ * // Next, you can compose the above questions dynamically with various "contexts":
131
+ * // firstLabel().of(exampleForm())
132
+ * // firstLabel().of(anotherExampleForm())
133
+ * ```
134
+ *
135
+ * @group Questions
85
136
  */
86
- function ordinal(index) {
87
- const lastDigit = Math.abs(index) % 10, lastTwoDigits = Math.abs(index) % 100;
88
- switch (true) {
89
- case (lastDigit === 1 && lastTwoDigits !== 11):
90
- return index + 'st';
91
- case (lastDigit === 2 && lastTwoDigits !== 12):
92
- return index + 'nd';
93
- case (lastDigit === 3 && lastTwoDigits !== 13):
94
- return index + 'rd';
95
- default:
96
- return index + 'th';
137
+ class MetaList extends List {
138
+ constructor(collection) {
139
+ super(collection);
140
+ this.collection = collection;
141
+ }
142
+ of(context) {
143
+ return new MetaList(this.collection.of(context)).describedAs(this.toString() + (0, io_1.d) ` of ${context}`);
144
+ }
145
+ eachMappedTo(question) {
146
+ return new MetaList(new MetaEachMappedTo(this.collection, question, this.toString()));
147
+ }
148
+ where(question, expectation) {
149
+ return new MetaList(new MetaWhere(this.collection, question, expectation, this.toString()));
150
+ }
151
+ count() {
152
+ return Question_1.Question.about(`the number of ${this.toString()}`, async (actor) => {
153
+ const items = await this.answeredBy(actor);
154
+ return items.length;
155
+ }, (parent) => this.of(parent).count());
156
+ }
157
+ first() {
158
+ return Question_1.Question.about(`the first of ${this.toString()}`, async (actor) => {
159
+ const items = await this.answeredBy(actor);
160
+ if (items.length === 0) {
161
+ throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the first item from a list with 0 items: ${items}`);
162
+ }
163
+ return items[0];
164
+ }, (parent) => this.of(parent).first());
165
+ }
166
+ last() {
167
+ return Question_1.Question.about(`the last of ${this.toString()}`, async (actor) => {
168
+ const items = await this.answeredBy(actor);
169
+ if (items.length === 0) {
170
+ throw new errors_1.ListItemNotFoundError((0, io_1.d) `Can't retrieve the last item from a list with 0 items: ${items}`);
171
+ }
172
+ return items.at(-1);
173
+ }, (parent) => this.of(parent).last());
174
+ }
175
+ nth(index) {
176
+ return Question_1.Question.about(`the ${this.ordinal(index + 1)} of ${this.toString()}`, async (actor) => {
177
+ const items = await this.answeredBy(actor);
178
+ if (index < 0 || items.length <= index) {
179
+ throw new errors_1.ListItemNotFoundError(`Can't retrieve the ${this.ordinal(index)} item from a list with ${items.length} items: ` + (0, io_1.d) `${items}`);
180
+ }
181
+ return items[index];
182
+ }, (parent) => this.of(parent).nth(index));
97
183
  }
98
184
  }
185
+ exports.MetaList = MetaList;
99
186
  /**
100
187
  * @package
101
188
  */
@@ -124,7 +211,7 @@ class Where extends Question_1.Question {
124
211
  return results;
125
212
  }
126
213
  catch (error) {
127
- throw new errors_1.LogicError((0, io_1.d) `Couldn't check if ${this.question} of an item of ${this.collection} does ${this.expectation}`, error);
214
+ throw new errors_1.LogicError((0, io_1.d) `Couldn't check if ${this.question} of an item of ${this.collection} does ${this.expectation}: ` + error.message, error);
128
215
  }
129
216
  }
130
217
  describedAs(subject) {
@@ -135,6 +222,14 @@ class Where extends Question_1.Question {
135
222
  return this.subject;
136
223
  }
137
224
  }
225
+ /**
226
+ * @package
227
+ */
228
+ class MetaWhere extends Where {
229
+ of(context) {
230
+ return new MetaWhere(this.collection.of(context), this.question, this.expectation, this.toString());
231
+ }
232
+ }
138
233
  /**
139
234
  * @package
140
235
  */
@@ -161,6 +256,14 @@ class EachMappedTo extends Question_1.Question {
161
256
  return this.subject;
162
257
  }
163
258
  }
259
+ /**
260
+ * @package
261
+ */
262
+ class MetaEachMappedTo extends EachMappedTo {
263
+ of(context) {
264
+ return new MetaEachMappedTo(this.collection.of(context), this.mapping, this.toString());
265
+ }
266
+ }
164
267
  /**
165
268
  * @package
166
269
  */
@@ -1 +1 @@
1
- {"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":";;;AAAA,yCAAiE;AACjE,iCAA6B;AAK7B,0CAAuC;AAEvC,kCAA+B;AAE/B,iDAAgD;AAGhD;;;;;GAKG;AACH,MAAa,IAAgB,SAAQ,mBAA8B;IAG/D,MAAM,CAAC,EAAE,CAAK,UAAiC;QAC3C,OAAO,IAAI,IAAI,CAAK,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,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;IAED,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,8BAAqB,CAAC,IAAA,MAAC,EAAA,2DAA4D,KAAM,EAAE,CAAC,CAAA;aACzG;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,8BAAqB,CAAC,IAAA,MAAC,EAAA,0DAA2D,KAAM,EAAE,CAAC,CAAA;aACxG;YAED,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,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,8BAAqB,CAAC,sBAAuB,OAAO,CAAC,KAAK,CAAE,0BAA2B,KAAK,CAAC,MAAO,UAAU,GAAG,IAAA,MAAC,EAAA,GAAI,KAAM,EAAE,CAAC,CAAA;aAC5I;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"}
1
+ {"version":3,"file":"List.js","sourceRoot":"","sources":["../../../src/screenplay/questions/List.ts"],"names":[],"mappings":"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"}
@@ -15,14 +15,14 @@ import type { Question } from '../Question';
15
15
  *
16
16
  * @group Questions
17
17
  */
18
- export interface MetaQuestion<Supported_Context_Type, Answer_Type> {
18
+ export interface MetaQuestion<Supported_Context_Type, Returned_Question_Type extends Question<unknown>> {
19
19
  /**
20
20
  * Answers the given `MetaQuestion` in the context of another {@apilink Answerable}.
21
21
  *
22
22
  * #### Learn more
23
23
  * - {@apilink List}
24
24
  */
25
- of(context: Answerable<Supported_Context_Type>): Question<Promise<Answer_Type>> | Question<Answer_Type>;
25
+ of(context: Answerable<Supported_Context_Type>): Returned_Question_Type;
26
26
  /**
27
27
  * Human-readable description of this {@apilink MetaQuestion},
28
28
  * typically involving the description of the subject.
@@ -1 +1 @@
1
- {"version":3,"file":"MetaQuestion.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/MetaQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,sBAAsB,EAAE,WAAW;IAE7D;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,sBAAsB,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAExG;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC;CACtB"}
1
+ {"version":3,"file":"MetaQuestion.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/MetaQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,sBAAsB,EAAE,sBAAsB,SAAS,QAAQ,CAAC,OAAO,CAAC;IAElG;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAAC;IAExE;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC;CACtB"}
@@ -1,4 +1,5 @@
1
1
  export * from './AnswersQuestions';
2
+ export * from './ChainableMetaQuestion';
2
3
  export * from './Check';
3
4
  export * from './Expectation';
4
5
  export * from './expectations';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,KAAK,CAAC;AACpB,cAAc,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,KAAK,CAAC;AACpB,cAAc,cAAc,CAAC"}
@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./AnswersQuestions"), exports);
18
+ __exportStar(require("./ChainableMetaQuestion"), exports);
18
19
  __exportStar(require("./Check"), exports);
19
20
  __exportStar(require("./Expectation"), exports);
20
21
  __exportStar(require("./expectations"), exports);
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,0CAAwB;AACxB,gDAA8B;AAC9B,iDAA+B;AAC/B,yCAAuB;AACvB,iDAA+B;AAC/B,sCAAoB;AACpB,+CAA6B"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,0DAAwC;AACxC,0CAAwB;AACxB,gDAA8B;AAC9B,iDAA+B;AAC/B,yCAAuB;AACvB,iDAA+B;AAC/B,sCAAoB;AACpB,+CAA6B"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@serenity-js/core",
3
- "version": "3.9.1",
3
+ "version": "3.10.1",
4
4
  "description": "Serenity/JS Screenplay, reporting engine and core interfaces.",
5
5
  "author": {
6
6
  "name": "Jan Molak",
@@ -50,7 +50,7 @@
50
50
  "@types/diff": "^5.0.3",
51
51
  "@types/filenamify": "^2.0.2",
52
52
  "@types/mocha": "^10.0.1",
53
- "@types/semver": "^7.5.0",
53
+ "@types/semver": "^7.5.1",
54
54
  "@types/validate-npm-package-name": "^4.0.0",
55
55
  "assertion-error-formatter": "^3.0.0",
56
56
  "c8": "8.0.1",
@@ -58,7 +58,7 @@
58
58
  "mocha": "^10.2.0",
59
59
  "mocha-multi": "^1.1.7",
60
60
  "ts-node": "^10.9.1",
61
- "typescript": "^5.1.6"
61
+ "typescript": "5.1.6"
62
62
  },
63
63
  "repository": {
64
64
  "type": "git",
@@ -71,5 +71,5 @@
71
71
  "engines": {
72
72
  "node": "^16.13 || ^18.12 || ^20"
73
73
  },
74
- "gitHead": "237e0291a7eca71e5f5c0777e1f9d637e8622113"
74
+ "gitHead": "7ab90f30b17ed745cad713363a27edfd7cdce08a"
75
75
  }
@@ -204,14 +204,15 @@ export abstract class Question<T> {
204
204
  * )
205
205
  * )
206
206
  * );
207
- *
208
- * @param source
209
- * @param overrides
207
+ * ```
210
208
  *
211
209
  * #### Learn more
212
210
  * - {@apilink WithAnswerableProperties}
213
211
  * - {@apilink RecursivelyAnswered}
214
212
  * - {@apilink Answerable}
213
+ *
214
+ * @param source
215
+ * @param overrides
215
216
  */
216
217
  static fromObject<Source_Type extends object>(
217
218
  source: Answerable<WithAnswerableProperties<Source_Type>>,
@@ -245,6 +246,18 @@ export abstract class Question<T> {
245
246
  && typeof (maybeQuestion as any).answeredBy === 'function';
246
247
  }
247
248
 
249
+ /**
250
+ * Checks if the value is a {@apilink MetaQuestion}.
251
+ *
252
+ * @param maybeMetaQuestion
253
+ * The value to check
254
+ */
255
+ static isAMetaQuestion<CT, RQT extends Question<unknown>>(maybeMetaQuestion: unknown): maybeMetaQuestion is MetaQuestion<CT, RQT> {
256
+ return !! maybeMetaQuestion
257
+ && typeof maybeMetaQuestion['of'] === 'function'
258
+ && maybeMetaQuestion['of'].length === 1; // arity of 1
259
+ }
260
+
248
261
  protected static createAdapter<AT>(statement: Question<AT>): QuestionAdapter<Awaited<AT>> {
249
262
  function getStatement() {
250
263
  return statement;
@@ -466,7 +479,7 @@ export type QuestionAdapter<Answer_Type> =
466
479
  */
467
480
  export type MetaQuestionAdapter<Context_Type, Answer_Type> =
468
481
  & QuestionAdapter<Answer_Type>
469
- & MetaQuestion<Context_Type, Answer_Type>
482
+ & MetaQuestion<Context_Type, QuestionAdapter<Answer_Type>>
470
483
 
471
484
  /**
472
485
  * @package
@@ -531,7 +544,7 @@ class QuestionStatement<Answer_Type> extends Interaction implements Question<Pro
531
544
  */
532
545
  class MetaQuestionStatement<Answer_Type, Supported_Context_Type extends Answerable<any>>
533
546
  extends QuestionStatement<Answer_Type>
534
- implements MetaQuestion<Supported_Context_Type, Answer_Type>
547
+ implements MetaQuestion<Supported_Context_Type, QuestionAdapter<Answer_Type>>
535
548
  {
536
549
  constructor(
537
550
  subject: string,
@@ -541,9 +554,9 @@ class MetaQuestionStatement<Answer_Type, Supported_Context_Type extends Answerab
541
554
  super(subject, body);
542
555
  }
543
556
 
544
- of(answerable: Answerable<Supported_Context_Type>): Question<Promise<Answer_Type>> | Question<Answer_Type> {
557
+ of(answerable: Answerable<Supported_Context_Type>): QuestionAdapter<Answer_Type> {
545
558
  return Question.about(
546
- d`${ this.toString() } of ${ answerable }`,
559
+ this.toString() + d` of ${ answerable }`,
547
560
  actor => actor.answer(this.metaQuestionBody(answerable))
548
561
  );
549
562
  }
@@ -0,0 +1,30 @@
1
+ import type { Answerable } from '../Answerable';
2
+ import type { Question } from '../Question';
3
+ import type { MetaQuestion } from './MetaQuestion';
4
+
5
+ /**
6
+ * A chainable meta-question is a {@apilink MetaQuestion} that can be answered
7
+ * in the context of another {@apilink Answerable},
8
+ * and form a chain of transformations.
9
+ *
10
+ * {@apilink MetaQuestion|Meta questions} are typically used when filtering a {@apilink List}.
11
+ *
12
+ * ## Learn more
13
+ * - {@apilink List}
14
+ *
15
+ * @group Questions
16
+ */
17
+ export interface ChainableMetaQuestion<
18
+ Supported_Context_Type,
19
+ Returned_Question_Type extends Question<unknown>
20
+ > extends MetaQuestion<Supported_Context_Type, Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>> {
21
+
22
+ /**
23
+ * Answers the given `ChainableMetaQuestion` in the context of another {@apilink Answerable}
24
+ * and returns another `ChainableMetaQuestion` ready for further chaining.
25
+ *
26
+ * #### Learn more
27
+ * - {@apilink List}
28
+ */
29
+ of(context: Answerable<Supported_Context_Type>): Returned_Question_Type & ChainableMetaQuestion<Supported_Context_Type, Returned_Question_Type>;
30
+ }
@@ -3,13 +3,12 @@ import { d } from '../../io';
3
3
  import type { UsesAbilities } from '../abilities';
4
4
  import type { Actor } from '../Actor';
5
5
  import type { Answerable } from '../Answerable';
6
- import type { QuestionAdapter } from '../Question';
6
+ import type { MetaQuestionAdapter, QuestionAdapter } from '../Question';
7
7
  import { Question } from '../Question';
8
- import type { AnswersQuestions } from '../questions';
8
+ import type { AnswersQuestions, ChainableMetaQuestion, MetaQuestion } from '../questions';
9
9
  import { Task } from '../Task';
10
10
  import type { Expectation } from './Expectation';
11
11
  import { ExpectationMet } from './expectations';
12
- import type { MetaQuestion } from './MetaQuestion';
13
12
 
14
13
  /**
15
14
  * Serenity/JS Screenplay Pattern-style wrapper around {@apilink Array}
@@ -17,50 +16,115 @@ import type { MetaQuestion } from './MetaQuestion';
17
16
  *
18
17
  * @group Questions
19
18
  */
20
- export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
21
- private subject: string;
19
+ export abstract class List<Item_Type> extends Question<Promise<Item_Type[]>> {
20
+ protected subject?: string;
21
+
22
+ static of<IT, CT, RQT extends (Question<Promise<Array<IT>>> | Question<Array<IT>>)>(collection: Answerable<Array<IT>> & ChainableMetaQuestion<CT, RQT>): MetaList<CT, IT>;
23
+ static of<IT>(collection: Answerable<Array<IT>>): List<IT>;
24
+ static of<IT>(collection: unknown): unknown {
25
+ if (Question.isAMetaQuestion<unknown, Question<Array<IT>>>(collection)) {
26
+ return new MetaList(collection as Answerable<Array<IT>> & ChainableMetaQuestion<unknown, Question<Array<IT>>>);
27
+ }
22
28
 
23
- static of<IT>(collection: Answerable<Array<IT>>): List<IT> {
24
- return new List<IT>(collection);
29
+ return new ArrayList<IT>(collection as Answerable<Array<IT>>);
25
30
  }
26
31
 
27
- constructor(
28
- protected readonly collection: Answerable<Array<Item_Type>>,
29
- ) {
32
+ constructor(protected readonly collection: Answerable<Array<Item_Type>>) {
30
33
  super();
31
- this.subject = d`${ collection }`;
32
34
  }
33
35
 
34
- eachMappedTo<Mapped_Item_Type>(
35
- question: MetaQuestion<Item_Type, Promise<Mapped_Item_Type> | Mapped_Item_Type>,
36
- ): List<Mapped_Item_Type> {
37
- return new List(
38
- new EachMappedTo(this.collection, question, this.subject)
39
- );
36
+ forEach(callback: (current: CurrentItem<Item_Type>, index: number, items: Array<Item_Type>) => Promise<void> | void): Task {
37
+ return new ForEachLoop(this.collection, this.toString(), callback);
40
38
  }
41
39
 
42
- forEach(callback: (current: CurrentItem<Item_Type>, index: number, items: Array<Item_Type>) => Promise<void> | void): Task {
43
- return new ForEachLoop(this.collection, this.subject, callback);
40
+ abstract eachMappedTo<Mapped_Item_Type>(
41
+ question: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>
42
+ ): List<Mapped_Item_Type>;
43
+
44
+ abstract where<Answer_Type>(
45
+ question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>,
46
+ expectation: Expectation<Answer_Type>
47
+ ): List<Item_Type>;
48
+
49
+ abstract count(): QuestionAdapter<number>;
50
+
51
+ abstract first(): QuestionAdapter<Item_Type>;
52
+
53
+ abstract last(): QuestionAdapter<Item_Type>;
54
+
55
+ abstract nth(index: number): QuestionAdapter<Item_Type>;
56
+
57
+ async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Array<Item_Type>> {
58
+ const collection = await actor.answer(this.collection);
59
+
60
+ if (! Array.isArray(collection)) {
61
+ throw new LogicError(d`A List has to wrap an Array-compatible object. ${ collection } given.`);
62
+ }
63
+
64
+ return collection;
65
+ }
66
+
67
+ describedAs(subject: string): this {
68
+ this.subject = subject;
69
+ return this;
44
70
  }
45
71
 
46
- where<Answer_Type>(
47
- question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>,
72
+ toString(): string {
73
+ return this.subject ?? d`${ this.collection }`;
74
+ }
75
+
76
+ /**
77
+ * @param {number} index
78
+ */
79
+ protected ordinal(index: number): string {
80
+ const
81
+ lastDigit = Math.abs(index) % 10,
82
+ lastTwoDigits = Math.abs(index) % 100;
83
+
84
+ switch (true) {
85
+ case (lastDigit === 1 && lastTwoDigits !== 11):
86
+ return index + 'st';
87
+ case (lastDigit === 2 && lastTwoDigits !== 12):
88
+ return index + 'nd';
89
+ case (lastDigit === 3 && lastTwoDigits !== 13):
90
+ return index + 'rd';
91
+ default:
92
+ return index + 'th';
93
+ }
94
+ }
95
+ }
96
+
97
+ /**
98
+ * @package
99
+ */
100
+ class ArrayList<Item_Type> extends List<Item_Type> {
101
+
102
+ override eachMappedTo<Mapped_Item_Type>(
103
+ question: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>,
104
+ ): List<Mapped_Item_Type> {
105
+ return new ArrayList(
106
+ new EachMappedTo(this.collection, question, this.toString())
107
+ );
108
+ }
109
+
110
+ override where<Answer_Type>(
111
+ question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>,
48
112
  expectation: Expectation<Answer_Type>
49
- ): this {
50
- return new List<Item_Type>(
51
- new Where(this.collection, question, expectation, this.subject)
113
+ ): List<Item_Type> {
114
+ return new ArrayList<Item_Type>(
115
+ new Where(this.collection, question, expectation, this.toString())
52
116
  ) as this;
53
117
  }
54
118
 
55
- count(): QuestionAdapter<number> {
56
- return Question.about(`the number of ${ this.subject }`, async actor => {
119
+ override count(): QuestionAdapter<number> {
120
+ return Question.about(`the number of ${ this.toString() }`, async actor => {
57
121
  const items = await this.answeredBy(actor);
58
122
  return items.length;
59
123
  });
60
124
  }
61
125
 
62
- first(): QuestionAdapter<Item_Type> {
63
- return Question.about(`the first of ${ this.subject }`, async actor => {
126
+ override first(): QuestionAdapter<Item_Type> {
127
+ return Question.about(`the first of ${ this.toString() }`, async actor => {
64
128
  const items = await this.answeredBy(actor);
65
129
 
66
130
  if (items.length === 0) {
@@ -71,8 +135,8 @@ export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
71
135
  });
72
136
  }
73
137
 
74
- last(): QuestionAdapter<Item_Type> {
75
- return Question.about(`the last of ${ this.subject }`, async actor => {
138
+ override last(): QuestionAdapter<Item_Type> {
139
+ return Question.about(`the last of ${ this.toString() }`, async actor => {
76
140
  const items = await this.answeredBy(actor);
77
141
 
78
142
  if (items.length === 0) {
@@ -83,56 +147,137 @@ export class List<Item_Type> extends Question<Promise<Item_Type[]>> {
83
147
  });
84
148
  }
85
149
 
86
- nth(index: number): QuestionAdapter<Item_Type> {
87
- return Question.about(`the ${ ordinal(index + 1) } of ${ this.subject }`, async actor => {
150
+ override nth(index: number): QuestionAdapter<Item_Type> {
151
+ return Question.about(`the ${ this.ordinal(index + 1) } of ${ this.toString() }`, async actor => {
88
152
  const items = await this.answeredBy(actor);
89
153
 
90
154
  if (index < 0 || items.length <= index) {
91
- throw new ListItemNotFoundError(`Can't retrieve the ${ ordinal(index) } item from a list with ${ items.length } items: ` + d`${ items }`)
155
+ throw new ListItemNotFoundError(`Can't retrieve the ${ this.ordinal(index) } item from a list with ${ items.length } items: ` + d`${ items }`)
92
156
  }
93
157
 
94
158
  return items[index];
95
159
  });
96
160
  }
161
+ }
97
162
 
98
- async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Array<Item_Type>> {
99
- const collection = await actor.answer(this.collection);
163
+ /**
164
+ * Serenity/JS Screenplay Pattern-style wrapper around
165
+ * a {@apilink ChainableMetaQuestion} representing a collection
166
+ * that can be resolved in `Supported_Context_Type` of another {@apilink Question}.
167
+ *
168
+ * For example, {@apilink PageElements.located} returns `MetaList<PageElement>`,
169
+ * which allows for the collection of page elements to be resolved in the context
170
+ * of dynamically-provided root element.
171
+ *
172
+ * ```typescript
173
+ * import { By, PageElements, PageElement } from '@serenity-js/web'
174
+ *
175
+ * const firstLabel = () =>
176
+ * PageElements.located(By.css('label'))
177
+ * .first()
178
+ * .describedAs('first label')
179
+ *
180
+ * const exampleForm = () =>
181
+ * PageElement.located(By.css('form#example1'))
182
+ * .describedAs('example form')
183
+ *
184
+ * const anotherExampleForm = () =>
185
+ * PageElement.located(By.css('form#example2'))
186
+ * .describedAs('another example form')
187
+ *
188
+ * // Next, you can compose the above questions dynamically with various "contexts":
189
+ * // firstLabel().of(exampleForm())
190
+ * // firstLabel().of(anotherExampleForm())
191
+ * ```
192
+ *
193
+ * @group Questions
194
+ */
195
+ export class MetaList<Supported_Context_Type, Item_Type>
196
+ extends List<Item_Type>
197
+ implements ChainableMetaQuestion<Supported_Context_Type, MetaList<Supported_Context_Type, Item_Type>>
198
+ {
199
+ constructor(
200
+ protected override readonly collection: Answerable<Array<Item_Type>> & ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>
201
+ ) {
202
+ super(collection);
203
+ }
100
204
 
101
- if (! Array.isArray(collection)) {
102
- throw new LogicError(d`A List has to wrap an Array-compatible object. ${ collection } given.`);
103
- }
205
+ of(context: Answerable<Supported_Context_Type>): MetaList<Supported_Context_Type, Item_Type> {
206
+ return new MetaList<Supported_Context_Type, Item_Type>(
207
+ this.collection.of(context)
208
+ ).describedAs(this.toString() + d` of ${ context }`)
209
+ }
104
210
 
105
- return collection;
211
+ override eachMappedTo<Mapped_Item_Type>(
212
+ question: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>,
213
+ ): MetaList<Supported_Context_Type, Mapped_Item_Type> {
214
+ return new MetaList(
215
+ new MetaEachMappedTo(this.collection, question, this.toString()),
216
+ );
106
217
  }
107
218
 
108
- describedAs(subject: string): this {
109
- this.subject = subject;
110
- return this;
219
+ override where<Answer_Type>(
220
+ question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>,
221
+ expectation: Expectation<Answer_Type>
222
+ ): MetaList<Supported_Context_Type, Item_Type> {
223
+ return new MetaList<Supported_Context_Type, Item_Type>(
224
+ new MetaWhere(this.collection, question, expectation, this.toString())
225
+ ) as this;
111
226
  }
112
227
 
113
- toString(): string {
114
- return this.subject;
228
+ override count(): MetaQuestionAdapter<Supported_Context_Type, number> {
229
+ return Question.about(`the number of ${ this.toString() }`,
230
+ async actor => {
231
+ const items = await this.answeredBy(actor);
232
+ return items.length;
233
+ },
234
+ (parent: Answerable<Supported_Context_Type>) => this.of(parent).count()
235
+ );
115
236
  }
116
- }
117
237
 
118
- /**
119
- * @package
120
- * @param {number} index
121
- */
122
- function ordinal(index: number): string {
123
- const
124
- lastDigit = Math.abs(index) % 10,
125
- lastTwoDigits = Math.abs(index) % 100;
126
-
127
- switch (true) {
128
- case (lastDigit === 1 && lastTwoDigits !== 11):
129
- return index + 'st';
130
- case (lastDigit === 2 && lastTwoDigits !== 12):
131
- return index + 'nd';
132
- case (lastDigit === 3 && lastTwoDigits !== 13):
133
- return index + 'rd';
134
- default:
135
- return index + 'th';
238
+ override first(): MetaQuestionAdapter<Supported_Context_Type, Item_Type> {
239
+ return Question.about(`the first of ${ this.toString() }`,
240
+ async actor => {
241
+ const items = await this.answeredBy(actor);
242
+
243
+ if (items.length === 0) {
244
+ throw new ListItemNotFoundError(d`Can't retrieve the first item from a list with 0 items: ${ items }`)
245
+ }
246
+
247
+ return items[0];
248
+ },
249
+ (parent: Answerable<Supported_Context_Type>) => this.of(parent).first()
250
+ );
251
+ }
252
+
253
+ override last(): MetaQuestionAdapter<Supported_Context_Type, Item_Type> {
254
+ return Question.about(`the last of ${ this.toString() }`,
255
+ async actor => {
256
+ const items = await this.answeredBy(actor);
257
+
258
+ if (items.length === 0) {
259
+ throw new ListItemNotFoundError(d`Can't retrieve the last item from a list with 0 items: ${ items }`)
260
+ }
261
+
262
+ return items.at(-1);
263
+ },
264
+ (parent: Answerable<Supported_Context_Type>) => this.of(parent).last()
265
+ );
266
+ }
267
+
268
+ override nth(index: number): MetaQuestionAdapter<Supported_Context_Type, Item_Type> {
269
+ return Question.about(`the ${ this.ordinal(index + 1) } of ${ this.toString() }`,
270
+ async actor => {
271
+ const items = await this.answeredBy(actor);
272
+
273
+ if (index < 0 || items.length <= index) {
274
+ throw new ListItemNotFoundError(`Can't retrieve the ${ this.ordinal(index) } item from a list with ${ items.length } items: ` + d`${ items }`)
275
+ }
276
+
277
+ return items[index];
278
+ },
279
+ (parent: Answerable<Supported_Context_Type>) => this.of(parent).nth(index)
280
+ );
136
281
  }
137
282
  }
138
283
 
@@ -145,9 +290,9 @@ class Where<Item_Type, Answer_Type>
145
290
  private subject: string;
146
291
 
147
292
  constructor(
148
- private readonly collection: Answerable<Array<Item_Type>>,
149
- private readonly question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>,
150
- private readonly expectation: Expectation<Answer_Type>,
293
+ protected readonly collection: Answerable<Array<Item_Type>>,
294
+ protected readonly question: MetaQuestion<Item_Type, Question<Promise<Answer_Type> | Answer_Type>>,
295
+ protected readonly expectation: Expectation<Answer_Type>,
151
296
  originalSubject: string,
152
297
  ) {
153
298
  super();
@@ -175,7 +320,7 @@ class Where<Item_Type, Answer_Type>
175
320
 
176
321
  return results;
177
322
  } catch (error) {
178
- throw new LogicError(d`Couldn't check if ${ this.question } of an item of ${ this.collection } does ${ this.expectation }`, error);
323
+ throw new LogicError(d`Couldn't check if ${ this.question } of an item of ${ this.collection } does ${ this.expectation }: ` + error.message, error);
179
324
  }
180
325
  }
181
326
 
@@ -189,6 +334,25 @@ class Where<Item_Type, Answer_Type>
189
334
  }
190
335
  }
191
336
 
337
+ /**
338
+ * @package
339
+ */
340
+ class MetaWhere<Supported_Context_Type, Item_Type, Answer_Type>
341
+ extends Where<Item_Type, Answer_Type>
342
+ implements ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>
343
+ {
344
+ protected override readonly collection: Answerable<Array<Item_Type>> & ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>;
345
+
346
+ of(context: Answerable<Supported_Context_Type>): MetaWhere<Supported_Context_Type, Item_Type, Answer_Type> {
347
+ return new MetaWhere<Supported_Context_Type, Item_Type, Answer_Type>(
348
+ this.collection.of(context),
349
+ this.question,
350
+ this.expectation,
351
+ this.toString()
352
+ );
353
+ }
354
+ }
355
+
192
356
  /**
193
357
  * @package
194
358
  */
@@ -197,8 +361,8 @@ class EachMappedTo<Item_Type, Mapped_Item_Type> extends Question<Promise<Array<M
197
361
  private subject: string;
198
362
 
199
363
  constructor(
200
- private readonly collection: Answerable<Array<Item_Type>>,
201
- private readonly mapping: MetaQuestion<Item_Type, Promise<Mapped_Item_Type> | Mapped_Item_Type>,
364
+ protected readonly collection: Answerable<Array<Item_Type>>,
365
+ protected readonly mapping: MetaQuestion<Item_Type, Question<Promise<Mapped_Item_Type> | Mapped_Item_Type>>,
202
366
  originalSubject: string,
203
367
  ) {
204
368
  super();
@@ -228,6 +392,19 @@ class EachMappedTo<Item_Type, Mapped_Item_Type> extends Question<Promise<Array<M
228
392
  }
229
393
  }
230
394
 
395
+ /**
396
+ * @package
397
+ */
398
+ class MetaEachMappedTo<Supported_Context_Type, Item_Type, Mapped_Item_Type>
399
+ extends EachMappedTo<Item_Type, Mapped_Item_Type>
400
+ {
401
+ protected override readonly collection: Answerable<Array<Item_Type>> & ChainableMetaQuestion<Supported_Context_Type, Question<Promise<Array<Item_Type>>> | Question<Array<Item_Type>>>;
402
+
403
+ of(context: Answerable<Supported_Context_Type>): MetaEachMappedTo<Supported_Context_Type, Item_Type, Mapped_Item_Type> {
404
+ return new MetaEachMappedTo<Supported_Context_Type, Item_Type, Mapped_Item_Type>(this.collection.of(context), this.mapping, this.toString());
405
+ }
406
+ }
407
+
231
408
  /**
232
409
  * @package
233
410
  */
@@ -16,7 +16,7 @@ import type { Question } from '../Question';
16
16
  *
17
17
  * @group Questions
18
18
  */
19
- export interface MetaQuestion<Supported_Context_Type, Answer_Type> {
19
+ export interface MetaQuestion<Supported_Context_Type, Returned_Question_Type extends Question<unknown>> {
20
20
 
21
21
  /**
22
22
  * Answers the given `MetaQuestion` in the context of another {@apilink Answerable}.
@@ -24,7 +24,7 @@ export interface MetaQuestion<Supported_Context_Type, Answer_Type> {
24
24
  * #### Learn more
25
25
  * - {@apilink List}
26
26
  */
27
- of(context: Answerable<Supported_Context_Type>): Question<Promise<Answer_Type>> | Question<Answer_Type>;
27
+ of(context: Answerable<Supported_Context_Type>): Returned_Question_Type;
28
28
 
29
29
  /**
30
30
  * Human-readable description of this {@apilink MetaQuestion},
@@ -1,4 +1,5 @@
1
1
  export * from './AnswersQuestions';
2
+ export * from './ChainableMetaQuestion';
2
3
  export * from './Check';
3
4
  export * from './Expectation';
4
5
  export * from './expectations';