@carlsebastian/jsu 1.1.0 → 1.1.1

package/global.js

@@ -1,3 +1,4 @@
+import "./src/utils/arithmetic/arithmetic.js";
 import "./src/utils/custom/custom.js";
 import "./src/utils/custom/error/error.js";
 import "./src/utils/dom/dom.js";
@@ -5,4 +6,3 @@ import "./src/utils/guards/guards.js";
 import "./src/utils/primitives/primitives.js";
 import "./src/utils/storage/storage.js";
 import "./src/utils/variables.js";
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlsebastian/jsu",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A ready-to-use JavaScripts custom utilities such as types validations, formats validations, formatter, and many more!",
   "main": "./global.js",
   "types": "./src/types/global.d.ts",
@@ -13,6 +13,10 @@
       "require": "./global.js",
       "types": "./src/types/global.d.ts"
     },
+    "./arithmetics": {
+      "require": "./src/utils/arithmetic/arithmetic.js",
+      "types": "./src/types/arithmetic/arithmetic.d.ts"
+    },
     "./custom": {
       "require": "./src/utils/custom/custom.js",
       "types": "./src/types/custom/custom.d.ts"
@@ -49,7 +53,11 @@
     "url": "https://github.com/Sebastian-Carl/JSU/issues"
   },
   "homepage": "https://github.com/Sebastian-Carl/JSU#readme",
-  "keywords": [],
+  "keywords": [
+    "utils",
+    "js-utils",
+    "jsu"
+  ],
   "author": "",
   "license": "ISC"
 }

package/src/types/arithmetic/arithmetic.d.ts

