@dereekb/util 8.8.1 → 8.10.0

package/src/lib/path/path.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slashPathInvalidError = exports.mergeSlashPaths = exports.slashPathFactory = exports.slashPathValidationFactory = exports.replaceInvalidFilePathTypeSeparatorsInSlashPathFunction = exports.replaceInvalidFilePathTypeSeparatorsInSlashPath = exports.removeTrailingFileTypeSeparators = exports.replaceMultipleFilePathsInSlashPath = exports.fixMultiSlashesInSlashPath = exports.toAbsoluteSlashPathStartType = exports.toRelativeSlashPathStartType = exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX = exports.ALL_DOUBLE_SLASHES_REGEX = exports.ALL_SLASHES_REGEX = exports.TRAILING_FILE_TYPE_SEPARATORS_REGEX = exports.TRAILING_SLASHES_REGEX = exports.LEADING_SLASHES_REGEX = exports.slashPathStartTypeFactory = exports.slashPathParts = exports.slashPathName = exports.isValidSlashPath = exports.isSlashPathFolder = exports.isSlashPathFile = exports.slashPathType = exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT = exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS = exports.SLASH_PATH_FILE_TYPE_SEPARATOR = exports.SLASH_PATH_SEPARATOR = void 0;
+const map_1 = require("../value/map");
+const array_1 = require("../array/array");
+const string_1 = require("../string");
+const value_1 = require("../value");
+exports.SLASH_PATH_SEPARATOR = '/';
+exports.SLASH_PATH_FILE_TYPE_SEPARATOR = '.';
+exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS = ['#', '[', ']', '*', '?'];
+/**
+ * Default replacement character for illegal characters.
+ */
+exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT = '_';
+/**
+ * Returns the SlashPathType for the input.
+ *
+ * @param input
+ * @returns
+ */
+function slashPathType(input) {
+    const dotCount = input.split(exports.SLASH_PATH_FILE_TYPE_SEPARATOR, 2).length;
+    let type;
+    switch (dotCount) {
+        case 0:
+            if (input.length === 0) {
+                type = 'invalid';
+            }
+            else {
+                const lastValue = input[input.length - 1];
+                if (lastValue === exports.SLASH_PATH_SEPARATOR) {
+                    type = 'folder';
+                }
+                else {
+                    type = 'file';
+                }
+            }
+            break;
+        case 1:
+            type = 'file';
+            break;
+        default:
+            type = 'invalid';
+            break;
+    }
+    return type;
+}
+exports.slashPathType = slashPathType;
+function isSlashPathFile(input) {
+    const type = slashPathType(input);
+    return type === 'file' || type === 'typedfile';
+}
+exports.isSlashPathFile = isSlashPathFile;
+function isSlashPathFolder(input) {
+    return slashPathType(input) === 'folder';
+}
+exports.isSlashPathFolder = isSlashPathFolder;
+function isValidSlashPath(input) {
+    return slashPathType(input) !== 'invalid';
+}
+exports.isValidSlashPath = isValidSlashPath;
+/**
+ * Returns the last part of the slash path.
+ *
+ * @param slashPath
+ */
+function slashPathName(slashPath) {
+    const parts = slashPathParts(slashPath);
+    return parts[parts.length - 1];
+}
+exports.slashPathName = slashPathName;
+/**
+ * Returns each section of a SlashPath
+ *
+ * @param slashPath
+ * @returns
+ */
+function slashPathParts(slashPath) {
+    return slashPath.split(exports.SLASH_PATH_SEPARATOR).filter((x) => Boolean(x));
+}
+exports.slashPathParts = slashPathParts;
+function slashPathStartTypeFactory(type) {
+    let fn;
+    switch (type) {
+        case 'relative':
+            fn = toRelativeSlashPathStartType;
+            break;
+        case 'absolute':
+            fn = toAbsoluteSlashPathStartType;
+            break;
+        case 'any':
+            fn = (0, value_1.mapIdentityFunction)();
+            break;
+    }
+    return fn;
+}
+exports.slashPathStartTypeFactory = slashPathStartTypeFactory;
+exports.LEADING_SLASHES_REGEX = /^\/+/;
+exports.TRAILING_SLASHES_REGEX = /\/+$/;
+exports.TRAILING_FILE_TYPE_SEPARATORS_REGEX = /\.+$/;
+exports.ALL_SLASHES_REGEX = /\/+/g;
+exports.ALL_DOUBLE_SLASHES_REGEX = /\/{2,}/g;
+exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX = /\.+/g;
+function toRelativeSlashPathStartType(input) {
+    // remove all leading slashes
+    return input.replace(exports.LEADING_SLASHES_REGEX, '');
+}
+exports.toRelativeSlashPathStartType = toRelativeSlashPathStartType;
+/**
+ *
+ * @param input
+ * @returns
+ */
+function toAbsoluteSlashPathStartType(input) {
+    // add a leading slash, and remove any multiple slashes if provided
+    return input.startsWith(exports.SLASH_PATH_SEPARATOR) ? input.replace(exports.LEADING_SLASHES_REGEX, exports.SLASH_PATH_SEPARATOR) : `${exports.SLASH_PATH_SEPARATOR}${input}`;
+}
+exports.toAbsoluteSlashPathStartType = toAbsoluteSlashPathStartType;
+function fixMultiSlashesInSlashPath(input) {
+    return input.replace(exports.ALL_DOUBLE_SLASHES_REGEX, exports.SLASH_PATH_SEPARATOR);
+}
+exports.fixMultiSlashesInSlashPath = fixMultiSlashesInSlashPath;
+function replaceMultipleFilePathsInSlashPath(input) {
+    return input.replace(exports.ALL_DOUBLE_SLASHES_REGEX, exports.SLASH_PATH_SEPARATOR);
+}
+exports.replaceMultipleFilePathsInSlashPath = replaceMultipleFilePathsInSlashPath;
+function removeTrailingFileTypeSeparators(input) {
+    return input.replace(exports.TRAILING_FILE_TYPE_SEPARATORS_REGEX, '');
+}
+exports.removeTrailingFileTypeSeparators = removeTrailingFileTypeSeparators;
+/**
+ * Replaces all extra and invalidate FilePathTypeSeparator values from the SlashPath, returning a valid SlashPath.
+ *
+ * @param input
+ * @param replaceWith
+ * @returns
+ */
+function replaceInvalidFilePathTypeSeparatorsInSlashPath(input, replaceWith) {
+    return replaceInvalidFilePathTypeSeparatorsInSlashPathFunction(replaceWith)(input);
+}
+exports.replaceInvalidFilePathTypeSeparatorsInSlashPath = replaceInvalidFilePathTypeSeparatorsInSlashPath;
+/**
+ * Creates a function that replaces all extra and invalidate FilePathTypeSeparator values from the SlashPath, returning a valid SlashPath.
+ *
+ * @param input
+ * @param replaceWith
+ * @returns
+ */
+function replaceInvalidFilePathTypeSeparatorsInSlashPathFunction(replaceWith = exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT) {
+    return (input) => {
+        const endsOnFileTypeSeparator = input[input.length - 1] === exports.SLASH_PATH_FILE_TYPE_SEPARATOR;
+        const inputToEvaluate = endsOnFileTypeSeparator ? removeTrailingFileTypeSeparators(input) : input;
+        const { first, last, occurences } = (0, string_1.firstAndLastCharacterOccurrence)(inputToEvaluate, exports.SLASH_PATH_FILE_TYPE_SEPARATOR);
+        let fixedPath;
+        switch (occurences) {
+            case 0:
+                fixedPath = inputToEvaluate;
+                break;
+            case 1:
+                const lastSlashPosition = inputToEvaluate.lastIndexOf('/');
+                if (lastSlashPosition === -1 || lastSlashPosition < last) {
+                    // valid path
+                    fixedPath = inputToEvaluate;
+                }
+                else {
+                    // the dot occurs before another slash, so we should replace it
+                    fixedPath = (0, string_1.replaceCharacterAtIndexWith)(inputToEvaluate, last, replaceWith);
+                }
+                break;
+            default:
+                const [head, tail] = (0, string_1.splitStringAtIndex)(inputToEvaluate, last, true);
+                const headWithReplacedSeparators = head.replace(exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, replaceWith);
+                fixedPath = headWithReplacedSeparators + tail;
+                break;
+        }
+        return fixedPath;
+    };
+}
+exports.replaceInvalidFilePathTypeSeparatorsInSlashPathFunction = replaceInvalidFilePathTypeSeparatorsInSlashPathFunction;
+function slashPathValidationFactory(config) {
+    const { illegalStrings = exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, replaceIllegalCharacters: inputReplaceIllegalCharacters = true, replaceIllegalDots: inputReplaceIllegalDots = true, throwError } = config !== null && config !== void 0 ? config : {};
+    const fns = [];
+    const replaceIllegalCharacters = typeof inputReplaceIllegalCharacters === 'string' ? inputReplaceIllegalCharacters : exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT;
+    if (inputReplaceIllegalCharacters != null) {
+        fns.push((0, string_1.replaceStringsFunction)({
+            replace: illegalStrings,
+            replaceWith: replaceIllegalCharacters
+        }));
+    }
+    if (inputReplaceIllegalDots != null) {
+        const replaceIllegalDotsWith = typeof inputReplaceIllegalDots === 'string' ? inputReplaceIllegalDots : replaceIllegalCharacters;
+        fns.push(replaceInvalidFilePathTypeSeparatorsInSlashPathFunction(replaceIllegalDotsWith));
+    }
+    if (throwError === true || !(inputReplaceIllegalCharacters || inputReplaceIllegalDots)) {
+        fns.push((x) => {
+            if (!isValidSlashPath(x)) {
+                throw slashPathInvalidError();
+            }
+            return x;
+        });
+    }
+    return (0, map_1.chainMapSameFunctions)(fns);
+}
+exports.slashPathValidationFactory = slashPathValidationFactory;
+function slashPathFactory(config) {
+    const { startType: type = 'any', basePath: inputBasePaths, validate = true } = config !== null && config !== void 0 ? config : {};
+    const basePath = inputBasePaths ? mergeSlashPaths((0, array_1.asArray)(inputBasePaths)) : '';
+    const typeFactory = slashPathStartTypeFactory(type);
+    const validationFactory = validate ? (typeof validate === 'boolean' ? slashPathValidationFactory() : slashPathValidationFactory(validate)) : null;
+    const finalizeFn = (0, value_1.chainMapFunction)(typeFactory, validationFactory);
+    return (paths) => {
+        const merged = mergeSlashPaths((0, array_1.mergeArrayOrValueIntoArray)([basePath], paths));
+        return finalizeFn(merged);
+    };
+}
+exports.slashPathFactory = slashPathFactory;
+function mergeSlashPaths(paths) {
+    const merge = paths.filter((x) => Boolean(x)).join(exports.SLASH_PATH_SEPARATOR);
+    return fixMultiSlashesInSlashPath(merge);
+}
+exports.mergeSlashPaths = mergeSlashPaths;
+function slashPathInvalidError() {
+    return new Error('The slashPath is invalid.');
+}
+exports.slashPathInvalidError = slashPathInvalidError;
+//# sourceMappingURL=path.js.map

