@serenity-js/core 3.23.2 → 3.24.1

package/lib/screenplay/Question.js

@@ -29,6 +29,8 @@ const util = __importStar(require("util")); // eslint-disable-line unicorn/impor
 const errors_1 = require("../errors");
 const io_1 = require("../io");
 const Interaction_1 = require("./Interaction");
+const Describable_1 = require("./questions/Describable");
+const tag_functions_1 = require("./questions/tag-functions");
 const Unanswered_1 = require("./questions/Unanswered");
 /**
  * **Questions** describe how {@apilink Actor|actors} should query the system under test or the test environment to retrieve some information.
@@ -95,16 +97,18 @@ const Unanswered_1 = require("./questions/Unanswered");
  * import { Ensure, equals } from '@serenity-js/assertions'
  *
  * const RequestWasSuccessful = () =>
- *   Question.about<number>(`the text of the last response status`, actor => {
- *     return LastResponse.status().answeredBy(actor) === 200;
- *   });
+ *   Question.about<number>(`the text of the last response status`, async actor => {
+ *     const status = await actor.answer(LastResponse.status());
+ *
+ *     return status === 200;
+ *   })
  *
  * await actorCalled('Quentin')
  *   .whoCan(CallAnApi.at('https://api.example.org/'));
  *   .attemptsTo(
  *     Send.a(GetRequest.to('/books/0-688-00230-7')),
  *     Ensure.that(RequestWasSuccessful(), isTrue()),
- *   );
+ *   )
  * ```
  *
  * Note that the above example is for demonstration purposes only, Serenity/JS provides an easier way to
@@ -120,12 +124,12 @@ const Unanswered_1 = require("./questions/Unanswered");
  *   .attemptsTo(
  *     Send.a(GetRequest.to('/books/0-688-00230-7')),
  *     Ensure.that(LastResponse.status(), equals(200)),
- *   );
+ *   )
  * ```
  *
  * @group Screenplay Pattern
  */
