@serenity-js/core 2.32.7 → 3.0.0-rc.10

package/src/screenplay/questions/lists/ArrayListAdapter.ts

@@ -1,186 +0,0 @@
-import { ensure, isArray, isNumber } from 'tiny-types';
-
-import { formatted } from '../../../io';
-import { AnswersQuestions, UsesAbilities } from '../../actor';
-import { Answerable } from '../../Answerable';
-import { Question } from '../../Question';
-import { Expectation } from '../Expectation';
-import { ExpectationMet } from '../expectations';
-import { MetaQuestion } from '../MetaQuestion';
-import { ListAdapter } from './ListAdapter';
-
-/**
- * @desc
- *  Adapts an {@link Array} so that it can be used with {@link List}
- *
- * @implements {ListAdapter}
- */
-export class ArrayListAdapter<Item_Type> implements ListAdapter<Item_Type, Item_Type[], Promise<Item_Type>, Promise<Item_Type[]>> {
-
-    /**
-     * @param {Answerable<Item_Type[]>} array
-     */
-    constructor(private readonly array: Answerable<Item_Type[]>) {
-    }
-
-    /**
-     * @desc
-     *  Returns the number of items the underlying {@link Array} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<number>}
-     */
-    count(actor: AnswersQuestions & UsesAbilities): Promise<number> {
-        return this.arrayAs(actor)
-            .then(items => items.length);
-    }
-
-    /**
-     * @desc
-     *  Returns the underlying {@link Array},
-     *  with any filters applied.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<number>}
-     */
-    items(actor: AnswersQuestions & UsesAbilities): Promise<Item_Type[]> {
-        return this.arrayAs(actor);
-    }
-
-    /**
-     * @desc
-     *  Returns the first of items the underlying {@link Array} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<Item_Type>}
-     */
-    first(actor: AnswersQuestions & UsesAbilities): Promise<Item_Type> {
-        return this.arrayAs(actor)
-            .then(items => this.getItemAt(items, 0));
-    }
-
-    /**
-     * @desc
-     *  Returns the nth of items the underlying {@link Array} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     *
-     * @param {number} index
-     *  Zero-based index of the item to return
-     *
-     * @returns {Promise<Item_Type>}
-     */
-    get(actor: AnswersQuestions & UsesAbilities, index: number): Promise<Item_Type> {
-        return this.arrayAs(actor)
-            .then(items => this.getItemAt(items, index));
-    }
-
-    /**
-     * @desc
-     *  Returns the last of items the underlying {@link Array} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<Item_Type>}
-     */
-    last(actor: AnswersQuestions & UsesAbilities): Promise<Item_Type> {
-        return this.arrayAs(actor)
-            .then(items => this.getItemAt(items, items.length - 1));
-    }
-
-    /**
-     * @desc
-     *  Filters the underlying {@link Array} so that the result contains only those items that meet the {@link Expectation}
-     *
-     * @param {MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>} question
-     * @param {Expectation<any, Answer_Type>} expectation
-     *
-     * @returns {ListAdapter<Item_Type, Item_Type[], Promise<Item_Type>, Promise<Item_Type[]>>}
-     *
-     * @see {MetaQuestion}
-     */
-    withFilter<Answer_Type>(
-        question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>
-    ): ListAdapter<Item_Type, Item_Type[], Promise<Item_Type>, Promise<Item_Type[]>> {
-        return new ArrayListAdapter(
-            new ArrayListFilter(this.array, question, expectation)
-        );
-    }
-
-    /**
-     * @desc
-     *  Returns a human-readable description of the underlying {@link Array}.
-     *
-     * @returns {string}
-     */
-    toString(): string {
-        return formatted `${ this.array }`
-    }
-
-    private arrayAs(actor: AnswersQuestions & UsesAbilities): Promise<Item_Type[]> {
-        return actor.answer(this.array)
-            .then(array => ensure('ArrayListAdapter constructor parameter', array, isArray()));
-    }
-
-    private getItemAt(items: Item_Type[], index: number): Item_Type {
-
-        ensure('index', index, isNumber());
-
-        const collectionDescription = this.toString();
-        const itemsDescription = formatted`${ items }`;
-        const description = collectionDescription !== itemsDescription
-            ? `${ collectionDescription } ${ itemsDescription }`
-            : itemsDescription;
-
-        if (items.length === 0) {
-            throw new Error(`${ description } is empty`);
-        }
-
-        if (index in items) {
-            return items[index];
-        }
-
-        throw new Error(`${ description } has no item at index ${ index }`);
-    }
-}
-
-/**
- * @package
- */
-class ArrayListFilter<Item_Type, Answer_Type>
-    extends Question<Promise<Item_Type[]>>
-{
-    constructor(
-        private readonly collection: Answerable<Item_Type[]>,
-        private readonly question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>,
-        private readonly expectation: Expectation<any, Answer_Type>
-    ) {
-        super([
-            formatted `${ collection }`,
-            collection instanceof ArrayListFilter ? 'and' : 'where',
-            formatted `${ question } does ${ expectation }`
-        ].join(' '));
-    }
-
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Item_Type[]> {
-
-        return actor.answer(this.collection)
-            .then(array => ensure('ArrayListAdapter constructor parameter', array, isArray()))  // todo: extract to avoid duplication?
-            .then(array =>
-                Promise.all(array.map(item =>
-                    Promise.resolve(this.question.of(item).answeredBy(actor))
-                        .then(answer => this.expectation.answeredBy(actor)(answer))
-                        .then(outcome => ({ item, outcome }))
-                ))
-            )
-            .then(results =>
-                results.filter(result => result.outcome instanceof ExpectationMet)
-                    .map(result => result.item)
-            );
-    }
-}
-