package/src/lib/path/path.js.map

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

package/src/lib/promise/callback.d.ts

@@ -0,0 +1,4 @@
+import { Maybe } from '../value/maybe.type';
+export declare type PromiseCallback = (err?: Maybe<Error>) => void;
+export declare type UsePromiseCallback = (cb: PromiseCallback) => void;
+export declare function useCallback(use: UsePromiseCallback): Promise<void>;

package/src/lib/promise/callback.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCallback = void 0;
+const tslib_1 = require("tslib");
+function useCallback(use) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const callback = (err) => {
+                if (err != null) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            };
+            use(callback);
+        });
+    });
+}
+exports.useCallback = useCallback;
+//# sourceMappingURL=callback.js.map

package/src/lib/promise/callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/callback.ts"],"names":[],"mappings":";;;;AAKA,SAAsB,WAAW,CAAC,GAAuB;;QACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,QAAQ,GAAG,CAAC,GAAkB,EAAE,EAAE;gBACtC,IAAI,GAAG,IAAI,IAAI,EAAE;oBACf,MAAM,CAAC,GAAG,CAAC,CAAC;iBACb;qBAAM;oBACL,OAAO,EAAE,CAAC;iBACX;YACH,CAAC,CAAC;YAEF,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;CAAA;AAZD,kCAYC"}

