@thednp/shorty 1.0.2 → 2.0.0-alpha2

package/src/is/isShadowRoot.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if target is a `ShadowRoot`.
+ *
+ * @param element target
+ * @returns the query result
+ */
+const isShadowRoot = (element?: any): element is ShadowRoot =>
+  (element && element.constructor.name === "ShadowRoot") || false;
+
+export default isShadowRoot;

package/src/is/isString.js

@@ -1,8 +1,2 @@
-/**
- * Shortcut for `typeof SOMETHING === "string"`.
- *
- * @param  {any} str input value
- * @returns {boolean} the query result
- */
-const isString = (str) => typeof str === 'string';
-export default isString;
+const isString = (str) => typeof str === "string" || false;
+export default isString;

package/src/is/isString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isString.js","sourceRoot":"","sources":["isString.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAAG,CAAC,GAAS,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC;AAEhF,eAAe,QAAQ,CAAC"}

package/src/is/isString.ts

@@ -0,0 +1,9 @@
+/**
+ * Shortie for `typeof SOMETHING === "string"`.
+ *
+ * @param str input value
+ * @returns the query result
+ */
+const isString = (str?: any): str is string => typeof str === "string" || false;
+
+export default isString;

package/src/is/isTableElement.js

@@ -1,11 +1,2 @@
-/**
- * Check if a target element is a `<table>`, `<td>` or `<th>`.
- * This specific check is important for determining
- * the `offsetParent` of a given element.
- *
- * @param {any} element the target element
- * @returns {boolean} the query result
- */
-const isTableElement = (element) => (element && ['TABLE', 'TD', 'TH'].includes(element.tagName))
-  || false;
-export default isTableElement;
+const isTableElement = (element) => (element && ["TABLE", "TD", "TH"].includes(element.tagName)) || false;
+export default isTableElement;

package/src/is/isTableElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isTableElement.js","sourceRoot":"","sources":["isTableElement.ts"],"names":[],"mappings":"AAQA,MAAM,cAAc,GAAG,CAAC,OAAa,EAAsD,EAAE,CAC3F,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC;AAExE,eAAe,cAAc,CAAC"}

package/src/is/isTableElement.ts

@@ -0,0 +1,12 @@
+/**
+ * Check if a target element is a `<table>`, `<td>` or `<th>`.
+ * This specific check is important for determining
+ * the `offsetParent` of a given element.
+ *
+ * @param element the target element
+ * @returns the query result
+ */
+const isTableElement = (element?: any): element is HTMLTableElement | HTMLTableCellElement =>
+  (element && ["TABLE", "TD", "TH"].includes(element.tagName)) || false;
+
+export default isTableElement;

package/src/is/isWeakMap.js

@@ -0,0 +1,2 @@
+const isWeakMap = (obj) => (obj && obj.constructor.name === 'WeakMap') || false;
+export default isWeakMap;

package/src/is/isWeakMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isWeakMap.js","sourceRoot":"","sources":["isWeakMap.ts"],"names":[],"mappings":"AAMA,MAAM,SAAS,GAAG,CAAC,GAAS,EAA4B,EAAE,CACxD,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,KAAK,CAAC;AACvD,eAAe,SAAS,CAAC"}

package/src/is/isWeakMap.ts

@@ -0,0 +1,9 @@
+/**
+ * Checks if an element is a `WeakMap`.
+ *
+ * @param obj the target object
+ * @returns the query result
+ */
+const isWeakMap = (obj?: any): obj is WeakMap<any, any> =>
+  (obj && obj.constructor.name === 'WeakMap') || false;
+export default isWeakMap;

package/src/is/isWindow.js

@@ -1,9 +1,2 @@
-/**
- * Check if a target object is `Window`.
- * => equivalent to `object instanceof Window`
- *
- * @param {any} object the target object
- * @returns {boolean} the query result
- */
-const isWindow = (object) => (object && object.constructor.name === 'Window') || false;
-export default isWindow;
+const isWindow = (obj) => (obj && obj.constructor.name === "Window") || false;
+export default isWindow;

package/src/is/isWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isWindow.js","sourceRoot":"","sources":["isWindow.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,CAAC,GAAS,EAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,KAAK,CAAC;AAEnG,eAAe,QAAQ,CAAC"}

package/src/is/isWindow.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if a target object is `Window`.
+ * => equivalent to `object instanceof Window`
+ *
+ * @param obj the target object
+ * @returns the query result
+ */
+const isWindow = (obj?: any): obj is Window => (obj && obj.constructor.name === "Window") || false;
+
+export default isWindow;

