@carlsebastian/jsu 1.0.40 → 1.1.0

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

@@ -0,0 +1,81 @@
+# JSU - ERROR API - Constructors.MissingPropertyError()
+
+## Table Of Contents
+
+- [JSU - ERROR API - Constructors.MissingPropertyError()](#jsu---error-api---constructorsmissingpropertyerror)
+  - [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 missing property of 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 missing property id of the argument.
+  - `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 User = {
+  Id: 0,
+  Name: "Carl Aaron ...",
+  Address: "...",
+  Age: 21,
+};
+const UserProps = ["Id", "Name", "Address", "Age", "Greet"];
+for (const prop of UserProps.keys) {
+  if (!Object.hasOwn(prop))
+    throw new ERROR.Constructors.MissingPropertyError({
+        Message: "A missing property is found at User object!",
+        Context: {
+            Message: `User?.${prop}: Missing property!`,
+            Emitter: "foo"
+        },
+        Args: {
+            Id: "User",
+            PropertyId: prop
+        },
+        Guide: `Ensure to provide property '${prop}' at User object!`
+    });
+}
+
+// #: Uncaught MissingPropertyError: ...
+```
+
+## 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.*
+    - [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**.*
+    - [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/noSuchElementTagError.md

@@ -0,0 +1,81 @@
+# JSU - ERROR API - Constructors.NoSuchElementTagError()
+
+## Table Of Contents
+
+- [JSU - ERROR API - Constructors.NoSuchElementTagError()](#jsu---error-api---constructorsnosuchelementtagerror)
+  - [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 provided unknown or not-qualified element's tag of `Element`.
+
+## 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.Tag` - The provided unknown or not-qualified tag of element.
+    - `meta.Args.TagOf` - The element type or instance that does not have the provided tag. (Options: **_HTMLElement_**, **_MathMLElement_**, **_SVGElement_**)
+  - `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 CreateElement(tag) {
+  if (tag === null || tag === undefined || typeof tag !== "string" || tag.trim().length === 0) return null;
+
+  // #: VariablesAPI.HTMLElementTags - Provided collection of HTMLElements tag.
+  if (!Variables.HTMLElementTags.has(tag))
+    throw new ERROR.Constructor.NoSuchElementTag({
+      Message: `A not-qualified HTMLElement tag is found at CreateElement()!`,
+      Context: {
+        Message: `CreateElement(@tag: ${tag}): Unknown HTMLElement Tag`,
+        Emitter: "CreateElement",
+      },
+      Args: {
+        Id: "tag",
+        Tag: tag,
+        TagOf: "HTMLElement",
+      },
+      Guide: "Ensure to provided a qualified HTMLElement tag!",
+    });
+
+  return document.createElement(tag);
+}
+
+CreateElement("dib"); // Uncaught NoSuchElementTagError: ...
+```
+
+## 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.*
+    - [NotSupportedError()](./notSupportedError.md) - *A custom error class for not supported **objects**, **methods**, and/or **functions**.*
+    - [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/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

@@ -0,0 +1,45 @@
+# JSU - Custom API - Clamp()
+
+## Table Of Contents
+
+- [JSU - Custom API - Clamp()](#jsu---custom-api---clamp)
+  - [Table Of Contents](#table-of-contents)
+  - [What It Does?](#what-it-does)
+  - [Parameters](#parameters)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What It Does?
+
+- `Custom.Clamp()` method ensures that the given numerical value would never fall or exceeds the given `minimum` and `maximum` range bounds. Once it does, it will automatically be clamped to those given bounds.
+
+## Parameters
+
+- `value` - The given current numeric value.
+- `min` - The minimum range bound of the given numeric value.
+- `max` - The maximum range bound of the given numeric value.
+
+## Example Usage
+
+```js
+// #: Ensures that the given index would never exceeds the length of an array.
+const chars = ["a", "b", "c", "d", "e"];
+const charPos = 10;
+
+// #: Without clamp
+console.log(chars[charPos]); // undefined - might cause an error or trouble on your project.
+
+// #: With clamp
+console.log(chars[Custom.Clamp(charPos, 0, chars.length - 1)]); // It would always resulted to 'e' it exceeds the maximum bound (4) or 'a' when falls the minimum bound.
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,39 @@
+# JSU - Custom API - ConstructorOrTypeOf()
+
+## Table Of Contents
+
+- [JSU - Custom API - ConstructorOrTypeOf()](#jsu---custom-api---constructorortypeof)
+  - [Table Of Contents](#table-of-contents)
+  - [What It Does?](#what-it-does)
+  - [Parameter](#parameter)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What It Does?
+
+- `Custom.ConstructorOrTypeOf()` checks and returns the `constructor` or `type` of the given argument, by default, it prioritize on checking and retrieving the `constructor` of the given argument and safely fallback on checking and retrieving the `type` of the given argument if `constructor` is not present.
+
+## Parameter
+
+- `arg` - The given argument to check and retrieve its `constructor` or `type`.
+
+## Example Usage
+
+```js
+const CTs = [{}, [], '', 0, new Map(), new Set].map(arg => {
+    return Custom.ConstructorOrTypeOf(arg);
+});
+
+console.log(CTs); // #: [Object, Array, String, Number, Map, Set]
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,59 @@
+# JSU - Custom API - Generator()
+
+## Table Of Contents
+
+- [JSU - Custom API - Generator()](#jsu---custom-api---generator)
+  - [Table Of Contents](#table-of-contents)
+  - [What It Does?](#what-it-does)
+  - [Parameters](#parameters)
+  - [Properties / Methods](#properties--methods)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What It Does?
+
+- Provides a pre-made random generator methods which can be use on however you use it such as game's token session, lobby token, and more!
+
+## Parameters
+
+- `size` - The size of generator's contents to generate.
+- `conf` - A configuration for customizing the contents of generators and secureness of this generator's contents.
+  - `conf.lowercase` - Accepts a `boolean` state, and determines whether to include or exclude lowercase characters from generator's contents. (`a-z`)
+  - `conf.numbers` - Accepts a `boolean` state, and determines whether to include or exclude numerical characters from generator's contents. (`0-9`)
+  - `conf.secure` - Accepts a `boolean` state, and determines the entropy to use for generating the generator's contents. (`crypto` | `Math.random()`)
+  - `conf.symbols` - Accepts a `boolean` state, and determines whether to include or exclude symbol characters from generator's contents. (`~!@#$%^&*()-_+=`...)
+  - `conf.uppercase` - Accepts a `boolean` state, and determines whether to include or exclude uppercase characters from generator's contents. (`A-Z`)
+
+## Properties / Methods
+
+- [NewToken()](./methods/generator.newToken.md) - Generates a randomized sequence of characters of `A-Z`, `a-z`, `0-9` and `symbols`
+- [RandomCharacters()](./methods/generator.randomCharacters.md) - Generates a sequence of randomized characters of `A-Z` and/or `a-z`.
+- [RandomInteger()](./methods/generator.randomInteger.md) - Generates a randomized integer value from the given `minimum` and `maximum` range.
+
+## Example Usage
+
+```js
+const Generate = new Custom.Generator(10, { secure: true });
+
+// #: Generate a sequence of randomized token that can be use for security such as session id, validation token, etc.
+// #: Only when configuration's 'secure' property is enabled.
+const Token = Generate.NewToken();
+
+// #: Generate a sequence of randomized characters that can be used for security such as session id, validation token, etc.
+// #: Only when configuration's 'secure' property is enabled.
+const CToken = Generate.RandomCharacters();
+
+// #: Generate a randomized integer value.
+const RInt = Generate.RandomInteger();
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,35 @@
+# JSU - Custom API - Generator().NewToken()
+
+## Table Of Contents
+
+- [JSU - Custom API - Generator().NewToken()](#jsu---custom-api---generatornewtoken)
+  - [Table Of Contents](#table-of-contents)
+  - [What It Does?](#what-it-does)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What It Does?
+
+- `Generator().NewToken()` Generates a sequence of random characters which can be used as session id, data id, game lobby id, and more.
+
+## Example Usage
+
+```js
+const Generate = new Custom.Generator(10, { secure: true, lowercase: false }); // Base size and configuration to use from generators.
+
+const VToken = Generate.NewToken(); // Generated token with symbols, numbers, and uppercase only.
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,35 @@
+# JSU - Custom API - Generator().RandomCharacters()
+
+## Table Of Contents
+
+- [JSU - Custom API - Generator().RandomCharacters()](#jsu---custom-api---generatorrandomcharacters)
+  - [Table Of Contents](#table-of-contents)
+  - [What it does?](#what-it-does)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What it does?
+
+- `Generator().RandomCharacters()` generates a sequence of characters of `A-Z` and/or `a-z`. Its contents will be based on the given configuration at `Generator()`.
+
+## Example Usage
+
+```js
+const Generate = new Custom.Generator(10, { secure: true });
+
+const VChars = Generate.RandomCharacters(); // Generates random sequence of characters that consist both upper and lower case characters.
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,41 @@
+# JSU - Custom API - Generator().RandomInteger()
+
+## Table Of Contents
+
+- [JSU - Custom API - Generator().RandomInteger()](#jsu---custom-api---generatorrandominteger)
+  - [Table Of Contents](#table-of-contents)
+  - [What it does?](#what-it-does)
+  - [Parameters](#parameters)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What it does?
+
+- `Generator().RandomInteger(min, max)` generates a random integer value within the given `minimum` and `maximum` range.
+
+## Parameters
+
+- `min` - The minimum integer value of this generator can generate.
+- `max` - The maximum integer value of this generator can generate.
+
+## Example Usage
+
+```js
+const Generate = new Custom.Generator(10, { secure: true });
+
+console.log(Generate.RandomInteger(0, 10)); // Logs the generated random integer value within the given range.
+```
+
+## Navigate To
+
+- [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

@@ -0,0 +1,39 @@
+# JSU - Custom API - NameOf()
+
+## Table Of Contents
+
+- [JSU - Custom API - NameOf()](#jsu---custom-api---nameof)
+  - [Table Of Contents](#table-of-contents)
+  - [What it does?](#what-it-does)
+  - [Parameter](#parameter)
+  - [Example Usage](#example-usage)
+  - [Navigate To](#navigate-to)
+
+## What it does?
+
+- `NameOf()` checks and retrieves the `name` property of the specified or given object in any case format.
+
+## Parameter
+
+- `obj` - The specified or given object to retrieve its `name` property.
+
+## Example Usage
+
+```js
+const Os = [{ name: "o1" }, { NaMe: "o2" }, { NAme: "o3" }, { naME: "o4" }, { nAMe: "o5" }];
+
+for (const O of Os) {
+    console.log(Custom.NameOf(O)); // "o1" to "o5"
+}
+```
+
+## Navigate To
+
+- [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.*