package/src/lib/promise/index.d.ts

@@ -1,3 +1,4 @@
+export * from './callback';
 export * from './is';
 export * from './poll';
 export * from './map';

package/src/lib/promise/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./callback"), exports);
 tslib_1.__exportStar(require("./is"), exports);
 tslib_1.__exportStar(require("./poll"), exports);
 tslib_1.__exportStar(require("./map"), exports);

package/src/lib/promise/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/index.ts"],"names":[],"mappings":";;;AAAA,+CAAqB;AACrB,iDAAuB;AACvB,gDAAsB;AACtB,oDAA0B;AAC1B,yDAA+B;AAC/B,wDAA8B;AAC9B,iDAAuB;AACvB,gDAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,+CAAqB;AACrB,iDAAuB;AACvB,gDAAsB;AACtB,oDAA0B;AAC1B,yDAA+B;AAC/B,wDAA8B;AAC9B,iDAAuB;AACvB,gDAAsB"}

package/src/lib/string/char.d.ts

@@ -0,0 +1,34 @@
+export interface FirstAndLastCharacterOccurrence {
+    readonly first: number | -1;
+    readonly last: number | -1;
+    /**
+     * Total number of occurrences.
+     */
+    readonly occurences: number;
+}
+/**
+ * Find the first and last occurence of the input character in the input string.
+ *
+ * @param input string to find the character occurrences
+ * @param find character to find
+ * @returns
+ */
+export declare function firstAndLastCharacterOccurrence(input: string, find: string): FirstAndLastCharacterOccurrence;
+/**
+ * Replaces the character at the given index with the replacement string.
+ *
+ * @param input
+ * @param index
+ * @param replacement
+ * @returns
+ */
+export declare function replaceCharacterAtIndexWith(input: string, index: number, replacement: string): string;
+/**
+ * Splits the input string at the given character index.
+ *
+ * @param input
+ * @param index
+ * @param replacement
+ * @returns
+ */
+export declare function splitStringAtIndex(input: string, index: number, inclusive?: boolean): [string, string];

