@serenity-js/core 3.0.0-rc.9 → 3.0.1

package/lib/model/tags/IssueTag.d.ts

@@ -6,3 +6,4 @@ export declare class IssueTag extends Tag {
     static readonly Type = "issue";
     constructor(issueId: string);
 }
+//# sourceMappingURL=IssueTag.d.ts.map

package/lib/model/tags/IssueTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssueTag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/IssueTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;GAEG;AACH,qBAAa,QAAS,SAAQ,GAAG;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;gBAEnB,OAAO,EAAE,MAAM;CAG9B"}

package/lib/model/tags/ManualTag.d.ts

@@ -6,3 +6,4 @@ export declare class ManualTag extends Tag {
     static readonly Type = "External Tests";
     constructor(name?: string);
 }
+//# sourceMappingURL=ManualTag.d.ts.map

package/lib/model/tags/ManualTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManualTag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/ManualTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;GAEG;AACH,qBAAa,SAAU,SAAQ,GAAG;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,oBAAoB;gBAE5B,IAAI,SAAW;CAG9B"}

package/lib/model/tags/PlatformTag.d.ts

@@ -16,3 +16,4 @@ export declare class PlatformTag extends Tag {
         platformVersion: string;
     };
 }
+//# sourceMappingURL=PlatformTag.d.ts.map

package/lib/model/tags/PlatformTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformTag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/PlatformTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;GAEG;AACH,qBAAa,WAAY,SAAQ,GAAG;aAQZ,YAAY,EAAE,MAAM;aACpB,eAAe,EAAE,MAAM;IAR3C,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAElC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW;gBAKvB,YAAY,EAAE,MAAM,EACpB,eAAe,GAAE,MAAW;IAUhD,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;CAQ1F"}

package/lib/model/tags/PlatformTag.js

