nhb-toolbox 3.2.0 → 3.3.0

package/dist/date/greet.d.ts

@@ -0,0 +1,9 @@
+import type { GreetingConfigs } from './types';
+/**
+ * * Returns a greeting message based on the provided time or current time.
+ *
+ * @param configs - Configuration options for greeting times and messages.
+ * @returns The appropriate greeting message.
+ */
+export declare function getGreeting(configs?: GreetingConfigs): string;
+//# sourceMappingURL=greet.d.ts.map

package/dist/date/greet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greet.d.ts","sourceRoot":"","sources":["../../src/date/greet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAgD7D"}

package/dist/date/greet.js

@@ -0,0 +1,45 @@
+import { isValidTime } from './guards';
+import { extractHourMinute, getTotalMinutes } from './utils';
+/**
+ * * Returns a greeting message based on the provided time or current time.
+ *
+ * @param configs - Configuration options for greeting times and messages.
+ * @returns The appropriate greeting message.
+ */
+export function getGreeting(configs) {
+    const { morningEnds = '11:59', noonEnds = '12:59', afternoonEnds = '17:59', eveningEnds = '23:59', midnightEnds = '02:59', currentTime, morningMessage = 'Good Morning!', noonMessage = 'Good Noon!', afternoonMessage = 'Good Afternoon!', eveningMessage = 'Good Evening!', midnightMessage = 'Hello, Night Owl!', defaultMessage = 'Greetings!', } = configs || {};
+    let hour;
+    let minute;
+    if (currentTime && isValidTime(currentTime)) {
+        [hour, minute] = extractHourMinute(currentTime);
+    }
+    else {
+        const now = new Date();
+        hour = now.getHours();
+        minute = now.getMinutes();
+    }
+    const currentTotalMinutes = hour * 60 + minute;
+    const morningEndMinutes = getTotalMinutes(morningEnds);
+    const noonEndMinutes = getTotalMinutes(noonEnds);
+    const afternoonEndMinutes = getTotalMinutes(afternoonEnds);
+    const eveningEndMinutes = getTotalMinutes(eveningEnds);
+    const midnightEndMinutes = getTotalMinutes(midnightEnds);
+    if (currentTotalMinutes <= midnightEndMinutes) {
+        return midnightMessage;
+    }
+    else if (currentTotalMinutes <= morningEndMinutes) {
+        return morningMessage;
+    }
+    else if (currentTotalMinutes <= noonEndMinutes) {
+        return noonMessage;
+    }
+    else if (currentTotalMinutes <= afternoonEndMinutes) {
+        return afternoonMessage;
+    }
+    else if (currentTotalMinutes <= eveningEndMinutes) {
+        return eveningMessage;
+    }
+    else {
+        return defaultMessage;
+    }
+}

package/dist/date/guards.d.ts

@@ -0,0 +1,9 @@
+import type { Time } from './types';
+/**
+ * * Checks if the provided value is a valid time string in "HH:MM" format.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid time string, `false` otherwise.
+ */
+export declare function isValidTime(value: unknown): value is Time;
+//# sourceMappingURL=guards.d.ts.map

package/dist/date/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/date/guards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAWzD"}

package/dist/date/guards.js

@@ -0,0 +1,18 @@
+import { isString } from '../guards/primitives';
+import { isNumericString } from '../guards/specials';
+/**
+ * * Checks if the provided value is a valid time string in "HH:MM" format.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid time string, `false` otherwise.
+ */
+export function isValidTime(value) {
+    if (!isString(value))
+        return false;
+    const [hourStr, minuteStr] = value.split(':');
+    if (!isNumericString(hourStr) || !isNumericString(minuteStr))
+        return false;
+    const hour = Number(hourStr);
+    const minute = Number(minuteStr);
+    return hour >= 0 && hour <= 23 && minute >= 0 && minute <= 59;
+}

package/dist/date/types.d.ts