-class Question {
+class Question extends Describable_1.Describable {
     static about(description, body, metaQuestionBody) {
         const statement = typeof metaQuestionBody === 'function'
             ? new MetaQuestionStatement(description, body, metaQuestionBody)
@@ -211,9 +215,18 @@ class Question {
      * Generates a {@apilink QuestionAdapter} that resolves
      * any {@apilink Answerable} elements of the provided array.
      */
-    static fromArray(source) {
-        return Question.about('value', async (actor) => {
-            return await (0, io_1.asyncMap)(source, async (item) => actor.answer(item));
+    static fromArray(source, options) {
+        const formatter = new ValueFormatter(ValueFormatter.defaultOptions);
+        const description = source.length === 0
+            ? '[ ]'
+            : Question.about(formatter.format(source), async (actor) => {
+                const descriptions = await (0, io_1.asyncMap)(source, item => item instanceof Describable_1.Describable
+                    ? item.describedBy(actor)
+                    : Question.formattedValue(options).of(item).answeredBy(actor));
+                return `[ ${descriptions.join(', ')} ]`;
+            });
+        return Question.about(description, async (actor) => {
+            return await (0, io_1.asyncMap)(source, item => actor.answer(item));
         });
     }
     /**
@@ -237,6 +250,60 @@ class Question {
             && typeof maybeMetaQuestion['of'] === 'function'
             && maybeMetaQuestion['of'].length === 1; // arity of 1
     }
+    /**
+     * Creates a {@apilink MetaQuestion} that can be composed with any {@apilink Answerable}
+     * to produce a single-line description of its value.
+     *
+     * ```ts
+     * import { actorCalled, Question } from '@serenity-js/core'
+     * import { Ensure, equals } from '@serenity-js/assertions'
+     *
+     * const accountDetails = () =>
+     *   Question.about('account details', actor => ({ name: 'Alice', age: 28 }))
+     *
+     * await actorCalled('Alice').attemptsTo(
+     *   Ensure.that(
+     *     Question.formattedValue().of(accountDetails()),
+     *     equals('{ name: "Alice", age: 28 }'),
+     *   ),
+     * )
+     * ```
+     *
+     * @param options
+     */
+    static formattedValue(options) {
+        return MetaQuestionAboutFormattedValue.using(options);
+    }
+    /**
+     * Creates a {@apilink MetaQuestion} that can be composed with any {@apilink Answerable}
+     * to return its value when the answerable is a {@apilink Question},
+     * or the answerable itself otherwise.
+     *
+     * The description of the resulting question is produced by calling {@apilink Question.description} on the
+     * provided answerable.
+     *
+     * ```ts
+     * import { actorCalled, Question } from '@serenity-js/core'
+     * import { Ensure, equals } from '@serenity-js/assertions'
+     *
+     * const accountDetails = () =>
+     *   Question.about('account details', actor => ({ name: 'Alice', age: 28 }))
+     *
+     * await actorCalled('Alice').attemptsTo(
+     *   Ensure.that(
+     *     Question.description().of(accountDetails()),
+     *     equals('account details'),
+     *   ),
+     *   Ensure.that(
+     *     Question.value().of(accountDetails()),
+     *     equals({ name: 'Alice', age: 28 }),
+     *   ),
+     * )
+     * ```
+     */
+    static value() {
+        return new MetaQuestionAboutValue();
+    }
     static createAdapter(statement) {
         function getStatement() {
             return statement;
@@ -277,7 +344,7 @@ class Question {
                 if (key === 'then') {
                     return;
                 }
-                return Question.about(Question.fieldDescription(target, key), async (actor) => {
+                return Question.about(Question.staticFieldDescription(target, key), async (actor) => {
                     const answer = await actor.answer(target);
                     if (!isDefined(answer)) {
                         return undefined; // eslint-disable-line unicorn/no-useless-undefined
@@ -286,7 +353,7 @@ class Question {
                     return typeof field === 'function'
                         ? field.bind(answer)
                         : field;
-                });
+                }).describedAs(Question.formattedValue());
             },
             set(currentStatement, key, value, receiver) {
                 const target = currentStatement();
@@ -311,7 +378,7 @@ class Question {
             },
         });
     }
-    static fieldDescription(target, key) {
+    static staticFieldDescription(target, key) {
         // "of" is characteristic of Serenity/JS MetaQuestion
         if (key === 'of') {
             return `${target} ${key}`;
@@ -333,6 +400,21 @@ class Question {
         ].join('');
         return `${targetDescription}${parameterDescriptions}`;
     }
+    /**
+     * Changes the description of this object, as returned by {@apilink Describable.describedBy}
+     * and {@apilink Describable.toString}.
+     *
+     * @param description
+     *  Replaces the current description according to the following rules:
+     *  - If `description` is an {@apilink Answerable}, it replaces the current description
+     *  - If `description` is a {@apilink MetaQuestion}, the current description is passed as `context` to `description.of(context)`, and the result replaces the current description
+     */
+    describedAs(description) {
+        super.setDescription(Question.isAMetaQuestion(description)
+            ? description.of(this)
+            : description);
+        return this;
+    }
     /**
      * Maps this question to one of a different type.
      *
@@ -355,12 +437,10 @@ exports.Question = Question;
  * @package
  */
 class QuestionStatement extends Interaction_1.Interaction {
-    subject;
     body;
     answer = new Unanswered_1.Unanswered();
     constructor(subject, body, location = QuestionStatement.callerLocation(4)) {
         super(subject, location);
-        this.subject = subject;
         this.body = body;
     }
     /**
@@ -380,13 +460,12 @@ class QuestionStatement extends Interaction_1.Interaction {
     [util.inspect.custom](depth, options, inspect) {
         return (0, io_1.inspectedObject)(this.answer)(depth, options, inspect);
     }
-    describedAs(subject) {
-        this.subject = subject;
+    describedAs(description) {
+        super.setDescription(Question.isAMetaQuestion(description)
+            ? description.of(this)
+            : description);
         return this;
     }
-    toString() {
-        return this.subject;
-    }
     as(mapping) {
         return Question.about((0, io_1.f) `${this}.as(${mapping})`, async (actor) => {
             const answer = await actor.answer(this);
@@ -407,7 +486,7 @@ class MetaQuestionStatement extends QuestionStatement {
         this.metaQuestionBody = metaQuestionBody;
     }
     of(answerable) {
-        return Question.about(this.toString() + (0, io_1.d) ` of ${answerable}`, actor => actor.answer(this.metaQuestionBody(answerable)));
+        return Question.about((0, tag_functions_1.the) `${this} of ${answerable}`, actor => actor.answer(this.metaQuestionBody(answerable)));
     }
 }
 /**
@@ -415,11 +494,9 @@ class MetaQuestionStatement extends QuestionStatement {
  */
 class IsPresent extends Question {
     question;
-    subject;
     constructor(question) {
-        super();
+        super((0, io_1.f) `${question}.isPresent()`);
         this.question = question;
-        this.subject = (0, io_1.f) `${question}.isPresent()`;
     }
     async answeredBy(actor) {
         try {
@@ -440,13 +517,6 @@ class IsPresent extends Question {
         return typeof maybeOptional === 'object'
             && Reflect.has(maybeOptional, 'isPresent');
     }
-    describedAs(subject) {
-        this.subject = subject;
-        return this;
-    }
-    toString() {
-        return this.subject;
-    }
 }
 /**
  * @package
@@ -484,4 +554,141 @@ async function recursivelyAnswer(actor, answerable, description, currentRecursio
     }
     return answer;
 }
+class MetaQuestionAboutValue {
+    of(answerable) {
+        return new QuestionAboutValue(answerable);
+    }
+    toString() {
+        return 'value';
+    }
+}
+class QuestionAboutValue extends Question {
+    context;
+    constructor(context) {
+        super(QuestionAboutFormattedValue.of(context).toString());
+        this.context = context;
+    }
+    async answeredBy(actor) {
+        return await actor.answer(this.context);
+    }
+}
+class MetaQuestionAboutFormattedValue {
+    formatter;
+    static using(options) {
+        return new MetaQuestionAboutFormattedValue(new ValueFormatter({
+            ...ValueFormatter.defaultOptions,
+            ...options,
+        }));
+    }
+    constructor(formatter) {
+        this.formatter = formatter;
+    }
+    of(context) {
+        return new QuestionAboutFormattedValue(this.formatter, context);
+    }
+    toString() {
+        return 'formatted value';
+    }
+}
+class QuestionAboutFormattedValue extends Question {
+    formatter;
+    context;
+    static of(context) {
+        return new QuestionAboutFormattedValue(new ValueFormatter(ValueFormatter.defaultOptions), context);
+    }
+    constructor(formatter, context) {
+        const description = context === undefined
+            ? 'formatted value'
+            : formatter.format(context);
+        super(description);
+        this.formatter = formatter;
+        this.context = context;
+    }
+    async answeredBy(actor) {
+        const answer = await actor.answer(this.context);
+        return this.formatter.format(answer);
+    }
+    async describedBy(actor) {
+        const unanswered = !this.context
+            || !this.context['answer']
+            || Unanswered_1.Unanswered.isUnanswered(this.context.answer);
+        const answer = unanswered
+            ? await actor.answer(this.context)
+            : this.context.answer;
+        return this.formatter.format(answer);
+    }
+    of(context) {
+        return new QuestionAboutFormattedValue(this.formatter, Question.isAMetaQuestion(this.context)
+            ? this.context.of(context)
+            : context);
+    }
+}
+class ValueFormatter {
+    options;
+    static defaultOptions = { maxLength: Number.POSITIVE_INFINITY };
+    constructor(options) {
+        this.options = options;
+    }
+    format(value) {
+        if (value === null) {
+            return 'null';
+        }
+        if (value === undefined) {
+            return 'undefined';
+        }
+        if (typeof value === 'string') {
+            return `"${this.trim(value)}"`;
+        }
+        if (typeof value === 'symbol') {
+            return `Symbol(${this.trim(value.description)})`;
+        }
+        if (typeof value === 'bigint') {
+            return `${this.trim(value.toString())}`;
+        }
+        if (io_1.ValueInspector.isPromise(value)) {
+            return 'Promise';
+        }
+        if (Array.isArray(value)) {
+            return value.length === 0
+                ? '[ ]'
+                : `[ ${this.trim(value.map(item => this.format(item)).join(', '))} ]`;
+        }
+        if (value instanceof Map) {
+            return `Map(${this.format(Object.fromEntries(value.entries()))})`;
+        }
+        if (value instanceof Set) {
+            return `Set(${this.format(Array.from(value.values()))})`;
+        }
+        if (io_1.ValueInspector.isDate(value)) {
+            return `Date(${value.toISOString()})`;
+        }
+        if (value instanceof RegExp) {
+            return `${value}`;
+        }
+        if (io_1.ValueInspector.hasItsOwnToString(value)) {
+            return `${this.trim(value.toString())}`;
+        }
+        if (io_1.ValueInspector.isPlainObject(value)) {
+            const stringifiedEntries = Object
+                .entries(value)
+                .reduce((acc, [key, value]) => acc.concat(`${key}: ${this.format(value)}`), [])
+                .join(', ');
+            return `{ ${this.trim(stringifiedEntries)} }`;
+        }
+        if (typeof value === 'object') {
+            const entries = (0, objects_1.significantFieldsOf)(value)
+                .map(field => [field, value[field]]);
+            return `${value.constructor.name}(${this.format(Object.fromEntries(entries))})`;
+        }
+        return String(value);
+    }
+    trim(value) {
+        const ellipsis = '...';
+        const oneLiner = value.replaceAll(/\n+/g, ' ');
+        const maxLength = Math.max(ellipsis.length + 1, this.options.maxLength);
+        return oneLiner.length > maxLength
+            ? `${oneLiner.slice(0, Math.max(0, maxLength) - ellipsis.length)}${ellipsis}`
+            : oneLiner;
+    }
+}
 //# sourceMappingURL=Question.js.map

package/lib/screenplay/Question.js.map

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

package/lib/screenplay/Task.d.ts

@@ -1,5 +1,6 @@
 import type { PerformsActivities } from './activities';
 import { Activity } from './Activity';
+import type { Answerable } from './Answerable';
 /**
  * **Tasks** model **{@apilink Activity|sequences of activities}**
  * and help you capture meaningful steps of an {@apilink Actor|actor} workflow
@@ -28,11 +29,11 @@ import { Activity } from './Activity';
  * ## Defining a task
  *
  * ```ts
- * import { Answerable, Task, d } from '@serenity-js/core'
+ * import { Answerable, Task, the } from '@serenity-js/core'
  * import { By, Click, Enter, PageElement, Press, Key } from '@serenity-js/web'
  *
  * const SignIn = (username: Answerable<string>, password: Answerable<string>) =>
- *   Task.where(d`#actor signs is as ${ username }`,
+ *   Task.where(the`#actor signs is as ${ username }`,
  *     Enter.theValue(username).into(PageElement.located(By.id('username'))),
  *     Enter.theValue(password).into(PageElement.located(By.id('password'))),
  *     Press.the(Key.Enter),
@@ -48,11 +49,11 @@ import { Activity } from './Activity';
  * but you're not yet sure what activities it will involve.
  *
  * ```ts
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  *
  * const SignUp = () =>
- *     Task.where(`#actor signs up for a newsletter`) // no activities provided
- *                                                    // => task marked as pending
+ *     Task.where(the`#actor signs up for a newsletter`) // no activities provided
+ *                                                       // => task marked as pending
  * ```
  *
  * ## Composing activities into tasks
@@ -72,10 +73,10 @@ import { Activity } from './Activity';
  * The easiest way to implement such task, and any custom Serenity/JS task for this matter, is to use the {@apilink Task.where} method to compose the lower-level activities:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  *
  * const findFlight = (originCity: string, destinationCity: string) =>
- *     Task.where(`#actors finds a flight from ${ originCity } to ${ destinationCity }`,   // task goal
+ *     Task.where(the`#actor finds a flight from ${ originCity } to ${ destinationCity }`,   // task goal
  *         specifyOriginCity(originCity),                                                  // activities
  *         specifyDestinationCity(originCity),
  *     )
@@ -97,20 +98,20 @@ import { Activity } from './Activity';
  * which we can incorporate into our task definitions just like any other activities:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  * import { Click, Enter, Key, Press } from '@serenity-js/web'
  *
  * import { FlightFinder } from './ui/flight-finder'
  *
  * const specifyOriginCity = (originCity: string) =>
- *     Task.where(`#actor specifies origin city of ${ originCity }`,
+ *     Task.where(the`#actor specifies origin city of ${ originCity }`,
  *         Click.on(FlightFinder.originAirport),
  *         Enter.theValue(originCity).into(FlightFinder.originAirport),
  *         Press.the(Key.ArrowDown, Key.Enter).into(FlightFinder.originAirport),
  *     )
  *
  * const specifyDestinationCity = (destinationCity: string) =>
- *     Task.where(`#actor specifies destination city of ${ destinationCity }`,
+ *     Task.where(the`#actor specifies destination city of ${ destinationCity }`,
  *         Click.on(FlightFinder.destinationAirport),
  *         Enter.theValue(destinationCity).into(FlightFinder.destinationAirport),
  *         Press.the(Key.ArrowDown, Key.Enter).into(FlightFinder.destinationAirport),
@@ -123,23 +124,23 @@ import { Activity } from './Activity';
  * by **extracting a parameterised task**, in this case called `specifyCity`:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  * import { Click, Enter, Key, PageElement, Press } from '@serenity-js/web'
  *
  * import { FlightFinder } from './ui/flight-finder'
  *
  * const specifyOriginCity = (originCity: string) =>
- *     Task.where(`#actor specifies origin city of ${ originCity }`,
+ *     Task.where(the`#actor specifies origin city of ${ originCity }`,
  *         specifyCity(originCity, FlightFinder.originAirport)
  *     )
  *
  * const specifyDestinationCity = (destinationCity: string) =>
- *     Task.where(`#actor specifies destination city of ${ destinationCity }`,
+ *     Task.where(the`#actor specifies destination city of ${ destinationCity }`,
  *         specifyCity(destinationCity, FlightFinder.destinationAirport),
  *     )
  *
  * const specifyCity = (cityName: string, widget: PageElement) =>
- *     Task.where(`#actor specifies city of ${ cityName } in ${ widget }`,
+ *     Task.where(the`#actor specifies city of ${ cityName } in ${ widget }`,
  *         Click.on(widget),
  *         Enter.theValue(cityName).into(widget),
  *         Press.the(Key.ArrowDown, Key.Enter).into(widget),
@@ -179,7 +180,7 @@ export declare abstract class Task extends Activity {
      * @param activities
      *  A sequence of lower-level activities that constitute this task
      */
-    static where(description: string, ...activities: Activity[]): Task;
+    static where(description: Answerable<string>, ...activities: Activity[]): Task;
     /**
      * Instructs the provided {@apilink Actor} to perform this {@apilink Task}.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/screenplay/Task.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,8BAAsB,IAAK,SAAQ,QAAQ;IAEvC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMlE;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/screenplay/Task.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,8BAAsB,IAAK,SAAQ,QAAQ;IAEvC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAM9E;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}

package/lib/screenplay/Task.js

@@ -31,11 +31,11 @@ const Activity_1 = require("./Activity");
  * ## Defining a task
  *
  * ```ts
- * import { Answerable, Task, d } from '@serenity-js/core'
+ * import { Answerable, Task, the } from '@serenity-js/core'
  * import { By, Click, Enter, PageElement, Press, Key } from '@serenity-js/web'
  *
  * const SignIn = (username: Answerable<string>, password: Answerable<string>) =>
- *   Task.where(d`#actor signs is as ${ username }`,
+ *   Task.where(the`#actor signs is as ${ username }`,
  *     Enter.theValue(username).into(PageElement.located(By.id('username'))),
  *     Enter.theValue(password).into(PageElement.located(By.id('password'))),
  *     Press.the(Key.Enter),
@@ -51,11 +51,11 @@ const Activity_1 = require("./Activity");
  * but you're not yet sure what activities it will involve.
  *
  * ```ts
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  *
  * const SignUp = () =>
- *     Task.where(`#actor signs up for a newsletter`) // no activities provided
- *                                                    // => task marked as pending
+ *     Task.where(the`#actor signs up for a newsletter`) // no activities provided
+ *                                                       // => task marked as pending
  * ```
  *
  * ## Composing activities into tasks
@@ -75,10 +75,10 @@ const Activity_1 = require("./Activity");
  * The easiest way to implement such task, and any custom Serenity/JS task for this matter, is to use the {@apilink Task.where} method to compose the lower-level activities:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  *
  * const findFlight = (originCity: string, destinationCity: string) =>
- *     Task.where(`#actors finds a flight from ${ originCity } to ${ destinationCity }`,   // task goal
+ *     Task.where(the`#actor finds a flight from ${ originCity } to ${ destinationCity }`,   // task goal
  *         specifyOriginCity(originCity),                                                  // activities
  *         specifyDestinationCity(originCity),
  *     )
@@ -100,20 +100,20 @@ const Activity_1 = require("./Activity");
  * which we can incorporate into our task definitions just like any other activities:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  * import { Click, Enter, Key, Press } from '@serenity-js/web'
  *
  * import { FlightFinder } from './ui/flight-finder'
  *
  * const specifyOriginCity = (originCity: string) =>
- *     Task.where(`#actor specifies origin city of ${ originCity }`,
+ *     Task.where(the`#actor specifies origin city of ${ originCity }`,
  *         Click.on(FlightFinder.originAirport),
  *         Enter.theValue(originCity).into(FlightFinder.originAirport),
  *         Press.the(Key.ArrowDown, Key.Enter).into(FlightFinder.originAirport),
  *     )
  *
  * const specifyDestinationCity = (destinationCity: string) =>
- *     Task.where(`#actor specifies destination city of ${ destinationCity }`,
+ *     Task.where(the`#actor specifies destination city of ${ destinationCity }`,
  *         Click.on(FlightFinder.destinationAirport),
  *         Enter.theValue(destinationCity).into(FlightFinder.destinationAirport),
  *         Press.the(Key.ArrowDown, Key.Enter).into(FlightFinder.destinationAirport),
@@ -126,23 +126,23 @@ const Activity_1 = require("./Activity");
  * by **extracting a parameterised task**, in this case called `specifyCity`:
  *
  * ```typescript
- * import { Task } from '@serenity-js/core'
+ * import { Task, the } from '@serenity-js/core'
  * import { Click, Enter, Key, PageElement, Press } from '@serenity-js/web'
  *
  * import { FlightFinder } from './ui/flight-finder'
  *
  * const specifyOriginCity = (originCity: string) =>
- *     Task.where(`#actor specifies origin city of ${ originCity }`,
+ *     Task.where(the`#actor specifies origin city of ${ originCity }`,
  *         specifyCity(originCity, FlightFinder.originAirport)
  *     )
  *
  * const specifyDestinationCity = (destinationCity: string) =>
- *     Task.where(`#actor specifies destination city of ${ destinationCity }`,
+ *     Task.where(the`#actor specifies destination city of ${ destinationCity }`,
  *         specifyCity(destinationCity, FlightFinder.destinationAirport),
  *     )
  *
  * const specifyCity = (cityName: string, widget: PageElement) =>
- *     Task.where(`#actor specifies city of ${ cityName } in ${ widget }`,
+ *     Task.where(the`#actor specifies city of ${ cityName } in ${ widget }`,
  *         Click.on(widget),
  *         Enter.theValue(cityName).into(widget),
  *         Press.the(Key.ArrowDown, Key.Enter).into(widget),

package/lib/screenplay/Task.js.map

@@ -1 +1 @@
-{"version":3,"file":"Task.js","sourceRoot":"","sources":["../../src/screenplay/Task.ts"],"names":[],"mappings":";;;AAAA,sCAAuD;AAEvD,yCAAsC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,MAAsB,IAAK,SAAQ,mBAAQ;IAEvC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,WAAmB,EAAE,GAAG,UAAsB;QACvD,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,IAAI,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC;YACvD,CAAC,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;CAaJ;AA5BD,oBA4BC;AAED;;GAEG;AACH,MAAM,wBAAyB,SAAQ,IAAI;IACE;IAAzC,YAAY,WAAmB,EAAU,UAAsB;QAC3D,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QADN,eAAU,GAAV,UAAU,CAAY;IAE/D,CAAC;IAED,SAAS,CAAC,KAAyB;QAC/B,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,kBAAmB,SAAQ,IAAI;IACjC,YAAY,WAAmB;QAC3B,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,KAAyB;QAC/B,OAAO,OAAO,CAAC,MAAM,CACjB,IAAI,mCAA0B,CAAC,iBAAkB,IAAI,CAAC,QAAQ,EAAG,gCAAgC,CAAC,CACrG,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"Task.js","sourceRoot":"","sources":["../../src/screenplay/Task.ts"],"names":[],"mappings":";;;AAAA,sCAAuD;AAEvD,yCAAsC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,MAAsB,IAAK,SAAQ,mBAAQ;IAEvC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,WAA+B,EAAE,GAAG,UAAsB;QACnE,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,IAAI,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC;YACvD,CAAC,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;CAaJ;AA5BD,oBA4BC;AAED;;GAEG;AACH,MAAM,wBAAyB,SAAQ,IAAI;IACc;IAArD,YAAY,WAA+B,EAAU,UAAsB;QACvE,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QADM,eAAU,GAAV,UAAU,CAAY;IAE3E,CAAC;IAED,SAAS,CAAC,KAAyB;QAC/B,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,kBAAmB,SAAQ,IAAI;IACjC,YAAY,WAA+B;QACvC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,KAAyB;QAC/B,OAAO,OAAO,CAAC,MAAM,CACjB,IAAI,mCAA0B,CAAC,iBAAkB,IAAI,CAAC,QAAQ,EAAG,gCAAgC,CAAC,CACrG,CAAC;IACN,CAAC;CACJ"}