package/src/screenplay/questions/lists/ListAdapter.ts

@@ -1,33 +0,0 @@
-import { AnswersQuestions, UsesAbilities } from '../../actor';
-import { Expectation } from '../Expectation';
-import { MetaQuestion } from '../MetaQuestion';
-
-/**
- * @desc
- *  Adapts various types of collections so that they can be used with {@link List}.
- *
- *  You probably won't need to implement this interface, unless you're extending Serenity/JS.
- *
- * @see {@link List}
- */
-export interface ListAdapter<
-    Item_Type,
-    Collection_Type,
-    Item_Return_Type = Item_Type,
-    Collection_Return_Type = Collection_Type
-> {
-    count(actor: AnswersQuestions & UsesAbilities): Promise<number>;
-
-    first(actor: AnswersQuestions & UsesAbilities): Item_Return_Type;
-    last(actor: AnswersQuestions & UsesAbilities): Item_Return_Type;
-    get(actor: AnswersQuestions & UsesAbilities, index: number): Item_Return_Type;
-
-    items(actor: AnswersQuestions & UsesAbilities): Collection_Return_Type;
-
-    withFilter<Answer_Type>(
-        question: MetaQuestion<Item_Type, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>,
-    ): ListAdapter<Item_Type, Collection_Type, Item_Return_Type, Collection_Return_Type>;
-
-    toString(): string;
-}

package/src/screenplay/questions/lists/index.ts

@@ -1,2 +0,0 @@
-export * from './ArrayListAdapter';
-export * from './ListAdapter';

package/src/screenplay/questions/mappings/AnswerMappingFunction.ts

@@ -1,13 +0,0 @@
-import { MappingFunction } from '../../../io/collections';
-import { AnswersQuestions } from '../../actor';
-
-/**
- * @desc
- *  A mapping function converting one type into another.
- *
- * @public
- *
- * @typedef {function(actor: AnswersQuestions) => MappingFunction<V,O>} AnswerMappingFunction<V, O>
- */
-export type AnswerMappingFunction<V, O> =
-    (actor: AnswersQuestions) => MappingFunction<V, Promise<O> | O>

package/src/screenplay/questions/mappings/index.ts