package/src/misc/ArrayFrom.js

@@ -1,8 +1,2 @@
-/**
- * Shortcut for `Array.from()` static method.
- *
- * @param  {any[] | HTMLCollection | NodeList | Map<any, any>} arr array-like iterable object
- * @returns {Array<any>}
- */
-const ArrayFrom = (arr) => Array.from(arr);
-export default ArrayFrom;
+const ArrayFrom = (arr) => Array.from(arr);
+export default ArrayFrom;

package/src/misc/ArrayFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayFrom.js","sourceRoot":"","sources":["ArrayFrom.ts"],"names":[],"mappings":"AAQA,MAAM,SAAS,GAAG,CAAI,GAA+B,EAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/E,eAAe,SAAS,CAAC"}

package/src/misc/ArrayFrom.ts

@@ -0,0 +1,11 @@
+/**
+ * Shortie for `Array.from()` static method.
+ * The utility should also work with any typed arrays
+ * like Float64Array or Int32Array.
+ *
+ * @param arr array-like iterable object
+ * @returns a new array from iterable object
+ */
+const ArrayFrom = <T>(arr: ArrayLike<T> | Iterable<T>): T[] => Array.from(arr);
+
+export default ArrayFrom;

package/src/misc/Float32ArrayFrom.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Float32Array.from()` static method.
- * @param  {any[] | HTMLCollection | NodeList} arr array-like iterable object
- * @returns {Float32Array}
- */
-const Float32ArrayFrom = (arr) => Float32Array.from(Array.from(arr));
-export default Float32ArrayFrom;
+const Float32ArrayFrom = (arr) => Float32Array.from(Array.from(arr));
+export default Float32ArrayFrom;

package/src/misc/Float32ArrayFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Float32ArrayFrom.js","sourceRoot":"","sources":["Float32ArrayFrom.ts"],"names":[],"mappings":"AAKA,MAAM,gBAAgB,GAAG,CAAC,GAAyC,EAAgB,EAAE,CACnF,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErC,eAAe,gBAAgB,CAAC"}

package/src/misc/Float32ArrayFrom.ts

@@ -0,0 +1,9 @@
+/**
+ * Shortcut for `Float32Array.from()` static method.
+ * @param arr array-like iterable object
+ * @returns a new Float32Array
+ */
+const Float32ArrayFrom = (arr: ArrayLike<number> | Iterable<number>): Float32Array =>
+  Float32Array.from(Array.from(arr));
+
+export default Float32ArrayFrom;

package/src/misc/Float64ArrayFrom.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Float64Array.from()` static method.
- * @param  {any[] | HTMLCollection | NodeList} arr array-like iterable object
- * @returns {Float64Array}
- */
-const Float64ArrayFrom = (arr) => Float64Array.from(Array.from(arr));
-export default Float64ArrayFrom;
+const Float64ArrayFrom = (arr) => Float64Array.from(Array.from(arr));
+export default Float64ArrayFrom;

package/src/misc/Float64ArrayFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Float64ArrayFrom.js","sourceRoot":"","sources":["Float64ArrayFrom.ts"],"names":[],"mappings":"AAKA,MAAM,gBAAgB,GAAG,CAAC,GAAyC,EAAgB,EAAE,CACnF,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErC,eAAe,gBAAgB,CAAC"}

package/src/misc/Float64ArrayFrom.ts

@@ -0,0 +1,9 @@
+/**
+ * Shortcut for `Float64Array.from()` static method.
+ * @param arr array-like iterable object
+ * @returns a new Float64Array
+ */
+const Float64ArrayFrom = (arr: ArrayLike<number> | Iterable<number>): Float64Array =>
+  Float64Array.from(Array.from(arr));
+
+export default Float64ArrayFrom;

