@serenity-js/web 3.9.1 → 3.10.1

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

@@ -1 +1 @@
-{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Text.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Text.ts"],"names":[],"mappings":";;;AACA,4CAAgD;AAChD,iDAAoD;AAGpD,sCAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,MAAa,IAAI;IAEb;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,WAAuD;QAC7D,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,eAAgB,WAAY,EAAE,EACjD,KAAK,EAAC,KAAK,EAAC,EAAE;YACV,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAEhD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC,EACD,CAAC,MAA+B,EAAE,EAAE,CAChC,IAAI,CAAC,EAAE,CAAC,oBAAW,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CACnD,CAAC;IACN,CAAC;IAcD,MAAM,CAAC,KAAK,CAAC,YAAsD;QAC/D,IAAI,eAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE;YACxC,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,eAAgB,YAAa,EAAE,EAClD,cAAc,CAAC,YAAY,CAAC,EAC5B,CAAC,MAA+B,EAAE,EAAE,CAChC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAC1C,CAAC;SACL;QAED,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,eAAgB,YAAa,EAAE,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1F,CAAC;CACJ;AA/CD,oBA+CC;AAED,SAAS,cAAc,CAAC,YAAuC;IAC3D,OAAO,KAAK,EAAE,KAAuB,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAkB,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACjE,OAAO,IAAA,aAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAA;AACL,CAAC"}

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

@@ -1,5 +1,4 @@
-import type { AnswersQuestions, MetaQuestion, MetaQuestionAdapter, QuestionAdapter, UsesAbilities } from '@serenity-js/core';
-import { Question } from '@serenity-js/core';
+import type { MetaQuestionAdapter, QuestionAdapter } from '@serenity-js/core';
 import { PageElement } from '../models';
 /**
  * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
@@ -55,9 +54,7 @@ import { PageElement } from '../models';
  *
  * @group Questions
  */
-export declare class Value extends Question<Promise<string>> implements MetaQuestion<PageElement, string> {
-    private readonly element;
-    private subject;
+export declare class Value {
     /**
      * Instantiates a {@apilink Question} that uses
      * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
@@ -69,30 +66,5 @@ export declare class Value extends Question<Promise<string>> implements MetaQues
      * @param pageElement
      */
     static of(pageElement: QuestionAdapter<PageElement> | PageElement): MetaQuestionAdapter<PageElement, string>;
-    protected constructor(element: QuestionAdapter<PageElement> | PageElement);
-    /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the `value` attribute of a given {@apilink PageElement}
-     * located within the `parent` element.
-     *
-     * #### Learn more
-     * - {@apilink MetaQuestion}
-     *
-     * @param parent
-     */
-    of(parent: QuestionAdapter<PageElement> | PageElement): Question<Promise<string>>;
-    /**
-     * @inheritDoc
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string>;
-    /**
-     * @inheritDoc
-     */
-    describedAs(subject: string): this;
-    /**
-     * @inheritDoc
-     */
-    toString(): string;
 }
 //# sourceMappingURL=Value.d.ts.map

package/lib/screenplay/questions/Value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAC,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5H,OAAO,EAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBAAa,KACT,SAAQ,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAChC,YAAW,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC;IAkBtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB9C,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC;IAI5G,SAAS,aAA8B,OAAO,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,WAAW;IAK1F;;;;;;;;;;OAUG;IACH,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAIjF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1E;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGrB"}
+{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBAAa,KAAK;IAEd;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC;CAU/G"}

package/lib/screenplay/questions/Value.js

@@ -57,7 +57,7 @@ const models_1 = require("../models");
  *
  * @group Questions
  */
-class Value extends core_1.Question {
+class Value {
     /**
      * Instantiates a {@apilink Question} that uses
      * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
@@ -69,46 +69,10 @@ class Value extends core_1.Question {
      * @param pageElement
      */
     static of(pageElement) {
-        return core_1.Question.createAdapter(new Value(pageElement));
-    }
-    constructor(element) {
-        super();
-        this.element = element;
-        this.subject = (0, core_1.d) `the value of ${element}`;
-    }
-    /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the `value` attribute of a given {@apilink PageElement}
-     * located within the `parent` element.
-     *
-     * #### Learn more
-     * - {@apilink MetaQuestion}
-     *
-     * @param parent
-     */
-    of(parent) {
-        return new Value(models_1.PageElement.of(this.element, parent));
-    }
-    /**
-     * @inheritDoc
-     */
-    async answeredBy(actor) {
-        const element = await actor.answer(this.element);
-        return element.value();
-    }
-    /**
-     * @inheritDoc
-     */
-    describedAs(subject) {
-        this.subject = subject;
-        return this;
-    }
-    /**
-     * @inheritDoc
-     */
-    toString() {
-        return this.subject;
+        return core_1.Question.about((0, core_1.d) `the value of ${pageElement}`, async (actor) => {
+            const element = await actor.answer(pageElement);
+            return element.value();
+        }, (parent) => Value.of(models_1.PageElement.of(pageElement, parent)));
     }
 }
 exports.Value = Value;

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

@@ -1 +1 @@
-{"version":3,"file":"Value.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":";;;AACA,4CAAgD;AAEhD,sCAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAa,KACT,SAAQ,eAAyB;IAKjC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,WAAuD;QAC7D,OAAO,eAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAA6C,CAAC;IACtG,CAAC;IAED,YAAuC,OAAmD;QACtF,KAAK,EAAE,CAAC;QAD2B,YAAO,GAAP,OAAO,CAA4C;QAEtF,IAAI,CAAC,OAAO,GAAG,IAAA,QAAC,EAAA,gBAAiB,OAAQ,EAAE,CAAC;IAChD,CAAC;IAED;;;;;;;;;;OAUG;IACH,EAAE,CAAC,MAAkD;QACjD,OAAO,IAAI,KAAK,CAAC,oBAAW,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AA/DD,sBA+DC"}
+{"version":3,"file":"Value.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":";;;AACA,4CAAgD;AAEhD,sCAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAa,KAAK;IAEd;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,WAAuD;QAC7D,OAAO,eAAQ,CAAC,KAAK,CAAC,IAAA,QAAC,EAAA,gBAAiB,WAAY,EAAE,EAClD,KAAK,EAAC,KAAK,EAAC,EAAE;YACV,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAChD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC,EACD,CAAC,MAA+B,EAAE,EAAE,CAChC,KAAK,CAAC,EAAE,CAAC,oBAAW,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CACpD,CAAC;IACN,CAAC;CACJ;AAtBD,sBAsBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/web",
-  "version": "3.9.1",
+  "version": "3.10.1",
   "description": "Serenity/JS Screenplay Pattern APIs for the Web",
   "author": {
     "name": "Jan Molak",
@@ -44,8 +44,8 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/assertions": "3.9.1",
-    "@serenity-js/core": "3.9.1",
+    "@serenity-js/assertions": "3.10.1",
+    "@serenity-js/core": "3.10.1",
     "tiny-types": "^1.20.0"
   },
   "devDependencies": {
@@ -56,7 +56,7 @@
     "mocha": "^10.2.0",
     "mocha-multi": "^1.1.7",
     "ts-node": "^10.9.1",
-    "typescript": "^5.1.6"
+    "typescript": "5.1.6"
   },
-  "gitHead": "237e0291a7eca71e5f5c0777e1f9d637e8622113"
+  "gitHead": "7ab90f30b17ed745cad713363a27edfd7cdce08a"
 }

package/src/screenplay/models/Page.ts

@@ -276,6 +276,7 @@ export abstract class Page<Native_Element_Type = any> implements Optional, Switc
      *
      * @param selector
      */
+    // abstract locateAll(selector: Selector): PageElements<Native_Element_Type>;
     abstract locateAll(selector: Selector): PageElements<Native_Element_Type>;
 
     /**

package/src/screenplay/models/PageElement.ts

@@ -1,4 +1,4 @@
-import type { Answerable, MetaQuestion, MetaQuestionAdapter,Optional, QuestionAdapter } from '@serenity-js/core';
+import type { Answerable, MetaQuestionAdapter, Optional } from '@serenity-js/core';
 import { d, Question } from '@serenity-js/core';
 import { ensure, isDefined } from 'tiny-types';
 
@@ -22,21 +22,21 @@ import type { SwitchableOrigin } from './SwitchableOrigin';
  */
 export abstract class PageElement<Native_Element_Type = any> implements Optional, Switchable {
 
-    static from<NET>(nativeElement: NET): QuestionAdapter<PageElement<NET>> & MetaQuestion<PageElement, PageElement> {
+    static from<NET>(nativeElement: NET): MetaQuestionAdapter<PageElement<NET>, PageElement<NET>> {
         return Question.about(`native page element`, async actor => {
             const currentPage = await BrowseTheWeb.as<BrowseTheWeb<NET>>(actor).currentPage();
 
             return currentPage.createPageElement(nativeElement);
-        }) as QuestionAdapter<PageElement<NET>> & MetaQuestion<PageElement, PageElement>;
+        });
     }
 
-    static located<NET>(selector: Answerable<Selector>): QuestionAdapter<PageElement<NET>> & MetaQuestion<PageElement, PageElement> {
+    static located<NET>(selector: Answerable<Selector>): MetaQuestionAdapter<PageElement<NET>, PageElement<NET>> {
         return Question.about(d`page element located ${ selector }`, async actor => {
             const bySelector  = await actor.answer(selector);
             const currentPage = await BrowseTheWeb.as<BrowseTheWeb<NET>>(actor).currentPage();
 
             return currentPage.locate(bySelector);
-        }) as QuestionAdapter<PageElement<NET>> & MetaQuestion<PageElement, PageElement>;
+        });
     }
 
     static of<NET>(

package/src/screenplay/models/PageElements.ts

@@ -1,9 +1,8 @@
-import type { Answerable, MetaQuestion, MetaQuestionAdapter } from '@serenity-js/core';
-import { List, Question } from '@serenity-js/core';
+import type { Answerable } from '@serenity-js/core';
+import { MetaList } from '@serenity-js/core';
 
-import { BrowseTheWeb } from '../abilities';
-import type { Locator } from './Locator';
 import type { PageElement } from './PageElement';
+import { PageElementsLocator } from './PageElementsLocator';
 import type { Selector } from './selectors';
 
 /**
@@ -13,98 +12,16 @@ import type { Selector } from './selectors';
  * ## Learn more
  *
  * - [Page Element Query Language](/handbook/web-testing/page-element-query-language)
+ * - {@apilink MetaList}
  * - {@apilink List}
- * - {@apilink MetaQuestion}
+ * - {@apilink ChainableMetaQuestion}
  *
  * @group Models
  */
 export class PageElements<Native_Element_Type = any>
-    extends List<PageElement<Native_Element_Type>>
-    implements MetaQuestion<PageElement<Native_Element_Type>, Promise<Array<PageElement<Native_Element_Type>>>>
+    extends MetaList<PageElement<Native_Element_Type>, PageElement<Native_Element_Type>>
 {
-    static located<NET>(selector: Answerable<Selector>): PageElements<NET> {
-        return new PageElements(relativeToDocumentRoot(selector));
+    static located<NET>(selector: Answerable<Selector>): PageElements {
+        return new PageElements(PageElementsLocator.fromDocumentRoot<NET>(selector));
     }
-
-    /**
-     * @param locator
-     */
-    constructor(protected readonly locator: Answerable<Locator<Native_Element_Type>>) {
-        super(allElementsOf(locator));
-    }
-
-    of(parent: Answerable<PageElement<Native_Element_Type>>): PageElements<Native_Element_Type> {
-        return new PageElements<Native_Element_Type>(relativeToParent(this.locator, parent))
-            .describedAs(`${ this.toString() } of ${ parent }`);
-    }
-
-    override count(): MetaQuestionAdapter<PageElement<Native_Element_Type>, number> {
-        const count = super.count();
-        return Question.about(
-            count.toString(),
-            actor => actor.answer(count),
-            (parent: Answerable<PageElement>) => this.of(parent).count(),
-        );
-    }
-
-    override first(): MetaQuestionAdapter<PageElement<Native_Element_Type>, PageElement<Native_Element_Type>> {
-        const first = super.first();
-        return Question.about<PageElement, PageElement>(
-            first.toString(),
-            async actor => actor.answer(first),
-            (parent: Answerable<PageElement>) => this.of(parent).first(),
-        );
-    }
-
-    override last(): MetaQuestionAdapter<PageElement<Native_Element_Type>, PageElement<Native_Element_Type>> {
-        const last = super.last();
-        return Question.about<PageElement, PageElement>(
-            last.toString(),
-            async actor => actor.answer(last),
-            (parent: Answerable<PageElement>) => this.of(parent).last(),
-        );
-    }
-
-    override nth(index: number): MetaQuestionAdapter<PageElement<Native_Element_Type>, PageElement<Native_Element_Type>> {
-        const nth = super.nth(index);
-        return Question.about<PageElement, PageElement>(
-            nth.toString(),
-            async actor => actor.answer(nth),
-            (parent: Answerable<PageElement>) => this.of(parent).nth(index),
-        );
-    }
-}
-
-/**
- * @package
- */
-function relativeToDocumentRoot<Native_Element_Type>(selector: Answerable<Selector>): Question<Promise<Locator<Native_Element_Type>>> {
-    return Question.about(String(selector), async actor => {
-        const bySelector  = await actor.answer(selector);
-        const currentPage = await BrowseTheWeb.as<BrowseTheWeb<Native_Element_Type>>(actor).currentPage();
-
-        return currentPage.locate(bySelector).locator;
-    });
-}
-
-/**
- * @package
- */
-function relativeToParent<Native_Element_Type>(relativeLocator: Answerable<Locator<Native_Element_Type>>, parent: Answerable<PageElement<Native_Element_Type>>): Question<Promise<Locator<Native_Element_Type>>> {
-    return Question.about(`${ relativeLocator.toString() } of ${ parent }`, async actor => {
-        const locator: Locator<Native_Element_Type>             = await actor.answer(relativeLocator);
-        const parentElement: PageElement<Native_Element_Type>   = await actor.answer(parent);
-
-        return locator.of(parentElement.locator);
-    });
-}
-
-/**
- * @package
- */
-function allElementsOf<Native_Element_Type>(locator: Answerable<Locator<Native_Element_Type>>): Question<Promise<Array<PageElement<Native_Element_Type>>>> {
-    return Question.about(`page elements located ${ String(locator) }`, async actor => {
-        const resolved: Locator<Native_Element_Type> = await actor.answer(locator);
-        return resolved.allElements();
-    });
 }

package/src/screenplay/models/PageElementsLocator.ts

@@ -0,0 +1,57 @@
+import type { Answerable, AnswersQuestions, ChainableMetaQuestion, UsesAbilities  } from '@serenity-js/core';
+import { d, Question } from '@serenity-js/core';
+
+import { BrowseTheWeb } from '../abilities';
+import type { Locator } from './Locator';
+import type { PageElement } from './PageElement';
+import type { Selector } from './selectors';
+
+/**
+ * @group Models
+ */
+export class PageElementsLocator<Native_Element_Type = any>
+    extends Question<Promise<Array<PageElement<Native_Element_Type>>>>
+    implements ChainableMetaQuestion<PageElement<Native_Element_Type>, Question<Promise<Array<PageElement<Native_Element_Type>>>>>
+{
+    static fromDocumentRoot<NET>(selector: Answerable<Selector>): PageElementsLocator<NET> {
+        return new PageElementsLocator(
+            Question.about(d`page elements located ${ selector }`, async actor => {
+                const bySelector  = await actor.answer(selector);
+                const currentPage = await BrowseTheWeb.as<BrowseTheWeb<NET>>(actor).currentPage();
+
+                return currentPage.locate(bySelector).locator;
+            })
+        );
+    }
+
+    private subject?: string;
+
+    constructor(private readonly locator: Answerable<Locator<Native_Element_Type>>) {
+        super();
+    }
+
+    of(parent: Answerable<PageElement<Native_Element_Type>>): Question<Promise<Array<PageElement<Native_Element_Type>>>> & ChainableMetaQuestion<PageElement<Native_Element_Type>, Question<Promise<Array<PageElement<Native_Element_Type>>>>> {
+        return new PageElementsLocator(
+            Question.about(this.toString() + d` of ${ parent }`, async actor => {
+                const locator: Locator<Native_Element_Type>             = await actor.answer(this.locator);
+                const parentElement: PageElement<Native_Element_Type>   = await actor.answer(parent);
+
+                return locator.of(parentElement.locator);
+            })
+        );
+    }
+
+    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Array<PageElement<Native_Element_Type>>> {
+        const resolved: Locator<Native_Element_Type> = await actor.answer(this.locator);
+        return resolved.allElements();
+    }
+
+    describedAs(subject: string): this {
+        this.subject = subject;
+        return this;
+    }
+
+    toString(): string {
+        return this.subject ?? d`${ this.locator }`;
+    }
+}

package/src/screenplay/models/index.ts

@@ -8,6 +8,7 @@ export * from './Locator';
 export * from './Page';
 export * from './PageElement';
 export * from './PageElements';
+export * from './PageElementsLocator';
 export * from './RootLocator';
 export * from './SelectOption';
 export * from './selectors';

package/src/screenplay/questions/Attribute.ts

@@ -97,7 +97,7 @@ import { PageElement } from '../models';
  */
 export class Attribute
     extends Question<Promise<string>>
-    implements MetaQuestion<PageElement, string>
+    implements MetaQuestion<PageElement, Question<Promise<string>>>
 {
     private subject: string;
 

package/src/screenplay/questions/CssClasses.ts

@@ -1,4 +1,4 @@
-import type { AnswersQuestions, MetaQuestion, MetaQuestionAdapter,QuestionAdapter, UsesAbilities } from '@serenity-js/core';
+import type { Answerable,MetaQuestionAdapter, QuestionAdapter } from '@serenity-js/core';
 import { d, Question } from '@serenity-js/core';
 
 import { PageElement } from '../models';
@@ -96,11 +96,7 @@ import { PageElement } from '../models';
  *
  * @group Questions
  */
-export class CssClasses
-    extends Question<Promise<string[]>>
-    implements MetaQuestion<PageElement, string[]>
-{
-    private subject: string;
+export class CssClasses {
 
     /**
      * Instantiates a {@apilink Question} that uses
@@ -114,58 +110,21 @@ export class CssClasses
      * @param pageElement
      */
     static of(pageElement: QuestionAdapter<PageElement> | PageElement): MetaQuestionAdapter<PageElement, string[]> {
-        return Question.createAdapter(new CssClasses(pageElement)) as MetaQuestionAdapter<PageElement, string[]>;
-    }
-
-    protected constructor(private readonly pageElement: QuestionAdapter<PageElement> | PageElement) {
-        super();
-        this.subject = d`CSS classes of ${ pageElement}`;
-    }
+        return Question.about(d`CSS classes of ${ pageElement }`,
+            async actor => {
+                const element = await actor.answer(pageElement);
 
-    /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
-     * of a given {@apilink PageElement},
-     * located in a given `parent` element.
-     *
-     * #### Learn more
-     * - {@apilink MetaQuestion}
-     *
-     * @param parent
-     */
-    of(parent: QuestionAdapter<PageElement> | PageElement): Question<Promise<string[]>> {
-        return new CssClasses(PageElement.of(this.pageElement, parent));
-    }
-
-    /**
-     * @inheritDoc
-     */
-    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string[]> {
-        const element = await actor.answer(this.pageElement);
-
-        return element.attribute('class')
-            .then(attribute => attribute ?? '')
-            .then(attribute => attribute
-                .replace(/\s+/, ' ')
-                .trim()
-                .split(' ')
-                .filter(cssClass => !! cssClass),
-            );
-    }
-
-    /**
-     * @inheritDoc
-     */
-    describedAs(subject: string): this {
-        this.subject = subject;
-        return this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    toString(): string {
-        return this.subject;
+                return element.attribute('class')
+                    .then(attribute => attribute ?? '')
+                    .then(attribute => attribute
+                        .replace(/\s+/, ' ')
+                        .trim()
+                        .split(' ')
+                        .filter(cssClass => !! cssClass),
+                    );
+            },
+            (parent: Answerable<PageElement>) =>
+                CssClasses.of(PageElement.of(pageElement, parent))
+        );
     }
 }

package/src/screenplay/questions/Text.ts

@@ -1,8 +1,9 @@
-import type { Answerable, AnswersQuestions, MetaQuestion, MetaQuestionAdapter,QuestionAdapter, UsesAbilities } from '@serenity-js/core';
+import type { Answerable, AnswersQuestions, MetaQuestionAdapter, QuestionAdapter } from '@serenity-js/core';
 import { d, Question } from '@serenity-js/core';
 import { asyncMap } from '@serenity-js/core/lib/io';
 
-import { PageElement, PageElements } from '../models';
+import type { PageElements } from '../models';
+import { PageElement } from '../models';
 
 /**
  * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
@@ -104,7 +105,15 @@ export class Text {
      * @param pageElement
      */
     static of(pageElement: QuestionAdapter<PageElement> | PageElement): MetaQuestionAdapter<PageElement, string> {
-        return TextOfSingleElement.of(pageElement);
+        return Question.about(d`the text of ${ pageElement }`,
+            async actor => {
+                const element = await actor.answer(pageElement);
+
+                return element.text();
+            },
+            (parent: Answerable<PageElement>) =>
+                Text.of(PageElement.of(pageElement, parent))
+        );
     }
 
     /**
@@ -120,108 +129,21 @@ export class Text {
     static ofAll(pageElements: PageElements): MetaQuestionAdapter<PageElement, string[]>
     static ofAll(pageElements: Answerable<PageElement[]>): QuestionAdapter<string[]>
     static ofAll(pageElements: PageElements | Answerable<PageElement[]>): QuestionAdapter<string[]> {
-        if (pageElements instanceof PageElements) {
-            return TextOfMultipleElements.of(pageElements);
+        if (Question.isAMetaQuestion(pageElements)) {
+            return Question.about(d`the text of ${ pageElements }`,
+                textOfMultiple(pageElements),
+                (parent: Answerable<PageElement>) =>
+                    Text.ofAll(pageElements.of(parent))
+            );
         }
 
-        return Question.about(d`the text of ${ pageElements }`, async actor => {
-            const elements: PageElement[] = await actor.answer(pageElements);
-
-            return asyncMap(elements, element => element.text());
-        });
-    }
-}
-
-class TextOfSingleElement
-    extends Question<Promise<string>>
-    implements MetaQuestion<PageElement, string>
-{
-    /**
-     * @private
-     */
-    private subject: string;
-
-    static of(element: QuestionAdapter<PageElement> | PageElement): MetaQuestionAdapter<PageElement, string> {
-        return Question.createAdapter(new TextOfSingleElement(element)) as MetaQuestionAdapter<PageElement, string>;
-    }
-
-    protected constructor(private readonly element: QuestionAdapter<PageElement> | PageElement) {
-        super();
-        this.subject = d`the text of ${ element }`;
-    }
-
-    of(parent: QuestionAdapter<PageElement> | PageElement): Question<Promise<string>> {
-        return new TextOfSingleElement(PageElement.of(this.element, parent));
-    }
-
-    /**
-     * @inheritDoc
-     */
-    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string> {
-        const element = await actor.answer(this.element);
-
-        return element.text();
-    }
-
-    /**
-     * @inheritDoc
-     */
-    describedAs(subject: string): this {
-        this.subject = subject;
-        return this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    toString(): string {
-        return this.subject;
+        return Question.about(d`the text of ${ pageElements }`, textOfMultiple(pageElements));
     }
 }
 
-class TextOfMultipleElements
-    extends Question<Promise<string[]>>
-    implements MetaQuestion<PageElement, string[]>
-{
-    /**
-     * @private
-     */
-    private subject: string;
-
-    static of(elements: PageElements): MetaQuestionAdapter<PageElement, string[]> {
-        return Question.createAdapter(new TextOfMultipleElements(elements)) as MetaQuestionAdapter<PageElement, string[]>;
-    }
-
-    protected constructor(private readonly elements: PageElements) {
-        super();
-        this.subject = d`the text of ${ elements }`;
-    }
-
-    of(parent: Answerable<PageElement>): Question<Promise<string[]>> {
-        return new TextOfMultipleElements(this.elements.of(parent));
-    }
-
-    /**
-     * @inheritDoc
-     */
-    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string[]> {
-        const elements: PageElement[] = await actor.answer(this.elements);
-
+function textOfMultiple(pageElements: Answerable<PageElement[]>) {
+    return async (actor: AnswersQuestions) => {
+        const elements: PageElement[] = await actor.answer(pageElements);
         return asyncMap(elements, element => element.text());
     }
-
-    /**
-     * @inheritDoc
-     */
-    describedAs(subject: string): this {
-        this.subject = subject;
-        return this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    toString(): string {
-        return this.subject;
-    }
 }