@@ -1,2 +0,0 @@
-export * from './AnswerMappingFunction';
-export * from './string';

package/src/screenplay/questions/mappings/string/append.ts

@@ -1,28 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { Answerable } from '../../../Answerable';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Appends the values to the end of the original string and returns a new string.
- *
- * @param {...Array<Answerable<string>>} values
- *  The values to append to the end of the string.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/concat
- */
-export function append(...values: Array<Answerable<string>>): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (originalAnswer: string) => {
-
-            ensure('The value to be mapped', originalAnswer, isDefined(), isString());
-
-            return Promise.all(values.map(value => actor.answer(value)))
-                .then(answers => originalAnswer.concat(...answers))
-        }
-}

package/src/screenplay/questions/mappings/string/index.ts

@@ -1,11 +0,0 @@
-export * from './append';
-export * from './normalize';
-export * from './replace';
-export * from './slice';
-export * from './split';
-export * from './toLocaleLowerCase';
-export * from './toLocaleUpperCase';
-export * from './toLowerCase';
-export * from './toNumber';
-export * from './toUpperCase';
-export * from './trim';

package/src/screenplay/questions/mappings/string/normalize.ts

@@ -1,33 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { Answerable } from '../../../Answerable';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Returns the String value result of normalizing the string into the normalization form
- *  named by form as specified in Unicode Standard Annex #15, Unicode Normalization Forms.
- *
- * @param {Answerable<string>} [form]
- *  One of "NFC", "NFD", "NFKC", or "NFKD", specifying the Unicode Normalization Form. If omitted or undefined, "NFC" is used.
- *  These values have the following meanings:
- *   "NFC" - Canonical Decomposition, followed by Canonical Composition.
- *   "NFD" - Canonical Decomposition.
- *   "NFKC" - Compatibility Decomposition, followed by Canonical Composition.
- *   "NFKD" - Compatibility Decomposition.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize
- */
-export function normalize(form?: Answerable<string>): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-
-            ensure('The value to be mapped', value, isDefined(), isString())
-
-            return actor.answer(form).then(answer => value.normalize(answer));
-        }
-}

package/src/screenplay/questions/mappings/string/replace.ts

@@ -1,34 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { Answerable } from '../../../Answerable';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Returns a new string with some or all matches of a pattern replaced by a replacement.
- *  The pattern can be a string or a RegExp, and the replacement can be a string or a function to be called for each match.
- *  If pattern is a string, only the first occurrence will be replaced.
- *
- * @param {Answerable<string | RegExp>} pattern
- *
- * @param {Answerable<string|function>} replacement
- *
- * @returns {MappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace
- */
-export function replace(pattern: Answerable<RegExp | string>, replacement: Answerable<string | ((substring: string, ...args: any[]) => string)>): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-            ensure('The value to be mapped', value, isDefined(), isString())
-
-            return Promise.all([
-                actor.answer(pattern),
-                actor.answer(replacement),
-            ]).then(([p, r]) =>
-                value.replace(p, r as any),
-            );
-        }
-}

package/src/screenplay/questions/mappings/string/slice.ts

@@ -1,53 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isInteger, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { Answerable } from '../../../Answerable';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Extracts the part of the string between the `startIndex` and `endIndex` indexes, or to the end of the string if `endIndex` is `undefined`.
- *
- * @param {Answerable<number>} startIndex
- *  The zero-based index at which to begin extraction.
- *
- *  If negative, it is treated as `str.length + startIndex`. For example, if `startIndex` is `-3`, it is treated as `str.length - 3`
- *
- *  If `startIndex` is greater than or equal to `str.length`, an empty string is returned.
- *
- * @param {Answerable<number>} [endIndex]
- *  The zero-based index _before_ which to endIndex extraction.
- *  The character at this index will not be included.
- *
- *  If `endIndex` is omitted or undefined, or greater than `str.length`,
- *  `slice()` extracts to the endIndex of the string.
- *
- *  If negative, it is treated as `str.length + endIndex`.
- *  For example, if `endIndex` is `-3`, it is treated as `str.length - 3`.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/substring
- */
-export function slice(startIndex: Answerable<number>, endIndex?: Answerable<number>): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-
-            ensure('The value to be mapped', value, isDefined(), isString())
-
-            return Promise.all([
-                actor.answer(startIndex),
-                actor.answer(endIndex),
-            ]).then(([ start, end ]) => {
-
-                ensure('startIndex', start, isDefined(), isInteger())
-
-                if (end !== undefined) {
-                    ensure('endIndex', end, isInteger());
-                }
-
-                return value.slice(start, end);
-            });
-        };
-}

