@carlsebastian/jsu 1.0.50 → 1.1.0

package/src/docs/custom/error/constructor/opts/notSupportedError.md

@@ -0,0 +1,81 @@
+# JSU - ERROR API - Constructors.NotSupportedError()
+
+## Table Of Contents
+
+- [JSU - ERROR API - Constructors.NotSupportedError()](#jsu---error-api---constructorsnotsupportederror)
+  - [Table Of Contents](#table-of-contents)
+  - [What it does?](#what-it-does)
+  - [Parameter](#parameter)
+  - [Properties](#properties)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What it does?
+
+- It raises a report on your project's runtime when a certain functions, methods, or API are was accessed but not supported.
+
+## Parameter
+
+- `meta` - The meta data object of this error.
+  - `meta.Message` - The message of this error. ( **_Required_** )
+  - `meta.Context` - The meta context object of this error.
+    - `meta.Context.Message` - A context message that points the root cause of error.
+    - `meta.Context.Emitter` - The source id of an object that is responsible of raising this error.
+  - `meta.Args` - A meta argument object of this error to check the reported arguments.
+    - `meta.Args.Id` - The object id that is being access but not supported.
+  - `Guide` - A guide for fixing this error.
+
+## Properties
+
+- `Message` - The message of this error.
+- `Context` - The context object of this error.
+- `Args` - The arguments object of this error.
+- `Guide` - A provided guide for fixing this error.
+- `TimeStamp` - A record of date & time of when this error has occurred.
+
+## Example Usage
+
+```js
+const IsLocalStorageAPISupported = (function () {
+    try {
+        const Key = "__TEST_KEY__";
+        localStorage.setItem(Key, "__TEST__");
+        localStorage.removeItem(Key);
+
+        return true;
+    } catch (e) {
+        return false;
+    }
+})()
+
+// #: Will throw when your or user's environment does not support LocalStorageAPI.
+if (!IsLocalStorageAPISupported)
+    throw new ERROR.Constructors.NotSupportedError({
+        Message: "LocalStorageAPI is not supported!",
+        Context: {
+            Message: "LocalStorageAPI is not currently supported on user's current browser environment!",
+            Emitter: "foo"
+        },
+        Args: {
+            Id: "LocalStorage"
+        },
+        Guide: "Try to update your current browser environment to its latest update or switch to another browser such as 'Chrome', 'FireFox' or 'Brave'."
+    });
+```
+
+## Navigate To
+
+- [Error](../../error.md) - *An API that provides a collection of customized and/or enhanced error classes.*
+  - [Constructors](../error.constructor.md) - *A collection of customized error class constructors.*
+    - [ArgumentError()](./argumentError.md) - *A custom version of Javascript's **TypeError** for invalid arguments types.*
+    - [IndexOutOfBoundsError()](./indexOutOfBounds.md) - *A custom version of Javascript's **RangeError** for index that exceeded the maximum index-bound of an object.*
+    - [InvalidPropertyError()](./invalidPropertyError.md) - *A custom error class for objects with invalid property.*
+    - [MissingParameterError()](./missingParameterError.md) - *A custom error class for parameters that does not provided a data.*
+    - [MissingPropertyError()](./missingPropertyError.md) - *A custom error class for incomplete or missing key-pair data of an object.*
+    - [NoSuchElementTagError()](./noSuchElementTagError.md) - *A custom error class for unknown or not qualified **HTMLElement**, **MathMLElement**, **SVGElement** tags.*
+    - [UnknownPropertyError()](./unknownPropertyError.md) - *A custom error class for unknown property that is trying to be access from an object.*
+  - [Raise](../../builder/builder.md) - *A collection of pre-defined contents builder and raiser of errors.*
+
+- [JSU - README](../../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../../api/api.md) - *A complete collection list of available APIs of ***JSU***.*
+    - [Custom](../../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*

package/src/docs/custom/error/constructor/opts/unknownPropertyError.md

@@ -0,0 +1,82 @@
+# JSU - ERROR API - Constructors.UnknownPropertyError()
+
+## Table Of Contents
+
+- [JSU - ERROR API - Constructors.UnknownPropertyError()](#jsu---error-api---constructorsunknownpropertyerror)
+  - [Table Of Contents](#table-of-contents)
+  - [What it does?](#what-it-does)
+  - [Parameter](#parameter)
+  - [Properties](#properties)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What it does?
+
+- It raises a report on your project's runtime about a property that is not existing on a certain object.
+
+## Parameter
+
+- `meta` - The meta data object of this error.
+  - `meta.Message` - The message of this error. ( **_Required_** )
+  - `meta.Context` - The meta context object of this error.
+    - `meta.Context.Message` - A context message that points the root cause of error.
+    - `meta.Context.Emitter` - The source id of an object that is responsible of raising this error.
+  - `meta.Args` - A meta argument object of this error to check the reported arguments.
+    - `meta.Args.Id` - The reported argument id that cause this error.
+    - `meta.Args.PropertyId` - The unknown property that is trying to be accessed.
+  - `Guide` - A guide for fixing this error.
+
+## Properties
+
+- `Message` - The message of this error.
+- `Context` - The context object of this error.
+- `Args` - The arguments object of this error.
+- `Guide` - A provided guide for fixing this error.
+- `TimeStamp` - A record of date & time of when this error has occurred.
+
+## Example Usage
+
+```js
+function GetPropertyOf(obj, prop) {
+    if (typeof obj !== "object" || Array.isArray(obj) || obj instanceof Map || obj instanceof Set)
+        throw new ERROR.Constructors.ArgumentError({...});
+
+    if (typeof prop !== "string")
+        throw new ERROR.Constructors.ArgumentError({...});
+
+    if (!Object.hasOwn(obj, prop))
+        throw new ERROR.Constructors.UnknownPropertyError({
+            Message: `Unknown property '${prop}' of 'obj'!`,
+            Context: {
+                Message: `GetPropertyOf(@obj.${prop}: UNKNOWN_PROPERTY)`,
+                Emitter: "GetPropertyOf"
+            },
+            Args: {
+                Id: "obj",
+                PropertyId: prop
+            },
+            Guide: "Ensure to provide only a existing property id of obj!"
+        });
+
+    return obj[prop];
+}
+
+GetPropertyOf({ pi: 3.14, n: 0 }, "p"); // Uncaught UnknownPropertyError: ...
+```
+
+## Navigate To
+
+- [Error](../../error.md) - *An API that provides a collection of customized and/or enhanced error classes.*
+  - [Constructors](../error.constructor.md) - *A collection of customized error class constructors.*
+    - [ArgumentError()](./argumentError.md) - *A custom version of Javascript's **TypeError** for invalid arguments types.*
+    - [IndexOutOfBoundsError()](./indexOutOfBounds.md) - *A custom version of Javascript's **RangeError** for index that exceeded the maximum index-bound of an object.*
+    - [InvalidPropertyError()](./invalidPropertyError.md) - *A custom error class for objects with invalid property.*
+    - [MissingParameterError()](./missingParameterError.md) - *A custom error class for parameters that does not provided a data.*
+    - [MissingPropertyError()](./missingPropertyError.md) - *A custom error class for incomplete or missing key-pair data of an object.*
+    - [NoSuchElementTagError()](./noSuchElementTagError.md) - *A custom error class for unknown or not qualified **HTMLElement**, **MathMLElement**, **SVGElement** tags.*
+    - [NotSupportedError()](./notSupportedError.md) - *A custom error class for not supported **objects**, **methods**, and/or **functions**.*
+  - [Raise](../../builder/builder.md) - *A collection of pre-defined contents builder and raiser of errors.*
+
+- [JSU - README](../../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../../api/api.md) - *A complete collection list of available APIs of ***JSU***.*
+    - [Custom](../../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*

package/src/docs/custom/error/error.md

@@ -0,0 +1,36 @@
+# JSU - ERROR API
+
+## Table Of Contents
+
+- [JSU - ERROR API](#jsu---error-api)
+  - [Table Of Contents](#table-of-contents)
+  - [Usage](#usage)
+  - [API Object](#api-object)
+  - [Properties](#properties)
+  - [Navigate To](#navigate-to)
+
+## Usage
+
+```js
+// Loads all available JSU APIs from your project's runtime.
+import "@carlsebastian/jsu";
+
+// Only loads ERROR API of JSU from your project's runtime.
+import "@carlsebastian/jsu/error";
+```
+
+## API Object
+
+- `ERROR` | `globalThis.ERROR` | `window.ERROR` | `JSU.ERROR`
+
+## Properties
+
+- [Constructors](./constructor/error.constructor.md) - *A collection of customized error class constructors.*
+- [Raise](./builder/builder.md) - *A collection of pre-defined contents builder and raiser of errors.*
+
+## Navigate To
+
+- [APIs](../../api/api.md) - *A complete collection list of available APIs of **JSU**.*
+  - [Custom](../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+
+- [JSU - README](../../../../README.MD) - *JSU Homepage Documentation.*

package/src/docs/custom/utils/clamp.md

@@ -35,9 +35,11 @@ console.log(chars[Custom.Clamp(charPos, 0, chars.length - 1)]); // It would alwa
 
 ## Navigate To
 
-- [Custom](../custom.md) - **_An API that contains only customized and/or enhanced version of utilities, methods, and more._**
-  - [ConstructorOrTypeOf()](./constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [Generator()](./generator/generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-  - [NameOf()](./nameOf.md) - Retrieves the `name` property of the given object.
-
-- [JSU - README](../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [ConstructorOrTypeOf()](./constructorOrTypeOf.md) - *Retrieves the **constructor** or **type** of the given argument.*
+  - [Generator()](./generator/generator.md) - *A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.*
+  - [NameOf()](./nameOf.md) - *Retrieves the **name** property of the given object.*
+
+- [JSU - README](../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/constructorOrTypeOf.md

@@ -29,9 +29,11 @@ console.log(CTs); // #: [Object, Array, String, Number, Map, Set]
 
 ## Navigate To
 
-- [Custom](../custom.md) - **_An API that contains only customized and/or enhanced version of utilities, methods, and more._**
-  - [Clamp()](./clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [Generator()](./generator/generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-  - [NameOf()](./nameOf.md) - Retrieves the `name` property of the given object.
-
-- [JSU - README](../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](./clamp.md) - Mutates the given numerical value within the given **minimum** and **maximum** range.
+  - [Generator()](./generator/generator.md) - A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.
+  - [NameOf()](./nameOf.md) - Retrieves the **name** property of the given object.
+
+- [JSU - README](../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/generator/generator.md

@@ -49,9 +49,11 @@ const RInt = Generate.RandomInteger();
 
 ## Navigate To
 
-- [Custom](../../custom.md) - ***An API that contains only customized and/or enhanced version of utilities, methods, and more.***
-  - [Clamp()](../clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [ConstructorOrTypeOf()](../constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [NameOf()](../nameOf.md) - Retrieves the `name` property of the given object.
-
-- [JSU - README](../../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](../clamp.md) - *Mutates the given numerical value within the given **minimum** and **maximum** range.*
+  - [ConstructorOrTypeOf()](../constructorOrTypeOf.md) - *Retrieves the **constructor** or **type** of the given argument.*
+  - [NameOf()](../nameOf.md) - *Retrieves the **name** property of the given object.*
+
+- [JSU - README](../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/generator/methods/generator.newToken.md

@@ -22,11 +22,14 @@ const VToken = Generate.NewToken(); // Generated token with symbols, numbers, an
 
 ## Navigate To
 
-- [Custom](../../../custom.md) - ***An API that contains only customized and/or enhanced version of utilities, methods, and more.***
-  - [Clamp()](../../clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [Generator()](../generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-    - [RandomCharacters()](./generator.randomCharacters.md) - Generates a sequence of randomized characters of `A-Z` and/or `a-z`.
-    - [RandomInteger()](./generator.randomInteger.md) - Generates a randomized integer value from the given `minimum` and `maximum` range.
-
-- [JSU - README](../../../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](../../clamp.md) - *Mutates the given numerical value within the given **minimum** and **maximum** range.*
+  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - *Retrieves the **constructor** or **type** of the given argument.*
+  - [NameOf()](../../nameOf.md) - *Retrieves the **name** property of the given object.*
+  - [Generator()](../generator.md) - *A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.*
+    - [RandomCharacters()](./generator.randomCharacters.md) - *Generates a sequence of randomized characters of **A-Z** and/or **a-z**.*
+    - [RandomInteger()](./generator.randomInteger.md) - *Generates a randomized integer value from the given **minimum** and **maximum** range.*
+
+- [JSU - README](../../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../../../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/generator/methods/generator.randomCharacters.md

@@ -22,11 +22,14 @@ const VChars = Generate.RandomCharacters(); // Generates random sequence of char
 
 ## Navigate To
 
-- [Custom](../../../custom.md) - ***An API that contains only customized and/or enhanced version of utilities, methods, and more.***
-  - [Clamp()](../../clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [Generator()](../generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-    - [NewToken()](./generator.newToken.md) - Generates a randomized sequence of characters of `A-Z`, `a-z`, `0-9` and `symbols`.
-    - [RandomInteger()](./generator.randomInteger.md) - Generates a randomized integer value from the given `minimum` and `maximum` range.
-
-- [JSU - README](../../../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](../../clamp.md) - *Mutates the given numerical value within the given **minimum** and **maximum** range.*
+  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - *Retrieves the **constructor** or **type** of the given argument.*
+  - [NameOf()](../../nameOf.md) - *Retrieves the **name** property of the given object.*
+  - [Generator()](../generator.md) - *A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.*
+    - [NewToken()](./generator.newToken.md) - *Generates a randomized sequence of characters of **A-Z**, **a-z**, **0-9** and **symbols**.*
+    - [RandomInteger()](./generator.randomInteger.md) - *Generates a randomized integer value from the given **minimum** and **maximum** range.*
+
+- [JSU - README](../../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../../../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/generator/methods/generator.randomInteger.md

@@ -28,11 +28,14 @@ console.log(Generate.RandomInteger(0, 10)); // Logs the generated random integer
 
 ## Navigate To
 
-- [Custom](../../../custom.md) - ***An API that contains only customized and/or enhanced version of utilities, methods, and more.***
-  - [Clamp()](../../clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [Generator()](../generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-    - [NewToken()](./generator.newToken.md) - Generates a randomized sequence of characters of `A-Z`, `a-z`, `0-9` and `symbols`.
-    - [RandomCharacters()](./generator.randomCharacters.md) - Generates a sequence of randomized characters of `A-Z` and/or `a-z`.
-
-- [JSU - README](../../../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../../../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](../../clamp.md) - *Mutates the given numerical value within the given **minimum** and **maximum** range.*
+  - [ConstructorOrTypeOf()](../../constructorOrTypeOf.md) - *Retrieves the **constructor** or **type** of the given argument.*
+  - [NameOf()](../../nameOf.md) - *Retrieves the **name** property of the given object.*
+  - [Generator()](../generator.md) - *A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.*
+    - [NewToken()](./generator.newToken.md) - *Generates a randomized sequence of characters of **A-Z**, **a-z**, **0-9** and **symbols**.*
+    - [RandomCharacters()](./generator.randomCharacters.md) - *Generates a sequence of randomized characters of **A-Z** and/or **a-z**.*
+
+- [JSU - README](../../../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../../../api/api.md) - *A complete collection of available APIs of **JSU**.*
+    - [ERROR](../../../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/docs/custom/utils/nameOf.md

@@ -29,9 +29,11 @@ for (const O of Os) {
 
 ## Navigate To
 
-- [Custom](../custom.md) - **_An API that contains only customized and/or enhanced version of utilities, methods, and more._**
-  - [Clamp()](./clamp.md) - Mutates the given numerical value within the given `minimum` and `maximum` range.
-  - [ConstructorOrTypeOf()](./constructorOrTypeOf.md) - Retrieves the `constructor` or `type` of the given argument.
-  - [Generator()](./generator/generator.md) - A customized generator constructor for generating randomized `tokens`, `characters`, and `integer`.
-
-- [JSU - README](../../../../README.MD) - JSU's Homepage Documentation.
+- [Custom](../custom.md) - *An API that provides a collection of customized and/or enhanced utilities or objects.*
+  - [Clamp()](./clamp.md) - Mutates the given numerical value within the given **minimum** and **maximum** range.
+  - [ConstructorOrTypeOf()](./constructorOrTypeOf.md) - Retrieves the **constructor** or **`type`** of the given argument.
+  - [Generator()](./generator/generator.md) - A customized generator constructor for generating randomized **tokens**, **characters**, and **integer**.
+
+- [JSU - README](../../../../README.MD) - *JSU Homepage Documentation.*
+  - [APIs](../../api/api.md) - *A complete collection list of available APIs of **JSU**.*
+    - [ERROR](../error/error.md) - *An API that provides a collection of customized and/or enhanced error classes.*

package/src/types/api/api.d.ts

@@ -112,7 +112,7 @@ interface DomAPI {
 
 interface ErrorAPI {
     Constructors: ErrorConstructorAPI;
-    Emit: ErrorEmitterAPI;
+    Raise: ErrorRaiseAPI;
 }
 
 type GuardsAPI = GuardsDataTypesAPI & GuardsFormatAPI;
@@ -136,12 +136,30 @@ interface StorageAPI {
     SESSION: SessionStorageAPI;
 }
 
-interface EnhancedGlobalUtilsAPI {
-    readonly Custom: CustomAPI;
-    readonly DOM: DomAPI;
-    readonly ERROR: ErrorAPI;
-    readonly Guards: GuardsAPI;
-    readonly Primitives: PrimitivesAPI;
-    readonly STORAGE: StorageAPI;
-    readonly GetElementBy: DOMGetElementByAPI;
+interface VariablesAPI {
+    /**
+     *  A collection of `HTMLElement` tags name.
+     *
+     *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements
+     */
+    HTMLElementTags: Map<keyof HTMLElementTags, { Generate(): HTMLElement; }>;
+
+    /**
+     *  A collection of `SVGElement` tags name.
+     *
+     *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element
+     */
+    SVGElementTags: Map<keyof SVGElementTags, { Generate(): SVGElement; }>;
+
+    /**
+     *  A collection of `MathMLElement` tags name.
+     *
+     *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element
+     */
+    MathElementTags: Map<keyof MathElementTags, { Generate(): MathMLElement; }>;
+
+    /**
+     *  A collection of available XML namespace of elements.
+     */
+    XMLNameSpace: ["http://www.w3.org/1998/Math/MathML", "http://www.w3.org/1999/xhtml", "http://www.w3.org/2000/svg"];
 }

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

@@ -8,14 +8,14 @@
 /// <reference types="./storage/storage.d.ts" />
 
 declare global {
-    readonly var Utils: EnhancedGlobalUtilsAPI;
-    readonly var DOM: DomAPI;
     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/operations/operation.divide.js

@@ -0,0 +1,79 @@
+import Raise from '../../custom/error/builder/error.builder.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.
+ *
+ *  @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);
+
+    if (ICtr === 2) {
+        const [A, B] = MapOf(nums, (num, pos) =>
+            !IsNum(parseInt(num, 10)) ? Raise._ArgumentError(Method, P[pos], num, "Number")
+            : parseInt(num, 10)
+        );
+
+        return A === 0 ? NaN : A / B;
+    }
+
+    const Base = parseInt(nums[0], 10);
+    if (!IsNum(Base))
+        Raise._ArgumentError(Method, P[0], nums[0], "Number");
+
+    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");
+
+        return acc /= pN;
+    }, Base);
+}