@serenity-js/core 2.32.4 → 3.0.0-rc.3

package/lib/screenplay/questions/lists/ArrayListAdapter.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArrayListAdapter = void 0;
-const tiny_types_1 = require("tiny-types");
-const io_1 = require("../../../io");
-const Question_1 = require("../../Question");
-const expectations_1 = require("../expectations");
-/**
- * @desc
- *  Adapts an {@link Array} so that it can be used with {@link List}
- *
- * @implements {ListAdapter}
- */
-class ArrayListAdapter {
-    /**
-     * @param {Answerable<Item_Type[]>} array
-     */
-    constructor(array) {
-        this.array = array;
-    }
-    /**
-     * @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) {
-        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) {
-        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) {
-        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, index) {
-        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) {
-        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(question, expectation) {
-        return new ArrayListAdapter(new ArrayListFilter(this.array, question, expectation));
-    }
-    /**
-     * @desc
-     *  Returns a human-readable description of the underlying {@link Array}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return (0, io_1.formatted) `${this.array}`;
-    }
-    arrayAs(actor) {
-        return actor.answer(this.array)
-            .then(array => (0, tiny_types_1.ensure)('ArrayListAdapter constructor parameter', array, (0, tiny_types_1.isArray)()));
-    }
-    getItemAt(items, index) {
-        (0, tiny_types_1.ensure)('index', index, (0, tiny_types_1.isNumber)());
-        const collectionDescription = this.toString();
-        const itemsDescription = (0, io_1.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}`);
-    }
-}
-exports.ArrayListAdapter = ArrayListAdapter;
-/**
- * @package
- */
-class ArrayListFilter extends Question_1.Question {
-    constructor(collection, question, expectation) {
-        super([
-            (0, io_1.formatted) `${collection}`,
-            collection instanceof ArrayListFilter ? 'and' : 'where',
-            (0, io_1.formatted) `${question} does ${expectation}`
-        ].join(' '));
-        this.collection = collection;
-        this.question = question;
-        this.expectation = expectation;
-    }
-    answeredBy(actor) {
-        return actor.answer(this.collection)
-            .then(array => (0, tiny_types_1.ensure)('ArrayListAdapter constructor parameter', array, (0, tiny_types_1.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 expectations_1.ExpectationMet)
-            .map(result => result.item));
-    }
-}
-//# sourceMappingURL=ArrayListAdapter.js.map

package/lib/screenplay/questions/lists/ArrayListAdapter.js.map

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

package/lib/screenplay/questions/lists/ListAdapter.d.ts

@@ -1,20 +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/lib/screenplay/questions/lists/ListAdapter.js

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

package/lib/screenplay/questions/lists/ListAdapter.js.map

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

package/lib/screenplay/questions/lists/index.d.ts

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

package/lib/screenplay/questions/lists/index.js

@@ -1,15 +0,0 @@
-"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]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ArrayListAdapter"), exports);
-__exportStar(require("./ListAdapter"), exports);
-//# sourceMappingURL=index.js.map

package/lib/screenplay/questions/lists/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/lists/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmC;AACnC,gDAA8B"}

package/lib/screenplay/questions/mappings/AnswerMappingFunction.d.ts

@@ -1,11 +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 declare type AnswerMappingFunction<V, O> = (actor: AnswersQuestions) => MappingFunction<V, Promise<O> | O>;

package/lib/screenplay/questions/mappings/AnswerMappingFunction.js

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

package/lib/screenplay/questions/mappings/AnswerMappingFunction.js.map

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

package/lib/screenplay/questions/mappings/index.d.ts

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

package/lib/screenplay/questions/mappings/index.js

@@ -1,15 +0,0 @@
-"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]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./AnswerMappingFunction"), exports);
-__exportStar(require("./string"), exports);
-//# sourceMappingURL=index.js.map

package/lib/screenplay/questions/mappings/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/mappings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0DAAwC;AACxC,2CAAyB"}

package/lib/screenplay/questions/mappings/string/append.d.ts

@@ -1,14 +0,0 @@
-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 declare function append(...values: Array<Answerable<string>>): AnswerMappingFunction<string, string>;