package/src/screenplay/questions/mappings/string/split.ts

@@ -1,38 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isNotBlank, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Divides a string into an ordered list of substrings, puts these substrings into an array, and returns the array.
- *  The division is done by searching for a pattern; where the pattern is provided as the first parameter in the method's call.
- *
- * @param {Answerable<string | RegExp>} separator
- *  The pattern describing where each split should occur.  The separator can be a simple string or it can be a regular expression.
- *
- * @param {Answerable<number>} [limit]
- *  A non-negative integer specifying a limit on the number of substrings to be included in the array.
- *  If provided, splits the string at each occurrence of the specified separator, but stops when limit entries have been placed in the array.
- *  Any leftover text is not included in the array at all.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/split
- */
-export function split(separator: string | RegExp, limit?: number): AnswerMappingFunction<string, string[]> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-            ensure('The value to be mapped', value, isDefined(), isString())
-
-            return Promise.all([
-                actor.answer(separator),
-                actor.answer(limit),
-            ]).then(([ s, l ]) => {
-                ensure('The separator', value, isDefined(), isString(), isNotBlank());
-
-                return value.split(s, l);
-            });
-        };
-}

package/src/screenplay/questions/mappings/string/toLocaleLowerCase.ts

@@ -1,31 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { Answerable } from '../../../Answerable';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Returns the calling string value converted to upper case, according to any locale-specific case mappings.
- *
- * @param {Answerable<string | string[]>} [locales]
- *  The `locale` parameter indicates the locale to be used to convert to lower case according to any
- *  locale-specific case mappings. If multiple locales are given in an `Array`,
- *  the [best available locale](https://tc39.es/ecma402/#sec-bestavailablelocale) is used.
- *  The default locale is the host environment’s current locale.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLocaleLowerCase
- */
-export function toLocaleLowerCase(locales?: Answerable<string | string[]>): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-            ensure('The value to be mapped', value, isDefined(), isString());
-
-            return actor.answer(locales)
-                .then(l => value.toLocaleLowerCase(l));
-        }
-
-}

package/src/screenplay/questions/mappings/string/toLocaleUpperCase.ts

@@ -1,30 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Returns a string where all alphabetic characters have been converted to uppercase,
- *  taking into account the host environment's current locale.
- *
- * @param {Answerable<string | string[]>} [locales]
- *  The `locale` parameter indicates the locale to be used to convert to lower case according to any
- *  locale-specific case mappings. If multiple locales are given in an `Array`,
- *  the [best available locale](https://tc39.es/ecma402/#sec-bestavailablelocale) is used.
- *  The default locale is the host environment’s current locale.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLocaleUpperCase
- */
-export function toLocaleUpperCase(locales?: string | string[]): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) => {
-            ensure('The value to be mapped', value, isDefined(), isString());
-
-            return actor.answer(locales)
-                .then(l => value.toLocaleUpperCase(l));
-        }
-}

package/src/screenplay/questions/mappings/string/toLowerCase.ts

@@ -1,20 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Converts all the alphabetic characters in a string to lowercase.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase
- */
-export function toLowerCase(): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) =>
-            ensure('The value to be mapped', value, isDefined(), isString())
-                .toLowerCase();
-}

package/src/screenplay/questions/mappings/string/toNumber.ts

