@germondai/ts-utils 0.0.2 → 0.0.3

package/dist/module.js

@@ -1,15 +1,11 @@
 // src/runtime/collection.ts
-var hasDuplicates = (array, keyExtractor) => {
-  const seen = new Set;
-  for (const item of array) {
-    const key = keyExtractor ? keyExtractor(item) : item;
-    if (seen.has(key))
-      return true;
-    seen.add(key);
-  }
-  return false;
-};
-var uniqueArray = (array) => [...new Set(array)];
+var hasDuplicates = (array, keyExtractor) => new Set(array.map((value, index) => keyExtractor?.(value, index, array) || value)).size < array.length;
+var uniqueArray = (array, keyExtractor) => [
+  ...new Map(array.map((value, index, array2) => [
+    keyExtractor?.(value, index, array2) || value,
+    value
+  ])).values()
+];
 // src/runtime/constants.ts
 var SUPPORTED_DISPLAYABLE_MEDIA_TYPES = {
   images: [

package/dist/runtime/collection.d.ts

@@ -1,19 +1,53 @@
 /**
- * Checks if an array contains duplicate values.
+ * Determines whether an array contains duplicate values.
  *
  * @param array - The array to check for duplicates.
+ * @param keyExtractor - Optional function to extract a key for comparison. If provided, duplicates are determined based on the extracted key.
  * @returns True if the array contains duplicates, false otherwise.
  *
  * @example
+ * // Basic usage with primitive values
  * hasDuplicates([1, 2, 3, 4, 1]); // true
  * hasDuplicates(['a', 'b', 'c']); // false
+ *
+ * // Usage with objects and a key extractor
  * hasDuplicates([{ id: 1 }, { id: 2 }, { id: 1 }], (item) => item.id); // true
  */
-export declare const hasDuplicates: <T>(array: T[], keyExtractor?: (item: T) => unknown) => boolean;
+export declare const hasDuplicates: <T>(array: T[], keyExtractor?: (value: T, index: number, array: T[]) => string | number) => boolean;
 /**
- * Removes duplicates from an array.
+ * Removes duplicates from an array based on a key function.
  *
  * @param array - The array to process.
+ * @param keyExtractor - Function to generate a unique key for each item.
  * @returns A new array without duplicates.
  */
-export declare const uniqueArray: <T>(array: T[]) => T[];
+/**
+ * Returns a new array containing only unique elements from the input array.
+ * Uniqueness is determined based on the values returned by the `keyExtractor` function,
+ * or by the elements themselves if no `keyExtractor` is provided.
+ *
+ * @typeParam T - The type of elements in the input array.
+ * @param array - The input array from which to extract unique elements.
+ * @param keyExtractor - An optional function that extracts a key from each element
+ * to determine uniqueness. If not provided, the elements themselves are used.
+ * The function receives the current element, its index, and the entire array as arguments.
+ * @returns A new array containing only unique elements from the input array.
+ *
+ * @example
+ * // Using default behavior (elements themselves determine uniqueness)
+ * const numbers = [1, 2, 2, 3, 4, 4];
+ * const uniqueNumbers = uniqueArray(numbers);
+ * console.log(uniqueNumbers); // Output: [1, 2, 3, 4]
+ *
+ * @example
+ * // Using a keyExtractor to determine uniqueness
+ * const users = [
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ *   { id: 1, name: 'Alice' },
+ * ];
+ * const uniqueUsers = uniqueArray(users, user => user.id);
+ * console.log(uniqueUsers);
+ * // Output: [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
+ */
+export declare const uniqueArray: <T>(array: T[], keyExtractor?: (value: T, index: number, array: T[]) => string | number) => T[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@germondai/ts-utils",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Germond's TypeScript Utilities",
   "repository": {
     "type": "git",