package/src/lib/string/char.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitStringAtIndex = exports.replaceCharacterAtIndexWith = exports.firstAndLastCharacterOccurrence = void 0;
+/**
+ * Find the first and last occurence of the input character in the input string.
+ *
+ * @param input string to find the character occurrences
+ * @param find character to find
+ * @returns
+ */
+function firstAndLastCharacterOccurrence(input, find) {
+    let first = -1;
+    let last = -1;
+    let occurences = 0;
+    if (find.length !== 1) {
+        throw new Error('firstAndLastCharacterOccurrence() expects a single character as find input.');
+    }
+    for (let i = 0; i < input.length; i += 1) {
+        if (input[i] === find) {
+            if (first === -1) {
+                first = i;
+            }
+            else {
+                last = i;
+            }
+            occurences += 1;
+        }
+    }
+    if (first !== -1 && last === -1) {
+        last = first;
+    }
+    return {
+        first,
+        last,
+        occurences
+    };
+}
+exports.firstAndLastCharacterOccurrence = firstAndLastCharacterOccurrence;
+/**
+ * Replaces the character at the given index with the replacement string.
+ *
+ * @param input
+ * @param index
+ * @param replacement
+ * @returns
+ */
+function replaceCharacterAtIndexWith(input, index, replacement) {
+    const [head, tail] = splitStringAtIndex(input, index, false);
+    return head + replacement + tail;
+}
+exports.replaceCharacterAtIndexWith = replaceCharacterAtIndexWith;
+/**
+ * Splits the input string at the given character index.
+ *
+ * @param input
+ * @param index
+ * @param replacement
+ * @returns
+ */
+function splitStringAtIndex(input, index, inclusive = false) {
+    const head = input.substring(0, index);
+    const tail = input.substring(index + (inclusive ? 0 : 1));
+    return [head, tail];
+}
+exports.splitStringAtIndex = splitStringAtIndex;
+//# sourceMappingURL=char.js.map

