@augment-vir/common 31.26.0 → 31.28.0

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

@@ -0,0 +1,25 @@
+/**
+ * Finds all duplicates.
+ *
+ * @category Array
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {extractDuplicates} from '@augment-vir/common';
+ *
+ * const result = extractDuplicates([
+ *     'a',
+ *     'b',
+ *     '',
+ *     'a',
+ * ]);
+ * // result is `{duplicates: ['a'], uniques: ['b', '']}`
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function extractDuplicates<T>(items: ReadonlyArray<T>, comparator?: (a: T, b: T) => boolean): {
+    duplicates: T[];
+    uniques: T[];
+};

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

@@ -0,0 +1,43 @@
+import { check } from '@augment-vir/assert';
+/**
+ * Finds all duplicates.
+ *
+ * @category Array
+ * @category Package : @augment-vir/common
+ * @example
+ *
+ * ```ts
+ * import {extractDuplicates} from '@augment-vir/common';
+ *
+ * const result = extractDuplicates([
+ *     'a',
+ *     'b',
+ *     '',
+ *     'a',
+ * ]);
+ * // result is `{duplicates: ['a'], uniques: ['b', '']}`
+ * ```
+ *
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function extractDuplicates(items, comparator = check.strictEquals) {
+    const duplicates = [];
+    const uniques = [];
+    items.forEach((item) => {
+        const duplicatesIndex = duplicates.findIndex((duplicateEntry) => comparator(duplicateEntry, item));
+        if (duplicatesIndex < 0) {
+            const uniquesIndex = uniques.findIndex((uniqueEntry) => comparator(uniqueEntry, item));
+            if (uniquesIndex < 0) {
+                uniques.push(item);
+            }
+            else {
+                uniques.splice(uniquesIndex, 1);
+                duplicates.push(item);
+            }
+        }
+    });
+    return {
+        duplicates,
+        uniques,
+    };
+}

package/dist/augments/object/deep-value.d.ts

@@ -0,0 +1,17 @@
+import { type AnyObject } from '@augment-vir/core';
+/**
+ * Gets the type of a nested property within `Parent` by recursively accessing each key in `Keys`.
+ *
+ * @category Object
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export type DeepValue<Parent extends AnyObject, Keys extends ReadonlyArray<PropertyKey>> = Keys extends Readonly<[infer First, ...infer Rest]> ? First extends keyof Parent ? Rest extends ReadonlyArray<PropertyKey> ? DeepValue<Parent[First], Rest> : undefined : undefined : Parent;
+/**
+ * Gets the value of a nested property within `Parent` by recursively accessing each key in `Keys`.
+ *
+ * @category Object
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function getDeepValue<const Parent extends AnyObject, const Keys extends ReadonlyArray<PropertyKey>>(parent: Parent, keys: Readonly<Keys>): DeepValue<Parent, Keys>;

package/dist/augments/object/deep-value.js

@@ -0,0 +1,21 @@
+import { check } from '@augment-vir/assert';
+/**
+ * Gets the value of a nested property within `Parent` by recursively accessing each key in `Keys`.
+ *
+ * @category Object
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function getDeepValue(parent, keys) {
+    if (!keys.length) {
+        return parent;
+    }
+    const innerParent = parent;
+    const currentKey = keys[0];
+    if (currentKey != undefined && check.hasKey(innerParent, currentKey)) {
+        return getDeepValue(innerParent[currentKey], keys.slice(1));
+    }
+    else {
+        return undefined;
+    }
+}

package/dist/augments/promise/timed-promise.js

@@ -30,7 +30,10 @@ export class PromiseTimeoutError extends Error {
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
 export function wrapPromiseInTimeout(duration, originalPromise, failureMessage) {
-    const milliseconds = convertDuration(duration, { milliseconds: true }).milliseconds;
+    const isInfinity = Object.values(duration).some((value) => value && check.isInfinite(value));
+    const milliseconds = isInfinity
+        ? Infinity
+        : convertDuration(duration, { milliseconds: true }).milliseconds;
     return new Promise(async (resolve, reject) => {
         const timeoutId = milliseconds === Infinity
             ? undefined

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './augments/array/awaited/awaited-filter.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/extract-duplicates.js';
 export * from './augments/array/filter.js';
 export * from './augments/array/remove-duplicates.js';
 export * from './augments/array/repeat-array.js';
@@ -38,6 +39,7 @@ export * from './augments/number/scientific.js';
 export * from './augments/number/truncate-number.js';
 export * from './augments/number/wrap-number.js';
 export * from './augments/object/deep-copy.js';
+export * from './augments/object/deep-value.js';
 export * from './augments/object/diff.js';
 export * from './augments/object/empty.js';
 export * from './augments/object/get-or-set.js';

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './augments/array/awaited/awaited-filter.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/extract-duplicates.js';
 export * from './augments/array/filter.js';
 export * from './augments/array/remove-duplicates.js';
 export * from './augments/array/repeat-array.js';
@@ -38,6 +39,7 @@ export * from './augments/number/scientific.js';
 export * from './augments/number/truncate-number.js';
 export * from './augments/number/wrap-number.js';
 export * from './augments/object/deep-copy.js';
+export * from './augments/object/deep-value.js';
 export * from './augments/object/diff.js';
 export * from './augments/object/empty.js';
 export * from './augments/object/get-or-set.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "31.26.0",
+    "version": "31.28.0",
     "description": "A collection of augments, helpers types, functions, and classes for any JavaScript environment.",
     "keywords": [
         "augment",
@@ -40,9 +40,9 @@
         "test:web": "virmator --no-deps test web"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.26.0",
-        "@augment-vir/core": "^31.26.0",
-        "@date-vir/duration": "^7.3.1",
+        "@augment-vir/assert": "^31.28.0",
+        "@augment-vir/core": "^31.28.0",
+        "@date-vir/duration": "^7.3.2",
         "ansi-styles": "^6.2.1",
         "deepcopy-esm": "^2.1.1",
         "json5": "^2.2.3",
@@ -55,8 +55,8 @@
         "@web/test-runner-commands": "^0.9.0",
         "@web/test-runner-playwright": "^0.11.1",
         "@web/test-runner-visual-regression": "^0.10.0",
-        "concurrently": "^9.1.2",
-        "execute-in-browser": "^1.0.7",
+        "concurrently": "^9.2.0",
+        "execute-in-browser": "^1.0.8",
         "istanbul-smart-text-reporter": "^1.1.5",
         "typescript": "^5.8.3"
     },