@serenity-js/core 3.0.0-rc.40 → 3.0.0-rc.41

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.0.0-rc.41](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.40...v3.0.0-rc.41) (2023-02-07)
+
+
+### Bug Fixes
+
+* **core:** corrected issue in asyncMap that led lists of lists to be flat-mapped not mapped ([d7a6f1d](https://github.com/serenity-js/serenity-js/commit/d7a6f1d7281f34c56cf2b606681c8046b1cffce7))
+* **core:** easier configuration and automatic colour support detection for AnsiDiffFormatter ([637ed44](https://github.com/serenity-js/serenity-js/commit/637ed44ffb16484544ade975bcbc4c3929ffe8f9)), closes [#1486](https://github.com/serenity-js/serenity-js/issues/1486)
+* **core:** further improvements to how the expected vs received values are rendered in VS Code ([e2101d0](https://github.com/serenity-js/serenity-js/commit/e2101d0b11e56b1701bf75efe0d4f85ab72a6f48)), closes [#1486](https://github.com/serenity-js/serenity-js/issues/1486)
+* **core:** improved support for Node 14 ([f828b45](https://github.com/serenity-js/serenity-js/commit/f828b4563a3c5165dc066fc675d4e5c2b78c3a0a))
+* **core:** introduced ExpectationDetails to provide more accurate info re failed expectations ([02b8f33](https://github.com/serenity-js/serenity-js/commit/02b8f33732341a9391192fc52a59ea8a8f5f19f0)), closes [#1102](https://github.com/serenity-js/serenity-js/issues/1102)
+* **core:** removed AssertionReport and AssertionReportDiffer as they're no longer needed ([a968ac5](https://github.com/serenity-js/serenity-js/commit/a968ac57365e10b503e74db4319eb96b3430ffb0)), closes [#1480](https://github.com/serenity-js/serenity-js/issues/1480)
+* **core:** removed the legacy Error (de-)serialisation mechanism ([7ea2b10](https://github.com/serenity-js/serenity-js/commit/7ea2b101c6d5ba1b32e14b3f24a5bd6b9c5c97f6))
+* **core:** typeOf now correctly recognises Proxy objects ([3ca68a3](https://github.com/serenity-js/serenity-js/commit/3ca68a33524556c43d288a9131e79cb53a9f392e))
+
+
+### Features
+
+* **assertions:** diffs included in RuntimeErrors are now colour-coded ([f88efb4](https://github.com/serenity-js/serenity-js/commit/f88efb48180924351e8f7b25c44f3560b0e01b0d)), closes [#1486](https://github.com/serenity-js/serenity-js/issues/1486)
+* **core:** assertion and synchronisation errors include location of the activity that threw them ([f06f378](https://github.com/serenity-js/serenity-js/commit/f06f378b9427d81a5adcea219ef01cf616a48c20)), closes [#1102](https://github.com/serenity-js/serenity-js/issues/1102)
+* **core:** assertion errors include precise information about unmet expectations and improved diffs ([1eb09b1](https://github.com/serenity-js/serenity-js/commit/1eb09b1c1c8fb059b53bd7fcefab660581abc7bc)), closes [#1102](https://github.com/serenity-js/serenity-js/issues/1102)
+* **core:** better assertion errors reporting in Visual Studio Code ([3b94b7d](https://github.com/serenity-js/serenity-js/commit/3b94b7d606fae49e7ca77c2fbe09d07eeb042ea9)), closes [#1486](https://github.com/serenity-js/serenity-js/issues/1486)
+* **core:** error factory is now configurable, which allows for the diffs to include colours ([dac293d](https://github.com/serenity-js/serenity-js/commit/dac293de5f8baed5aee3246b5467c4bcfbebbb25)), closes [#1486](https://github.com/serenity-js/serenity-js/issues/1486)
+* **core:** new ability to RaiseErrors ([4617d39](https://github.com/serenity-js/serenity-js/commit/4617d39a7b0d72381834abe27ff4393cbc79d0f5)), closes [#1102](https://github.com/serenity-js/serenity-js/issues/1102)
+* **core:** overridable abilities ([03966cc](https://github.com/serenity-js/serenity-js/commit/03966ccae40d102b7dbca1125beb90ceda8fbc50))
+
+
+
+
+
 # [3.0.0-rc.40](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.39...v3.0.0-rc.40) (2023-01-06)
 
 **Note:** Version bump only for package @serenity-js/core

package/lib/Serenity.d.ts

@@ -1,7 +1,8 @@
 import { SerenityConfig } from './config';
+import { ErrorOptions, RuntimeError } from './errors';
 import { DomainEvent } from './events';
-import { CorrelationId, Timestamp } from './model';
-import { Actor } from './screenplay/actor/Actor';
+import { ActivityDetails, CorrelationId, Timestamp } from './model';
+import { Actor } from './screenplay';
 import { Cast } from './stage/Cast';
 import { Clock } from './stage/Clock';
 /**
@@ -192,7 +193,8 @@ export declare class Serenity {
     currentTime(): Timestamp;
     assignNewSceneId(): CorrelationId;
     currentSceneId(): CorrelationId;
-    assignNewActivityId(): CorrelationId;
+    assignNewActivityId(activityDetails: ActivityDetails): CorrelationId;
+    createError<RE extends RuntimeError>(errorType: new (...args: any[]) => RE, options: ErrorOptions): RE;
     /**
      * @package
      */

package/lib/Serenity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Serenity.d.ts","sourceRoot":"","sources":["../src/Serenity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAKtC;;GAEG;AACH,qBAAa,QAAQ;IAab,OAAO,CAAC,QAAQ,CAAC,KAAK;IAZ1B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA4B;IAC5D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuB;IAEnD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAiC;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;OAEG;gBAEkB,KAAK,GAAE,KAAmB,EAC3C,GAAG,GAAE,MAAsB;IAa/B;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA6CvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAM1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAInC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sBAAsB,IAAI,KAAK;IAI/B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,WAAW,IAAI,SAAS;IAIxB,gBAAgB,IAAI,aAAa;IAIjC,cAAc,IAAI,aAAa;IAI/B,mBAAmB,IAAI,aAAa;IAIpC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
+{"version":3,"file":"Serenity.d.ts","sourceRoot":"","sources":["../src/Serenity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAoC,YAAY,EAAqB,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAKtC;;GAEG;AACH,qBAAa,QAAQ;IAab,OAAO,CAAC,QAAQ,CAAC,KAAK;IAZ1B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA4B;IAC5D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuB;IAEnD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAiC;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;OAEG;gBAEkB,KAAK,GAAE,KAAmB,EAC3C,GAAG,GAAE,MAAsB;IAc/B;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA8CvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAM1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAInC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sBAAsB,IAAI,KAAK;IAI/B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,WAAW,IAAI,SAAS;IAIxB,gBAAgB,IAAI,aAAa;IAIjC,cAAc,IAAI,aAAa;IAI/B,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,aAAa;IAIpE,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,EAAE;IAItG;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/lib/Serenity.js

@@ -19,7 +19,7 @@ class Serenity {
     constructor(clock = new Clock_1.Clock(), cwd = process.cwd()) {
         this.clock = clock;
         this.outputStream = process.stdout;
-        this.stage = new Stage_1.Stage(Serenity.defaultActors, new StageManager_1.StageManager(Serenity.defaultCueTimeout, clock));
+        this.stage = new Stage_1.Stage(Serenity.defaultActors, new StageManager_1.StageManager(Serenity.defaultCueTimeout, clock), new errors_1.ErrorFactory());
         this.classLoader = new io_1.ClassLoader(new io_1.ModuleLoader(cwd), new io_1.ClassDescriptionParser());
     }
     /**
@@ -31,6 +31,7 @@ class Serenity {
      * @param config
      */
     configure(config) {
+        var _a;
         const looksLikeBuilder = (0, io_1.has)({ build: 'function' });
         const looksLikeStageCrewMember = (0, io_1.has)({ assignedTo: 'function', notifyOf: 'function' });
         const cueTimeout = config.cueTimeout
@@ -39,7 +40,7 @@ class Serenity {
         if (config.outputStream) {
             this.outputStream = config.outputStream;
         }
-        this.stage = new Stage_1.Stage(Serenity.defaultActors, new StageManager_1.StageManager(cueTimeout, this.clock));
+        this.stage = new Stage_1.Stage(Serenity.defaultActors, new StageManager_1.StageManager(cueTimeout, this.clock), new errors_1.ErrorFactory((_a = config.diffFormatter) !== null && _a !== void 0 ? _a : new errors_1.NoOpDiffFormatter()));
         if (config.actors) {
             this.engage(config.actors);
         }
@@ -237,8 +238,11 @@ class Serenity {
     currentSceneId() {
         return this.stage.currentSceneId();
     }
-    assignNewActivityId() {
-        return this.stage.assignNewActivityId();
+    assignNewActivityId(activityDetails) {
+        return this.stage.assignNewActivityId(activityDetails);
+    }
+    createError(errorType, options) {
+        return this.stage.createError(errorType, options);
     }
     /**
      * @package

package/lib/Serenity.js.map

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

package/lib/config/SerenityConfig.d.ts

@@ -1,4 +1,5 @@
 import { OutputStream } from '../adapter';
+import { DiffFormatter } from '../errors';
 import { Duration } from '../model';
 import { Cast, StageCrewMember, StageCrewMemberBuilder } from '../stage';
 import { ClassDescription } from './ClassDescription';
@@ -40,6 +41,13 @@ export declare abstract class SerenityConfig {
      * a scenario timeout, which should be configured in your test runner.
      */
     cueTimeout?: Duration;
+    /**
+     * {@apilink DiffFormatter} that should be used by the {@apilink ErrorFactory} and the ability to {@apilink RaiseErrors}
+     * when generating diffs included in {@apilink RuntimeError} objects.
+     *
+     * By default, Serenity/JS uses {@apilink NoOpDiffFormatter}.
+     */
+    diffFormatter?: DiffFormatter;
     /**
      * An output stream to be injected into {@apilink StageCrewMemberBuilder|StageCrewMemberBuilders}
      *

package/lib/config/SerenityConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SerenityConfig.d.ts","sourceRoot":"","sources":["../../src/config/SerenityConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,8BAAsB,cAAc;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,eAAe,GAAG,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAE1E;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC;IAEtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B"}
+{"version":3,"file":"SerenityConfig.d.ts","sourceRoot":"","sources":["../../src/config/SerenityConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,8BAAsB,cAAc;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,eAAe,GAAG,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAE1E;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC;IAEtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B"}

package/lib/config/SerenityConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"SerenityConfig.js","sourceRoot":"","sources":["../../src/config/SerenityConfig.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;GAYG;AACH,MAAsB,cAAc;CAmCnC;AAnCD,wCAmCC"}
+{"version":3,"file":"SerenityConfig.js","sourceRoot":"","sources":["../../src/config/SerenityConfig.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;;;GAYG;AACH,MAAsB,cAAc;CA2CnC;AA3CD,wCA2CC"}

package/lib/errors/ErrorFactory.d.ts

@@ -0,0 +1,16 @@
+import { DiffFormatter } from './diff';
+import { ErrorOptions } from './ErrorOptions';
+import { RuntimeError } from './model';
+/**
+ * Generates Serenity/JS {@apilink RuntimeError} objects based on provided {@apilink ErrorOptions|configuration}.
+ *
+ * @group Errors
+ */
+export declare class ErrorFactory {
+    private readonly formatter;
+    constructor(formatter?: DiffFormatter);
+    create<RE extends RuntimeError>(errorType: new (...args: any[]) => RE, options: ErrorOptions): RE;
+    private title;
+    private diffFrom;
+}
+//# sourceMappingURL=ErrorFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFactory.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorFactory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,YAAY;IAET,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,GAAE,aAAuC;IAG/E,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,EAAE;IAcjG,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;CAMnB"}

package/lib/errors/ErrorFactory.js

@@ -0,0 +1,241 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorFactory = void 0;
+const diff_1 = require("diff");
+const objects_1 = require("tiny-types/lib/objects");
+const util_1 = require("util");
+const io_1 = require("../io");
+const stringified_1 = require("../io/stringified");
+const screenplay_1 = require("../screenplay");
+const AnsiDiffFormatter_1 = require("./diff/AnsiDiffFormatter");
+/**
+ * Generates Serenity/JS {@apilink RuntimeError} objects based on provided {@apilink ErrorOptions|configuration}.
+ *
+ * @group Errors
+ */
+class ErrorFactory {
+    constructor(formatter = new AnsiDiffFormatter_1.AnsiDiffFormatter()) {
+        this.formatter = formatter;
+    }
+    create(errorType, options) {
+        const message = [
+            this.title(options.message),
+            options.expectation && `\nExpectation: ${options.expectation}`,
+            options.diff && ('\n' + this.diffFrom(options.diff)),
+            options.location && (`    at ${options.location.path.value}:${options.location.line}:${options.location.column}`),
+        ].
+            filter(Boolean).
+            join('\n');
+        return new errorType(message, options === null || options === void 0 ? void 0 : options.cause);
+    }
+    title(value) {
+        return String(value).trim();
+    }
+    diffFrom(diff) {
+        return new Diff(diff.expected, diff.actual)
+            .lines()
+            .map(line => line.decorated(this.formatter))
+            .join('\n');
+    }
+}
+exports.ErrorFactory = ErrorFactory;
+class DiffLine {
+    constructor(type, value) {
+        this.type = type;
+        this.value = value;
+    }
+    prependMarker() {
+        return this.prepend(this.marker());
+    }
+    appendMarker() {
+        return this.append(this.marker());
+    }
+    prepend(text) {
+        return new DiffLine(this.type, String(text) + this.value);
+    }
+    append(text) {
+        return new DiffLine(this.type, this.value + String(text));
+    }
+    decorated(decorator) {
+        return decorator[this.type](this.value);
+    }
+    marker() {
+        return DiffLine.markers[this.type];
+    }
+}
+_a = DiffLine;
+DiffLine.markers = {
+    'expected': '- ',
+    'received': '+ ',
+    'unchanged': '  ',
+};
+DiffLine.empty = () => new DiffLine('unchanged', '');
+DiffLine.unchanged = (line) => new DiffLine('unchanged', String(line));
+DiffLine.expected = (line) => new DiffLine('expected', String(line));
+DiffLine.received = (line) => new DiffLine('received', String(line));
+DiffLine.changed = (change, line) => {
+    if (change.removed) {
+        return _a.expected(line);
+    }
+    if (change.added) {
+        return _a.received(line);
+    }
+    return _a.unchanged(line);
+};
+class DiffValue {
+    constructor(name, value) {
+        this.value = value;
+        this.nameAndType = `${name} ${(0, io_1.typeOf)(value)}`;
+        this.desiredNameFieldLength = this.nameAndType.length;
+        this.summary = this.summaryOf(value);
+    }
+    withDesiredFieldLength(columns) {
+        this.desiredNameFieldLength = columns;
+        return this;
+    }
+    hasSummary() {
+        return this.summary !== undefined;
+    }
+    type() {
+        return (0, io_1.typeOf)(this.value);
+    }
+    isComplex() {
+        return (typeof this.value === 'object' || util_1.types.isProxy(this.value))
+            && !(this.value instanceof RegExp)
+            && !(this.value instanceof screenplay_1.Unanswered);
+    }
+    isArray() {
+        return Array.isArray(this.value);
+    }
+    isComparableAsJson() {
+        if (!this.value || this.value instanceof screenplay_1.Unanswered) {
+            return false;
+        }
+        return (0, stringified_1.isPlainObject)(this.value)
+            || this.value['toJSON'];
+    }
+    toString() {
+        const labelWidth = this.desiredNameFieldLength - this.nameAndType.length;
+        return [
+            this.nameAndType,
+            this.summary && ': '.padEnd(labelWidth + 2),
+            this.summary,
+            this.changes && this.changes.padStart(labelWidth + 5),
+        ].
+            filter(Boolean).
+            join('');
+    }
+    summaryOf(value) {
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        const isDefined = value !== undefined && value !== null;
+        if (isDefined && ((0, io_1.isPrimitive)(value) || value instanceof RegExp)) {
+            return String(value);
+        }
+        return undefined;
+    }
+}
+class Diff {
+    constructor(expectedValue, actualValue) {
+        this.diff = this.diffFrom(expectedValue, actualValue);
+    }
+    diffFrom(expectedValue, actualValue) {
+        const { expected, actual } = this.aligned(new DiffValue('Expected', expectedValue), new DiffValue('Received', actualValue));
+        if (this.shouldRenderActualValueOnly(expected, actual)) {
+            return this.renderActualValue(expected, actual);
+        }
+        if (this.shouldRenderJsonDiff(expected, actual)) {
+            return this.renderJsonDiff(expected, actual);
+        }
+        if (this.shouldRenderArrayDiff(expected, actual)) {
+            return this.renderArrayDiff(expected, actual);
+        }
+        return [
+            DiffLine.expected(expected),
+            DiffLine.received(actual),
+            DiffLine.empty(),
+        ];
+    }
+    shouldRenderActualValueOnly(expected, actual) {
+        return actual.isComplex()
+            && !actual.hasSummary()
+            && expected.type() !== actual.type();
+    }
+    shouldRenderJsonDiff(expected, actual) {
+        return expected.isComparableAsJson()
+            && actual.isComparableAsJson()
+            && !expected.hasSummary()
+            && !actual.hasSummary();
+    }
+    shouldRenderArrayDiff(expected, actual) {
+        return expected.isArray()
+            && actual.isArray();
+    }
+    aligned(expected, actual) {
+        const maxFieldLength = Math.max(expected.desiredNameFieldLength, actual.desiredNameFieldLength);
+        return {
+            expected: expected.withDesiredFieldLength(maxFieldLength),
+            actual: actual.withDesiredFieldLength(maxFieldLength)
+        };
+    }
+    renderActualValue(expected, actual) {
+        const lines = (0, io_1.inspected)(actual.value)
+            .split('\n')
+            .map(DiffLine.unchanged);
+        return [
+            DiffLine.expected(expected),
+            DiffLine.received(actual),
+            DiffLine.empty(),
+            ...lines,
+            DiffLine.empty(),
+        ];
+    }
+    renderJsonDiff(expected, actual) {
+        const changes = (0, diff_1.diffJson)(expected.value, actual.value);
+        const lines = changes.reduce((acc, change) => {
+            const changedLines = change.value.trimEnd().split('\n');
+            return acc.concat(changedLines.map(line => DiffLine.changed(change, line).prependMarker()));
+        }, []);
+        const { added, removed } = this.countOf(changes);
+        return [
+            DiffLine.expected(expected).append('  ').appendMarker().append(`${removed}`),
+            DiffLine.received(actual).append('  ').appendMarker().append(`${added}`),
+            DiffLine.empty(),
+            ...lines,
+            DiffLine.empty(),
+        ];
+    }
+    renderArrayDiff(expected, actual) {
+        const changes = (0, diff_1.diffArrays)(expected.value, actual.value, { comparator: objects_1.equal });
+        const lines = changes.reduce((acc, change) => {
+            const items = change.value;
+            return acc.concat(items.map(item => DiffLine.changed(change, (0, io_1.inspected)(item, { compact: true }))
+                .prepend('  ')
+                .prependMarker()));
+        }, []);
+        const { added, removed } = this.countOf(changes);
+        return [
+            DiffLine.expected(expected).append('  ').appendMarker().append(`${removed}`),
+            DiffLine.received(actual).append('  ').appendMarker().append(`${added}`),
+            DiffLine.empty(),
+            DiffLine.unchanged('  ['),
+            ...lines,
+            DiffLine.unchanged('  ]'),
+            DiffLine.empty(),
+        ];
+    }
+    countOf(changes) {
+        return changes.reduce(({ removed, added }, change) => {
+            return {
+                removed: removed + (change.removed ? change.count : 0),
+                added: added + (change.added ? change.count : 0),
+            };
+        }, { removed: 0, added: 0 });
+    }
+    lines() {
+        return this.diff;
+    }
+}
+//# sourceMappingURL=ErrorFactory.js.map

package/lib/errors/ErrorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFactory.js","sourceRoot":"","sources":["../../src/errors/ErrorFactory.ts"],"names":[],"mappings":";;;;AAAA,+BAAiE;AACjE,oDAA+C;AAC/C,+BAA6B;AAE7B,8BAAuD;AACvD,mDAAkD;AAClD,8CAA2C;AAE3C,gEAA6D;AAI7D;;;;GAIG;AACH,MAAa,YAAY;IAErB,YAA6B,YAA2B,IAAI,qCAAiB,EAAE;QAAlD,cAAS,GAAT,SAAS,CAAyC;IAC/E,CAAC;IAED,MAAM,CAA0B,SAAqC,EAAE,OAAqB;QAExF,MAAM,OAAO,GAAG;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC3B,OAAO,CAAC,WAAW,IAAI,kBAAmB,OAAO,CAAC,WAAY,EAAE;YAChE,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,CAAC,QAAQ,IAAI,CAAC,UAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAM,IAAK,OAAO,CAAC,QAAQ,CAAC,IAAK,IAAK,OAAO,CAAC,QAAQ,CAAC,MAAO,EAAE,CAAC;SAC1H;YACD,MAAM,CAAC,OAAO,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEX,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,CAAkB,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,KAAa;QACvB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAEO,QAAQ,CAAC,IAA4C;QACzD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;aACtC,KAAK,EAAE;aACP,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;CACJ;AA7BD,oCA6BC;AAID,MAAM,QAAQ;IA+BV,YACqB,IAAc,EACd,KAAa;QADb,SAAI,GAAJ,IAAI,CAAU;QACd,UAAK,GAAL,KAAK,CAAQ;IAElC,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,YAAY;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,IAAS;QACb,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,IAAS;QACZ,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,SAAwB;QAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAEO,MAAM;QACV,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;;;AA1Dc,gBAAO,GAA6B;IAC/C,UAAU,EAAG,IAAI;IACjB,UAAU,EAAG,IAAI;IACjB,WAAW,EAAE,IAAI;CACpB,CAAA;AAEM,cAAK,GAAG,GAAG,EAAE,CAChB,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAE3B,kBAAS,GAAG,CAAC,IAAS,EAAE,EAAE,CAC7B,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAErC,iBAAQ,GAAG,CAAC,IAAS,EAAE,EAAE,CAC5B,IAAI,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAEpC,iBAAQ,GAAG,CAAC,IAAS,EAAE,EAAE,CAC5B,IAAI,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAEpC,gBAAO,GAAG,CAAC,MAAiC,EAAE,IAAY,EAAE,EAAE;IACjE,IAAI,MAAM,CAAC,OAAO,EAAE;QAChB,OAAO,EAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;KAC9B;IAED,IAAI,MAAM,CAAC,KAAK,EAAE;QACd,OAAO,EAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;KAC9B;IAED,OAAO,EAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC,CAAA;AAiCL,MAAM,SAAS;IAOX,YACI,IAAY,EACI,KAAc;QAAd,UAAK,GAAL,KAAK,CAAS;QAE9B,IAAI,CAAC,WAAW,GAAc,GAAI,IAAK,IAAK,IAAA,WAAM,EAAC,KAAK,CAAE,EAAE,CAAC;QAC7D,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACtD,IAAI,CAAC,OAAO,GAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,sBAAsB,CAAC,OAAe;QAClC,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IACtC,CAAC;IAED,IAAI;QACA,OAAO,IAAA,WAAM,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS;QACL,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,YAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;eAC7D,CAAE,CAAC,IAAI,CAAC,KAAK,YAAY,MAAM,CAAC;eAChC,CAAE,CAAC,IAAI,CAAC,KAAK,YAAY,uBAAU,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACH,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,kBAAkB;QACd,IAAI,CAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,YAAY,uBAAU,EAAE;YAClD,OAAO,KAAK,CAAC;SAChB;QAED,OAAO,IAAA,2BAAa,EAAC,IAAI,CAAC,KAAK,CAAC;eACzB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ;QACJ,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QAEzE,OAAO;YACH,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO;YACZ,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC;SACxD;YACD,MAAM,CAAC,OAAO,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,CAAC;IAEO,SAAS,CAAC,KAAc;QAC5B,IAAI,KAAK,YAAY,IAAI,EAAE;YACvB,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;SAC9B;QAED,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;QAExD,IAAI,SAAS,IAAI,CAAC,IAAA,gBAAW,EAAC,KAAK,CAAC,IAAI,KAAK,YAAY,MAAM,CAAC,EAAE;YAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;SACxB;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ;AAED,MAAM,IAAI;IAGN,YACI,aAAsB,EACtB,WAAoB;QAEpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC1D,CAAC;IAEO,QAAQ,CAAC,aAAsB,EAAE,WAAoB;QACzD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CACrC,IAAI,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,EACxC,IAAI,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,CACzC,CAAC;QAEF,IAAI,IAAI,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YACpD,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;SACnD;QAED,IAAI,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YAC7C,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;SAChD;QAED,IAAI,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;SACjD;QAED,OAAO;YACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3B,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE;SACnB,CAAA;IACL,CAAC;IAEO,2BAA2B,CAAC,QAAmB,EAAE,MAAiB;QACtE,OAAO,MAAM,CAAC,SAAS,EAAE;eAClB,CAAE,MAAM,CAAC,UAAU,EAAE;eACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAEO,oBAAoB,CAAC,QAAmB,EAAE,MAAiB;QAC/D,OAAO,QAAQ,CAAC,kBAAkB,EAAE;eAC7B,MAAM,CAAC,kBAAkB,EAAE;eAC3B,CAAE,QAAQ,CAAC,UAAU,EAAE;eACvB,CAAE,MAAM,CAAC,UAAU,EAAE,CAAA;IAChC,CAAC;IAEO,qBAAqB,CAAC,QAAmB,EAAE,MAAiB;QAChE,OAAO,QAAQ,CAAC,OAAO,EAAE;eAClB,MAAM,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAEO,OAAO,CAAC,QAAmB,EAAE,MAAiB;QAClD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC3B,QAAQ,CAAC,sBAAsB,EAC/B,MAAM,CAAC,sBAAsB,CAChC,CAAC;QAEF,OAAO;YACH,QAAQ,EAAE,QAAQ,CAAC,sBAAsB,CAAC,cAAc,CAAC;YACzD,MAAM,EAAI,MAAM,CAAC,sBAAsB,CAAC,cAAc,CAAC;SAC1D,CAAC;IACN,CAAC;IAEO,iBAAiB,CAAC,QAAmB,EAAE,MAAiB;QAE5D,MAAM,KAAK,GAAG,IAAA,cAAS,EAAC,MAAM,CAAC,KAAK,CAAC;aAChC,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE7B,OAAO;YACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3B,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE;YAChB,GAAG,KAAK;YACR,QAAQ,CAAC,KAAK,EAAE;SACnB,CAAC;IACN,CAAC;IAEO,cAAc,CAAC,QAAmB,EAAE,MAAiB;QACzD,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC,QAAQ,CAAC,KAAe,EAAE,MAAM,CAAC,KAAe,CAAC,CAAC;QAE3E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxD,OAAO,GAAG,CAAC,MAAM,CACb,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,CAC3E,CAAA;QACL,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO;YACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAI,OAAQ,EAAE,CAAC;YAC9E,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAI,KAAM,EAAE,CAAC;YAC1E,QAAQ,CAAC,KAAK,EAAE;YAChB,GAAG,KAAK;YACR,QAAQ,CAAC,KAAK,EAAE;SACnB,CAAC;IACN,CAAC;IAEO,eAAe,CAAC,QAAmB,EAAE,MAAiB;QAC1D,MAAM,OAAO,GAAG,IAAA,iBAAU,EAAC,QAAQ,CAAC,KAAuB,EAAE,MAAM,CAAC,KAAuB,EAAE,EAAE,UAAU,EAAE,eAAK,EAAE,CAAE,CAAC;QAErH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,OAAO,GAAG,CAAC,MAAM,CACb,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACb,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAA,cAAS,EAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD,OAAO,CAAC,IAAI,CAAC;iBACb,aAAa,EAAE,CACvB,CACJ,CAAC;QACN,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO;YACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAI,OAAQ,EAAE,CAAC;YAC9E,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAI,KAAM,EAAE,CAAC;YAC1E,QAAQ,CAAC,KAAK,EAAE;YAChB,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;YACzB,GAAG,KAAK;YACR,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE;SACnB,CAAA;IACL,CAAC;IAEO,OAAO,CAAC,OAA6C;QACzD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE;YACjD,OAAO;gBACH,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtD,KAAK,EAAI,KAAK,GAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvD,CAAA;QACL,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;CACJ"}

package/lib/errors/ErrorOptions.d.ts

@@ -0,0 +1,13 @@
+import { FileSystemLocation } from '../io';
+import { ExpectationDetails } from '../screenplay';
+export interface ErrorOptions {
+    message: string;
+    location?: FileSystemLocation;
+    expectation?: ExpectationDetails;
+    diff?: {
+        expected: unknown;
+        actual: unknown;
+    };
+    cause?: Error;
+}
+//# sourceMappingURL=ErrorOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorOptions.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,IAAI,CAAC,EAAE;QACH,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB"}

package/lib/{screenplay/Ability.js → errors/ErrorOptions.js}

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

package/lib/errors/ErrorOptions.js.map

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

package/lib/errors/ErrorSerialiser.d.ts

@@ -1,19 +1,4 @@
 import { JSONObject } from 'tiny-types';
-export interface SerialisedError extends JSONObject {
-    /**
-     *  Name of the constructor function used to instantiate
-     *  the original {@apilink Error} object.
-     */
-    name: string;
-    /**
-     *  Message of the original {@apilink Error} object
-     */
-    message: string;
-    /**
-     *  Stack trace of the original {@apilink Error} object
-     */
-    stack: string;
-}
 /**
  * @group Errors
  */

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorSerialiser.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorSerialiser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,UAAU,EAAa,MAAM,YAAY,CAAC;AAKlF,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAC/C;;;OAGG;IACH,IAAI,EAAK,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAI,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAStC;IAEF,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAiBtC,MAAM,CAAC,kBAAkB,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI;IAQ/E,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS;IAwBvE,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;CAWzD"}
+{"version":3,"file":"ErrorSerialiser.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorSerialiser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,UAAU,EAAa,MAAM,YAAY,CAAC;AAElF;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAStC;IAEF,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAiBtC,MAAM,CAAC,kBAAkB,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI;IAQ/E,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS;IAwBvE,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;CAWzD"}

package/lib/errors/ErrorSerialiser.js

@@ -2,15 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorSerialiser = void 0;
 const tiny_types_1 = require("tiny-types");
-// todo: can I remove it?
-const json_1 = require("./json");
 /**
  * @group Errors
  */
 class ErrorSerialiser {
     static serialise(error) {
         if (this.isSerialisable(error)) {
-            return (0, json_1.stringify)(error.toJSON());
+            return JSON.stringify(error.toJSON(), undefined, 0);
         }
         const name = error && error.constructor && error.constructor.name
             ? error.constructor.name
@@ -19,7 +17,7 @@ class ErrorSerialiser {
             serialised[key] = error[key];
             return serialised;
         }, { name });
-        return (0, json_1.stringify)(serialisedError);
+        return JSON.stringify(serialisedError, undefined, 0);
     }
     static registerErrorTypes(...types) {
         types.forEach(type => {
@@ -31,7 +29,7 @@ class ErrorSerialiser {
             return undefined;
         }
         const serialisedError = typeof serialised === 'string'
-            ? (0, json_1.parse)(serialised)
+            ? JSON.parse(serialised)
             : serialised;
         const constructor = ErrorSerialiser.recognisedErrors.find(errorType => errorType.name === serialisedError.name) || Error;
         if (this.isDeserialisable(constructor)) {
@@ -59,12 +57,12 @@ class ErrorSerialiser {
             return new Error(String(stack));
         }
         const [, name, message, callStack_] = stack.match(stackTracePattern);
-        return ErrorSerialiser.deserialise((0, json_1.stringify)({ name, message: message.trim(), stack }));
+        return ErrorSerialiser.deserialise({ name, message: message.trim(), stack });
     }
 }
 exports.ErrorSerialiser = ErrorSerialiser;
 ErrorSerialiser.recognisedErrors = [
-    // Built-in JavaScript Errors
+    // Built-in JavaScript errors
     Error,
     EvalError,
     RangeError,

package/lib/errors/ErrorSerialiser.js.map

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

package/lib/errors/RaiseErrors.d.ts

@@ -0,0 +1,57 @@
+import { Ability } from '../screenplay';
+import { Stage } from '../stage';
+import { ErrorOptions } from './ErrorOptions';
+import { RuntimeError } from './model';
+/**
+ * An {@apilink Ability} that enables an {@apilink Actor} to create a Serenity/JS {@apilink RuntimeError}
+ * from within a custom {@apilink Interaction}.
+ *
+ * The stack trace of an error created this way includes the filesystem location pointing to where the interaction was invoked,
+ * which makes debugging any failures easier.
+ *
+ * :::info Pro tip
+ * The ability to `RaiseErrors` is given to all Serenity/JS actors by default, so you don't need to configure it explicitly.
+ * :::
+ *
+ * ## Raising an error
+ *
+ * ```typescript
+ * import { Interaction, LogicError, RaiseErrors } from '@serenity-js/core'
+ * import isPathInside from 'is-path-inside'
+ * import { unlink } from 'fs/promises'
+ *
+ * const RemoveFile = (pathToFile: string) =>
+ *   Interaction.where(`#actor removes a file at ${ pathToFile }`, async actor => {
+ *
+ *     if (! isPathInside(pathToFile, process.cwd())) {
+ *
+ *       throw RaiseErrors.as(actor).create(LogicError, {
+ *         message: `Removing files outside the current working directory is not allowed`
+ *         diff: {
+ *           expected: process.cwd(),
+ *           actual: pathToFile,
+ *         }
+ *       })
+ *     }
+ *
+ *     await unlink(pathToFile);
+ *   })
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink ErrorOptions}
+ * - {@apilink ErrorFactory}
+ * - {@apilink AssertionError}
+ * - {@apilink ConfigurationError}
+ * - {@apilink LogicError}
+ * - {@apilink RuntimeError}
+ * - {@apilink TestCompromisedError}
+ *
+ * @group Errors
+ */
+export declare class RaiseErrors extends Ability {
+    private readonly stage;
+    constructor(stage: Stage);
+    create<RE extends RuntimeError>(errorType: new (...args: any[]) => RE, options: ErrorOptions): RE;
+}
+//# sourceMappingURL=RaiseErrors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RaiseErrors.d.ts","sourceRoot":"","sources":["../../src/errors/RaiseErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAIzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,EAAE;CAGpG"}