package/src/lib/string/char.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"char.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/char.ts"],"names":[],"mappings":";;;AASA;;;;;;GAMG;AACH,SAAgB,+BAA+B,CAAC,KAAa,EAAE,IAAY;IACzE,IAAI,KAAK,GAAW,CAAC,CAAC,CAAC;IACvB,IAAI,IAAI,GAAW,CAAC,CAAC,CAAC;IACtB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;KAChG;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACxC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;YACrB,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;gBAChB,KAAK,GAAG,CAAC,CAAC;aACX;iBAAM;gBACL,IAAI,GAAG,CAAC,CAAC;aACV;YAED,UAAU,IAAI,CAAC,CAAC;SACjB;KACF;IAED,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE;QAC/B,IAAI,GAAG,KAAK,CAAC;KACd;IAED,OAAO;QACL,KAAK;QACL,IAAI;QACJ,UAAU;KACX,CAAC;AACJ,CAAC;AA9BD,0EA8BC;AAED;;;;;;;GAOG;AACH,SAAgB,2BAA2B,CAAC,KAAa,EAAE,KAAa,EAAE,WAAmB;IAC3F,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC;AACnC,CAAC;AAHD,kEAGC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,KAAa,EAAE,KAAa,EAAE,SAAS,GAAG,KAAK;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACtB,CAAC;AAJD,gDAIC"}

package/src/lib/string/index.d.ts

@@ -0,0 +1,4 @@
+export * from './char';
+export * from './string';
+export * from './replace';
+export * from './transform';

