@carlsebastian/jsu 1.0.50 → 1.1.1

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/error/builder/error.builder.d.ts

@@ -1,7 +1,7 @@
 /**
  *  A collection of customized error emitter contents for `ErrorConstructorAPI`.
  */
-type ErrorEmitterAPI = {
+type ErrorRaiseAPI = {
     /**
      *  Builds and emit the contents of `ArgumentError`.
      *

package/src/types/custom/error/constructor/error.custom.d.ts

@@ -2,33 +2,49 @@ type ErrorConstructorAPI = {
     /**
      *  A customized and enhanced `TypeError`.
      */
-    ArgumentError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").ArgumentError;
+    ArgumentError: {
+        new (meta: ArgumentErrorMeta): ArgumentErrorMeta;
+    };
     /**
      *  A customized and enhanced `RangeError`.
      */
-    IndexOutOfBoundsError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").IndexOutOfBoundsError;
+    IndexOutOfBoundsError: {
+        new (meta: IndexOutOfBoundsErrorMeta): IndexOutOfBoundsErrorMeta;
+    };
     /**
      *  A customized error for invalid properties.
      */
-    InvalidPropertyError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").InvalidPropertyError;
+    InvalidPropertyError: {
+        new (meta: InvalidPropertyErrorMeta): InvalidPropertyErrorMeta;
+    };
     /**
      *  A customized error for missing parameter value.
      */
-    MissingParameterError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").MissingParameterError;
+    MissingParameterError: {
+        new (meta: MissingParameterErrorMeta): MissingParameterErrorMeta;
+    };
     /**
      *  A customized error for missing property.
      */
-    MissingPropertyError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").MissingPropertyError;
+    MissingPropertyError: {
+        new (meta: MissingPropertyError): MissingPropertyError;
+    };
     /**
      *  A customized error for unqualified element's tag.
      */
-    NoSuchElementTagError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").NoSuchElementTagError;
+    NoSuchElementTagError: {
+        new (meta: NoSuchElementTagErrorMeta): NoSuchElementTagErrorMeta;
+    };
     /**
      *  A customized error for not supported objects, etc.
      */
-    NotSupportedError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").NotSupportedError;
+    NotSupportedError: {
+        new (meta: NotSupportedErrorMeta): NotSupportedErrorMeta;
+    };
     /**
      *  A customized error for unknown property.
      */
-    UnknownPropertyError: typeof import("../../../../utils/custom/error/constructor/error.custom.js").UnknownPropertyError;
+    UnknownPropertyError: {
+        new (meta: UnknownPropertyErrorMeta): UnknownPropertyErrorMeta;
+    };
 }

package/src/types/custom/error/constructor/error.meta.d.ts

@@ -10,9 +10,9 @@ type BaseMeta<OtherArguments extends {} = {}> = {
 
 type ArgumentErrorMeta = BaseMeta<{ ReceivedArgument: string, ExpectedArguments: string[] }>;
 type IndexOutOfBoundsErrorMeta = BaseMeta<{ Index: number, MaxBound: number }>;
-type InvalidPropertyError = BaseMeta<{ PropertyId: string }>;
-type MissingParameterError = BaseMeta<{ Value: string }>;
-type MissingPropertyError = BaseMeta<{ PropertyId: string }>;
-type NoSuchElementTagError = BaseMeta<{ Tag: string, TagOf: "HTMLElement" | "MathMLElement" | "SVGElement" }>;
-type NotSupportedError = BaseMeta;
-type UnknownPropertyError = BaseMeta<{ PropertyId: string }>;
+type InvalidPropertyErrorMeta = BaseMeta<{ PropertyId: string }>;
+type MissingParameterErrorMeta = BaseMeta<{ Value: string }>;
+type MissingPropertyErrorMeta = BaseMeta<{ PropertyId: string }>;
+type NoSuchElementTagErrorMeta = BaseMeta<{ Tag: string, TagOf: "HTMLElement" | "MathMLElement" | "SVGElement" }>;
+type NotSupportedErrorMeta = BaseMeta;
+type UnknownPropertyErrorMeta = BaseMeta<{ PropertyId: string }>;

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,14 +9,15 @@
 /// <reference types="./storage/storage.d.ts" />
 
 declare global {
-    readonly var Utils: EnhancedGlobalUtilsAPI;
-    readonly var DOM: DomAPI;
+    readonly var Arithmetic: ArithmeticAPI;
     readonly var Custom: CustomAPI;
+    readonly var DOM: DomAPI;
     readonly var ERROR: ErrorAPI;
+    readonly var GetElementBy: DOMGetElementByAPI;
     readonly var Guards: GuardsAPI;
     readonly var Primitives: PrimitivesAPI;
     readonly var STORAGE: StorageAPI;
-    readonly var GetElementBy: DOMGetElementByAPI;
+    readonly var Variables: VariablesAPI
 }
 
 export { };

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/operations/operation.divide.js

@@ -0,0 +1,78 @@
+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';
+
+/**
+ *  Accumulates the total divided value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to divide with the first numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total divided value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to divide with the first numerical value.
+ *  @param { number } num3 - The third numerical value to divide with the first and second numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total divided value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to divide with the first numerical value.
+ *  @param { number } num3 - The third numerical value to divide with the first and second numerical value.
+ *  @param { number } num4 - The fourth numerical value to divide with the first, second, and third numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total divided value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to divide with the first numerical value.
+ *  @param { number } num3 - The third numerical value to divide with the first and second numerical value.
+ *  @param { number } num4 - The fourth numerical value to divide with the first, second, and third numerical value.
+ *  @param { number } num5 - The fifth numerical value to divide with the first, second, third, and fourth numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total divided value of the given numerical values.
+ *
+ *  @overload
+ *  @param { ...number } nums - The collection of numerical values to divide.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+export default function Divide(...nums) {
+    const Method = "Divide", ICtr = nums.length, P = ["num1", "num2", "num3", "num4", "num5"];
+
+    if (ICtr < 2)
+        Raise._MissingParameterError(Method, P[ICtr], undefined);
+
+    const NUMS = NormalizeNumbers(...nums);
+    if (ICtr === 2) {
+        const [A, B] = NUMS;
+
+        return A === 0 || B === 0 ? NaN : A / B;
+    }
+
+    const BASE = NUMS[0];
+    if (BASE === 0)
+        return NaN;
+
+    let Accumulated = BASE;
+    for (const NUM of NUMS.slice(1)) {
+        if (NUM === 0) {
+            Accumulated = NaN;
+            break;
+        }
+
+        return Accumulated += NUM;
+    }
+
+    return Accumulated;
+}

package/src/utils/arithmetic/operations/operation.multiply.js

@@ -0,0 +1,75 @@
+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';
+
+/**
+ *  Accumulates the total multiplied value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to multiply with the first numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total multiplied value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to multiply with the first numerical value.
+ *  @param { number } num3 - The third numerical value to multiply with the first and second numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total multiplied value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to multiply with the first numerical value.
+ *  @param { number } num3 - The third numerical value to multiply with the first and second numerical value.
+ *  @param { number } num4 - The fourth numerical value to multiply with the first, second, and third numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total multiplied value of the given numerical values.
+ *
+ *  @overload
+ *  @param { number } num1 - The first and base numerical value of this operation.
+ *  @param { number } num2 - The second numerical value to multiply with the first numerical value.
+ *  @param { number } num3 - The third numerical value to multiply with the first and second numerical value.
+ *  @param { number } num4 - The fourth numerical value to multiply with the first, second, and third numerical value.
+ *  @param { number } num5 - The fifth numerical value to multiply with the first, second, third, and fourth numerical value.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+/**
+ *  Accumulates the total multiplied value of the given numerical values.
+ *
+ *  @overload
+ *  @param { ...number } nums - The collection of numerical values to multiply.
+ *  @returns { number } The total accumulated value of the given numerical values.
+ */
+export default function Multiply(...nums) {
+    const Method = "Multiply", ICtr = nums.length, P = ["num1", "num2", "num3", "num4", "num5"];
+
+    if (ICtr < 2)
+        Raise._MissingParameterError(Method, P[ICtr], undefined);
+
+    const NUMS = NormalizeNumbers(...nums);
+    if (ICtr === 2) {
+        const [A, B] = NUMS;
+
+        return A === 0 || B === 0 ? 0 : A * B;
+    }
+
+    const BASE = NUMS[0];
+    let Accumulated = BASE;
+    for (const NUM of NUMS.slice(1)) {
+        if (NUM === 0) {
+            Accumulated = 0;
+            break;
+        }
+
+        Accumulated *= NUM;
+    }
+
+    return Accumulated;
+}