@@ -0,0 +1,34 @@
+/** - Minute in numeric string from `00` to `23` */
+export type Hour = '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23';
+/** - Minute in numeric string from `00` to `59` */
+export type Minute = '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59';
+/** - Time in "HH:MM" format. */
+export type Time = `${Hour}:${Minute}`;
+/** - Configuration options for greeting. */
+export interface GreetingConfigs {
+    /** Time when the morning period ends (HH:MM format). Defaults to `11:59` */
+    morningEnds?: Time;
+    /** Time when the noon period ends (HH:MM format). Defaults to `12:59` */
+    noonEnds?: Time;
+    /** Time when the afternoon period ends (HH:MM format). Defaults to `17:59` */
+    afternoonEnds?: Time;
+    /** Time when the evening period ends (HH:MM format). Defaults to `23:59` */
+    eveningEnds?: Time;
+    /** Time when the midnight period ends (HH:MM format). Defaults to `02:59` */
+    midnightEnds?: Time;
+    /** Current time in "HH:MM" format for some weird reason. Defaults to current time `new Date()` */
+    currentTime?: Time;
+    /** Custom greeting message for the morning period. */
+    morningMessage?: string;
+    /** Custom greeting message for the noon period. */
+    noonMessage?: string;
+    /** Custom greeting message for the afternoon period. */
+    afternoonMessage?: string;
+    /** Custom greeting message for the evening period. */
+    eveningMessage?: string;
+    /** Custom greeting message for the midnight period. */
+    midnightMessage?: string;
+    /** Default greeting message if no period matches. */
+    defaultMessage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/date/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/date/types.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,MAAM,IAAI,GACb,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAER,mDAAmD;AACnD,MAAM,MAAM,MAAM,GACf,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAER,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC/B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,IAAI,CAAC;IAErB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,IAAI,CAAC;IAEpB,kGAAkG;IAClG,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/date/types.js

@@ -0,0 +1 @@
+export {};

package/dist/date/utils.d.ts

@@ -0,0 +1,16 @@
+import type { Time } from './types';
+/**
+ * * Extracts the hour and minute from a time string in `HH:MM` format.
+ *
+ * @param time - The time string to extract from.
+ * @return The extracted hour and minute as number tuple.
+ */
+export declare function extractHourMinute(time: Time): [number, number];
+/**
+ * * Converts a time string `HH:MM` into total minutes from `00:00`.
+ *
+ * @param time - The time in `HH:MM` format.
+ * @returns The total minutes elapsed since `00:00`.
+ */
+export declare function getTotalMinutes(time: Time): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/date/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/date/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAIlD"}

package/dist/date/utils.js

@@ -0,0 +1,20 @@
+/**
+ * * Extracts the hour and minute from a time string in `HH:MM` format.
+ *
+ * @param time - The time string to extract from.
+ * @return The extracted hour and minute as number tuple.
+ */
+export function extractHourMinute(time) {
+    const [hour, minute] = time.split(':').map(Number);
+    return [hour, minute];
+}
+/**
+ * * Converts a time string `HH:MM` into total minutes from `00:00`.
+ *
+ * @param time - The time in `HH:MM` format.
+ * @returns The total minutes elapsed since `00:00`.
+ */
+export function getTotalMinutes(time) {
+    const [h, m] = extractHourMinute(time);
+    return h * 60 + m;
+}

package/dist/index.d.ts

@@ -3,15 +3,19 @@ export { generateAnagrams } from './string/anagram';
 export { isCamelCase, isEmojiOnly, isKebabCase, isPalindrome, isPascalCase, isSnakeCase, } from './string/guards';
 export { convertStringCase, extractEmails, extractURLs, maskString, normalizeString, replaceAllInString, reverseString, slugifyString, } from './string/convert';
 export { extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, } from './string/utilities';
-export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getRandomNumber, isEven, isEven as isEvenNumber, isFibonacci, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isMultiple, isOdd, isOdd as isOddNumber, isPerfectSquare, reverseNumber, sumDigits, } from './number/basics';
+export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics';
+export { isEven, isEven as isEvenNumber, isFibonacci, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';
 export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
-export { findPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
+export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
 export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color, Color as Colour } from './colors/Color';
+export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
+export { isValidTime, isValidTime as isValidTimeString } from './date/guards';
+export { extractHourMinute, getTotalMinutes } from './date/utils';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, moveArrayElement, removeDuplicatesFromArray, rotateArray, splitArray, } from './array/transform';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,9 +5,10 @@ export { isCamelCase, isEmojiOnly, isKebabCase, isPalindrome, isPascalCase, isSn
 export { convertStringCase, extractEmails, extractURLs, maskString, normalizeString, replaceAllInString, reverseString, slugifyString, } from './string/convert';
 export { extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, } from './string/utilities';
 // ! Number Utilities
-export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getRandomNumber, isEven, isEven as isEvenNumber, isFibonacci, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isMultiple, isOdd, isOdd as isOddNumber, isPerfectSquare, reverseNumber, sumDigits, } from './number/basics';
+export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics';
+export { isEven, isEven as isEvenNumber, isFibonacci, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';
 export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
-export { findPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
+export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
 export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 // ! Color Utilities
@@ -15,6 +16,10 @@ export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color, Color as Colour } from './colors/Color';
+// ! Date & Time Utilities
+export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
+export { isValidTime, isValidTime as isValidTimeString } from './date/guards';
+export { extractHourMinute, getTotalMinutes } from './date/utils';
 // ! Array Utilities
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';

package/dist/number/basics.d.ts

@@ -1,3 +1,4 @@
+import type { Numeric } from '../types';
 import type { ConvertedDecimal, DecimalOptions, RandomNumberOptions } from './types';
 /**
  * * Utility to generate a random number between a given range.
@@ -15,7 +16,7 @@ export declare const getRandomNumber: (options?: RandomNumberOptions) => number;
  * @param options - Options for rounding behavior, including decimal places and return type.
  * @returns Converted number as `number` (default) or `string` (if `isString` is `true`).
  */
-export declare const convertToDecimal: <T extends boolean | undefined = false>(input: number | `${number}`, options?: DecimalOptions<T>) => ConvertedDecimal<T>;
+export declare const convertToDecimal: <T extends boolean | undefined = false>(input: Numeric, options?: DecimalOptions<T>) => ConvertedDecimal<T>;
 /**
  * * Calculates the HCF/GCD of multiple numbers.
  *
@@ -30,42 +31,6 @@ export declare const calculateHCF: (...numbers: number[]) => number;
  * @returns The LCM/LCD of all the provided numbers.
  */
 export declare const calculateLCM: (...numbers: number[]) => number;
-/**
- * * Check if a number is even or not.
- *
- * @param input The number to check.
- * @returns Boolean: `true` if even and `false` if not even.
- */
-export declare const isEven: (input: number) => boolean;
-/**
- * * Checks if a number is odd or not.
- *
- * @param input The number to check.
- * @returns Boolean: `true` if odd and `false` if not odd.
- */
-export declare const isOdd: (input: number) => boolean;
-/**
- * * Checks if a number is a multiple of another number.
- *
- * @param input - The number to check.
- * @param multipleOf - The number to check against.
- * @returns `true` if `input` is a multiple of `multipleOf`, otherwise `false`.
- */
-export declare const isMultiple: (input: number, multipleOf: number) => boolean;
-/**
- * * Checks if a number is a perfect square.
- *
- * @param num The number to check.
- * @returns `true` if the number is a perfect square, otherwise `false`.
- */
-export declare function isPerfectSquare(num: number): boolean;
-/**
- * * Checks if a number is part of the Fibonacci sequence.
- *
- * @param num The number to check.
- * @returns `true` if the number is a Fibonacci number, otherwise `false`.
- */
-export declare function isFibonacci(num: number): boolean;
 /**
  * * Generates the first `n` Fibonacci numbers.
  *
@@ -79,12 +44,19 @@ export declare function getFibonacciSeries(n: number): number[];
  * @param num The input number.
  * @returns The sum of its digits.
  */
-export declare function sumDigits(num: number): number;
+export declare function sumDigits(num: Numeric): number;
+/**
+ * * Sums up numbers.
+ *
+ * @param numbers The input numbers.
+ * @returns The sum of the numbers.
+ */
+export declare function sumNumbers(...numbers: Numeric[]): number;
 /**
  * * Reverses a number (e.g., `123` → `321`).
  *
  * @param num The number to reverse.
  * @returns The reversed number.
  */
-export declare function reverseNumber(num: number): number;
+export declare function reverseNumber(num: Numeric): number;
 //# sourceMappingURL=basics.d.ts.map

package/dist/number/basics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/number/basics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAAc,mBAAmB,KAAG,MA+C/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,OAAO,GAAG,SAAS,iBACtD,MAAM,GAAG,GAAG,MAAM,EAAE,YACjB,cAAc,CAAC,CAAC,CAAC,KACzB,gBAAgB,CAAC,CAAC,CAQpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,EAAE,KAAG,MAQnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,EAAE,KAAG,MAQnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,OAEtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,UAAW,MAAM,KAAG,OAErC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UAAW,MAAM,cAAc,MAAM,KAAG,OAE9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/number/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAAc,mBAAmB,KAAG,MA+C/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,OAAO,GAAG,SAAS,iBACtD,OAAO,YACJ,cAAc,CAAC,CAAC,CAAC,KACzB,gBAAgB,CAAC,CAAC,CAQpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,EAAE,KAAG,MAQnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,EAAE,KAAG,MAQnD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAK9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAIxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOlD"}

package/dist/number/basics.js

@@ -80,52 +80,6 @@ export const calculateLCM = (...numbers) => {
     }
     return lcm;
 };