@@ -6,6 +6,9 @@ const Tag_1 = require("./Tag");
  * @access public
  */
 class PlatformTag extends Tag_1.Tag {
+    static fromJSON(o) {
+        return new PlatformTag(o.platformName, o.platformVersion);
+    }
     constructor(platformName, platformVersion = '') {
         super([platformName, platformVersion]
             .filter(_ => !!_)
@@ -13,9 +16,6 @@ class PlatformTag extends Tag_1.Tag {
         this.platformName = platformName;
         this.platformVersion = platformVersion;
     }
-    static fromJSON(o) {
-        return new PlatformTag(o.platformName, o.platformVersion);
-    }
     toJSON() {
         return {
             name: this.name,

package/lib/model/tags/PlatformTag.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlatformTag.js","sourceRoot":"","sources":["../../../src/model/tags/PlatformTag.ts"],"names":[],"mappings":";;;AAEA,+BAA4B;AAE5B;;GAEG;AACH,MAAa,WAAY,SAAQ,SAAG;IAOhC,YACoB,YAAoB,EACpB,kBAA0B,EAAE;QAE5C,KAAK,CACD,CAAE,YAAY,EAAE,eAAe,CAAE;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;aACjB,IAAI,CAAC,GAAG,CAAC,EACd,WAAW,CAAC,IAAI,CACnB,CAAC;QARc,iBAAY,GAAZ,YAAY,CAAQ;QACpB,oBAAe,GAAf,eAAe,CAAa;IAQhD,CAAC;IAdD,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,YAAsB,EAAE,CAAC,CAAC,eAAyB,CAAC,CAAC;IAClF,CAAC;IAcD,MAAM;QACF,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;SACxC,CAAC;IACN,CAAC;;AA1BL,kCA2BC;AA1BmB,gBAAI,GAAG,UAAU,CAAC"}
+{"version":3,"file":"PlatformTag.js","sourceRoot":"","sources":["../../../src/model/tags/PlatformTag.ts"],"names":[],"mappings":";;;AAEA,+BAA4B;AAE5B;;GAEG;AACH,MAAa,WAAY,SAAQ,SAAG;IAGhC,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,YAAsB,EAAE,CAAC,CAAC,eAAyB,CAAC,CAAC;IAClF,CAAC;IAED,YACoB,YAAoB,EACpB,kBAA0B,EAAE;QAE5C,KAAK,CACD,CAAE,YAAY,EAAE,eAAe,CAAE;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;aACjB,IAAI,CAAC,GAAG,CAAC,EACd,WAAW,CAAC,IAAI,CACnB,CAAC;QARc,iBAAY,GAAZ,YAAY,CAAQ;QACpB,oBAAe,GAAf,eAAe,CAAa;IAQhD,CAAC;IAED,MAAM;QACF,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;SACxC,CAAC;IACN,CAAC;;AA1BL,kCA2BC;AA1BmB,gBAAI,GAAG,UAAU,CAAC"}

package/lib/model/tags/Tag.d.ts

@@ -12,3 +12,4 @@ export declare abstract class Tag extends TinyType {
         type: string;
     };
 }
+//# sourceMappingURL=Tag.d.ts.map

package/lib/model/tags/Tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/Tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,UAAU,EAAY,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIxG;;GAEG;AACH,8BAAsB,GAAI,SAAQ,QAAQ;aAaA,IAAI,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;IAZhF,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,GAAG;IAYnC,SAAS,aAA6B,IAAI,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;IAOhF,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAG3C"}

package/lib/model/tags/Tag.js

@@ -1,19 +1,35 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tag = void 0;
 const tiny_types_1 = require("tiny-types");
-const TagTypes = require("./index");
+const TagTypes = __importStar(require("./index"));
 /**
  * @access public
  */
 class Tag extends tiny_types_1.TinyType {
-    constructor(name, type) {
-        super();
-        this.name = name;
-        this.type = type;
-        (0, tiny_types_1.ensure)('Tag name', name, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.property)('length', (0, tiny_types_1.isGreaterThan)(0)));
-        (0, tiny_types_1.ensure)('Tag type', type, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.property)('length', (0, tiny_types_1.isGreaterThan)(0)));
-    }
     static fromJSON(o) {
         const type = (0, tiny_types_1.ensure)('serialised tag type', o.type, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
         const found = Object.keys(TagTypes).find(t => TagTypes[t].Type === type) || TagTypes.ArbitraryTag.name;
@@ -22,6 +38,13 @@ class Tag extends tiny_types_1.TinyType {
         }
         return new TagTypes[found](o.name);
     }
+    constructor(name, type) {
+        super();
+        this.name = name;
+        this.type = type;
+        (0, tiny_types_1.ensure)('Tag name', name, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.property)('length', (0, tiny_types_1.isGreaterThan)(0)));
+        (0, tiny_types_1.ensure)('Tag type', type, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.property)('length', (0, tiny_types_1.isGreaterThan)(0)));
+    }
     toJSON() {
         return super.toJSON();
     }

package/lib/model/tags/Tag.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tag.js","sourceRoot":"","sources":["../../../src/model/tags/Tag.ts"],"names":[],"mappings":";;;AAAA,2CAAwG;AAExG,oCAAoC;AAEpC;;GAEG;AACH,MAAsB,GAAI,SAAQ,qBAAQ;IAatC,YAAsC,IAAY,EAAkB,IAAY;QAC5E,KAAK,EAAE,CAAC;QAD0B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;QAG5E,IAAA,mBAAM,EAAC,UAAU,EAAE,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,EAAC,QAAQ,EAAE,IAAA,0BAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAA,mBAAM,EAAC,UAAU,EAAE,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,EAAC,QAAQ,EAAE,IAAA,0BAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAjBD,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,MAAM,IAAI,GAAW,IAAA,mBAAM,EAAC,qBAAqB,EAAE,CAAC,CAAC,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAW,CAAC;QAE9F,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;QAEvG,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,EAAE;YACnE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACtC;QAED,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IASD,MAAM;QACF,OAAO,KAAK,CAAC,MAAM,EAAoC,CAAC;IAC5D,CAAC;CACJ;AAvBD,kBAuBC"}
+{"version":3,"file":"Tag.js","sourceRoot":"","sources":["../../../src/model/tags/Tag.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAwG;AAExG,kDAAoC;AAEpC;;GAEG;AACH,MAAsB,GAAI,SAAQ,qBAAQ;IACtC,MAAM,CAAC,QAAQ,CAAC,CAAa;QACzB,MAAM,IAAI,GAAW,IAAA,mBAAM,EAAC,qBAAqB,EAAE,CAAC,CAAC,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAW,CAAC;QAE9F,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;QAEvG,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,EAAE;YACnE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACtC;QAED,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,YAAsC,IAAY,EAAkB,IAAY;QAC5E,KAAK,EAAE,CAAC;QAD0B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;QAG5E,IAAA,mBAAM,EAAC,UAAU,EAAE,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,EAAC,QAAQ,EAAE,IAAA,0BAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAA,mBAAM,EAAC,UAAU,EAAE,IAAI,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,EAAC,QAAQ,EAAE,IAAA,0BAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,MAAM;QACF,OAAO,KAAK,CAAC,MAAM,EAAoC,CAAC;IAC5D,CAAC;CACJ;AAvBD,kBAuBC"}

package/lib/model/tags/Tags.d.ts

@@ -6,3 +6,4 @@ export declare class Tags {
     private static Pattern;
     static from(text: string): Tag[];
 }
+//# sourceMappingURL=Tags.d.ts.map

package/lib/model/tags/Tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tags.d.ts","sourceRoot":"","sources":["../../../src/model/tags/Tags.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqC,GAAG,EAAE,MAAM,IAAI,CAAC;AAE5D;;GAEG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAC,OAAO,CAA4B;WAEpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE;CAS1C"}

package/lib/model/tags/ThemeTag.d.ts

@@ -6,3 +6,4 @@ export declare class ThemeTag extends Tag {
     static readonly Type = "theme";
     constructor(theme: string);
 }
+//# sourceMappingURL=ThemeTag.d.ts.map

package/lib/model/tags/ThemeTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeTag.d.ts","sourceRoot":"","sources":["../../../src/model/tags/ThemeTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;GAEG;AACH,qBAAa,QAAS,SAAQ,GAAG;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;gBAEnB,KAAK,EAAE,MAAM;CAG5B"}

package/lib/model/tags/index.d.ts

@@ -1,7 +1,6 @@
 export * from './ArbitraryTag';
 export * from './BrowserTag';
 export * from './CapabilityTag';
-export * from './ContextTag';
 export * from './ExecutionRetriedTag';
 export * from './FeatureTag';
 export * from './IssueTag';
@@ -10,3 +9,4 @@ export * from './PlatformTag';
 export * from './Tag';
 export * from './Tags';
 export * from './ThemeTag';
+//# sourceMappingURL=index.d.ts.map

package/lib/model/tags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/model/tags/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/lib/model/tags/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -13,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ArbitraryTag"), exports);
 __exportStar(require("./BrowserTag"), exports);
 __exportStar(require("./CapabilityTag"), exports);
-__exportStar(require("./ContextTag"), exports);
 __exportStar(require("./ExecutionRetriedTag"), exports);
 __exportStar(require("./FeatureTag"), exports);
 __exportStar(require("./IssueTag"), exports);

package/lib/model/tags/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/model/tags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,wDAAsC;AACtC,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,wCAAsB;AACtB,yCAAuB;AACvB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/model/tags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,kDAAgC;AAChC,wDAAsC;AACtC,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,wCAAsB;AACtB,yCAAuB;AACvB,6CAA2B"}

package/lib/screenplay/Activity.d.ts

@@ -1,31 +1,47 @@
-import { AnswersQuestions, PerformsActivities, UsesAbilities } from './actor';
+import { FileSystemLocation } from '../io';
+import { UsesAbilities } from './abilities';
+import { PerformsActivities } from './activities';
+import { AnswersQuestions } from './questions';
 /**
- * @desc
- *  A command object representing an activity that an {@link Actor} can perform.
+ * **Activities** represents {@apilink Task|tasks} and {@apilink Interaction|interactions} to be performed by an {@apilink Actor|actor}.
  *
- * @see {@link Actor}
- * @see https://en.wikipedia.org/wiki/Command_pattern
+ * Learn more about:
+ * - [Performing activities at multiple levels](/handbook/design/screenplay-pattern#performing-activities-at-multiple-levels)
+ * - {@apilink Actor}
+ * - {@apilink PerformsActivities}
+ * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
+ *
+ * @group Screenplay Pattern
  */
-export interface Activity {
+export declare abstract class Activity {
+    #private;
+    private static errorStackParser;
+    constructor(description: string, location?: FileSystemLocation);
+    /**
+     * Returns the location where this {@apilink Activity} was instantiated.
+     */
+    instantiationLocation(): FileSystemLocation;
     /**
-     * @desc
-     *  Makes the provided {@link Actor}
-     *  perform this Activity.
+     * Instructs the provided {@apilink Actor} to perform this {@apilink Activity}.
      *
-     * @param {PerformsActivities | UsesAbilities | AnswersQuestions} actor
-     * @returns {Promise<void>}
+     * @param actor
      *
-     * @see {@link Actor}
-     * @see {@link PerformsActivities}
-     * @see {@link UsesAbilities}
-     * @see {@link AnswersQuestions}
+     * #### Learn more
+     * - {@apilink Actor}
+     * - {@apilink PerformsActivities}
+     * - {@apilink UsesAbilities}
+     * - {@apilink AnswersQuestions}
      */
-    performAs(actor: PerformsActivities | UsesAbilities | AnswersQuestions): PromiseLike<any>;
+    abstract performAs(actor: PerformsActivities | UsesAbilities | AnswersQuestions): Promise<any>;
     /**
-     * @desc
-     *  Generates a description to be used when reporting this Activity.
+     * Generates a human-friendly description to be used when reporting this Activity.
+     *
+     * **Note**: When this activity is reported, token `#actor` in the description
+     * will be replaced with the name of the actor performing this Activity.
      *
-     * @returns {string}
+     * For example, `#actor clicks on a button` becomes `Wendy clicks on a button`.
      */
     toString(): string;
+    protected static callerLocation(frameOffset: number): FileSystemLocation;
 }
+//# sourceMappingURL=Activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../src/screenplay/Activity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAQ,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,8BAAsB,QAAQ;;IAE1B,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;gBAKrD,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,kBAA+C;IAM7D;;OAEG;IACH,qBAAqB,IAAI,kBAAkB;IAI3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAE9F;;;;;;;OAOG;IACH,QAAQ,IAAI,MAAM;IAIlB,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;CA0B3E"}

package/lib/screenplay/Activity.js

@@ -1,3 +1,77 @@
 "use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _Activity_description, _Activity_location;
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Activity = void 0;
+const path_1 = __importDefault(require("path"));
+const errors_1 = require("../errors");
+const io_1 = require("../io");
+/**
+ * **Activities** represents {@apilink Task|tasks} and {@apilink Interaction|interactions} to be performed by an {@apilink Actor|actor}.
+ *
+ * Learn more about:
+ * - [Performing activities at multiple levels](/handbook/design/screenplay-pattern#performing-activities-at-multiple-levels)
+ * - {@apilink Actor}
+ * - {@apilink PerformsActivities}
+ * - [Command design pattern on Wikipedia](https://en.wikipedia.org/wiki/Command_pattern)
+ *
+ * @group Screenplay Pattern
+ */
+class Activity {
+    constructor(description, location = Activity.callerLocation(5)) {
+        _Activity_description.set(this, void 0);
+        _Activity_location.set(this, void 0);
+        __classPrivateFieldSet(this, _Activity_description, description, "f");
+        __classPrivateFieldSet(this, _Activity_location, location, "f");
+    }
+    /**
+     * Returns the location where this {@apilink Activity} was instantiated.
+     */
+    instantiationLocation() {
+        return __classPrivateFieldGet(this, _Activity_location, "f");
+    }
+    /**
+     * Generates a human-friendly description to be used when reporting this Activity.
+     *
+     * **Note**: When this activity is reported, token `#actor` in the description
+     * will be replaced with the name of the actor performing this Activity.
+     *
+     * For example, `#actor clicks on a button` becomes `Wendy clicks on a button`.
+     */
+    toString() {
+        return __classPrivateFieldGet(this, _Activity_description, "f");
+    }
+    static callerLocation(frameOffset) {
+        const originalStackTraceLimit = Error.stackTraceLimit;
+        Error.stackTraceLimit = 30;
+        const error = new Error('Caller location marker');
+        Error.stackTraceLimit = originalStackTraceLimit;
+        const nonSerenityNodeModulePattern = new RegExp(`node_modules` + `\\` + path_1.default.sep + `(?!@serenity-js` + `\\` + path_1.default.sep + `)`);
+        const frames = this.errorStackParser.parse(error);
+        const userLandFrames = frames.filter(frame => !((frame === null || frame === void 0 ? void 0 : frame.fileName.startsWith('node:')) || // node 16 and 18
+            (frame === null || frame === void 0 ? void 0 : frame.fileName.startsWith('internal')) || // node 14
+            nonSerenityNodeModulePattern.test(frame === null || frame === void 0 ? void 0 : frame.fileName) // ignore node_modules, except for @serenity-js/*
+        ));
+        const index = Math.min(Math.max(1, frameOffset), userLandFrames.length - 1);
+        // use the desired user-land frame, or the last one from the stack trace for internal invocations
+        const invocationFrame = userLandFrames[index] || frames[frames.length - 1];
+        return new io_1.FileSystemLocation(io_1.Path.from(invocationFrame.fileName), invocationFrame.lineNumber, invocationFrame.columnNumber);
+    }
+}
+exports.Activity = Activity;
+_Activity_description = new WeakMap(), _Activity_location = new WeakMap();
+Activity.errorStackParser = new errors_1.ErrorStackParser();
 //# sourceMappingURL=Activity.js.map

package/lib/screenplay/Activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"Activity.js","sourceRoot":"","sources":["../../src/screenplay/Activity.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Activity.js","sourceRoot":"","sources":["../../src/screenplay/Activity.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,gDAAwB;AAExB,sCAA6C;AAC7C,8BAAiD;AAKjD;;;;;;;;;;GAUG;AACH,MAAsB,QAAQ;IAM1B,YACI,WAAmB,EACnB,WAA+B,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QAL7D,wCAA8B;QAC9B,qCAAuC;QAMnC,uBAAA,IAAI,yBAAgB,WAAW,MAAA,CAAC;QAChC,uBAAA,IAAI,sBAAa,QAAQ,MAAA,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACjB,OAAO,uBAAA,IAAI,0BAAU,CAAC;IAC1B,CAAC;IAeD;;;;;;;OAOG;IACH,QAAQ;QACJ,OAAO,uBAAA,IAAI,6BAAa,CAAC;IAC7B,CAAC;IAES,MAAM,CAAC,cAAc,CAAC,WAAmB;QAE/C,MAAM,uBAAuB,GAAG,KAAK,CAAC,eAAe,CAAC;QACtD,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAClD,KAAK,CAAC,eAAe,GAAG,uBAAuB,CAAC;QAEhD,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,cAAc,GAAG,IAAI,GAAG,cAAI,CAAC,GAAG,GAAG,iBAAiB,GAAE,IAAI,GAAG,cAAI,CAAC,GAAG,GAAE,GAAG,CAAC,CAAC;QAE5H,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAE,CAC5C,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,KAAa,iBAAiB;aACjE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA,IAAU,UAAU;YAC1D,4BAA4B,CAAC,IAAI,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,QAAQ,CAAC,CAAI,iDAAiD;SAC1G,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,iGAAiG;QACjG,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE3E,OAAO,IAAI,uBAAkB,CACzB,SAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EACnC,eAAe,CAAC,UAAU,EAC1B,eAAe,CAAC,YAAY,CAC/B,CAAC;IACN,CAAC;;AAvEL,4BAwEC;;AAtEkB,yBAAgB,GAAG,IAAI,yBAAgB,EAAE,CAAC"}

package/lib/screenplay/Actor.d.ts

@@ -0,0 +1,146 @@
+import { Artifact, Name } from '../model';
+import { Ability, AbilityType, Answerable } from '../screenplay';
+import { Stage } from '../stage';
+import { CanHaveAbilities, UsesAbilities } from './abilities';
+import { PerformsActivities } from './activities';
+import { Activity } from './Activity';
+import { CollectsArtifacts } from './artifacts';
+import { AnswersQuestions } from './questions';
+/**
+ * **Actors** represent **people** and **external systems** interacting with the system under test.
+ * Their role is to perform {@apilink Activity|activities} that demonstrate how to accomplish a given goal.
+ *
+ * Actors are the core building block of the [Screenplay Pattern](/handbook/design/screenplay-pattern),
+ * along with {@apilink Ability|Abilities}, {@apilink Interaction|Interactions}, {@apilink Task|Tasks}, and {@apilink Question|Questions}.
+ * Actors are also the first thing you see in a typical Serenity/JS test scenario.
+ *
+ * ![Screenplay Pattern](/images/design/serenity-js-screenplay-pattern.png)
+ *
+ * Learn more about:
+ * - {@apilink Cast}
+ * - {@apilink Stage}
+ * - {@apilink Ability|Abilities}
+ * - {@apilink Activity|Activities}
+ * - {@apilink Interaction|Interactions}
+ * - {@apilink Task|Tasks}
+ * - {@apilink Question|Questions}
+ *
+ * ## Representing people and systems as actors
+ *
+ * To use a Serenity/JS {@apilink Actor}, all you need is to say their name:
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')
+ * // returns: Actor
+ * ```
+ *
+ * Serenity/JS actors perform within the scope of a test scenario, so the first time you invoke {@apilink actorCalled},
+ * Serenity/JS instantiates a new actor from the default {@apilink Cast} of actors (or any custom cast you might have {@apilink configured|configured}).
+ * Any subsequent invocations of this function within the scope of the same test scenario retrieve the already instantiated actor, identified by their name.
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core'
+ *
+ * actorCalled('Alice')    // instantiates Alice
+ * actorCalled('Bob')      // instantiates Bob
+ * actorCalled('Alice')    // retrieves Alice, since she's already been instantiated
+ * ```
+ *
+ * Serenity/JS scenarios can involve as many or as few actors as you need to model the given business workflow.
+ * For example, you might want to use **multiple actors** in test scenarios that model how **different people** perform different parts of a larger business process, such as reviewing and approving a loan application.
+ * It is also quite common to introduce **supporting actors** to perform **administrative tasks**, like setting up test data and environment, or **audit tasks**, like checking the logs or messages emitted to a message queue
+ * by the system under test.
+ *
+ * :::info The Stan Lee naming convention
+ * Actor names can be much more than just simple identifiers like `Alice` or `Bob`. While you can give your actors any names you like, a good convention to follow is to give them
+ * names indicating the [personae](https://articles.uie.com/goodwin_interview/) they represent or the role they play in the system.
+ *
+ * Just like the characters in [Stan Lee](https://en.wikipedia.org/wiki/Stan_Lee) graphic novels,
+ * actors in Serenity/JS test scenarios are often given alliterate names as a mnemonic device.
+ * Names like "Adam the Admin", "Edna the Editor", "Trevor the Traveller", are far more memorable than a generic "UI user" or "API user".
+ * They're also much easier for people to associate with the context, constraints, and affordances of the given actor.
+ * :::
+ *
+ * @group Screenplay Pattern
+ */
+export declare class Actor implements PerformsActivities, UsesAbilities, CanHaveAbilities<Actor>, AnswersQuestions, CollectsArtifacts {
+    readonly name: string;
+    private readonly stage;
+    private readonly abilities;
+    constructor(name: string, stage: Stage, abilities?: Map<AbilityType<Ability>, Ability>);
+    /**
+     * Retrieves actor's {@apilink Ability} of `abilityType`, or one that extends `abilityType`.
+     *
+     * Please note that this method performs an {@apilink instanceof} check against abilities
+     * given to this actor via {@apilink Actor.whoCan}.
+     *
+     * Please also note that {@apilink Actor.whoCan} performs the same check when abilities are assigned to the actor
+     * to ensure the actor has at most one instance of a given ability type.
+     *
+     * @param abilityType
+     */
+    abilityTo<T extends Ability>(abilityType: AbilityType<T>): T;
+    /**
+     * Instructs the actor to attempt to perform a number of {@apilink Activity|activities},
+     * so either {@apilink Task|Tasks} or {@apilink Interaction|Interactions}),
+     * one by one.
+     *
+     * @param {...activities: Activity[]} activities
+     */
+    attemptsTo(...activities: Activity[]): Promise<void>;
+    /**
+     * Gives this Actor a list of {@apilink Ability|abilities} they can use
+     * to interact with the system under test or the test environment.
+     *
+     * @param abilities
+     *  A vararg list of abilities to give the actor
+     *
+     * @returns
+     *  The actor with newly gained abilities
+     *
+     * @throws {@apilink ConfigurationError}
+     *  Throws a ConfigurationError if the actor already has an ability of this type.
+     */
+    whoCan(...abilities: Ability[]): Actor;
+    /**
+     * @param answerable -
+     *  An {@apilink Answerable} to answer (resolve the value of).
+     *
+     * @returns
+     *  The answer to the Answerable
+     */
+    answer<T>(answerable: Answerable<T>): Promise<T>;
+    /**
+     * Announce collection of an {@apilink Artifact} so that it can be picked up by a {@apilink StageCrewMember}.
+     *
+     * @param artifact
+     * @param name
+     */
+    collect(artifact: Artifact, name?: string | Name): void;
+    /**
+     * Instructs the actor to invoke {@apilink Discardable.discard} method on any
+     * {@apilink Discardable} {@apilink Ability} it's been configured with.
+     */
+    dismiss(): Promise<void>;
+    /**
+     * Returns a human-readable, string representation of this actor and their abilities.
+     *
+     * **PRO TIP:** To get the name of the actor, use {@apilink Actor.name}
+     */
+    toString(): string;
+    private initialiseAbilities;
+    private findAbilitiesOfType;
+    private findAbilityTo;
+    private acquireAbility;
+    private mostGenericTypeOf;
+    /**
+     * Instantiates a {@apilink Name} based on the string value of the parameter,
+     * or returns the argument if it's already an instance of {@apilink Name}.
+     *
+     * @param maybeName
+     */
+    private nameFrom;
+}
+//# sourceMappingURL=Actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/screenplay/Actor.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,QAAQ,EAMR,IAAI,EAEP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAA2C,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,KAAM,YACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,CAAC,KAAK,CAAC,EACvB,gBAAgB,EAChB,iBAAiB;aAGG,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFV,IAAI,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAA4C;IAI7G;;;;;;;;;;OAUG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAqB5D;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK;IAMtC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBhD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUvD;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAMlB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,iBAAiB;IASzB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAKnB"}