package/src/misc/ObjectAssign.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Object.assign()` static method.
- * @param  {Record<string, any>} obj a target object
- * @param  {Record<string, any>} source a source object
- */
-const ObjectAssign = (obj, source) => Object.assign(obj, source);
-export default ObjectAssign;
+const ObjectAssign = (obj, ...source) => Object.assign(obj, ...source);
+export default ObjectAssign;

package/src/misc/ObjectAssign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectAssign.js","sourceRoot":"","sources":["ObjectAssign.ts"],"names":[],"mappings":"AAOA,MAAM,YAAY,GAAG,CAAkB,GAAM,EAAE,GAAG,MAAW,EAAiC,EAAE,CAC9F,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;AAEhC,eAAe,YAAY,CAAC"}

package/src/misc/ObjectAssign.ts

@@ -0,0 +1,11 @@
+/**
+ * Shortcut for `Object.assign()` static method.
+ * @param obj a target object
+ * @param source source object(s)
+ * @see https://github.com/devinrhode2/ObjectTyped/blob/master/src/index.ts
+ */
+
+const ObjectAssign = <A extends {}, B>(obj: A, ...source: B[]): B extends any[] ? any : A & B =>
+  Object.assign(obj, ...source);
+
+export default ObjectAssign;

package/src/misc/ObjectEntries.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Object.entries()` static method.
- * @param  {Record<string, any>} obj a target object
- * @returns {[string, any][]}
- */
-const ObjectEntries = (obj) => Object.entries(obj);
-export default ObjectEntries;
+const ObjectEntries = (obj) => Object.entries(obj);
+export default ObjectEntries;

package/src/misc/ObjectEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectEntries.js","sourceRoot":"","sources":["ObjectEntries.ts"],"names":[],"mappings":"AAKA,MAAM,aAAa,GAAG,CAAe,GAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAiC,CAAC;AAEpG,eAAe,aAAa,CAAC"}

package/src/misc/ObjectEntries.ts

@@ -0,0 +1,8 @@
+/**
+ * Shortcut for `Object.entries()` static method.
+ * @param obj a target object
+ * @returns the entries of an object in an array format [key, value][]
+ */
+const ObjectEntries = <O extends {}>(obj: O) => Object.entries(obj) as Array<[keyof O, O[keyof O]]>;
+
+export default ObjectEntries;