-/**
- * * Check if a number is even or not.
- *
- * @param input The number to check.
- * @returns Boolean: `true` if even and `false` if not even.
- */
-export const isEven = (input) => {
-    return input % 2 === 0;
-};
-/**
- * * Checks if a number is odd or not.
- *
- * @param input The number to check.
- * @returns Boolean: `true` if odd and `false` if not odd.
- */
-export const isOdd = (input) => {
-    return input % 2 !== 0;
-};
-/**
- * * Checks if a number is a multiple of another number.
- *
- * @param input - The number to check.
- * @param multipleOf - The number to check against.
- * @returns `true` if `input` is a multiple of `multipleOf`, otherwise `false`.
- */
-export const isMultiple = (input, multipleOf) => {
-    return input % multipleOf === 0;
-};
-/**
- * * Checks if a number is a perfect square.
- *
- * @param num The number to check.
- * @returns `true` if the number is a perfect square, otherwise `false`.
- */
-export function isPerfectSquare(num) {
-    return Number.isInteger(Math.sqrt(num));
-}
-/**
- * * Checks if a number is part of the Fibonacci sequence.
- *
- * @param num The number to check.
- * @returns `true` if the number is a Fibonacci number, otherwise `false`.
- */
-export function isFibonacci(num) {
-    return (isPerfectSquare(5 * num * num + 4) || isPerfectSquare(5 * num * num - 4));
-}
 /**
  * * Generates the first `n` Fibonacci numbers.
  *
@@ -146,11 +100,22 @@ export function getFibonacciSeries(n) {
  * @returns The sum of its digits.
  */
 export function sumDigits(num) {
-    return Math.abs(num)
+    return Math.abs(Number(num))
         .toString()
         .split('')
         .reduce((sum, digit) => sum + Number(digit), 0);
 }
