Number & Array Utilities

import {
  chunk,
  keyBy,
  groupBy,
  sortBy,
  partition,
  intersection,
  difference,
  unique,
  uniqueByKey,
  findDuplicates,
  shuffleArray,
  flatten,
  clamp,
  formatCompactNumber,
  range,
  percentage,
  randomNumber,
  isNumeric,
} from "@explita/utils";

import { keyBy } from "@explita/utils";
 
const users = [
  { id: "u_1", name: "Alice", role: "Admin" },
  { id: "u_2", name: "Bob", role: "Member" },
];
 
const lookup = keyBy(users, "id");
/*
{
  "u_1": { id: "u_1", name: "Alice", role: "Admin" },
  "u_2": { id: "u_2", name: "Bob", role: "Member" }
}
*/

import { groupBy } from "@explita/utils";
 
const inventory = [
  { category: "fruit", name: "Apple" },
  { category: "fruit", name: "Banana" },
  { category: "grain", name: "Rice" },
];
 
groupBy(inventory, "category");
/*
{
  fruit: [{ category: "fruit", name: "Apple" }, { category: "fruit", name: "Banana" }],
  grain: [{ category: "grain", name: "Rice" }]
}
*/

import { sortBy } from "@explita/utils";
 
const items = [
  { name: "Product C", price: 30 },
  { name: "Product A", price: 10 },
  { name: "Product B", price: 20 },
];
 
// Sort by property ascending
sortBy(items, "price");
// [{ price: 10, ... }, { price: 20, ... }, { price: 30, ... }]
 
// Sort by custom getter descending
sortBy(items, (item) => item.price, "desc");
// [{ price: 30, ... }, { price: 20, ... }, { price: 10, ... }]

import { partition } from "@explita/utils";
 
const numbers = [1, 2, 3, 4, 5, 6];
const [evens, odds] = partition(numbers, (n) => n % 2 === 0);
 
console.log(evens); // [2, 4, 6]
console.log(odds);  // [1, 3, 5]

import { chunk } from "@explita/utils";
 
chunk([1, 2, 3, 4, 5, 6, 7], 3);
// [[1, 2, 3], [4, 5, 6], [7]]

import { intersection, difference } from "@explita/utils";
 
// Common elements in all arrays
intersection([1, 2, 3], [2, 3, 4], [3, 5]);
// [3]
 
// Elements in the first array not present in other arrays
difference([1, 2, 3, 4], [2, 4]);
// [1, 3]

import { unique, uniqueByKey } from "@explita/utils";
 
unique([1, 2, 2, 3, 1]); 
// [1, 2, 3]
 
uniqueByKey(
  [
    { id: 1, name: "Item A" },
    { id: 2, name: "Item B" },
    { id: 1, name: "Item A" },
  ],
  "id"
);
// [{ id: 1, name: "Item A" }, { id: 2, name: "Item B" }]

import { findDuplicates } from "@explita/utils";
 
const employees = [
  { email: "john@doe.com", name: "John" },
  { email: "jane@doe.com", name: "Jane" },
  { email: "john@doe.com", name: "John 2" },
];
 
findDuplicates(employees, "email", "Duplicate email found");
/*
[
  { _index: 2, email: "Duplicate email found" },
  { _index: 0, email: "Duplicate email found" }
]
*/

import { shuffleArray, flatten } from "@explita/utils";
 
// Non-mutating Fisher-Yates shuffle
shuffleArray([1, 2, 3, 4, 5]); 
// [3, 1, 5, 2, 4]
 
// Deep array flattening
flatten([1, [2, [3, [4, 5]]]]);
// [1, 2, 3, 4, 5]

import { clamp } from "@explita/utils";
 
clamp(105, 0, 100); // 100 (capped at max)
clamp(-15, 0, 100); // 0   (capped at min)
clamp(42, 0, 100);  // 42  (within range)

import { formatCompactNumber } from "@explita/utils";
 
formatCompactNumber(1250);     // "1.3K"
formatCompactNumber(2500000);  // "2.5M"
formatCompactNumber(8900000000); // "8.9B"

import { range } from "@explita/utils";
 
range(1, 5);     // [1, 2, 3, 4, 5]
range(0, 10, 2); // [0, 2, 4, 6, 8, 10]
range(3);        // [0, 1, 2, 3]

import { percentage } from "@explita/utils";
 
percentage(200, 50);    // 25
percentage(3, 1, 2);    // 33.33 (precision = 2)

import { isNumeric, randomNumber } from "@explita/utils";
 
isNumeric("123.45"); // true
isNumeric("abc");    // false
isNumeric(NaN);      // false
 
randomNumber(6); // 6-digit random number (e.g. 583920)