package/lib/screenplay/questions/mappings/string/append.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.append = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const tiny_types_1 = require("tiny-types");
-/**
- * @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
- */
-function append(...values) {
-    return (actor) => (originalAnswer) => {
-        (0, tiny_types_1.ensure)('The value to be mapped', originalAnswer, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
-        return Promise.all(values.map(value => actor.answer(value)))
-            .then(answers => originalAnswer.concat(...answers));
-    };
-}
-exports.append = append;
-//# sourceMappingURL=append.js.map

package/lib/screenplay/questions/mappings/string/append.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"append.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/append.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2CAAyD;AAMzD;;;;;;;;;;GAUG;AACH,SAAgB,MAAM,CAAC,GAAG,MAAiC;IACvD,OAAO,CAAC,KAAuB,EAAE,EAAE,CAC/B,CAAC,cAAsB,EAAE,EAAE;QAEvB,IAAA,mBAAM,EAAC,wBAAwB,EAAE,cAAc,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAC;QAE1E,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;aACvD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAA;AACT,CAAC;AATD,wBASC"}

package/lib/screenplay/questions/mappings/string/index.d.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/lib/screenplay/questions/mappings/string/index.js

@@ -1,24 +0,0 @@
-"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]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./append"), exports);
-__exportStar(require("./normalize"), exports);
-__exportStar(require("./replace"), exports);
-__exportStar(require("./slice"), exports);
-__exportStar(require("./split"), exports);
-__exportStar(require("./toLocaleLowerCase"), exports);
-__exportStar(require("./toLocaleUpperCase"), exports);
-__exportStar(require("./toLowerCase"), exports);
-__exportStar(require("./toNumber"), exports);
-__exportStar(require("./toUpperCase"), exports);
-__exportStar(require("./trim"), exports);
-//# sourceMappingURL=index.js.map

package/lib/screenplay/questions/mappings/string/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,sDAAoC;AACpC,sDAAoC;AACpC,gDAA8B;AAC9B,6CAA2B;AAC3B,gDAA8B;AAC9B,yCAAuB"}

package/lib/screenplay/questions/mappings/string/normalize.d.ts

@@ -1,20 +0,0 @@
-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 declare function normalize(form?: Answerable<string>): AnswerMappingFunction<string, string>;

