@augment-vir/common 32.2.1 → 32.2.3

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

@@ -24,7 +24,9 @@ export function extractDuplicates(items, comparator = check.strictEquals) {
     const duplicates = [];
     const uniques = [];
     items.forEach((item) => {
-        const duplicatesIndex = duplicates.findIndex((duplicateEntry) => comparator(duplicateEntry, item));
+        const duplicatesIndex = duplicates.findIndex((duplicateEntry) => {
+            return comparator(duplicateEntry, item);
+        });
         if (duplicatesIndex < 0) {
             const uniquesIndex = uniques.findIndex((uniqueEntry) => comparator(uniqueEntry, item));
             if (uniquesIndex < 0) {

package/dist/augments/error/combine-errors.js

@@ -30,5 +30,7 @@ export function combineErrors(errors) {
     else if (errors.length === 1) {
         return errors[0];
     }
-    return new Error(errors.map((error) => extractErrorMessage(error).trim()).join('\n'));
+    else {
+        return new Error(errors.map((error) => extractErrorMessage(error).trim()).join('\n'));
+    }
 }

package/dist/augments/function/retry.js

@@ -65,12 +65,14 @@ function internalRetry({ currentRetry, maxRetries, callback, options = {}, }) {
             throw ensureErrorAndPrependMessage(error, 'Retry max reached');
         }
         else if (options.interval) {
-            return wait(options.interval).then(() => internalRetry({
-                currentRetry: currentRetry + 1,
-                maxRetries,
-                callback,
-                options,
-            }));
+            return wait(options.interval).then(() => {
+                return internalRetry({
+                    currentRetry: currentRetry + 1,
+                    maxRetries,
+                    callback,
+                    options,
+                });
+            });
         }
         else {
             return internalRetry({

package/dist/augments/log/log-string.js

@@ -42,10 +42,12 @@ async function createToLogString() {
             return ({ args, colorKey, options }) => {
                 const css = options.omitColors
                     ? undefined
-                    : filterMap(options.colorConfig[colorKey].colors, (cssString) => removeSuffix({
-                        value: cssString,
-                        suffix: ';',
-                    }), check.isTruthy).join('; ');
+                    : filterMap(options.colorConfig[colorKey].colors, (cssString) => {
+                        return removeSuffix({
+                            value: cssString,
+                            suffix: ';',
+                        });
+                    }, check.isTruthy).join('; ');
                 const argStrings = args.map((arg) => {
                     if (typeof arg === 'string') {
                         return arg;

package/dist/augments/log/logger.js

@@ -40,10 +40,12 @@ export function createLogger(logWriters, optionsOverride) {
         }));
     }
     const loggerLogs = mapEnumToObject(LogColorKey, (colorKey) => {
-        return (...args) => writeLog({
-            args,
-            colorKey,
-        });
+        return (...args) => {
+            return writeLog({
+                args,
+                colorKey,
+            });
+        };
     });
     return {
         ...loggerLogs,

package/dist/augments/number/wrap-number.js

@@ -33,13 +33,13 @@ export function wrapNumber(value, minMax) {
             return min + offset;
         }
     }
+    else if (value > max) {
+        return min;
+    }
+    else if (value < min) {
+        return max;
+    }
     else {
-        if (value > max) {
-            return min;
-        }
-        else if (value < min) {
-            return max;
-        }
         return value;
     }
 }

package/dist/augments/object/diff.js

@@ -94,7 +94,9 @@ export function diffArrays(array0, array1) {
  */
 export function diffBasic(value0, value1, 
 /** A custom equality checker. Defaults to a strict equality check (`===`). */
-areEqual = (value0, value1) => value0 === value1) {
+areEqual = (value0, value1) => {
+    return value0 === value1;
+}) {
     if (areEqual(value0, value1)) {
         return [];
     }

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

@@ -9,10 +9,12 @@ import { getObjectTypedKeys } from '@augment-vir/core';
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
 export function getObjectTypedEntries(input) {
-    return getObjectTypedKeys(input).map((key) => [
-        key,
-        input[key],
-    ]);
+    return getObjectTypedKeys(input).map((key) => {
+        return [
+            key,
+            input[key],
+        ];
+    });
 }
 /**
  * Create an object from an array of entries. This is the same as
@@ -36,5 +38,7 @@ export function typedObjectFromEntries(entries) {
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
 export function getEntriesSortedByKey(input) {
-    return getObjectTypedEntries(input).sort((tupleA, tupleB) => String(tupleA[0]).localeCompare(String(tupleB[0])));
+    return getObjectTypedEntries(input).sort((tupleA, tupleB) => {
+        return String(tupleA[0]).localeCompare(String(tupleB[0]));
+    });
 }

package/dist/augments/object/object-filter.js

@@ -75,7 +75,9 @@ export function removeNullishValues(input) {
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
 export function replaceUndefinedValuesWithNull(input) {
-    return mapObjectValues(input, (key, value) => value === undefined ? null : value);
+    return mapObjectValues(input, (key, value) => {
+        return value === undefined ? null : value;
+    });
 }
 /**
  * Replaces all `null` values with `undefined`.
@@ -85,5 +87,7 @@ export function replaceUndefinedValuesWithNull(input) {
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
 export function replaceNullValuesWithUndefined(input) {
-    return mapObjectValues(input, (key, value) => value === null ? undefined : value);
+    return mapObjectValues(input, (key, value) => {
+        return value === null ? undefined : value;
+    });
 }

package/dist/augments/selection-set/select-from.js

@@ -50,7 +50,9 @@ export function shouldPreserveInSelectionSet(input) {
  */
 export function selectFrom(originalObject, selectionSet) {
     if (Array.isArray(originalObject)) {
-        return originalObject.map((originalEntry) => selectFrom(originalEntry, selectionSet));
+        return originalObject.map((originalEntry) => {
+            return selectFrom(originalEntry, selectionSet);
+        });
     }
     const keysToRemove = [];
     return omitObjectKeys(mapObjectValues(originalObject, (key, value) => {

package/dist/augments/string/shell-quote.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Wraps a string in single quotes so that a POSIX shell treats it as a single literal argument.
+ * Single quotes disable word splitting, glob expansion, and command substitution, so the shell
+ * passes the value through exactly as given. The only character that cannot appear inside single
+ * quotes is a single quote itself, which is closed, escaped, and reopened.
+ *
+ * This is only valid for POSIX shells like `bash`. It is not correct for `cmd.exe`, which uses
+ * entirely different quoting rules.
+ *
+ * This protects a single round of shell parsing. If the command string will be parsed twice (bash
+ * hands it to something that parses it again), quoting once is not enough; see
+ * `interpolationSafeWindowsPath` in `@augment-vir/node`, whose backslash count assumes two rounds.
+ *
+ * @category String
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {shellQuote} from '@augment-vir/common';
+ *
+ * shellQuote('hello world'); // outputs `"'hello world'"`
+ * shellQuote("it's"); // outputs `"'it'\\''s'"`
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function shellQuote(input: string): string;

package/dist/augments/string/shell-quote.js

@@ -0,0 +1,33 @@
+/**
+ * Wraps a string in single quotes so that a POSIX shell treats it as a single literal argument.
+ * Single quotes disable word splitting, glob expansion, and command substitution, so the shell
+ * passes the value through exactly as given. The only character that cannot appear inside single
+ * quotes is a single quote itself, which is closed, escaped, and reopened.
+ *
+ * This is only valid for POSIX shells like `bash`. It is not correct for `cmd.exe`, which uses
+ * entirely different quoting rules.
+ *
+ * This protects a single round of shell parsing. If the command string will be parsed twice (bash
+ * hands it to something that parses it again), quoting once is not enough; see
+ * `interpolationSafeWindowsPath` in `@augment-vir/node`, whose backslash count assumes two rounds.
+ *
+ * @category String
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {shellQuote} from '@augment-vir/common';
+ *
+ * shellQuote('hello world'); // outputs `"'hello world'"`
+ * shellQuote("it's"); // outputs `"'it'\\''s'"`
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function shellQuote(input) {
+    return [
+        "'",
+        input.replaceAll("'", String.raw `'\''`),
+        "'",
+    ].join('');
+}

package/dist/index.d.ts

@@ -93,6 +93,7 @@ export * from './augments/string/length.js';
 export * from './augments/string/lines.js';
 export * from './augments/string/prefix.js';
 export * from './augments/string/replace.js';
+export * from './augments/string/shell-quote.js';
 export * from './augments/string/split.js';
 export * from './augments/string/substring-index.js';
 export * from './augments/string/suffix.js';

package/dist/index.js

@@ -93,6 +93,7 @@ export * from './augments/string/length.js';
 export * from './augments/string/lines.js';
 export * from './augments/string/prefix.js';
 export * from './augments/string/replace.js';
+export * from './augments/string/shell-quote.js';
 export * from './augments/string/split.js';
 export * from './augments/string/substring-index.js';
 export * from './augments/string/suffix.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "32.2.1",
+    "version": "32.2.3",
     "description": "A collection of augments, helpers types, functions, and classes for any JavaScript environment.",
     "keywords": [
         "augment",
@@ -40,22 +40,22 @@
         "test:web": "virmator --no-deps test web"
     },
     "dependencies": {
-        "@augment-vir/assert": "^32.2.1",
-        "@augment-vir/core": "^32.2.1",
-        "@date-vir/duration": "^8.6.1",
+        "@augment-vir/assert": "^32.2.3",
+        "@augment-vir/core": "^32.2.3",
+        "@date-vir/duration": "^9.0.0",
         "@paralleldrive/cuid2": "^3.3.0",
-        "ansi-styles": "^6.2.3",
+        "ansi-styles": "^7.0.0",
         "deepcopy-esm": "^2.1.2",
         "json5": "^2.2.3",
-        "typed-event-target": "^4.3.1"
+        "typed-event-target": "^4.3.3"
     },
     "devDependencies": {
-        "@web/dev-server-esbuild": "^1.0.5",
-        "@web/test-runner": "^0.20.2",
-        "@web/test-runner-playwright": "^0.11.1",
-        "execute-in-browser": "^1.0.9",
+        "@web/dev-server-esbuild": "^2.0.0",
+        "@web/test-runner": "^1.0.0",
+        "@web/test-runner-playwright": "^1.0.0",
+        "execute-in-browser": "^1.0.10",
         "istanbul-smart-text-reporter": "^1.1.5",
-        "runstorm": "^1.0.4",
+        "runstorm": "^1.0.6",
         "typescript": "^6.0.3"
     },
     "engines": {