+/**
+ * * Sums up numbers.
+ *
+ * @param numbers The input numbers.
+ * @returns The sum of the numbers.
+ */
+export function sumNumbers(...numbers) {
+    return numbers
+        .map((num) => Number(num))
+        .reduce((sum, number) => sum + number, 0);
+}
 /**
  * * Reverses a number (e.g., `123` → `321`).
  *
@@ -158,6 +123,6 @@ export function sumDigits(num) {
  * @returns The reversed number.
  */
 export function reverseNumber(num) {
-    const reversed = parseInt(Math.abs(num).toString().split('').reverse().join(''), 10);
-    return num < 0 ? -reversed : reversed;
+    const reversed = parseInt(Math.abs(Number(num)).toString().split('').reverse().join(''), 10);
+    return Number(num) < 0 ? -reversed : reversed;
 }

package/dist/number/guards.d.ts

@@ -0,0 +1,37 @@
+/**
+ * * Check if a number is even or not.
+ *
+ * @param input The number to check.
+ * @returns Boolean: `true` if even and `false` if not even.
+ */
+export declare const isEven: (input: number) => boolean;
+/**
+ * * Checks if a number is odd or not.
+ *
+ * @param input The number to check.
+ * @returns Boolean: `true` if odd and `false` if not odd.
+ */
+export declare const isOdd: (input: number) => boolean;
+/**
+ * * Checks if a number is a multiple of another number.
+ *
+ * @param input - The number to check.
+ * @param multipleOf - The number to check against.
+ * @returns `true` if `input` is a multiple of `multipleOf`, otherwise `false`.
+ */
+export declare const isMultiple: (input: number, multipleOf: number) => boolean;
+/**
+ * * Checks if a number is a perfect square.
+ *
+ * @param num The number to check.
+ * @returns `true` if the number is a perfect square, otherwise `false`.
+ */
+export declare function isPerfectSquare(num: number): boolean;
+/**
+ * * Checks if a number is part of the Fibonacci sequence.
+ *
+ * @param num The number to check.
+ * @returns `true` if the number is a Fibonacci number, otherwise `false`.
+ */
+export declare function isFibonacci(num: number): boolean;
+//# sourceMappingURL=guards.d.ts.map