package/lib/screenplay/questions/mappings/string/normalize.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalize = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const tiny_types_1 = require("tiny-types");
-/**
- * @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
- */
-function normalize(form) {
-    return (actor) => (value) => {
-        (0, tiny_types_1.ensure)('The value to be mapped', value, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
-        return actor.answer(form).then(answer => value.normalize(answer));
-    };
-}
-exports.normalize = normalize;
-//# sourceMappingURL=normalize.js.map

package/lib/screenplay/questions/mappings/string/normalize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/normalize.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2CAAyD;AAMzD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,SAAS,CAAC,IAAyB;IAC/C,OAAO,CAAC,KAAuB,EAAE,EAAE,CAC/B,CAAC,KAAa,EAAE,EAAE;QAEd,IAAA,mBAAM,EAAC,wBAAwB,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAA;QAEhE,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC,CAAA;AACT,CAAC;AARD,8BAQC"}

package/lib/screenplay/questions/mappings/string/replace.d.ts

@@ -1,17 +0,0 @@
-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 declare function replace(pattern: Answerable<RegExp | string>, replacement: Answerable<string | ((substring: string, ...args: any[]) => string)>): AnswerMappingFunction<string, string>;

package/lib/screenplay/questions/mappings/string/replace.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.replace = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const tiny_types_1 = require("tiny-types");
-/**
- * @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
- */
-function replace(pattern, replacement) {
-    return (actor) => (value) => {
-        (0, tiny_types_1.ensure)('The value to be mapped', value, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
-        return Promise.all([
-            actor.answer(pattern),
-            actor.answer(replacement),
-        ]).then(([p, r]) => value.replace(p, r));
-    };
-}
-exports.replace = replace;
-//# sourceMappingURL=replace.js.map

package/lib/screenplay/questions/mappings/string/replace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/replace.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2CAAyD;AAMzD;;;;;;;;;;;;;GAaG;AACH,SAAgB,OAAO,CAAC,OAAoC,EAAE,WAAiF;IAC3I,OAAO,CAAC,KAAuB,EAAE,EAAE,CAC/B,CAAC,KAAa,EAAE,EAAE;QACd,IAAA,mBAAM,EAAC,wBAAwB,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAA;QAEhE,OAAO,OAAO,CAAC,GAAG,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;SAC5B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACf,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAQ,CAAC,CAC7B,CAAC;IACN,CAAC,CAAA;AACT,CAAC;AAZD,0BAYC"}

package/lib/screenplay/questions/mappings/string/slice.d.ts

@@ -1,28 +0,0 @@
-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 declare function slice(startIndex: Answerable<number>, endIndex?: Answerable<number>): AnswerMappingFunction<string, string>;

package/lib/screenplay/questions/mappings/string/slice.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.slice = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const tiny_types_1 = require("tiny-types");
-/**
- * @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
- */
-function slice(startIndex, endIndex) {
-    return (actor) => (value) => {
-        (0, tiny_types_1.ensure)('The value to be mapped', value, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
-        return Promise.all([
-            actor.answer(startIndex),
-            actor.answer(endIndex),
-        ]).then(([start, end]) => {
-            (0, tiny_types_1.ensure)('startIndex', start, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isInteger)());
-            if (end !== undefined) {
-                (0, tiny_types_1.ensure)('endIndex', end, (0, tiny_types_1.isInteger)());
-            }
-            return value.slice(start, end);
-        });
-    };
-}
-exports.slice = slice;
-//# sourceMappingURL=slice.js.map

package/lib/screenplay/questions/mappings/string/slice.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slice.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/slice.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2CAAoE;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,KAAK,CAAC,UAA8B,EAAE,QAA6B;IAC/E,OAAO,CAAC,KAAuB,EAAE,EAAE,CAC/B,CAAC,KAAa,EAAE,EAAE;QAEd,IAAA,mBAAM,EAAC,wBAAwB,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAA;QAEhE,OAAO,OAAO,CAAC,GAAG,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;YACxB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;SACzB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,KAAK,EAAE,GAAG,CAAE,EAAE,EAAE;YAEvB,IAAA,mBAAM,EAAC,YAAY,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAA;YAErD,IAAI,GAAG,KAAK,SAAS,EAAE;gBACnB,IAAA,mBAAM,EAAC,UAAU,EAAE,GAAG,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;aACxC;YAED,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACV,CAAC;AApBD,sBAoBC"}

package/lib/screenplay/questions/mappings/string/split.d.ts

@@ -1,19 +0,0 @@
-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 declare function split(separator: string | RegExp, limit?: number): AnswerMappingFunction<string, string[]>;

package/lib/screenplay/questions/mappings/string/split.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.split = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const tiny_types_1 = require("tiny-types");
-/**
- * @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
- */
-function split(separator, limit) {
-    return (actor) => (value) => {
-        (0, tiny_types_1.ensure)('The value to be mapped', value, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)());
-        return Promise.all([
-            actor.answer(separator),
-            actor.answer(limit),
-        ]).then(([s, l]) => {
-            (0, tiny_types_1.ensure)('The separator', value, (0, tiny_types_1.isDefined)(), (0, tiny_types_1.isString)(), (0, tiny_types_1.isNotBlank)());
-            return value.split(s, l);
-        });
-    };
-}
-exports.split = split;
-//# sourceMappingURL=split.js.map

package/lib/screenplay/questions/mappings/string/split.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"split.js","sourceRoot":"","sources":["../../../../../src/screenplay/questions/mappings/string/split.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2CAAqE;AAKrE;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,KAAK,CAAC,SAA0B,EAAE,KAAc;IAC5D,OAAO,CAAC,KAAuB,EAAE,EAAE,CAC/B,CAAC,KAAa,EAAE,EAAE;QACd,IAAA,mBAAM,EAAC,wBAAwB,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,CAAC,CAAA;QAEhE,OAAO,OAAO,CAAC,GAAG,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;SACtB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,EAAE;YACjB,IAAA,mBAAM,EAAC,eAAe,EAAE,KAAK,EAAE,IAAA,sBAAS,GAAE,EAAE,IAAA,qBAAQ,GAAE,EAAE,IAAA,uBAAU,GAAE,CAAC,CAAC;YAEtE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACV,CAAC;AAdD,sBAcC"}

package/lib/screenplay/questions/mappings/string/toLocaleLowerCase.d.ts

@@ -1,17 +0,0 @@
-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 declare function toLocaleLowerCase(locales?: Answerable<string | string[]>): AnswerMappingFunction<string, string>;