@carlsebastian/jsu 1.0.40 → 1.1.0

package/src/utils/dom/element/create/element.create.js

@@ -1,4 +1,4 @@
-import Emit from '../../../custom/error/builder/error.builder.js';
+import Raise from '../../../custom/error/builder/error.builder.js';
 import { IsArrEmpty, IsPlainObjEmpty, IsStrEmpty } from '../../../guards/formats/formats.js';
 import { IsArr, IsElement, IsNum, IsPlainObj, IsStr } from '../../../guards/data-types/data-types.js';
 import { CountOf } from '../../../primitives/obj/obj.accessor.js';
@@ -20,10 +20,10 @@ function ValidateTagAndConfiguration(caller, tag, conf) {
     const Caller = IsStr(caller) ? caller : "(Anonymous)";
 
     if (!IsStr(tag))
-        Emit._ArgumentError(Caller, "tag", tag, "String");
+        Raise._ArgumentError(Caller, "tag", tag, "String");
 
     if (!IsPlainObj(conf))
-        Emit._ArgumentError(Caller, "conf", conf, "Plain Object ({})");
+        Raise._ArgumentError(Caller, "conf", conf, "Plain Object ({})");
 }
 
 /**
@@ -160,7 +160,7 @@ const Create = {
                 if (!IsNum(Conf.Tabindex)) {
                     const ParsedIndex = parseInt(Conf.TabIndex, 10);
                     if (!IsNum(ParsedIndex))
-                        Emit._ArgumentError(Method, "conf.TabIndex", Conf.TabIndex, "Number");
+                        Raise._ArgumentError(Method, "conf.TabIndex", Conf.TabIndex, "Number");
 
                     Conf.TabIndex = ParsedIndex;
                 }
@@ -170,7 +170,7 @@ const Create = {
 
             if (Conf.XML_Language) {
                 if (!IsStr(Conf.XML_Language))
-                    Emit._ArgumentError(Method, "conf.XML_Language", Conf.XML_Language, "String");
+                    Raise._ArgumentError(Method, "conf.XML_Language", Conf.XML_Language, "String");
 
                 if (!IsStrEmpty(Conf.XML_Language))
                     ThisElement.setAttribute("xml:lang", Conf.XML_Language);
@@ -178,7 +178,7 @@ const Create = {
 
             if (Conf.XML_Space) {
                 if (!IsStr(Conf.XML_Space))
-                    Emit._ArgumentError(Method, "conf.XML_Space", Conf.XML_Space, "String");
+                    Raise._ArgumentError(Method, "conf.XML_Space", Conf.XML_Space, "String");
 
                 if (IsStrEmpty(Conf.XML_Space) || Conf.XML_Space !== "default" && Conf.XML_Space !== "preserve")
                     Conf.XML_Space = "default";
@@ -223,7 +223,7 @@ const Create = {
         if (CountOf(Conf) > 0) {
             if (Conf.Data) {
                 if (!IsPlainObj(Conf.Data))
-                    Emit._ArgumentError(Method, "conf.Data", Conf.Data, "Plain Object ({})");
+                    Raise._ArgumentError(Method, "conf.Data", Conf.Data, "Plain Object ({})");
 
                 if (CountOf(Conf.Data) > 0)
                     for (const [DK, DV] of Object.entries(Conf.Data)) {
@@ -241,7 +241,7 @@ const Create = {
 
             if (Conf.Dir) {
                 if (!IsStr(Conf.Dir))
-                    Emit._ArgumentError(Method, "conf.Dir", Conf.Dir, "String");
+                    Raise._ArgumentError(Method, "conf.Dir", Conf.Dir, "String");
 
                 if (IsStrEmpty(Conf.Dir) || (Conf.Dir !== "ltr" && Conf.Dir !== "rtl"))
                     Conf.Dir = "ltr";
@@ -254,7 +254,7 @@ const Create = {
 
             if (Conf.Href) {
                 if (!IsStr(Conf.Href))
-                    Emit._ArgumentError(Method, "conf.Href", Conf.Href, "String");
+                    Raise._ArgumentError(Method, "conf.Href", Conf.Href, "String");
 
                 if (!IsStrEmpty(Conf.Href))
                     ThisElement.setAttribute("href", Conf.Href);
@@ -262,7 +262,7 @@ const Create = {
 
             if (Conf.Id) {
                 if (!IsStr(Conf.Id))
-                    Emit._ArgumentError(Method, "conf.Id", Conf.Id, "String");
+                    Raise._ArgumentError(Method, "conf.Id", Conf.Id, "String");
 
                 if (!IsStrEmpty(Conf.Id))
                     ThisElement.id = Conf.Id;
@@ -270,7 +270,7 @@ const Create = {
 
             if (Conf.ScriptLevel) {
                 if (!IsStr(Conf.ScriptLevel))
-                    Emit._ArgumentError(Method, "conf.ScriptLevel", Conf.ScriptLevel, "String");
+                    Raise._ArgumentError(Method, "conf.ScriptLevel", Conf.ScriptLevel, "String");
 
                 if (!IsStrEmpty(Conf.ScriptLevel))
                     ThisElement.setAttribute("scriptlevel", Conf.ScriptLevel);
@@ -278,7 +278,7 @@ const Create = {
 
             if (Conf.MathBackground) {
                 if (!IsStr(Conf.MathBackground))
-                    Emit._ArgumentError(Method, "conf.MathBackground", Conf.MathBackground, "String");
+                    Raise._ArgumentError(Method, "conf.MathBackground", Conf.MathBackground, "String");
 
                 if (!IsStrEmpty(Conf.MathBackground))
                     ThisElement.setAttribute("mathbackground", Conf.MathBackground);
@@ -286,7 +286,7 @@ const Create = {
 
             if (Conf.MathColor) {
                 if (!IsStr(Conf.MathColor))
-                    Emit._ArgumentError(Method, "conf.MathColor", Conf.MathColor, "String");
+                    Raise._ArgumentError(Method, "conf.MathColor", Conf.MathColor, "String");
 
                 if (!IsStrEmpty(Conf.MathColor))
                     ThisElement.setAttribute("mathcolor", Conf.MathColor);
@@ -294,7 +294,7 @@ const Create = {
 
             if (Conf.MathSize) {
                 if (!IsStr(Conf.MathSize))
-                    Emit._ArgumentError(Method, "conf.MathSize", Conf.MathSize, "String");
+                    Raise._ArgumentError(Method, "conf.MathSize", Conf.MathSize, "String");
 
                 if (!IsStrEmpty(Conf.MathSize))
                     ThisElement.setAttribute("mathsize", Conf.MathSize);

package/src/utils/dom/element/getElementBy/dom.getElementBy.js

@@ -1,4 +1,4 @@
-import Emit from '../../../custom/error/builder/error.builder.js';
+import Raise from '../../../custom/error/builder/error.builder.js';
 import { IsNullOrUndefined, IsParentNode, IsStr } from '../../../guards/data-types/data-types.js';
 import { IsStrEmpty } from '../../../guards/formats/formats.js';
 import { XMLNameSpace } from '../../../variables.js';
@@ -31,7 +31,7 @@ const GetElementBy = {
         const Method = `${this.name}.ID`;
 
         if (!IsStr(id))
-            Emit._ArgumentError(Method, "id", id, "String");
+            Raise._ArgumentError(Method, "id", id, "String");
 
         if (IsStrEmpty(id)) {
             console.warn(`${Method}(@id: \'\'): Expects a non-empty-string! (Exited with null)`);
@@ -65,7 +65,7 @@ const GetElementBy = {
         const Method = `${this.name}.ClassName`;
 
         if (!IsStr(cls))
-            Emit._ArgumentError(Method, "cls", cls, "String");
+            Raise._ArgumentError(Method, "cls", cls, "String");
 
         if (IsStrEmpty(cls)) {
             console.warn(`${Method}(@cls: \'\'): Expects a non-empty-string! (Exited with [])`);
@@ -101,7 +101,7 @@ const GetElementBy = {
         const Method = `${this.name}.TagName`;
 
         if (!IsStr(tag))
-            Emit._ArgumentError(Method, "tag", tag, "String");
+            Raise._ArgumentError(Method, "tag", tag, "String");
 
         if (IsStrEmpty(tag)) {
             console.warn(`${Method}(@tag: \'\'): Expects a non-empty-string! (Exited with [])`);
@@ -141,10 +141,10 @@ const GetElementBy = {
         const Method = `${this.name}.TagNameNS`;
 
         if (!IsStr(namespace))
-            Emit._ArgumentError(Method, "namespace", namespace, "String");
+            Raise._ArgumentError(Method, "namespace", namespace, "String");
 
         if (!IsStr(tag))
-            Emit._ArgumentError(Method, "tag", tag, "String");
+            Raise._ArgumentError(Method, "tag", tag, "String");
 
         if (IsStrEmpty(namespace)) {
             console.warn(`${Method}(@namespace: \'\'): Expects a non-empty-string! (Exited with [])`);

package/src/utils/dom/element/query/dom.query.js

@@ -1,4 +1,4 @@
-import Emit from '../../../custom/error/builder/error.builder.js';
+import Raise from '../../../custom/error/builder/error.builder.js';
 import { IsStr, IsParentNode } from '../../../guards/data-types/data-types.js';
 import { IsStrEmpty } from '../../../guards/formats/formats.js';
 
@@ -23,7 +23,7 @@ export function Select(selector, root = document) {
     const Method = "Select";
 
     if (!IsStr(selector))
-        Emit._ArgumentError(Method, "selector", selector, "String");
+        Raise._ArgumentError(Method, "selector", selector, "String");
 
     if (IsStrEmpty(selector)) {
         console.warn(`${Method}(@selector: \'\'): Expects a non-empty-string! (Exited with null)`);
@@ -59,7 +59,7 @@ export function SelectAll(selector, root = document) {
     const Method = "SelectAll";
 
     if (!IsStr(selector))
-        Emit._ArgumentError(Method, "selector", selector, "String");
+        Raise._ArgumentError(Method, "selector", selector, "String");
 
     if (IsStrEmpty(selector)) {
         console.warn(`${Method}(@selector: \'\'): Expects a non-empty-string! (Exited with null)`);

package/src/utils/dom/element/tag-verifier/verifier.js

@@ -1,4 +1,4 @@
-import Emit from '../../../custom/error/builder/error.builder.js';
+import Raise from '../../../custom/error/builder/error.builder.js';
 import { IsStrEmpty } from '../../../guards/formats/formats.js';
 import { IsStr } from '../../../guards/data-types/data-types.js';
 import * as VAR from '../../../variables.js';
@@ -14,7 +14,7 @@ export default function VerifyTag(tag) {
     const Method = "VerifyTag";
 
     if (!IsStr(tag) || IsStrEmpty(tag))
-        Emit._ArgumentError(Method, "tag", tag, "String");
+        Raise._ArgumentError(Method, "tag", tag, "String");
 
     tag = tag.trim().toLowerCase()
     return {
@@ -26,7 +26,7 @@ export default function VerifyTag(tag) {
          */
         HTMLElement() {
             if (!VAR.HTMLElementTags.has(tag))
-                Emit._NoSuchElementTagError(`${Method}.HTMLElement`, "tag", tag, "HTMLElement");
+                Raise._NoSuchElementTagError(`${Method}.HTMLElement`, "tag", tag, "HTMLElement");
 
             return VAR.HTMLElementTags.get(tag)?.Generate() ?? null;
         },