package/dist/number/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/number/guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,OAEtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,UAAW,MAAM,KAAG,OAErC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UAAW,MAAM,cAAc,MAAM,KAAG,OAE9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIhD"}

package/dist/number/guards.js

@@ -0,0 +1,46 @@
+/**
+ * * Check if a number is even or not.
+ *
+ * @param input The number to check.
+ * @returns Boolean: `true` if even and `false` if not even.
+ */
+export const isEven = (input) => {
+    return input % 2 === 0;
+};
+/**
+ * * Checks if a number is odd or not.
+ *
+ * @param input The number to check.
+ * @returns Boolean: `true` if odd and `false` if not odd.
+ */
+export const isOdd = (input) => {
+    return input % 2 !== 0;
+};
+/**
+ * * Checks if a number is a multiple of another number.
+ *
+ * @param input - The number to check.
+ * @param multipleOf - The number to check against.
+ * @returns `true` if `input` is a multiple of `multipleOf`, otherwise `false`.
+ */
+export const isMultiple = (input, multipleOf) => {
+    return input % multipleOf === 0;
+};
+/**
+ * * Checks if a number is a perfect square.
+ *
+ * @param num The number to check.
+ * @returns `true` if the number is a perfect square, otherwise `false`.
+ */
+export function isPerfectSquare(num) {
+    return Number.isInteger(Math.sqrt(num));
+}
+/**
+ * * Checks if a number is part of the Fibonacci sequence.
+ *
+ * @param num The number to check.
+ * @returns `true` if the number is a Fibonacci number, otherwise `false`.
+ */
+export function isFibonacci(num) {
+    return (isPerfectSquare(5 * num * num + 4) || isPerfectSquare(5 * num * num - 4));
+}

package/dist/number/range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/number/range.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAChD,IAAI,GAAE,UAAkB,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,CAAC,CAAC,CA2FlB"}
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/number/range.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAChD,IAAI,GAAE,UAAkB,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,CAAC,CAAC,CA2FlB"}

package/dist/number/range.js

@@ -1,6 +1,7 @@
 import { shuffleArray } from '../array/basics';
 import { convertArrayToString } from '../utils';
-import { getRandomNumber, isEven, isOdd } from './basics';
+import { getRandomNumber } from './basics';
+import { isEven, isOdd } from './guards';
 import { _applyMultiples } from './helpers';
 import { isPrime } from './prime';
 /**

package/dist/types/index.d.ts

@@ -11,6 +11,8 @@ export type FlattenPartial<T> = Partial<{
     [K in keyof T]: T[K];
 }>;
 /** Utility type to flatten Partial type */
+/** Union of `number` and numeric string */
+export type Numeric = number | `${number}`;
 /** Union of Primitive Types */
 export type Primitive = string | number | boolean | null | undefined;
 /** Extract primitive key(s) from an object */

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,IAAI;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAEzC,2CAA2C;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAElE,2CAA2C;AAG3C,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,8CAA8C;AAC9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK;CAClD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK;CAClE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAExD,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEpD,kDAAkD;AAClD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAC/C,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,mDAAmD;AACnD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI,CACjD,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,iCAAiC;AACjC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE,mCAAmC;AACnC,MAAM,MAAM,aAAa,GACtB,KAAK,CAAC,OAAO,CAAC,GACd,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC,GAChB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,SAAS,GACT,YAAY,GACZ,aAAa,CAAC,OAAO,CAAC,GACtB,OAAO,CAAC,OAAO,CAAC,GAChB,KAAK,GACL,SAAS,GACT,UAAU,GACV,cAAc,GACd,WAAW,GACX,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,IAAI;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAEzC,2CAA2C;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAElE,2CAA2C;AAG3C,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AAE3C,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,8CAA8C;AAC9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK;CAClD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK;CAClE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAExD,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEpD,kDAAkD;AAClD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAC/C,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,mDAAmD;AACnD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI,CACjD,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,iCAAiC;AACjC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE,mCAAmC;AACnC,MAAM,MAAM,aAAa,GACtB,KAAK,CAAC,OAAO,CAAC,GACd,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC,GAChB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,SAAS,GACT,YAAY,GACZ,aAAa,CAAC,OAAO,CAAC,GACtB,OAAO,CAAC,OAAO,CAAC,GAChB,KAAK,GACL,SAAS,GACT,UAAU,GACV,cAAc,GACd,WAAW,GACX,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",