@augment-vir/common 31.35.0 → 31.37.0

package/dist/augments/array/array-to-object.js

@@ -92,7 +92,10 @@ options = {}) {
         if (gotAPromise) {
             return new Promise(async (resolve, reject) => {
                 try {
-                    const entries = filterMap(await Promise.all(mappedEntries), (entry) => {
+                    const entries = filterMap(
+                    /** This does contain promises. */
+                    // eslint-disable-next-line @typescript-eslint/await-thenable
+                    await Promise.all(mappedEntries), (entry) => {
                         if (!entry) {
                             return undefined;
                         }

package/dist/augments/array/cross-product.d.ts

@@ -0,0 +1,37 @@
+import { type ArrayElement } from '@augment-vir/core';
+/**
+ * Creates the cartesian product (cross product) of an object whose values are arrays. The result is
+ * an array of objects where each object contains one picked value from every input array.
+ *
+ * @category Array
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {crossProduct} from '@augment-vir/common';
+ *
+ * const result = crossProduct({
+ *     a: [
+ *         1,
+ *         2,
+ *         3,
+ *     ],
+ *     b: [
+ *         'a',
+ *         'b',
+ *         'c',
+ *     ],
+ * });
+ * // result is:
+ * // [
+ * //   {a: 1, b: 'a'}, {a: 2, b: 'a'}, {a: 3, b: 'a'},
+ * //   {a: 1, b: 'b'}, {a: 2, b: 'b'}, {a: 3, b: 'b'},
+ * //   {a: 1, b: 'c'}, {a: 2, b: 'c'}, {a: 3, b: 'c'},
+ * // ]
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function crossProduct<const OriginalValues extends Record<PropertyKey, ReadonlyArray<any>>>(originalValues: OriginalValues): {
+    [Key in keyof OriginalValues]: ArrayElement<OriginalValues[Key]>;
+}[];

package/dist/augments/array/cross-product.js

@@ -0,0 +1,51 @@
+/**
+ * Creates the cartesian product (cross product) of an object whose values are arrays. The result is
+ * an array of objects where each object contains one picked value from every input array.
+ *
+ * @category Array
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {crossProduct} from '@augment-vir/common';
+ *
+ * const result = crossProduct({
+ *     a: [
+ *         1,
+ *         2,
+ *         3,
+ *     ],
+ *     b: [
+ *         'a',
+ *         'b',
+ *         'c',
+ *     ],
+ * });
+ * // result is:
+ * // [
+ * //   {a: 1, b: 'a'}, {a: 2, b: 'a'}, {a: 3, b: 'a'},
+ * //   {a: 1, b: 'b'}, {a: 2, b: 'b'}, {a: 3, b: 'b'},
+ * //   {a: 1, b: 'c'}, {a: 2, b: 'c'}, {a: 3, b: 'c'},
+ * // ]
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function crossProduct(originalValues) {
+    return Object.entries(originalValues)
+        .reverse()
+        .filter(([, values,]) => values.length)
+        .reduce((accum, [key, values,]) => {
+        if (!accum.length) {
+            accum = [{}];
+        }
+        return values.flatMap((value) => {
+            return accum.map((partial) => {
+                return {
+                    ...partial,
+                    [key]: value,
+                };
+            });
+        });
+    }, []);
+}

package/dist/augments/object/map-entries.js

@@ -49,7 +49,10 @@ export function mapObject(originalObject, mapCallback) {
         if (gotAPromise) {
             return new Promise(async (resolve, reject) => {
                 try {
-                    const entries = filterMap(await Promise.all(mappedEntries), (entry) => {
+                    const entries = filterMap(
+                    /** This does contain promises. */
+                    // eslint-disable-next-line @typescript-eslint/await-thenable
+                    await Promise.all(mappedEntries), (entry) => {
                         if (!entry) {
                             return undefined;
                         }

package/dist/augments/path/universal-path.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Replaces a path's extension with a new one. If the original path has no extension, `newExtension`
+ * will be appended.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {replaceExtension} from '@augment-vir/common';
+ *
+ * replaceExtension({path: '/users/stuff/file.ts?tail', newExtension: '.js'});
+ * // '/users/stuff/file.js?tail'
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function replaceExtension({ newExtension, path, }: Readonly<{
+    path: string;
+    newExtension: string;
+}>): string;
+/**
+ * Checks if the given path contains an extension.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {hasExtension} from '@augment-vir/common';
+ *
+ * hasExtension('/users/stuff/file.ts?tail'); // true
+ * hasExtension('/users/stuff/file?tail'); // false
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function hasExtension(path: string): boolean;
+/**
+ * Type for `sep` or path separators. Either `'/'` or `'\'`.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export type Sep = '/' | '\\';
+/**
+ * The default `sep` or path separator for use with universal (Node.js and browser supported) path
+ * operations. In the browser, this uses `'/'`. In Node.js, `node:path.sep` is used.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare const defaultSep: Sep;
+/**
+ * Extracts a path's extension, amongst other things, from the given path, without relying on
+ * Node.js built-in packages (this works in a browser).
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {extractExtension} from '@augment-vir/common';
+ *
+ * const results = extractExtension('/users/stuff/file.ts?tail');
+ *
+ * // results = {
+ * //     basename: 'file',
+ * //     dirname: '/users/stuff/',
+ * //     extension: '.ts',
+ * //     tail: '?tail',
+ * // }
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function extractExtension(path: string, 
+/**
+ * By default, the path separator is determined by {@link defaultSep}. With this input you can
+ * override the path separator in use.
+ */
+sepOverride?: '/' | '\\' | undefined): {
+    /**
+     * The part of the path that is the path to the file. This will be an empty string if there is
+     * none. Includes the all trailing and leading slashes, if they exist in `path`.
+     */
+    dirname: string;
+    /**
+     * The file name itself. This will only be an empty string if the given `path` is itself empty.
+     * This does not include the extension.
+     */
+    basename: string;
+    /**
+     * The extension extracted from the path. This will be an empty string if there is no extension.
+     * This includes a leading dot, if an extension exists.
+     */
+    extension: string;
+    /**
+     * Any query `'?'` and/or hash `'#'` data in the given `path`. This will be an empty string if
+     * no query or hash data exists in the given `path`. Includes the leading `'?'` or `'#'`.
+     */
+    tail: string;
+};

package/dist/augments/path/universal-path.js

@@ -0,0 +1,111 @@
+import { isRuntimeEnv, RuntimeEnv } from '@augment-vir/core';
+import { wrapInTry } from '../function/wrap-in-try.js';
+import { addPrefix } from '../string/prefix.js';
+/**
+ * Replaces a path's extension with a new one. If the original path has no extension, `newExtension`
+ * will be appended.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {replaceExtension} from '@augment-vir/common';
+ *
+ * replaceExtension({path: '/users/stuff/file.ts?tail', newExtension: '.js'});
+ * // '/users/stuff/file.js?tail'
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function replaceExtension({ newExtension, path, }) {
+    const { basename, dirname, tail } = extractExtension(path);
+    return [
+        dirname,
+        basename,
+        addPrefix({ value: newExtension, prefix: '.' }),
+        tail,
+    ].join('');
+}
+/**
+ * Checks if the given path contains an extension.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {hasExtension} from '@augment-vir/common';
+ *
+ * hasExtension('/users/stuff/file.ts?tail'); // true
+ * hasExtension('/users/stuff/file?tail'); // false
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function hasExtension(path) {
+    return !!extractExtension(path).extension;
+}
+/**
+ * The default `sep` or path separator for use with universal (Node.js and browser supported) path
+ * operations. In the browser, this uses `'/'`. In Node.js, `node:path.sep` is used.
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+/* node:coverage ignore next 3: cannot test both on a single system. */
+export const defaultSep = isRuntimeEnv(RuntimeEnv.Web)
+    ? '/'
+    : await wrapInTry(async () => (await import('node:path')).sep, { fallbackValue: '/' });
+/**
+ * Extracts a path's extension, amongst other things, from the given path, without relying on
+ * Node.js built-in packages (this works in a browser).
+ *
+ * @category Path : Common
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {extractExtension} from '@augment-vir/common';
+ *
+ * const results = extractExtension('/users/stuff/file.ts?tail');
+ *
+ * // results = {
+ * //     basename: 'file',
+ * //     dirname: '/users/stuff/',
+ * //     extension: '.ts',
+ * //     tail: '?tail',
+ * // }
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function extractExtension(path, 
+/**
+ * By default, the path separator is determined by {@link defaultSep}. With this input you can
+ * override the path separator in use.
+ */
+sepOverride) {
+    const sep = sepOverride || defaultSep;
+    const queryIndex = path.indexOf('?');
+    const hashIndex = path.indexOf('#');
+    const headTailSplitIndex = hashIndex === -1
+        ? queryIndex
+        : queryIndex === -1
+            ? hashIndex
+            : Math.min(hashIndex, queryIndex);
+    const head = headTailSplitIndex === -1 ? path : path.slice(0, headTailSplitIndex);
+    const tail = headTailSplitIndex === -1 ? '' : path.slice(headTailSplitIndex);
+    const lastSep = head.lastIndexOf(sep);
+    /** Includes last slash (if present). */
+    const dirname = head.slice(0, lastSep + 1);
+    const basename = head.slice(lastSep + 1);
+    const dotIndex = basename.lastIndexOf('.');
+    return {
+        dirname,
+        basename: dotIndex > 0 ? basename.slice(0, dotIndex) : basename,
+        extension: dotIndex > 0 ? basename.slice(dotIndex) : '',
+        tail,
+    };
+}

package/dist/augments/string/split.js

@@ -1,4 +1,4 @@
-import { setRegExpCaseSensitivity } from '../regexp/regexp-flags.js';
+import { setRegExpCaseSensitivity } from '@augment-vir/core';
 import { findSubstringIndexes } from './substring-index.js';
 /**
  * Same as *

package/dist/augments/string/substring-index.js

@@ -1,4 +1,4 @@
-import { addRegExpFlags, setRegExpCaseSensitivity } from '../regexp/regexp-flags.js';
+import { addRegExpFlags, setRegExpCaseSensitivity } from '@augment-vir/core';
 /**
  * Finds all indexes of a `searchFor` string or RegExp in `searchIn`. Ths is similar to
  * [`''.indexOf`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf)

package/dist/index.d.ts

@@ -6,10 +6,10 @@ export * from './augments/array/awaited/awaited-find.js';
 export * from './augments/array/awaited/awaited-for-each.js';
 export * from './augments/array/awaited/awaited-map.js';
 export * from './augments/array/create-array.js';
+export * from './augments/array/cross-product.js';
 export * from './augments/array/ensure-array.js';
 export * from './augments/array/extract-duplicates.js';
 export * from './augments/array/filter.js';
-export * from './augments/array/remove-duplicates.js';
 export * from './augments/array/repeat-array.js';
 export * from './augments/array/shuffle-array.js';
 export * from './augments/array/string-array.js';
@@ -59,6 +59,7 @@ export * from './augments/object/object-keys.js';
 export * from './augments/object/object-sort.js';
 export * from './augments/object/object-values.js';
 export * from './augments/path/esm-path.js';
+export * from './augments/path/universal-path.js';
 export * from './augments/prisma/base-prisma-types.js';
 export * from './augments/prisma/prisma-basic-model.js';
 export * from './augments/prisma/prisma-full-model.js';
@@ -72,7 +73,6 @@ export * from './augments/random/random-integer.js';
 export * from './augments/random/random-string.js';
 export * from './augments/random/seeded-random.js';
 export * from './augments/regexp/match.js';
-export * from './augments/regexp/regexp-flags.js';
 export * from './augments/selection-set/select-collapsed.js';
 export * from './augments/selection-set/select-from.js';
 export * from './augments/selection-set/selection-set.js';
@@ -83,7 +83,6 @@ export * from './augments/string/comma.js';
 export * from './augments/string/indent.js';
 export * from './augments/string/join.js';
 export * from './augments/string/prefix.js';
-export * from './augments/string/remove-duplicate-characters.js';
 export * from './augments/string/replace.js';
 export * from './augments/string/split.js';
 export * from './augments/string/substring-index.js';

package/dist/index.js

@@ -6,10 +6,10 @@ export * from './augments/array/awaited/awaited-find.js';
 export * from './augments/array/awaited/awaited-for-each.js';
 export * from './augments/array/awaited/awaited-map.js';
 export * from './augments/array/create-array.js';
+export * from './augments/array/cross-product.js';
 export * from './augments/array/ensure-array.js';
 export * from './augments/array/extract-duplicates.js';
 export * from './augments/array/filter.js';
-export * from './augments/array/remove-duplicates.js';
 export * from './augments/array/repeat-array.js';
 export * from './augments/array/shuffle-array.js';
 export * from './augments/array/string-array.js';
@@ -59,6 +59,7 @@ export * from './augments/object/object-keys.js';
 export * from './augments/object/object-sort.js';
 export * from './augments/object/object-values.js';
 export * from './augments/path/esm-path.js';
+export * from './augments/path/universal-path.js';
 export * from './augments/prisma/base-prisma-types.js';
 export * from './augments/prisma/prisma-basic-model.js';
 export * from './augments/prisma/prisma-full-model.js';
@@ -72,7 +73,6 @@ export * from './augments/random/random-integer.js';
 export * from './augments/random/random-string.js';
 export * from './augments/random/seeded-random.js';
 export * from './augments/regexp/match.js';
-export * from './augments/regexp/regexp-flags.js';
 export * from './augments/selection-set/select-collapsed.js';
 export * from './augments/selection-set/select-from.js';
 export * from './augments/selection-set/selection-set.js';
@@ -83,7 +83,6 @@ export * from './augments/string/comma.js';
 export * from './augments/string/indent.js';
 export * from './augments/string/join.js';
 export * from './augments/string/prefix.js';
-export * from './augments/string/remove-duplicate-characters.js';
 export * from './augments/string/replace.js';
 export * from './augments/string/split.js';
 export * from './augments/string/substring-index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "31.35.0",
+    "version": "31.37.0",
     "description": "A collection of augments, helpers types, functions, and classes for any JavaScript environment.",
     "keywords": [
         "augment",
@@ -40,13 +40,13 @@
         "test:web": "virmator --no-deps test web"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.35.0",
-        "@augment-vir/core": "^31.35.0",
+        "@augment-vir/assert": "^31.37.0",
+        "@augment-vir/core": "^31.37.0",
         "@date-vir/duration": "^7.4.2",
-        "ansi-styles": "^6.2.1",
+        "ansi-styles": "^6.2.3",
         "deepcopy-esm": "^2.1.1",
         "json5": "^2.2.3",
-        "type-fest": "^4.41.0",
+        "type-fest": "^5.0.0",
         "typed-event-target": "^4.1.0"
     },
     "devDependencies": {

package/dist/augments/array/remove-duplicates.d.ts

@@ -1,60 +0,0 @@
-/**
- * Removes duplicates from an array. Optionally provide a callback for calculating a unique id for
- * entries.
- *
- * @category Array
- * @category Package : @augment-vir/common
- * @example No callback
- *
- * ```ts
- * import {removeDuplicates} from '@augment-vir/common';
- *
- * const result = removeDuplicates([
- *     1,
- *     1,
- *     1,
- *     1,
- *     1,
- *     2,
- *     4,
- * ]);
- * // result is `[1, 2, 4]`
- *
- * const exampleEntry = {id: 5};
- *
- * const result2 = removeDuplicates([
- *     {id: 1},
- *     // this entry will not get filtered out because it's a new object reference
- *     {id: 1},
- *     exampleEntry,
- *     // this `exampleEntry` will get filtered out because it's the same reference as the one above
- *     exampleEntry,
- *     {id: 4},
- * ]);
- * // result2 is `[{id: 1}, {id: 1}, exampleEntry, {id: 4}]`
- * ```
- *
- * @example With callback
- *
- * ```ts
- * import {removeDuplicates} from '@augment-vir/common';
- *
- * const exampleEntry = {id: 5};
- *
- * const result2 = removeDuplicates(
- *     [
- *         {id: 1},
- *         {id: 1},
- *         exampleEntry,
- *         exampleEntry,
- *         {id: 4},
- *     ],
- *     (entry) => entry.id,
- * );
- * // result2 is `[{id: 1}, exampleEntry, {id: 4}]`
- * ```
- *
- * @returns A new array (does not mutate).
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export declare function removeDuplicates<const Entry>(originalArray: ReadonlyArray<Entry>, calculateUniqueId?: (entry: Readonly<Entry>) => unknown): Entry[];

package/dist/augments/array/remove-duplicates.js

@@ -1,72 +0,0 @@
-/**
- * Removes duplicates from an array. Optionally provide a callback for calculating a unique id for
- * entries.
- *
- * @category Array
- * @category Package : @augment-vir/common
- * @example No callback
- *
- * ```ts
- * import {removeDuplicates} from '@augment-vir/common';
- *
- * const result = removeDuplicates([
- *     1,
- *     1,
- *     1,
- *     1,
- *     1,
- *     2,
- *     4,
- * ]);
- * // result is `[1, 2, 4]`
- *
- * const exampleEntry = {id: 5};
- *
- * const result2 = removeDuplicates([
- *     {id: 1},
- *     // this entry will not get filtered out because it's a new object reference
- *     {id: 1},
- *     exampleEntry,
- *     // this `exampleEntry` will get filtered out because it's the same reference as the one above
- *     exampleEntry,
- *     {id: 4},
- * ]);
- * // result2 is `[{id: 1}, {id: 1}, exampleEntry, {id: 4}]`
- * ```
- *
- * @example With callback
- *
- * ```ts
- * import {removeDuplicates} from '@augment-vir/common';
- *
- * const exampleEntry = {id: 5};
- *
- * const result2 = removeDuplicates(
- *     [
- *         {id: 1},
- *         {id: 1},
- *         exampleEntry,
- *         exampleEntry,
- *         {id: 4},
- *     ],
- *     (entry) => entry.id,
- * );
- * // result2 is `[{id: 1}, exampleEntry, {id: 4}]`
- * ```
- *
- * @returns A new array (does not mutate).
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export function removeDuplicates(originalArray, calculateUniqueId = (entry) => entry) {
-    const grouped = new Map();
-    return originalArray.filter((entry) => {
-        const uniqueId = calculateUniqueId(entry);
-        if (grouped.get(uniqueId)) {
-            return false;
-        }
-        else {
-            grouped.set(uniqueId, entry);
-            return true;
-        }
-    });
-}

package/dist/augments/regexp/regexp-flags.d.ts

@@ -1,56 +0,0 @@
-/**
- * Creates a new RegExp by adding the given `flags` to the original RegExp.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {addRegExpFlags} from '@augment-vir/common';
- *
- * addRegExpFlags(/a/i, 'gm');
- * // output is `/a/igm`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export declare function addRegExpFlags(originalRegExpOrString: RegExp | string, flags: string): RegExp;
-/**
- * Creates a new RegExp with the given `flags`.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {setRegExpFlags} from '@augment-vir/common';
- *
- * setRegExpFlags(/a/i, 'gm');
- * // output is `/a/gm`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export declare function setRegExpFlags(originalRegExpOrString: RegExp | string, flags: string): RegExp;
-/**
- * Creates a new RegExp by adding or removing the case insensitivity flag `'i'`, based on the given
- * `caseSensitive` input. The first input can also be a string and it will be converted into a
- * RegExp.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {setRegExpCaseSensitivity} from '@augment-vir/common';
- *
- * setRegExpCaseSensitivity(/abc/i, {caseSensitive: true}); // output is `/abc/`
- * setRegExpCaseSensitivity(/abc/, {caseSensitive: false}); // output is `/abc/i`
- * setRegExpCaseSensitivity('abc', {caseSensitive: true}); // output is `/abc/i`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export declare function setRegExpCaseSensitivity(originalRegExpOrString: string | RegExp, { caseSensitive }: {
-    caseSensitive: boolean;
-}): RegExp;

package/dist/augments/regexp/regexp-flags.js

@@ -1,75 +0,0 @@
-import { escapeStringForRegExp } from '@augment-vir/core';
-import { removeDuplicateCharacters } from '../string/remove-duplicate-characters.js';
-/**
- * Creates a new RegExp by adding the given `flags` to the original RegExp.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {addRegExpFlags} from '@augment-vir/common';
- *
- * addRegExpFlags(/a/i, 'gm');
- * // output is `/a/igm`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export function addRegExpFlags(originalRegExpOrString, flags) {
-    const allFlags = removeDuplicateCharacters([
-        typeof originalRegExpOrString === 'string' ? '' : originalRegExpOrString.flags,
-        flags,
-    ]
-        .join('')
-        .toLowerCase());
-    return setRegExpFlags(originalRegExpOrString, allFlags);
-}
-/**
- * Creates a new RegExp with the given `flags`.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {setRegExpFlags} from '@augment-vir/common';
- *
- * setRegExpFlags(/a/i, 'gm');
- * // output is `/a/gm`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export function setRegExpFlags(originalRegExpOrString, flags) {
-    const allFlags = removeDuplicateCharacters(flags);
-    if (typeof originalRegExpOrString === 'string') {
-        return new RegExp(escapeStringForRegExp(originalRegExpOrString), allFlags);
-    }
-    else {
-        return new RegExp(originalRegExpOrString.source, allFlags);
-    }
-}
-/**
- * Creates a new RegExp by adding or removing the case insensitivity flag `'i'`, based on the given
- * `caseSensitive` input. The first input can also be a string and it will be converted into a
- * RegExp.
- *
- * @category RegExp
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {setRegExpCaseSensitivity} from '@augment-vir/common';
- *
- * setRegExpCaseSensitivity(/abc/i, {caseSensitive: true}); // output is `/abc/`
- * setRegExpCaseSensitivity(/abc/, {caseSensitive: false}); // output is `/abc/i`
- * setRegExpCaseSensitivity('abc', {caseSensitive: true}); // output is `/abc/i`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export function setRegExpCaseSensitivity(originalRegExpOrString, { caseSensitive }) {
-    const caseSensitivityFlag = caseSensitive ? '' : 'i';
-    return addRegExpFlags(originalRegExpOrString, caseSensitivityFlag);
-}

package/dist/augments/string/remove-duplicate-characters.d.ts

@@ -1,17 +0,0 @@
-/**
- * Removes duplicate characters from any number of strings.
- *
- * @category String
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {removeDuplicateCharacters} from '@augment-vir/common';
- *
- * removeDuplicateCharacters('aAaBc', 'QrsAa');
- * // output is `'aABcQrs'`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export declare function removeDuplicateCharacters(...values: ReadonlyArray<string>): string;

package/dist/augments/string/remove-duplicate-characters.js

@@ -1,22 +0,0 @@
-import { removeDuplicates } from '../array/remove-duplicates.js';
-/**
- * Removes duplicate characters from any number of strings.
- *
- * @category String
- * @category Package : @augment-vir/common
- * @example
- *
- * ```ts
- * import {removeDuplicateCharacters} from '@augment-vir/common';
- *
- * removeDuplicateCharacters('aAaBc', 'QrsAa');
- * // output is `'aABcQrs'`
- * ```
- *
- * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
- */
-export function removeDuplicateCharacters(...values) {
-    const combined = values.join('');
-    const deDuped = removeDuplicates(Array.from(combined));
-    return Array.from(deDuped).join('');
-}