@@ -0,0 +1,281 @@
+interface ArithmeticAPI {
+    /**
+     *  Accumulates the total divided value of the first and second numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to divide with primary value.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(num1: number, num2: number): number;
+
+    /**
+     *  Accumulates the total divided value of the first, second, and third numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to divide with primary value.
+     *  @param num3 - The third numerical value to divide with the given first 2 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(num1: number, num2: number, num3: number): number;
+
+    /**
+     *  Accumulates the total divided value of the first, second, third, and fourth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to divide with primary value.
+     *  @param num3 - The third numerical value to divide with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to divide with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total divided value of the first, second, third, and fourth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to divide with primary value.
+     *  @param num3 - The third numerical value to divide with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to divide with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total divided value of the first, second, third, fourth, and fifth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to divide with primary value.
+     *  @param num3 - The third numerical value to divide with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to divide with the given first 3 numerical values.
+     *  @param num5 - The fifth numerical value to divide with the other given 4 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(num1: number, num2: number, num3: number, num4: number, num5: number): number;
+
+    /**
+     *  Accumulates the total divided value of the given collection of numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to divide other given numerical values would always resulted to `NaN`.
+     *
+     *  @param nums - The collection of numerical values to divide.
+     *  @returns The total accumulated result of this operation.
+     */
+    Divide(...nums: number[]): number;
+
+    /**
+     *  Accumulates the total multiplied value of the first and second numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to multiply with primary value.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(num1: number, num2: number): number;
+
+    /**
+     *  Accumulates the total multiplied value of the first, second, and third numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to multiply with primary value.
+     *  @param num3 - The third numerical value to multiply with the given first 2 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(num1: number, num2: number, num3: number): number;
+
+    /**
+     *  Accumulates the total multiplied value of the first, second, third, and fourth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to multiply with primary value.
+     *  @param num3 - The third numerical value to multiply with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to multiply with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total multiplied value of the first, second, third, and fourth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to multiply with primary value.
+     *  @param num3 - The third numerical value to multiply with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to multiply with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total multiplied value of the first, second, third, fourth, and fifth numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to multiply with primary value.
+     *  @param num3 - The third numerical value to multiply with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to multiply with the given first 3 numerical values.
+     *  @param num5 - The fifth numerical value to multiply with the other given 4 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(num1: number, num2: number, num3: number, num4: number, num5: number): number;
+
+    /**
+     *  Accumulates the total multiplied value of the given collection of numerical values.
+     *
+     *  ***Note***:
+     *   - Using a zero (`0`) to multiply other given numerical values would always resulted to (`0`).
+     *
+     *  @param nums - The collection of numerical values to multiply.
+     *  @returns The total accumulated result of this operation.
+     */
+    Multiply(...nums: number[]): number;
+
+    /**
+     *  Accumulates the total subtracted value of the first and second numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to subtract with primary value.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(num1: number, num2: number): number;
+
+    /**
+     *  Accumulates the total subtracted value of the first, second, and third numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to subtract with primary value.
+     *  @param num3 - The third numerical value to subtract with the given first 2 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(num1: number, num2: number, num3: number): number;
+
+    /**
+     *  Accumulates the total subtracted value of the first, second, third, and fourth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to subtract with primary value.
+     *  @param num3 - The third numerical value to subtract with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to subtract with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total subtracted value of the first, second, third, and fourth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to subtract with primary value.
+     *  @param num3 - The third numerical value to subtract with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to subtract with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total subtracted value of the first, second, third, fourth, and fifth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to subtract with primary value.
+     *  @param num3 - The third numerical value to subtract with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to subtract with the given first 3 numerical values.
+     *  @param num5 - The fifth numerical value to subtract with the other given 4 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(num1: number, num2: number, num3: number, num4: number, num5: number): number;
+
+    /**
+     *  Accumulates the total subtracted value of the given collection of numerical values.
+     *
+     *  @param nums - The collection of numerical values to subtract.
+     *  @returns The total accumulated result of this operation.
+     */
+    Subtract(...nums: number[]): number;
+
+    /**
+     *  Accumulates the total summed value of the first and second numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to sum with primary value.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(num1: number, num2: number): number;
+
+    /**
+     *  Accumulates the total summed value of the first, second, and third numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to sum with primary value.
+     *  @param num3 - The third numerical value to sum with the given first 2 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(num1: number, num2: number, num3: number): number;
+
+    /**
+     *  Accumulates the total summed value of the first, second, third, and fourth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to sum with primary value.
+     *  @param num3 - The third numerical value to sum with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to sum with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total summed value of the first, second, third, and fourth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to sum with primary value.
+     *  @param num3 - The third numerical value to sum with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to sum with the given first 3 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(num1: number, num2: number, num3: number, num4: number): number;
+
+    /**
+     *  Accumulates the total summed value of the first, second, third, fourth, and fifth numerical values.
+     *
+     *  @param num1 - The first or primary base numerical value of this operation.
+     *  @param num2 - The second numerical value to sum with primary value.
+     *  @param num3 - The third numerical value to sum with the given first 2 numerical values.
+     *  @param num4 - The fourth numerical value to sum with the given first 3 numerical values.
+     *  @param num5 - The fifth numerical value to sum with the other given 4 numerical values.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(num1: number, num2: number, num3: number, num4: number, num5: number): number;
+
+    /**
+     *  Accumulates the total summed value of the given collection of numerical values.
+     *
+     *  @param nums - The collection of numerical values to sum.
+     *  @returns The total accumulated result of this operation.
+     */
+    Sum(...nums: number[]): number;
+}

package/src/types/custom/utils/custom.utils.d.ts