@@ -39,7 +39,7 @@ export default function VerifyTag(tag) {
          */
         SVGElement() {
             if (!VAR.SVGElementTags.has(tag))
-                Emit._NoSuchElementTagError(`${Method}.SVGElement`, "tag", tag, "SVGElement");
+                Raise._NoSuchElementTagError(`${Method}.SVGElement`, "tag", tag, "SVGElement");
 
             return VAR.SVGElementTags.get(tag)?.Generate() ?? null;
         },
@@ -52,7 +52,7 @@ export default function VerifyTag(tag) {
          */
         MathElement() {
             if (!VAR.MathMLElementTags.has(tag))
-                Emit._NoSuchElementTagError(`${Method}.MathMLElement`, "tag", tag, "MathMLElement");
+                Raise._NoSuchElementTagError(`${Method}.MathMLElement`, "tag", tag, "MathMLElement");
 
             return VAR.MathMLElementTags.get(tag)?.Generate();
         }

package/src/utils/dom/lifecycle/mount.js

@@ -1,4 +1,4 @@
-import Emit from '../../custom/error/builder/error.builder.js';
+import Raise from '../../custom/error/builder/error.builder.js';
 import { IsChildNode, IsParentNode, IsPropertyAt } from '../../guards/data-types/data-types.js';
 
 /**
@@ -27,7 +27,7 @@ export default function Mount(parentNode, ...childNodes) {
     const Method = "Mount", PCN = childNodes.length > 1 ? "childNodes" : "childNode";
 
     if (!IsParentNode(parentNode))
-        Emit._ArgumentError(Method, "parentNode", parentNode, "ParentNode");
+        Raise._ArgumentError(Method, "parentNode", parentNode, "ParentNode");
 
     if (childNodes.length === 0) {
         console.warn(`${Method}(@childNode: NOT_PROVIDED): Expects at least 1 or more child node(s) to mount! (Exited)`);
@@ -41,7 +41,7 @@ export default function Mount(parentNode, ...childNodes) {
 
     for (const Node of childNodes) {
         if (!IsChildNode(Node))
-            Emit._ArgumentError(Method, PCN, Node, "ChildNode");
+            Raise._ArgumentError(Method, PCN, Node, "ChildNode");
 
         parentNode.appendChild(Node);
     }

package/src/utils/dom/lifecycle/unmount.js

@@ -1,4 +1,4 @@
-import Emit from '../../custom/error/builder/error.builder.js';
+import Raise from '../../custom/error/builder/error.builder.js';
 import { IsChildNode, IsPropertyAt } from '../../guards/data-types/data-types.js';
 
 /**
@@ -31,7 +31,7 @@ export default function Unmount(...childNodes) {
 
     for (const Node of childNodes) {
         if (!IsChildNode(Node))
-            Emit._ArgumentError(Method, PCN, Node, "ChildNode");
+            Raise._ArgumentError(Method, PCN, Node, "ChildNode");
 
         if (!IsPropertyAt(Node, "remove")) {
             console.warn(`${Method}(@${PCN}${ICtr > 1 ? `[${Node}]` : `: ${Node}`}: NOT_SUPPORTED_METHOD): A given child node does not support the 'remove()' method! (${ICtr > 1 ? "Skipped" : "Exited"})`);

package/src/utils/storage/local/storage.local.js

@@ -1,4 +1,4 @@
-import Emit from '../../custom/error/builder/error.builder.js';
+import Raise from '../../custom/error/builder/error.builder.js';
 
 /* -- Helper -- */
 /**
@@ -14,10 +14,10 @@ function ValidateStorageKey(caller, localKey, processId) {
         ? caller : `STORAGE.LOCAL.(ANONYMOUS)`;
 
     if (typeof localKey !== "string")
-        Emit._ArgumentError(Method, "localKey", localKey, "String");
+        Raise._ArgumentError(Method, "localKey", localKey, "String");
 
     if (typeof processId !== "string")
-        Emit._ArgumentError(Method, "processId", processId, "String");
+        Raise._ArgumentError(Method, "processId", processId, "String");
 
     const Key = localKey.trim();
     if (Key.length === 0) {

package/src/utils/storage/session/storage.session.js

@@ -1,4 +1,4 @@
-import Emit from '../../custom/error/builder/error.builder.js';
+import Raise from '../../custom/error/builder/error.builder.js';
 
 /* Helper */
 /**
@@ -14,10 +14,10 @@ function ValidateStorageKey(caller, sessionKey, processId) {
         ? caller : `STORAGE.SESSION.(ANONYMOUS)`;
 
     if (typeof sessionKey !== "string")
-        Emit._ArgumentError(Method, "sessionKey", sessionKey, "String");
+        Raise._ArgumentError(Method, "sessionKey", sessionKey, "String");
 
     if (typeof processId !== "string")
-        Emit._ArgumentError(Method, "processId", processId, "String");
+        Raise._ArgumentError(Method, "processId", processId, "String");
 
     const Key = sessionKey.trim();
     if (Key.length === 0) {

package/src/utils/storage/storage.js

@@ -1,4 +1,4 @@
-import Emit from '../custom/error/builder/error.builder.js';
+import Raise from '../custom/error/builder/error.builder.js';
 import { Global } from '../custom/utils/custom.utils.js';
 import { IsNullOrUndefined, IsPropertyAt } from '../guards/data-types/data-types.js';
 import LocalStorageMethods from './local/storage.local.js';
@@ -25,7 +25,7 @@ const STORAGE = {
      */
     IS_SUPPORTED() {
         if (!this.LOCAL.IS_SUPPORTED && !this.SESSION.IS_SUPPORTED)
-            Emit._NotSupportedError(`${this.NAME}.${this.IS_SUPPORTED.name}`, this.NAME);
+            Raise._NotSupportedError(`${this.NAME}.${this.IS_SUPPORTED.name}`, this.NAME);
 
         return true;
     },

package/src/utils/variables.js

@@ -1,9 +1,9 @@
 /**
- *  A collection of HTMLElements tags.
+ *  A collection of `HTMLElement` tags.
  *
  *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements
  *
- *  @type { Map<string, { Generate: () => HTMLElement }> }
+ *  @type { Map<keyof HTMLElementTags, { Generate(): HTMLElement }> }
  */
 export const HTMLElementTags = [
     "a", "abbr", "acronym", "address", "address", "area", "article", "aside", "audio", "b", "base", "bdi",
@@ -24,11 +24,11 @@ export const HTMLElementTags = [
 }, new Map([]));
 
 /**
- *  A collection of SVGElements tags.
+ *  A collection of `SVGElement` tags.
  *
  *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element
  *
- *  @type { Map<string, { Generate: () => SVGElement}> }
+ *  @type { Map<keyof SVGElementTags, { Generate(): SVGElement }> }
  */
 export const SVGElementTags = [
     "a", "animate", "animateMotion", "animateTransform", "circle", "clipPath", "defs", "desc", "ellipse",
@@ -46,11 +46,11 @@ export const SVGElementTags = [
 }, new Map([]));
 
 /**
- *  A collection of MathMLElements tags.
+ *  A collection of `MathMLElement` tags.
  *
  *  ***Source***: https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element
  *
- *  @type { Map<string, { Generate: () => MathMLElement}> }
+ *  @type { Map<keyof MathElementTags, { Generate(): MathMLElement }> }
  */
 export const MathMLElementTags = [
     "math", "maction", "annotation", "annotation-xml", "menclose", "merror", "mfenced", "mfrac", "mi", "mmultiscripts",
@@ -67,11 +67,17 @@ export const MathMLElementTags = [
  */
 export const XMLNameSpace = ["http://www.w3.org/1998/Math/MathML", "http://www.w3.org/1999/xhtml", "http://www.w3.org/2000/svg"];
 
+if (globalThis.Variables === null || globalThis.Variables === undefined)
+    Object.defineProperty(globalThis, "Variables", {
+        value: {},
+        writable: false, configurable: true, enumerable: true
+    });
+
 [
     ["HTMLElementTags", HTMLElementTags], ["MathMLElementTags", MathMLElementTags],
     ["SVGElementTags", SVGElementTags], ["XMLNameSpace", XMLNameSpace]
 ].forEach((key, val) => {
-    Object.defineProperty(globalThis, key, {
+    Object.defineProperty(globalThis.Variables, key, {
         value: val,
         writable: false, configurable: true, enumerable: true
     });

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "allowJs": true,
-    "checkJs": true,
-    "noCheck": true,
-    "noEmit": true,
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "target": "ESNext",
-    "strict": true,
-    "lib": ["DOM", "ESNext"]
-  },
-  "include": ["src", "src/types/**/*.d.ts"]
-}