package/src/lib/string/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./char"), exports);
+tslib_1.__exportStar(require("./string"), exports);
+tslib_1.__exportStar(require("./replace"), exports);
+tslib_1.__exportStar(require("./transform"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,mDAAyB;AACzB,oDAA0B;AAC1B,sDAA4B"}

package/src/lib/string/replace.d.ts

@@ -0,0 +1,30 @@
+import { ArrayOrValue } from '@dereekb/util';
+import { MapSameFunction } from '../value/map';
+export declare type ReplaceStringsFunction = MapSameFunction<string>;
+export interface ReplaceStringsConfig {
+    /**
+     * Strings to target/replace.
+     */
+    replace: ArrayOrValue<string>;
+    /**
+     * Value to replace all recurrences with.
+     */
+    replaceWith: string;
+}
+export declare function replaceStringsFunction(config: ReplaceStringsConfig): (input: string) => string;
+export declare const REGEX_SPECIAL_CHARACTERS: string[];
+export declare const REGEX_SPECIAL_CHARACTERS_SET: Set<string>;
+/**
+ * Creates an escaped regex string joined with or values that finds all of the input values.
+ *
+ * @param find
+ */
+export declare function findStringsRegexString(find: ArrayOrValue<string>): string;
+/**
+ * Escapes the input string to be usable in a Regex value.
+ *
+ * For instance, 'hello.world' will be escaped to be 'hello\.world'
+ *
+ * @param input
+ */
+export declare function escapeStringForRegex(input: string): string;

package/src/lib/string/replace.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeStringForRegex = exports.findStringsRegexString = exports.REGEX_SPECIAL_CHARACTERS_SET = exports.REGEX_SPECIAL_CHARACTERS = exports.replaceStringsFunction = void 0;
+const util_1 = require("@dereekb/util");
+const char_1 = require("./char");
+function replaceStringsFunction(config) {
+    const { replace: replaceInput, replaceWith } = config;
+    const replaceRegexString = findStringsRegexString(replaceInput);
+    const replaceRegex = new RegExp(replaceRegexString, 'g');
+    return (input) => input.replace(replaceRegex, replaceWith);
+}
+exports.replaceStringsFunction = replaceStringsFunction;
+exports.REGEX_SPECIAL_CHARACTERS = ['\\', '^', '$', '.', '|', '?', '*', '+', '(', ')', '[', ']', '{', '}'];
+exports.REGEX_SPECIAL_CHARACTERS_SET = new Set(exports.REGEX_SPECIAL_CHARACTERS);
+/**
+ * Creates an escaped regex string joined with or values that finds all of the input values.
+ *
+ * @param find
+ */
+function findStringsRegexString(find) {
+    const input = (0, util_1.asArray)(find);
+    const escapedInput = input.map(escapeStringForRegex);
+    return escapedInput.join('|');
+}
+exports.findStringsRegexString = findStringsRegexString;
+/**
+ * Escapes the input string to be usable in a Regex value.
+ *
+ * For instance, 'hello.world' will be escaped to be 'hello\.world'
+ *
+ * @param input
+ */
+function escapeStringForRegex(input) {
+    /**
+     * index of all occurences in the input to replace/merge together.
+     */
+    const occurrences = [];
+    for (let i = 0; i < input.length; i += 1) {
+        const char = input[i];
+        if (exports.REGEX_SPECIAL_CHARACTERS_SET.has(char)) {
+            occurrences.push(i);
+        }
+    }
+    let result;
+    function escapeCharacter(char) {
+        return `\\${char}`;
+    }
+    switch (occurrences.length) {
+        case 0:
+            result = input;
+            break;
+        case 1:
+            const charToReplace = input[occurrences[0]];
+            result = (0, char_1.replaceCharacterAtIndexWith)(input, occurrences[0], escapeCharacter(charToReplace)); //Add an escape to the character
+            break;
+        default:
+            const parts = [];
+            const endAt = occurrences.length;
+            let start = 0;
+            let occurrence = 0;
+            for (let i = 0; i < endAt; i += 1) {
+                occurrence = occurrences[i];
+                const char = input[occurrence];
+                const sub = input.substring(start, occurrence);
+                const part = sub + escapeCharacter(char);
+                parts.push(part);
+                start = occurrence + 1;
+            }
+            // add in the last substring
+            parts.push(input.substring(start));
+            // join all parts together
+            result = parts.join('');
+            break;
+    }
+    return result;
+}
+exports.escapeStringForRegex = escapeStringForRegex;
+//# sourceMappingURL=replace.js.map

package/src/lib/string/replace.js.map

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

package/src/lib/{string.d.ts → string/string.d.ts}

@@ -1,5 +1,5 @@
-import { MapFunction } from './value/map';
-import { Maybe } from './value/maybe.type';
+import { MapFunction } from '../value/map';
+import { Maybe } from '../value/maybe.type';
 export declare type MapStringFunction<T> = MapFunction<string, T>;
 /**
  * Represents a string that is made up of comma-separated values.

package/src/lib/string/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/string.ts"],"names":[],"mappings":";;;AAkBA,SAAgB,qBAAqB,CAAC,KAAoB;IACxD,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAFD,sDAEC;AAID,SAAgB,yBAAyB,CAAc,KAA8B,EAAE,QAA8B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAiB;IAC3I,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAHD,8DAGC;AAED,SAAgB,8BAA8B,CAAC,KAAkC;IAC/E,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAFD,wEAEC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAqB,EAAE,MAAM,GAAG,GAAG;IACvE,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;KACrD;SAAM;QACL,OAAO,SAAS,CAAC;KAClB;AACH,CAAC;AAND,sDAMC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAFD,sDAEC"}

package/src/lib/string/transform.d.ts

@@ -0,0 +1,24 @@
+import { MapFunction } from '../value/map';
+export declare function stringTrimFunction(input: string): string;
+export declare function stringToUppercaseFunction(input: string): string;
+export declare function stringToLowercaseFunction(input: string): string;
+export declare type TransformStringFunctionConfig<S extends string = string> = {
+    /**
+     * Whether or not to trim the value.
+     */
+    trim?: boolean;
+    /**
+     * Whether or not to store all values as lowercase. Ignored if transform is provided.
+     */
+    toLowercase?: boolean;
+    /**
+     * Whether or not to store all values as uppercase. Ignored if transform is provided.
+     */
+    toUppercase?: boolean;
+    /**
+     * Optional transform function for text.
+     */
+    transform?: TransformStringFunction<S>;
+};
+export declare type TransformStringFunction<S extends string = string> = MapFunction<S, S>;
+export declare function transformStringFunction<S extends string = string>(config: TransformStringFunctionConfig): TransformStringFunction<S>;

package/src/lib/string/transform.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformStringFunction = exports.stringToLowercaseFunction = exports.stringToUppercaseFunction = exports.stringTrimFunction = void 0;
+const map_1 = require("../value/map");
+function stringTrimFunction(input) {
+    return input.trim();
+}
+exports.stringTrimFunction = stringTrimFunction;
+function stringToUppercaseFunction(input) {
+    return input.toUpperCase();
+}
+exports.stringToUppercaseFunction = stringToUppercaseFunction;
+function stringToLowercaseFunction(input) {
+    return input.toLowerCase();
+}
+exports.stringToLowercaseFunction = stringToLowercaseFunction;
+function transformStringFunction(config) {
+    let baseTransform;
+    if (config.transform) {
+        baseTransform = config.transform;
+    }
+    else if (config.toUppercase) {
+        baseTransform = stringToUppercaseFunction;
+    }
+    else if (config.toLowercase) {
+        baseTransform = stringToLowercaseFunction;
+    }
+    let transform = baseTransform;
+    if (config.trim) {
+        if (baseTransform != null) {
+            transform = (x) => baseTransform(stringTrimFunction(x));
+        }
+        else {
+            transform = stringTrimFunction;
+        }
+    }
+    if (transform == null) {
+        transform = map_1.MAP_IDENTITY;
+    }
+    return transform;
+}
+exports.transformStringFunction = transformStringFunction;
+//# sourceMappingURL=transform.js.map

package/src/lib/string/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/transform.ts"],"names":[],"mappings":";;;AAAA,sCAAyD;AAGzD,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAFD,gDAEC;AAED,SAAgB,yBAAyB,CAAC,KAAa;IACrD,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAFD,8DAEC;AAED,SAAgB,yBAAyB,CAAC,KAAa;IACrD,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAFD,8DAEC;AAuBD,SAAgB,uBAAuB,CAA4B,MAAqC;IACtG,IAAI,aAA6C,CAAC;IAElD,IAAI,MAAM,CAAC,SAAS,EAAE;QACpB,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC;KAClC;SAAM,IAAI,MAAM,CAAC,WAAW,EAAE;QAC7B,aAAa,GAAG,yBAAyB,CAAC;KAC3C;SAAM,IAAI,MAAM,CAAC,WAAW,EAAE;QAC7B,aAAa,GAAG,yBAAyB,CAAC;KAC3C;IAED,IAAI,SAAS,GAAmC,aAAa,CAAC;IAE9D,IAAI,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,aAAa,IAAI,IAAI,EAAE;YACzB,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,CAAE,aAAyC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;SACtF;aAAM;YACL,SAAS,GAAG,kBAAkB,CAAC;SAChC;KACF;IAED,IAAI,SAAS,IAAI,IAAI,EAAE;QACrB,SAAS,GAAG,kBAAuC,CAAC;KACrD;IAED,OAAO,SAAkD,CAAC;AAC5D,CAAC;AA1BD,0DA0BC"}

package/src/lib/value/index.d.ts

@@ -7,3 +7,4 @@ export * from './maybe';
 export * from './modifier';
 export * from './url';
 export * from './use';
+export * from './point';

package/src/lib/value/index.js

@@ -10,4 +10,5 @@ tslib_1.__exportStar(require("./maybe"), exports);
 tslib_1.__exportStar(require("./modifier"), exports);
 tslib_1.__exportStar(require("./url"), exports);
 tslib_1.__exportStar(require("./use"), exports);
+tslib_1.__exportStar(require("./point"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/value/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,qDAA2B;AAC3B,kDAAwB;AACxB,gDAAsB;AACtB,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,gDAAsB;AACtB,gDAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,qDAA2B;AAC3B,kDAAwB;AACxB,gDAAsB;AACtB,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,gDAAsB;AACtB,gDAAsB;AACtB,kDAAwB"}