@@ -27,6 +27,31 @@ type CustomUtilitiesAPI = {
      */
     ConstructorOrTypeOf(arg: any): string | undefined;
 
+    /**
+     *  Defines the given key-pair data to the target object.
+     *
+     *  ***Options***:
+     *   - `def` - Allows the defined key-pair data to be **writable**, **configurable**, and **enumerable**. (Default)
+     *   - `hard` - Prevents the defined key-pair data to be **writable**, **configurable**, and **enumerable**.
+     *   - `med` - Prevents the defined key-pair data to be **writable** and **configurable** but, can be **enumerable**.
+     *   - `soft` - Prevents the defined key-pair data to be **writable** but, can be **configurable** and **enumerable**.
+     *
+     *  @param obj - The target object to define the key-pair data at.
+     *  @param key - The key of key-pair data.
+     *  @param data - The data of key-pair data.
+     *  @param opt - A options of what would be the state configuration of the defined key-pair data.
+     */
+    DefineProperty<K, D>(obj: { [prop: string]: any }, key: K, data: D, opt?: 'def' | 'hard' | 'med' | 'soft'): { [prop: string]: any } & { [prop in K]: D; };
+
+    /**
+     *  Defines the given key-pair data to the `globalThis` or `window` API.
+     *
+     *  @param key - The key of key-pair data.
+     *  @param data - The data of key-pair data.
+     *  @param opt - A options of what would be the state configuration of the defined key-pair data.
+     */
+    Global(key: string, data: any, opt?: 'def' | 'hard' | 'med' | 'soft'): void;
+
     /**
      *  Retrieves the `name` property of the specified object.
      *
@@ -39,4 +64,62 @@ type CustomUtilitiesAPI = {
      *  @returns The `name` property value of the object.
      */
     NameOf(obj: {}): string;
+
+    /**
+     *  Validates and normalize the given numerical value to valid numerical value.
+     *
+     *  @param num1 - The numerical value to normalize.
+     *  @returns The normalized numerical value.
+     */
+    NormalizeNumbers(num1: number): number;
+
+    /**
+     *  Validates and normalize the given collection of numerical values to a valid numerical values.
+     *
+     *  @param num1 - The first numerical value to normalize.
+     *  @param num2 - The second numerical value to normalize.
+     *  @returns The normalized collection of numerical values.
+     */
+    NormalizeNumbers(num1: number, num2: number): number[];
+
+    /**
+     *  Validates and normalize the given collection of numerical values to a valid numerical values.
+     *
+     *  @param num1 - The first numerical value to normalize.
+     *  @param num2 - The second numerical value to normalize.
+     *  @param num3 - The third numerical value to normalize.
+     *  @returns The normalized collection of numerical values.
+     */
+    NormalizeNumbers(num1: number, num2: number, num3: number): number[];
+
+    /**
+     *  Validates and normalize the given collection of numerical values to a valid numerical values.
+     *
+     *  @param num1 - The first numerical value to normalize.
+     *  @param num2 - The second numerical value to normalize.
+     *  @param num3 - The third numerical value to normalize.
+     *  @param num4 - The fourth numerical value to normalize.
+     *  @returns The normalized collection of numerical values.
+     */
+    NormalizeNumbers(num1: number, num2: number, num3: number, num4: number): number[];
+
+    /**
+     *  Validates and normalize the given collection of numerical values to a valid numerical values.
+     *
+     *  @param num1 - The first numerical value to normalize.
+     *  @param num2 - The second numerical value to normalize.
+     *  @param num3 - The third numerical value to normalize.
+     *  @param num4 - The fourth numerical value to normalize.
+     *  @param num5 - The fifth numerical value to normalize.
+     *  @returns The normalized collection of numerical values.
+     */
+    NormalizeNumbers(num1: number, num2: number, num3: number, num4: number, num5: number): number[];
+
+    /**
+     *  Validates and normalize the given collection of numerical values to a valid numerical values.
+     *
+     *  @param nums - The collection of numerical values to normalize.
+     *  @returns The normalized collection of numerical values.
+     */
+    NormalizeNumbers(...nums: number[]): number[];
 }

package/src/types/global.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="./api/api.d.ts" />
 /// <reference types="./api/element.d.ts" />
+/// <reference types="./arithmetic/arithmetic.d.ts" />
 /// <reference types="./dom/dom.d.ts" />
 /// <reference types="./custom/custom.d.ts" />
 /// <reference types="./custom/error/error.d.ts" />