package/src/misc/ObjectKeys.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Object.keys()` static method.
- * @param  {Record<string, any>} obj a target object
- * @returns {string[]}
- */
-const ObjectKeys = (obj) => Object.keys(obj);
-export default ObjectKeys;
+const ObjectKeys = (obj) => Object.keys(obj);
+export default ObjectKeys;

package/src/misc/ObjectKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectKeys.js","sourceRoot":"","sources":["ObjectKeys.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,GAAG,CAAC,GAAwB,EAAY,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE5E,eAAe,UAAU,CAAC"}

package/src/misc/ObjectKeys.ts

@@ -0,0 +1,8 @@
+/**
+ * Shortcut for `Object.keys()` static method.
+ * @param obj a target object
+ * @returns an array with object keys
+ */
+const ObjectKeys = (obj: Record<string, any>): string[] => Object.keys(obj);
+
+export default ObjectKeys;

package/src/misc/ObjectValues.js

@@ -1,7 +1,2 @@
-/**
- * Shortcut for `Object.values()` static method.
- * @param  {Record<string, any>} obj a target object
- * @returns {any[]}
- */
-const ObjectValues = (obj) => Object.values(obj);
-export default ObjectValues;
+const ObjectValues = (obj) => Object.values(obj);
+export default ObjectValues;

package/src/misc/ObjectValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectValues.js","sourceRoot":"","sources":["ObjectValues.ts"],"names":[],"mappings":"AAKA,MAAM,YAAY,GAAG,CAAe,GAAM,EAAuB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAEvF,eAAe,YAAY,CAAC"}

package/src/misc/ObjectValues.ts

@@ -0,0 +1,8 @@
+/**
+ * Shortcut for `Object.values()` static method.
+ * @param obj a target object
+ * @returns an array with the object values
+ */
+const ObjectValues = <O extends {}>(obj: O): Array<[O[keyof O]]> => Object.values(obj);
+
+export default ObjectValues;

package/src/misc/OriginalEvent.js

@@ -1,19 +1,13 @@
-import ObjectAssign from './ObjectAssign';
-
-/**
- * Returns a namespaced `CustomEvent` specific to each component.
- * @param {string} EventType Event.type
- * @param {Record<string, any>=} config Event.options | Event.properties
- * @returns {SHORTY.OriginalEvent} a new namespaced event
- */
-export default function OriginalEvent(EventType, config) {
-  const OriginalCustomEvent = new CustomEvent(EventType, {
-    cancelable: true, bubbles: true,
-  });
-
-  /* istanbul ignore else */
-  if (config instanceof Object) {
-    ObjectAssign(OriginalCustomEvent, config);
-  }
-  return OriginalCustomEvent;
-}
+import isObject from '../is/isObject';
+import ObjectAssign from './ObjectAssign';
+const OriginalEvent = (EventType, config) => {
+    const OriginalCustomEvent = new CustomEvent(EventType, {
+        cancelable: true,
+        bubbles: true,
+    });
+    if (isObject(config)) {
+        ObjectAssign(OriginalCustomEvent, config);
+    }
+    return OriginalCustomEvent;
+};
+export default OriginalEvent;

package/src/misc/OriginalEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OriginalEvent.js","sourceRoot":"","sources":["OriginalEvent.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAQ1C,MAAM,aAAa,GAAG,CAAI,SAAiB,EAAE,MAA2B,EAAoB,EAAE;IAC5F,MAAM,mBAAmB,GAAG,IAAI,WAAW,CAAI,SAAS,EAAE;QACxD,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI;KACQ,CAAC,CAAC;IAGzB,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE;QACpB,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;KAC3C;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/src/misc/OriginalEvent.ts

@@ -0,0 +1,24 @@
+import OriginalEvent from '../interface/originalEvent';
+import isObject from '../is/isObject';
+import ObjectAssign from './ObjectAssign';
+
+/**
+ * Returns a namespaced `CustomEvent` specific to each component.
+ * @param EventType Event.type
+ * @param config Event.options | Event.properties
+ * @returns a new namespaced event
+ */
+const OriginalEvent = <T>(EventType: string, config?: CustomEventInit<T>): OriginalEvent<T> => {
+  const OriginalCustomEvent = new CustomEvent<T>(EventType, {
+    cancelable: true,
+    bubbles: true,
+  } as CustomEventInit<T>);
+
+  /* istanbul ignore else */
+  if (isObject(config)) {
+    ObjectAssign(OriginalCustomEvent, config);
+  }
+  return OriginalCustomEvent;
+};
+
+export default OriginalEvent;

package/src/misc/createElement.js

@@ -1,27 +1,24 @@
-import getDocument from '../get/getDocument';
-import ObjectAssign from './ObjectAssign';
-
-/**
- * This is a shortie for `document.createElement` method
- * which allows you to create a new `HTMLElement` for a given `tagName`
- * or based on an object with specific non-readonly attributes:
- * `id`, `className`, `textContent`, `style`, etc.
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement
- *
- * @param {Record<string, string> | string} param `tagName` or object
- * @return {HTMLElement} a new `HTMLElement` or `Element`
- */
-export default function createElement(param) {
-  if (!param) return null;
-
-  if (typeof param === 'string') {
-    return getDocument().createElement(param);
-  }
-
-  const { tagName } = param;
-  const attr = { ...param };
-  const newElement = createElement(tagName);
-  delete attr.tagName;
-  ObjectAssign(newElement, attr);
-  return newElement;
-}
+import isString from '../is/isString';
+import setAttribute from '../attr/setAttribute';
+import getDocument from '../get/getDocument';
+import ObjectEntries from './ObjectEntries';
+const createElement = (param) => {
+    if (!param)
+        return undefined;
+    if (typeof param === 'string') {
+        return getDocument().createElement(param);
+    }
+    const { tagName } = param;
+    const newElement = createElement(tagName);
+    if (!newElement)
+        return undefined;
+    const attr = { ...param };
+    delete attr.tagName;
+    ObjectEntries(attr).forEach(([key, value]) => {
+        if (isString(value)) {
+            setAttribute(newElement, key, value);
+        }
+    });
+    return newElement;
+};
+export default createElement;

package/src/misc/createElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createElement.js","sourceRoot":"","sources":["createElement.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,YAAY,MAAM,sBAAsB,CAAC;AAChD,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAY5C,MAAM,aAAa,GAAG,CAAC,KAAqC,EAA2B,EAAE;IACvF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,WAAW,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;KAC3C;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC;IAEpB,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC3C,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE;YACnB,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;SACtC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/src/misc/createElement.ts

@@ -0,0 +1,39 @@
+import isString from '../is/isString';
+import setAttribute from '../attr/setAttribute';
+import getDocument from '../get/getDocument';
+import ObjectEntries from './ObjectEntries';
+
+/**
+ * Shortie for `document.createElement` method
+ * which allows you to create a new `HTMLElement` for a given `tagName`
+ * or based on an object with specific non-readonly attributes with string values:
+ * `id`, `className`, `textContent`, `style`, etc.
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement
+ *
+ * @param param `tagName` or object
+ * @return a new `HTMLElement` or `Element`
+ */
+const createElement = (param?: string | Partial<HTMLElement>): HTMLElement | undefined => {
+  if (!param) return undefined;
+
+  if (typeof param === 'string') {
+    return getDocument().createElement(param);
+  }
+
+  const { tagName } = param;
+  const newElement = createElement(tagName);
+
+  if (!newElement) return undefined;
+
+  const attr = { ...param };
+  delete attr.tagName;
+
+  ObjectEntries(attr).forEach(([key, value]) => {
+    if (isString(value)) {
+      setAttribute(newElement, key, value);
+    }
+  });
+  return newElement;
+};
+
+export default createElement;

package/src/misc/createElementNS.js

@@ -1,30 +1,24 @@
-import getDocument from '../get/getDocument';
-import ObjectEntries from './ObjectEntries';
-import setAttribute from '../attr/setAttribute';
-
-/**
- * This is a shortie for `document.createElementNS` method
- * which allows you to create a new `HTMLElement` for a given `tagName`
- * or based on an object with specific non-readonly attributes:
- * `id`, `className`, `textContent`, `style`, etc.
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS
- *
- * @param {string} namespace `namespaceURI` to associate with the new `HTMLElement`
- * @param {Record<string, string> | string} param `tagName` or object
- * @return {HTMLElement} a new `HTMLElement` or `Element`
- */
-export default function createElementNS(namespace, param) {
-  if (!namespace && !param) return null;
-  if (typeof param === 'string') {
-    return getDocument().createElementNS(namespace, param);
-  }
-
-  const { tagName } = param;
-  const attr = { ...param };
-  const newElement = createElementNS(namespace, tagName);
-  delete attr.tagName;
-  ObjectEntries(attr).forEach(([key, value]) => {
-    setAttribute(newElement, key, value);
-  });
-  return newElement;
-}
+import getDocument from '../get/getDocument';
+import ObjectEntries from './ObjectEntries';
+import setAttribute from '../attr/setAttribute';
+import isString from '../is/isString';
+const createElementNS = (ns, param) => {
+    if (!ns && !param)
+        return undefined;
+    if (typeof param === 'string') {
+        return getDocument().createElementNS(ns, param);
+    }
+    const { tagName } = param;
+    const newElement = createElementNS(ns, tagName);
+    if (!newElement)
+        return undefined;
+    const attr = { ...param };
+    delete attr.tagName;
+    ObjectEntries(attr).forEach(([key, value]) => {
+        if (isString(value)) {
+            setAttribute(newElement, key, value);
+        }
+    });
+    return newElement;
+};
+export default createElementNS;

package/src/misc/createElementNS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createElementNS.js","sourceRoot":"","sources":["createElementNS.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,YAAY,MAAM,sBAAsB,CAAC;AAChD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAatC,MAAM,eAAe,GAAG,CACtB,EAAW,EACX,KAAqC,EACZ,EAAE;IAC3B,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAEpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,WAAW,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,KAAK,CAAgB,CAAC;KAChE;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,OAAiB,CAAC,CAAC;IAE1D,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC;IAEpB,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC3C,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE;YACnB,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;SACtC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/src/misc/createElementNS.ts

@@ -0,0 +1,44 @@
+import getDocument from '../get/getDocument';
+import ObjectEntries from './ObjectEntries';
+import setAttribute from '../attr/setAttribute';
+import isString from '../is/isString';
+
+/**
+ * Shortie for `document.createElementNS` method
+ * which allows you to create a new `HTMLElement` for a given `tagName`
+ * or based on an object with specific non-readonly attributes with string values:
+ * `id`, `className`, `textContent`, `style`, etc.
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS
+ *
+ * @param ns `namespaceURI` to associate with the new `HTMLElement`
+ * @param param `tagName` or object
+ * @return a new `HTMLElement`
+ */
+const createElementNS = (
+  ns?: string,
+  param?: string | Partial<HTMLElement>
+): HTMLElement | undefined => {
+  if (!ns && !param) return undefined;
+
+  if (typeof param === 'string') {
+    return getDocument().createElementNS(ns, param) as HTMLElement;
+  }
+
+  const { tagName } = param;
+  const newElement = createElementNS(ns, tagName as string);
+
+  if (!newElement) return undefined;
+
+  const attr = { ...param };
+  delete attr.tagName;
+
+  ObjectEntries(attr).forEach(([key, value]) => {
+    if (isString(value)) {
+      setAttribute(newElement, key, value);
+    }
+  });
+
+  return newElement;
+};
+
+export default createElementNS;