@@ -1,19 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Converts a `string` to a `number`.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number
- */
-export function toNumber(): AnswerMappingFunction<string, number> {
-    return (actor: AnswersQuestions) =>
-        (value: string) =>
-            Number(ensure('value', value, isDefined()));
-}

package/src/screenplay/questions/mappings/string/toUpperCase.ts

@@ -1,20 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Converts all the alphabetic characters in a string to uppercase.
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase
- */
-export function toUpperCase(): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) =>
-            ensure('The value to be mapped', value, isDefined(), isString())
-                .toUpperCase();
-}

package/src/screenplay/questions/mappings/string/trim.ts

@@ -1,22 +0,0 @@
-/* eslint-disable unicorn/consistent-function-scoping */
-import { ensure, isDefined, isString } from 'tiny-types';
-
-import { AnswersQuestions } from '../../../actor';
-import { AnswerMappingFunction } from '../AnswerMappingFunction';
-
-/**
- * @desc
- *  Removes whitespace from both ends of a string.
- *  Whitespace in this context is all the whitespace characters (space, tab, no-break space, etc.)
- *  and all the line terminator characters (LF, CR, etc.).
- *
- * @returns {AnswerMappingFunction<string, string>}
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/trim
- */
-export function trim(): AnswerMappingFunction<string, string> {
-    return (actor: AnswersQuestions) =>
-        (value: string) =>
-            ensure('The value to be mapped', value, isDefined(), isString())
-                .trim();
-}

package/src/screenplay/questions/proxies/PropertyPathKey.ts

@@ -1,4 +0,0 @@
-/**
- * @package
- */
-export type PropertyPathKey = string | symbol | number;

package/src/screenplay/questions/proxies/createMetaQuestionProxy.ts

@@ -1,51 +0,0 @@
-/* eslint-disable @typescript-eslint/ban-types */
-import { formatted } from '../../../io';
-import { Answerable } from '../../Answerable';
-import { Question } from '../../Question';
-import { MetaQuestion } from '../MetaQuestion';
-import { describePath } from './describePath';
-import { key } from './key';
-import { PropertyPathKey } from './PropertyPathKey';
-
-/**
- * @package
- */
-export type WithPropertiesAsMetaQuestions<Original_Type, Nested_Type = Original_Type> = {
-    [Key in keyof Nested_Type]: Nested_Type[Key] extends object
-        ? Question<Promise<Nested_Type[Key]>> & MetaQuestion<Answerable<Original_Type>, Promise<Nested_Type[Key]>> & WithPropertiesAsMetaQuestions<Original_Type, Nested_Type[Key]>
-        : Question<Promise<Nested_Type[Key]>> & MetaQuestion<Answerable<Original_Type>, Promise<Nested_Type[Key]>>
-}
-
-/**
- * @package
- */
-export function createMetaQuestionProxy<Original_Type extends object>(path: PropertyPathKey[] = []): WithPropertiesAsMetaQuestions<Original_Type> {
-
-    const empty = {};
-
-    return new Proxy<Original_Type>(empty as any, {
-        get(target: unknown, name: PropertyPathKey) {
-
-            if (key(name).isOneOf<MetaQuestion<Answerable<Original_Type>, Promise<any>>>('of')) {
-
-                return function of(subject: Answerable<Original_Type>) {
-
-                    return Question.about(formatted `property ${ describePath(path) } of ${ subject }`, actor => {
-                        return actor.answer(subject).then(answer => {
-
-                            return path.reduce((subObject, keyName, index) => {
-                                if (keyName in subObject) {
-                                    return subObject[keyName];
-                                }
-                                throw new Error(formatted `property ${ describePath(path.slice(0, index + 1)) } of ${ subject } doesn't exist`);
-                            }, answer);
-
-                        });
-                    });
-                }
-            }
-
-            return createMetaQuestionProxy<Original_Type>(path.concat(name));
-        }
-    }) as WithPropertiesAsMetaQuestions<Original_Type>;
-}