@@ -8,6 +9,7 @@
 /// <reference types="./storage/storage.d.ts" />
 
 declare global {
+    readonly var Arithmetic: ArithmeticAPI;
     readonly var Custom: CustomAPI;
     readonly var DOM: DomAPI;
     readonly var ERROR: ErrorAPI;

package/src/utils/arithmetic/arithmetic.js

@@ -0,0 +1,20 @@
+import { DefineProperty, Global } from '../custom/utils/custom.utils.js';
+import { IsNullOrUndefined } from '../guards/data-types/data-types.js';
+import { HasProperty, IsStrEmpty } from '../guards/formats/formats.js';
+import Divide from './operations/operation.divide.js';
+import Multiply from './operations/operation.multiply.js';
+import Subtract from './operations/operation.subtract.js';
+import Sum from './operations/operation.sum.js';
+
+function Arithmetics() {
+    const ArithmeticAPI = {};
+
+    for (const Method of [Divide, Multiply, Subtract, Sum]) {
+        const Key = Method.name;
+        if (!IsNullOrUndefined(Key) && !IsStrEmpty(Key) && !HasProperty(ArithmeticAPI, Key))
+            DefineProperty(ArithmeticAPI, Key, Method, "med");
+    }
+
+    Global("Arithmetic", ArithmeticAPI, "soft");
+}
+Arithmetics();

package/src/utils/{Arithmetic → arithmetic}/operations/operation.divide.js

@@ -1,6 +1,6 @@
 import Raise from '../../custom/error/builder/error.builder.js';
+import { NormalizeNumbers } from '../../custom/utils/custom.utils.js';
 import { IsNum } from '../../guards/data-types/data-types.js';
-import { MapOf } from '../../primitives/obj/obj.iterator.js';
 
 /**
  *  Accumulates the total divided value of the given numerical values.
@@ -53,27 +53,26 @@ export default function Divide(...nums) {
     if (ICtr < 2)
         Raise._MissingParameterError(Method, P[ICtr], undefined);
 
+    const NUMS = NormalizeNumbers(...nums);
     if (ICtr === 2) {
-        const [A, B] = MapOf(nums, (num, pos) =>
-            !IsNum(parseInt(num, 10)) ? Raise._ArgumentError(Method, P[pos], num, "Number")
-            : parseInt(num, 10)
-        );
+        const [A, B] = NUMS;
 
-        return A === 0 ? NaN : A / B;
+        return A === 0 || B === 0 ? NaN : A / B;
     }
 
-    const Base = parseInt(nums[0], 10);
-    if (!IsNum(Base))
-        Raise._ArgumentError(Method, P[0], nums[0], "Number");
-
-    if (Base === 0)
+    const BASE = NUMS[0];
+    if (BASE === 0)
         return NaN;
 
-    return nums.slice(1).reduce((acc, num, pos) => {
-        const pN = parseInt(num, 10);
-        if (!IsNum(pN))
-            Raise._ArgumentError(Method, ICtr > 5 ? "nums" : P[pos + 1], num, "Number");
+    let Accumulated = BASE;
+    for (const NUM of NUMS.slice(1)) {
+        if (NUM === 0) {
+            Accumulated = NaN;
+            break;
+        }
+
+        return Accumulated += NUM;
+    }
 
-        return acc /= pN;
-    }, Base);
+    return Accumulated;
 }

package/src/utils/{Arithmetic → arithmetic}/operations/operation.multiply.js

@@ -1,6 +1,6 @@
 import Raise from '../../custom/error/builder/error.builder.js';
+import { NormalizeNumbers } from '../../custom/utils/custom.utils.js';
 import { IsNum } from '../../guards/data-types/data-types.js';
-import { MapOf } from '../../primitives/obj/obj.iterator.js';
 
 /**
  *  Accumulates the total multiplied value of the given numerical values.
@@ -53,27 +53,23 @@ export default function Multiply(...nums) {
     if (ICtr < 2)
         Raise._MissingParameterError(Method, P[ICtr], undefined);
 
+    const NUMS = NormalizeNumbers(...nums);
     if (ICtr === 2) {
-        const [A, B] = MapOf(nums, (num, pos) =>
-            !IsNum(parseInt(num, 10)) ? Raise._ArgumentError(Method, P[pos], num, "Number")
-            : parseInt(num, 10)
-        );
+        const [A, B] = NUMS;
 
-        return A === 0 ? A : A + B;
+        return A === 0 || B === 0 ? 0 : A * B;
     }
 
-    const Base = parseInt(nums[0], 10);
-    if (!IsNum(Base))
-        Raise._ArgumentError(Method, P[0], nums[0], "Number");
+    const BASE = NUMS[0];
+    let Accumulated = BASE;
+    for (const NUM of NUMS.slice(1)) {
+        if (NUM === 0) {
+            Accumulated = 0;
+            break;
+        }
 
-    if (Base === 0)
-        return 0;
-
-    return nums.slice(1).reduce((acc, num, pos) => {
-        const pN = parseInt(num, 10);
-        if (!IsNum(pN))
-            Raise._ArgumentError(Method, ICtr > 5 ? "nums" : P[pos + 1], num, "Number");
+        Accumulated *= NUM;
+    }
 
-        return acc += pN;
-    }, Base);
+    return Accumulated;
 }

package/src/utils/{Arithmetic → arithmetic}/operations/operation.subtract.js

@@ -1,6 +1,6 @@
 import Raise from '../../custom/error/builder/error.builder.js';
+import { NormalizeNumbers } from '../../custom/utils/custom.utils.js';
 import { IsNum } from '../../guards/data-types/data-types.js';
-import { MapOf } from '../../primitives/obj/obj.iterator.js';
 
 /**
  *  Accumulates the total subtracted value of the given numerical values.
@@ -53,24 +53,12 @@ export default function Subtract(...nums) {
     if (ICtr < 2)
         Raise._MissingParameterError(Method, P[ICtr], undefined);
 
+    const NUMS = NormalizeNumbers(...nums);
     if (ICtr === 2) {
-        const [A, B] = MapOf(nums, (num, pos) =>
-            !IsNum(parseInt(num, 10)) ? Raise._ArgumentError(Method, P[pos], num, "Number")
-            : parseInt(num, 10)
-        );
+        const [A, B] = NUMS;
 
-        return A + B;
+        return A - B;
     }
 
-    const Base = parseInt(nums[0], 10);
-    if (!IsNum(Base))
-        Raise._ArgumentError(Method, P[0], nums[0], "Number");
-
-    return nums.slice(1).reduce((acc, num, pos) => {
-        const pN = parseInt(num, 10);
-        if (!IsNum(pN))
-            Raise._ArgumentError(Method, ICtr > 5 ? "nums" : P[pos + 1], num, "Number");
-
-        return acc += pN;
-    }, Base);
+    return NUMS.reduce((acc, num) => acc -= num, 0);
 }

package/src/utils/{Arithmetic → arithmetic}/operations/operation.sum.js

@@ -1,4 +1,5 @@
 import Raise from '../../custom/error/builder/error.builder.js';
+import { NormalizeNumbers } from '../../custom/utils/custom.utils.js';
 import { IsNum } from '../../guards/data-types/data-types.js';
 import { MapOf } from '../../primitives/obj/obj.iterator.js';
 
@@ -53,24 +54,12 @@ export default function Sum(...nums) {
     if (ICtr < 2)
         Raise._MissingParameterError(Method, ICtr === 0 ? "num1" : "num2", undefined);
 
+    const NUMS = NormalizeNumbers(...nums);
     if (ICtr === 2) {
-        let [n1, n2] = MapOf(nums, (num, pos) =>
-            !IsNum(parseInt(num)) ? Raise._ArgumentError(Method, P[pos], num, "Number")
-            : parseInt(num, 10)
-        );
+        const [A, B] = NUMS;
 
-        return n1 + n2;
+        return A + B;
     }
 
-    const Base = parseInt(nums[0], 10);
-    if (!IsNum(Base))
-        Raise._ArgumentError(Method, P[0], nums[0], "Number");
-
-    return nums.slice(1).reduce((acc, num, pos) => {
-        const pN = parseInt(num, 10);
-        if (!IsNum(pN))
-            Raise._ArgumentError(Method, ICtr > 5 ? "nums" : P[pos + 1], num, "Number");
-
-        return acc += pN;
-    }, Base);
+    return NUMS.reduce((acc, num) => acc += num, 0);
 }

package/src/utils/custom/utils/custom.utils.js

@@ -1,4 +1,4 @@
-import { IsNullOrUndefined, IsNum, IsPlainObj, IsStr } from '../../guards/data-types/data-types.js';
+import { IsNullOrUndefined, IsNum, IsPlainObj, IsStr, IsArr } from '../../guards/data-types/data-types.js';
 import { IsStrEmpty } from '../../guards/formats/formats.js';
 import { EachOf, MapOf, SomeOf } from '../../primitives/obj/obj.iterator.js';
 import Raise from '../error/builder/error.builder.js';
@@ -148,3 +148,67 @@ export function Global(key, data, opt = "def") {
 
     DefineProperty(globalThis, key, data, opt);
 }
+
+/**
+ *  Validates the given collection of numerical values whether if its a valid numerical value, and returns
+ *  the parsed numeric collection of it.
+ *
+ *  ***Note***:
+ *   - This automatically parse a argument data if its a numerical value in string format.
+ *
+ *  @overload
+ *  @param { number } num1 - The first numerical value to validate and normalize.
+ *  @returns { number } The validate and parsed numerical value.
+ *
+ *  @overload
+ *  @param { number } num1 - The first numerical value to validate and normalize.
+ *  @param { number } num2 - The second numerical value to validate and normalize.
+ *  @returns { number[] } The validated and parsed collection of numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first numerical value to validate and normalize.
+ *  @param { number } num2 - The second numerical value to validate and normalize.
+ *  @param { number } num3 - The third numerical value to validate and normalize.
+ *  @returns { number[] } The validated and parsed collection of numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first numerical value to validate and normalize.
+ *  @param { number } num2 - The second numerical value to validate and normalize.
+ *  @param { number } num3 - The third numerical value to validate and normalize.
+ *  @param { number } num4 - The fourth numerical value to validate and normalize.
+ *  @returns { number[] } The validated and parsed collection of numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first numerical value to validate and normalize.
+ *  @param { number } num2 - The second numerical value to validate and normalize.
+ *  @param { number } num3 - The third numerical value to validate and normalize.
+ *  @param { number } num4 - The fourth numerical value to validate and normalize.
+ *  @param { number } num5 - The fifth numerical value to validate and normalize.
+ *  @returns { number[] } The validated and parsed collection of numerical values.
+ *
+ *  @overload
+ *  @param { ...number } nums - The given collection of numerical values to validate.
+ *  @returns { number[] } The validated and parsed collection of numerical values.
+ */
+export function NormalizeNumbers(...nums) {
+    const Method = "NormalizeNumbers", ICtr = nums.length, P = ["num1", "num2", "num3", "num4", "num5"];
+
+    if (ICtr === 0)
+        Raise._MissingParameterError(Method, P[ICtr], undefined);
+
+    return nums.reduce((acc, num, pos) => {
+        const pN = parseInt(num, 10);
+        if (!IsNum(pN))
+            Raise._ArgumentError(Method, ICtr > 5 ? "nums" : P[pos], num, "Number");
+
+        if (ICtr > 1) {
+            if (!IsArr(acc))
+                acc = [];
+
+            acc.push(pN);
+        } else
+            acc = pN;
+
+        return acc;
+    });
+}